搜尋套件、儲存庫與 APP 分類

GitHub 儲存庫onyx-lyon1/onyx

黑曜石

克萊德·伯納德大學的應用程式

黑曜石 專案封面
星標
31
分支
8
最近推送(UTC)
2026年10月10日
專案狀態
未封存

原始 README

以下為英文專案原文快照,最新內容請造訪 GitHub。

Onyx
Onyx : Everything for Lyon 1

The student application for Claude Bernard Lyon 1 University

Releases Playstore License Discord

Features | Download | Contribute | Build | License

Banner

Onyx is an unofficial, open-source application that lets you access all Université Claude Bernard Lyon 1 services from your phone.

Features

Calendar Screenshot Email Screenshot Grades Screenshot Map Screenshot Izly Screenshot

Download

github app-store

Contribute

An application for students, by students. Feel free to contribute to this project by opening issues or pull requests. We really appreciate any help. You can also chat with us on Discord.

Thanks

Thanks to weblate for the translation platform !

Build

To build the app, follow these steps:

Prerequisites 🛠️
  • Install Flutter from flutter.dev.

  • Linux

    You will need those libraries:

    • pkg-config
    • libgtk3
    • libglib2
    • libsecret
    • zenity

    On Debian/Ubuntu like distros, they can be installed with this single command :

    sudo apt install pkg-config libgtk-3-dev libglib2.0-dev libsecret-1-dev zenity
    
  • Android

    You will need a recent version of Android Sdk.

    You can then run flutter doctor to check if it's detected by flutter.

Building the App 🏗️

Please make sure you are on the main branch before proceeding with the build process. Navigate to the apps/onyx directory and execute the following command based on your target platform:

  • To build an APK: flutter build apk --profile --no-tree-shake-icons (the --profile flag build the app without the signing key but with full optimizations)
    • The APK file is located at apps/onyx/build/app/outputs/flutter-apk/app-release.apk.
  • To build for Linux: flutter build linux --no-tree-shake-icons
    • The Linux build is located at apps/onyx/build/linux/x64/release/bundle/Onyx.
  • To build an app bundle: flutter build appbundle --profile --no-tree-shake-icons (the --profile flag build the app without the signing key but with full optimizations)
    • The app bundle is located at apps/onyx/build/app/outputs/bundle/release/app-release.aab.
  • For other platforms, please refer to the Flutter documentation for their respective build locations.
Development Environment Setup ⚙️

To set up your development environment:

  1. The required libraries are located in the packages/ directory.
  2. Install Melos, which handles linking libraries directly in the app for development:
    • Install Melos by running: dart pub global activate melos.
    • Refer to the Melos documentation for more details.
  3. Run melos bs or melos bootstrap to link the local libraries in the app and retrieve all dependencies.
  4. Navigate to the apps/onyx directory and run flutter clean to ensure a clean environment.
  5. Run flutter run to start the app.
  6. Optionally, you can use melos generate to generate automatically generated files (usually not needed unless you modify them).
  7. Run melos test to run unit tests for all the libraries.
  8. Run melos analyze to perform static analysis on the libraries and the Onyx app.
  9. To unlink everything, use melos clean.
  10. You may have to use the agenda ids with your keys, to prevent commiting them, you can use git update-index --assume-unchanged apps/onyx/assets/key.txt and git update-index --assume-unchanged apps/onyx/assets/iv.txt to ignore changes to this file.
android emulation

if you are using the flake, to create an virtual device, run : avdmanager create avd --force --name phone --package 'system-images;android-33;google_apis_playstore;x86_64' then to run it simply run : emulator -avd phone -skin 720x1280

End-to-End Testing 🧪

To run end-to-end tests:

  1. Install Maestro by following the Maestro documentation.
  2. Run the following command to install Maestro: curl -Ls "https://get.maestro.mobile.dev" | bash (Applicable for Mac OS, Linux, or Windows with WSL)
  3. Navigate to the apps/onyx/integration_test directory. 4. After installing the app on an Android device (physical or virtual), run the following command to execute the tests: maestro test general_test.yaml Maestro will automatically run the tests.

Now, you're all set to build and test your Flutter app. 🎉

License

This work is licensed under the GPL-3.0 License. To view a copy of this license, visit https://www.gnu.org/licenses/

powered by the cat

Onyx : Everything for Lyon 1 GitHub avatar
GitHub 作者

Onyx : Everything for Lyon 1 ↗

語言DartCMakeC++KotlinNixSwiftRubyHTMLPythonCJustShellObjective-C

依賴 Flutter 元件

使用的依賴

依賴清單 1 項

App 分類

如何選擇適合專案的儲存庫?

先依使用情境篩選,再比較專案活躍情況,最後到原始儲存庫確認使用要求。

  1. 透過儲存庫名稱、作者或描述搜尋,再依技術分類縮小範圍。
  2. 綜合星標、分支與最近推送比較專案;星標反映社群關注,不保證品質。
  3. 使用前在 GitHub 確認 README、授權條款與 Issues。

來源與維護

“A repository is the most basic element of GitHub.”

GitHub Docs — About repositories ↗