Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/wildaid/o-fish-android
Android app for the Officer's Fishery Information Sharing Hub (O-FISH). The mobile app allows fisheries officers to document and share critical information gathered during a routine vessel inspection.
https://github.com/wildaid/o-fish-android
android android-app android-development android-sdk hacktoberfest hacktoberfest2020 hacktoberfest2021 mongodb mongodb-atlas mongodb-database non-profit nonprofit realm-mobile-database
Last synced: about 1 month ago
JSON representation
Android app for the Officer's Fishery Information Sharing Hub (O-FISH). The mobile app allows fisheries officers to document and share critical information gathered during a routine vessel inspection.
- Host: GitHub
- URL: https://github.com/wildaid/o-fish-android
- Owner: WildAid
- License: apache-2.0
- Created: 2020-06-01T20:09:18.000Z (over 4 years ago)
- Default Branch: main
- Last Pushed: 2022-10-12T00:50:20.000Z (about 2 years ago)
- Last Synced: 2024-09-14T00:05:34.594Z (2 months ago)
- Topics: android, android-app, android-development, android-sdk, hacktoberfest, hacktoberfest2020, hacktoberfest2021, mongodb, mongodb-atlas, mongodb-database, non-profit, nonprofit, realm-mobile-database
- Language: Kotlin
- Homepage:
- Size: 16.8 MB
- Stars: 22
- Watchers: 3
- Forks: 24
- Open Issues: 9
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
Awesome Lists containing this project
README
# WildAid O-FISH Android App
The [WildAid Marine Program](https://marine.wildaid.org/) works to protect vulnerable marine environments.
O-FISH (Officer Fishery Information Sharing Hub) is a multi-platform application that enables officers to browse and record boarding report data from their mobile devices.
Developers are expected to follow the MongoDB Community Code of Conduct guidelines.
This repo implements the Android O-FISH app.
The details behind the data architecture, schema, and partitioning strategy are described in [Realm Data and Partitioning Strategy Behind the WildAid O-FISH Mobile Apps](https://developer.mongodb.com/how-to/realm-data-architecture-ofish-app).
## Prerequisites
This is the Android Mobile app for O-FISH. To build and use the app, you must [use the sandbox realm-app-id](https://bit.ly/ofishsandbox) or [build your own foundation](http://wildaid.github.io/build).
## Building and running the app
1. Open the code in Android studio.
1. Wait for the Gradle sync to finish.
1. Add the Realm App ID from your template to `local.properties` AND `realm.properties` in the top-level directory (where this README is):
`realm_app_id=your_app_id`
e.g. for the sandbox:
`realm_app_id=wildaidsandbox-mxgfy`
To be able to login to the app once it is built, you need to create a user in your instance of the [O-FISH Realm App](https://github.com/WildAid/o-fish-realm) or [in the sandbox environment](https://bit.ly/ofishsandbox).
For example, if you are using the sandbox, your files should look like this:
`$ cat local.properties`
`realm_app_id=wildaidsandbox-mxgfy`
`$ cat realm.properties`
`realm_app_id=wildaidsandbox-mxgfy`