Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/ApturiCOVID/apturicovid-android
Apturi Covid Android lietotne
https://github.com/ApturiCOVID/apturicovid-android
apturicovid covid-19 exposure-notification
Last synced: 3 months ago
JSON representation
Apturi Covid Android lietotne
- Host: GitHub
- URL: https://github.com/ApturiCOVID/apturicovid-android
- Owner: ApturiCOVID
- Created: 2020-06-26T08:35:06.000Z (over 4 years ago)
- Default Branch: development
- Last Pushed: 2022-12-07T19:02:12.000Z (almost 2 years ago)
- Last Synced: 2024-06-25T20:54:25.900Z (5 months ago)
- Topics: apturicovid, covid-19, exposure-notification
- Language: Kotlin
- Homepage: https://apturicovid.lv
- Size: 2.91 MB
- Stars: 38
- Watchers: 8
- Forks: 7
- Open Issues: 8
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
- awesome-android-kotlin-apps - apturicovid-android
README
This source code is a property of [Centre for Disease Prevention and Control (CDPC) of Latvia](https://spkc.gov.lv/). You are free to use it accordingly to the Licence terms, and we would like to hear from you if you find it useful. Please drop us an email to: [email protected]
# SPKC Apturi Covid Android Application
This project's goal is to delay and mitigate the impact of SARS-CoV-2 by developing the official Apturi Covid (Stop Covid) Android application for the Republic of Latvia, utilising Google's [Exposure Notification](https://www.google.com/covid19/exposurenotifications/) Framework.
![Application Preview](assets/android-overview.png)
### Usage of the Exposure Notification Framework
Only approved health authorities can access these APIs. Therefore, framework calls will result in API error unless the application Bundle ID and signature keystore hash is whitelisted by Google.
## How it works
Application functionality is based on Google's Exposure Notification Framework. Application directly is not interacting with Bluetooth LE in any way. Bluetooth key transmission and receiving is handled entirely by EN Framework. Please [read more here](https://www.google.com/covid19/exposurenotifications/) regarding the implementation specifics of the Framework.
Application communicates with the server and exchanges information only to perform the following actions:
1. Phone number verification (with user consent)
1. Fetching exposure detection configuration. Detailed information [here](https://www.google.com/covid19/exposurenotifications/)
1. Downloading publicly available batches of TEKs (Temporary Exposure Keys)
1. Uploading anonymous exposure events (with user consent)### Exposure Detection
Exposure Detection is performed at every application launch and every 60 minutes by `WorkManager` scheduled worker `ExposureKeyFetchWorker`. Application stores analysed baches for 14 days to ensure the display of a potential exposure.
## Development
1. Android Studio 4.0
1. Add Firebase configuration: place your `google-services.json` under the `/app` directory
1. Copy the `dev-keystore.properties.example` file to `dev-keystore.properties` and set the development keystore information.
1. Copy the `secrets.properties.example` file to `secrets.properties` and set the [SafetyNet](https://developer.android.com/training/safetynet/attestation) key.
1. Copy the `staging-environment.properties.example` file to `staging-environment.properties` and set the API and file storage URLs.## Support & Feedback
Contributions and feedback is always welcome. If you have encountered and issue, have an improvement in mind or an implementation question, please use the issues section.
### Vulnerability reporting
If you believe you have found a security vulnerability, please submit your report to us as described in the issues section.
## License
This work is licensed under [Creative Commons Attribution-ShareAlike 4.0 International](https://creativecommons.org/licenses/by-sa/4.0/)
## Contributors ❤️✨
[](https://github.com/edgarsMalahovskis)
[](https://github.com/mkims)
[](https://github.com/ulazdins)
[](https://github.com/ArtSp)
[](https://github.com/artursbraucs)
[](https://github.com/and3ris)