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

GitHub 儲存庫AgoraDesk-LocalMonero/agoradesk-app-foss

本地Monero

AgoraDesk/LocalMonero 移動應用程式來源程式碼。https://agoradesk.com

本地Monero 專案封面
星標
149
分支
17
最近推送(UTC)
2024年5月29日
專案狀態
未封存

原始 README

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

AgoraDesk, LocalMonero Apps

There are two apps under one code base in this repository.

AgoraDesk

LocalMonero

App Features 🔥

  1. Within one code base there are 2 apps: AgoraDesk, LocalMonero. Each app can be built as Android and iOS native app. Design and logic separation made with flavors (more info further in this doc).

  2. Universal Links work for Android and iOS. In case the app is installed on the device, the regular links will run apps instead of browsers. In case of two apps installed on one device the AgoraDesk app is prioritized (it means in case of link localmonero/something AgoraDesk app will be opened).

  3. Push notifications to work on iOS & Android. In case the user's device (for example in China or with GrapheneOS) can't receive pushes, the app detects it and start polling in the background mode. More info

  4. For privacy, all notifications are sent without translations and are translated on the client-side using data messages in the app code, not through Firebase Cloud Messaging (FCM).

  5. The feature to use a custom proxy (HTTP, SOCKS4, or SOCKS5) has been added in the settings for more secure connections.

  6. Made with Dart & Flutter ❤️

Build

For build the app locally after getting code from repository use FOSS commands in Makefile.

For example, to build a FOSS apk LocalMonero app

flutter build apk --verbose --flavor localmonero --dart-define=app.flavor=localmonero --dart-define=app.includeFcm=false

The apps use MapBox for reverse geocoding. In order to build it yourself, you need to create/provide your own MapBox API key. The instructions can be found here.

After that, create the file lib/keys/keys.dart and add your key there: key const keysMapToken = 'YOUR_MAPBOX_KEY';

You will get the app that works without FCM services. Push notifications will be received with polling with foreground service (if the app is closed it still works).

Flavors

How to build iOS with run parameters
  • https://stackoverflow.com/a/65315937/7198006
  • Firebase settings with flavors https://medium.com/@matt.goodson.business/separating-build-environment-configurations-in-flutter-with-firebase-doing-it-the-right-way-c72c3ad3621f
Fastlane

iOS https://docs.fastlane.tools/actions/deliver/

fastlane deliver --skip-screenshots=true

Android https://docs.fastlane.tools/actions/supply/

fastlane supply --skip_upload_changelogs=true --track=internal --skip_upload_screenshots=true

Initial settings
  • https://medium.com/@animeshjain/build-flavors-in-flutter-android-and-ios-with-different-firebase-projects-per-flavor-27c5c5dac10b
Set up Firebase for different flavors
  • https://firebase.flutter.dev/docs/cli
  • https://firebase.google.com/docs/projects/multiprojects
  • https://stackoverflow.com/questions/37615405/use-different-googleservice-info-plist-for-different-build-schemes
  • https://stackoverflow.com/questions/56626467/use-different-googleservice-info-plist-for-single-project-in-xcode-using-swift4
Set up iOS links for the different apps

ios/Runner/Runner.entitlements ios/Runner/Runner-localmonero.entitlements

Presspacks

  • Agoradesk https://agoradesk.com/static/press/agoradesk-presspack.zip/
  • LocalMonero https://localmonero.co/static/press/localmonero-presspack.zip/

Known issues

Push notifications

For privacy reasons, the backend sends push and data messages without translations. We receive them in the app, translate, and then display them. Therefore, our backend doesn't have information about the user's locale.

Contribution

  1. Commits naming https://www.conventionalcommits.org/en/v1.0.0/

Types other than fix: and feat: are allowed, for example @commitlint/config-conventional (based on the the Angular convention) recommends build:, chore:, ci:, docs:, style:, refactor:, perf:, test:, and others.

Mark commit number with #, for example fix: #89.

Also we can use following:

  • feat: A new feature
  • style: Changes that do not affect the meaning of the code (white-space, formatting, missing semi-colons, etc)
  • fix: A bug fix
  • docs: Documentation only changes
  • refactor: A code change that neither fixes a bug nor adds a feature
  • perf: A code change that improves performance
  • test: Adding missing tests
  • chore: Changes to the build process or auxiliary tools and libraries such as documentation generation

The source: https://ec.europa.eu/component-library/v1.15.0/eu/docs/conventions/git/#:~:text=feat%3A%20A%20new%20feature,bug%20nor%20adds%20a%20feature

F-Droid

  1. How to publish Flutter app on F-Droid - https://localmonero.co/devblog/publish-flutter-app-fdroid
  2. As we use Flutter as submodule, we should update it with F-Droid releases git submodule update --rebase --remote

Credits

  • We thank shortwavesurfer2009 for extensive accessibility testing
AgoraDesk / LocalMonero GitHub avatar
GitHub 作者

AgoraDesk / LocalMonero ↗

P2P Bitcoin, Monero trading platform

語言DartMakefileHTMLSwiftKotlinRubyCSSShellObjective-C

依賴 Flutter 元件

使用的依賴

依賴清單 90 項

App 分類

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

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

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

來源與維護

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

GitHub Docs — About repositories ↗