Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/Greenstand/treetracker-android
Treetracker is Greenstands open source Android app to track and verify reforestation efforts globally. NEW DEVELOPERS: Please refer to the README for is issue milestones and topics! https://github.com/Greenstand/treetracker-android/blob/master/README.md
https://github.com/Greenstand/treetracker-android
android
Last synced: 3 months ago
JSON representation
Treetracker is Greenstands open source Android app to track and verify reforestation efforts globally. NEW DEVELOPERS: Please refer to the README for is issue milestones and topics! https://github.com/Greenstand/treetracker-android/blob/master/README.md
- Host: GitHub
- URL: https://github.com/Greenstand/treetracker-android
- Owner: Greenstand
- License: agpl-3.0
- Created: 2017-09-13T20:05:32.000Z (about 7 years ago)
- Default Branch: master
- Last Pushed: 2024-02-24T17:28:33.000Z (9 months ago)
- Last Synced: 2024-06-11T16:34:00.701Z (5 months ago)
- Topics: android
- Language: Kotlin
- Homepage:
- Size: 10.7 MB
- Stars: 90
- Watchers: 17
- Forks: 87
- Open Issues: 73
-
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
- Codeowners: CODEOWNERS
Awesome Lists containing this project
- open-sustainable-technology - Treetracker - Coordinates the digital capture of tree growth data in the field, allowing to establish employment for people living in extreme poverty based on tree planting. (Biosphere / Deforestation and Reforestation)
README
# Treetracker Android
## Current Milestones and Issue Topics
### Next feature release
Feature we are currently prioritizing
https://github.com/Greenstand/treetracker-android/milestone/17
## Project Details
This is the Android app for Greenstands Treetracker open source project (www.treetracker.org).
This project coordinates the digital capture of tree growth data in the field, allowing to establish employment for people living in extreme poverty based on tree planting.
The Android segment is the data collection tool that transports the information into the next service through a data pipeline towards the veryification service.
For more on design intent and the app's user story see the [wiki in this repository](https://github.com/Greenstand/treetracker-android/wiki/User-Story)
## Project Setup
Developers will need to ask the #android_chat channel in Slack for the treetracker.keys.properties file to build gradle for the application.
For development, select the build variant _dev_. This build variant is configured to allow trees to be added without a specific accuracy.
## QC Deployment
Note: QC deployment pipeline are about to be changed and moved to Github actions from Travis. The
following details will be updated once the change is made.
This repo has been configured to be easily deployed to QC through Travis. The process, however, is still a manual.
In order to get a new build to QC, take the following steps:
1. Go to the [Project page in Travis](https://travis-ci.com/Greenstand/treetracker-android)
2. Select _More Options > Trigger build_
3. On the dialog, select the appropriate branch, and use either of these configurations:
* For an Android Beta build:
```
script:
- "fastlane android beta"
```
* For an Android JustDigIt build:
```
script:
- "fastlane android justdiggit_beta"
```
4. Run the build and then wait for it to complete. _Voilá._
Running without a `script` custom parameter will result in a standard build to be run without any artifacts deployed.
### Fastlane
Fastlane must be installed using
bundle install --path vendor/bundle
fastlane install_plugins
firebase login
otherwise the firebase plugin will not work
## Deployment
There is one prerequisite to using the appropriate gradle tasks:
1) Placing the relevant keys.json from the PlayStore in the ./app folder [example here](https://docs.fastlane.tools/getting-started/android/setup/#collect-your-google-credentials)
Once this is done, you can proceed by running one of the following tasks to run the release:
* `bootstrapReleasePlayResources` | Downloads the play store listing for the Release build. No download of image resources. See #18.
* `generateReleasePlayResources` | Collects play store resources for the Release build
* `publishListingRelease` | Updates the play store listing for the Release build
## Contributing
See [Contributing in the Development-Overview README](https://github.com/Greenstand/Development-Overview/blob/master/README.md)
Review the project board for current priorities [Android Project](https://github.com/orgs/Greenstand/projects/5)
Please review the [issue tracker](https://github.com/Greenstand/treetracker-android/issues) here on this github repository
Check out the cool [roadmap](https://github.com/Greenstand/Development-Overview/blob/master/Roadmap.md)
All contributions should be submitted as pull requests against the master branch in this github repository. https://github.com/Greenstand/treetracker-android/