## Changelog The list of changes for past and future releases is available [here](https://github.com/deckerst/aves/blob/develop/CHANGELOG.md). ## Permissions Aves requires a few permissions to do its job: - **read contents of shared storage**: the app only accesses media files, and modifying them requires explicit access grants from the user, - **read locations from media collection**: necessary to display the media coordinates, and to group them by country (via reverse geocoding), - **have network access**: necessary for the map view, and most likely for precise reverse geocoding too, - **view network connections**: checking for connection states allows Aves to gracefully degrade features that depend on internet. ## Contributing ### Issues [Bug reports](https://github.com/deckerst/aves/issues/new?assignees=&labels=type%3Abug&template=bug_report.md&title=) and [feature requests](https://github.com/deckerst/aves/issues/new?assignees=&labels=type%3Afeature&template=feature_request.md&title=) are welcome, but read the [guidelines](https://github.com/deckerst/aves/issues/234) first. If you have questions, check out the [discussions](https://github.com/deckerst/aves/discussions). ### Code At this stage this project does *not* accept PRs. ### Translations Translations are powered by [Weblate](https://hosted.weblate.org/engage/aves/) and the effort of wonderfully generous volunteers. If you want to translate this app in your language and share the result, [there is a guide](https://github.com/deckerst/aves/wiki/Contributing-to-Translations). ### Donations Some users have expressed the wish to financially support the project. Thanks! ❤️ [](https://www.paypal.com/donate/?hosted_button_id=RWKQ4J7D8USX6) [](https://liberapay.com/deckerst/donate) ## Project Setup ### Install dependencies Before running or building the app, update the dependencies for the desired flavor: ``` scripts/apply_flavor_play.sh ``` To build the project, create a file named `/android/key.properties`. It should contain a reference to a keystore for app signing, and other necessary credentials. See [key_template.properties](https://github.com/deckerst/aves/blob/develop/android/key_template.properties) for the expected keys. ### To run the app: ``` ./flutterw run -t lib/main_play.dart --flavor play ``` ### To build the app: creare file con le tue credenziali file.keystore dove YOUR_ALIAS_NAME è il tuo unico alias name e YOUR_ALIAS_PWD è la password del tuo alias ```sh keytool -genkey -v -keystore file.keystore -alias YOUR_ALIAS_NAME -storepass YOUR_ALIAS_PWD -keypass YOUR_ALIAS_PWD -keyalg RSA -validity 36500 ``` in questo caso ho inserito ```sh cd android keytool -genkey -v -keystore file.keystore -alias FabioMich66 -storepass Master66 -keypass Master66 -keyalg RSA -validity 36500 ``` se non puoi eseguire keytool perchè non è nel path di sistema cercalo usando ```sh cd / sudo find -name keytool ``` compilare il file `/android/key.properties` ``` nano android/key.properties ``` questi i miei dati utilizzando il format key_template.properties ``` storeFile=/Users/fabio/flutter_apps/aves/android/file.keystore storePassword=Master66 keyAlias=FabioMich66 keyPassword=Master66 googleApiKey= ``` infine compilare l'apk ``` ./flutterw build apk -t lib/main_play.dart --flavor play ``` [Version badge]: https://img.shields.io/github/v/release/deckerst/aves?include_prereleases&sort=semver [Build badge]: https://img.shields.io/github/actions/workflow/status/deckerst/aves/quality-check.yml?branch=develop ## Android studio aprire la console su Aves e caricare le dipendenze ``` scripts/apply_flavor_izzy.sh ``` in settings - Languages and Framework - Dart inserire il path ``` /home/fabio/flutter/bin/cache/ ``` e spuntare project aves Edit configurations e in Dart entrypoint inserire lib/main_play.dart in questo caso diventa /home/fabio/StudioProjects/aves/lib/main_izzy.dart e in flavor build izzy