e-ntfy-android/README.md

41 lines
2.1 KiB
Markdown
Raw Normal View History

2021-10-26 03:14:09 +02:00
# ntfy Android App
2021-11-14 01:26:37 +01:00
This is the Android app for [ntfy](https://github.com/binwiederhier/ntfy) ([ntfy.sh](https://ntfy.sh)). It is available
in the [Play Store](https://play.google.com/store/apps/details?id=io.heckel.ntfy).
2021-11-24 05:18:17 +01:00
# Releases
2021-11-25 05:16:48 +01:00
You can find the app in the [Play Store](https://play.google.com/store/apps/details?id=io.heckel.ntfy),
or as .apk files on the [releases page](https://github.com/binwiederhier/ntfy-android/releases).
2021-11-24 05:18:17 +01:00
2021-11-25 05:16:48 +01:00
There is a ticket to create an [F-Droid version](https://github.com/binwiederhier/ntfy/issues/7),
but I haven't had the time yet.
2021-11-24 05:18:17 +01:00
2021-11-25 05:16:48 +01:00
# Build
2021-11-24 05:18:17 +01:00
2021-11-25 05:16:48 +01:00
## Building without Firebase (F-Droid flavor)
Without Firebase, you may want to still change the default `app_base_url` in [strings.xml](https://github.com/binwiederhier/ntfy-android/blob/main/app/src/main/res/values/strings.xml)
if you're self-hosting the server. Then run:
```
./gradlew assembleFdroidRelease
```
## Building with Firebase (FCM, Google Play flavor)
2021-11-24 05:18:17 +01:00
To build your own version with Firebase, you must:
2021-11-25 05:16:48 +01:00
* Create a Firebase/FCM account
* Place your account file at `app/google-services.json`
2021-11-24 05:18:17 +01:00
* And change `app_base_url` in [strings.xml](https://github.com/binwiederhier/ntfy-android/blob/main/app/src/main/res/values/strings.xml)
2021-11-25 05:16:48 +01:00
* Then run:
```
./gradlew assemblePlayRelease
```
2021-11-24 05:18:17 +01:00
2021-10-26 03:14:09 +02:00
## License
Made with ❤️ by [Philipp C. Heckel](https://heckel.io), distributed under the [Apache License 2.0](LICENSE).
2021-10-30 03:13:58 +02:00
Thank you to these fantastic resources:
2021-10-26 03:14:09 +02:00
* [RecyclerViewKotlin](https://github.com/android/views-widgets-samples/tree/main/RecyclerViewKotlin) (Apache 2.0)
* [Just another Hacker News Android client](https://github.com/manoamaro/another-hacker-news-client) (MIT)
2021-10-30 03:13:58 +02:00
* [Android Room with a View](https://github.com/googlecodelabs/android-room-with-a-view/tree/kotlin) (Apache 2.0)
* [Firebase Messaging Example](https://github.com/firebase/quickstart-android/blob/7147f60451b3eeaaa05fc31208ffb67e2df73c3c/messaging/app/src/main/java/com/google/firebase/quickstart/fcm/kotlin/MyFirebaseMessagingService.kt) (Apache 2.0)
2021-11-03 02:43:31 +01:00
* [Designing a logo with Inkscape](https://www.youtube.com/watch?v=r2Kv61cd2P4)
2021-11-14 01:26:37 +01:00
* [Foreground service](https://robertohuertas.com/2019/06/29/android_foreground_services/)