https://github.com/mygod/reactmap-android

Android WebView app for ReactMap with added goodies
https://github.com/mygod/reactmap-android

Last synced: 14 days ago
JSON representation

Android WebView app for ReactMap with added goodies

• Host: GitHub
• URL: https://github.com/mygod/reactmap-android
• Owner: Mygod
• License: apache-2.0
• Created: 2023-08-22T03:05:02.000Z (over 1 year ago)
• Default Branch: master
• Last Pushed: 2025-05-07T07:25:09.000Z (15 days ago)
• Last Synced: 2025-05-07T23:08:26.316Z (14 days ago)
• Language: Kotlin
• Size: 1.83 MB
• Stars: 8
• Watchers: 2
• Forks: 13
• Open Issues: 1
• Metadata Files:
  • Readme: README.md
  • Funding: .github/FUNDING.yml
  • License: LICENSE

Awesome Lists containing this project

README

        
# ReactMap for Android

[![CircleCI](https://circleci.com/gh/Mygod/reactmap-android.svg?style=shield)](https://circleci.com/gh/Mygod/reactmap-android)

[![API](https://img.shields.io/badge/API-26%2B-brightgreen.svg?style=flat)](https://android-arsenal.com/api?level=26)

[![Releases](https://img.shields.io/github/downloads/Mygod/reactmap-android/total.svg)](https://github.com/Mygod/reactmap-android/releases)

[![Language: Kotlin](https://img.shields.io/github/languages/top/Mygod/reactmap-android.svg)](https://github.com/Mygod/reactmap-android/search?l=kotlin)

[![Codacy Badge](https://app.codacy.com/project/badge/Grade/58a48b28278d46edad1b5c82bf648607)](https://app.codacy.com/gh/Mygod/reactmap-android/dashboard?utm_source=gh&utm_medium=referral&utm_content=&utm_campaign=Badge_grade)

[![License](https://img.shields.io/github/license/Mygod/reactmap-android.svg)](LICENSE)

[![Get it on Obtainium](https://github.com/ImranR98/Obtainium/blob/main/assets/graphics/badge_obtainium.png)](https://apps.obtainium.imranr.dev/redirect?r=obtainium://add/https://github.com/Mygod/reactmap-android)

Use ReactMap as an Android app with battery improvements, including:

* Use Google location services to follow location.

* Reduce animations.

* Pause location following when jumping to a new location.

* Disable popups from automatically panning the map.

Other features:

* See map even behind your status bar and navigation bar!

* More conveniently refresh the webpage when fullscreen. (During network congestion, Chrome HTTP/3 implementation seems buggy. Lots of hacks were added to get around this to get refresh working.)

* Login button is clicked automatically (Discord login only).

* You could make alerts follow location in background.

* Handle links to the map without opening a new tab (requires custom build for custom domains).

* Compressed graphql payload to save bandwidth.

For best experiences, ReactMap should be updated to this commit or later:

https://github.com/WatWowMap/ReactMap/commit/addb5f3b27c49fe9d7165c8b76f54a5b10912f67

## Guide for custom build

### Setup instructions

1. If you have not already, generate a signing key with [`keytool`](https://developer.android.com/build/building-cmdline#sign_cmdline).

   Using [RSA with a key length of 4096, 8192, or 16384 bits](https://github.com/google/bundletool/blob/0b9149c283e2df73850da670f2130a732639283d/src/main/java/com/android/tools/build/bundletool/commands/AddTransparencyCommand.java#L97) is recommended.

2. (Required for deep link support on Android 12+) Create the following file at `https://mymap.com/.well-known/assetlinks.json` by creating the file in `/path/to/reactmap/public/.well-known/assetlinks.json`:

   ```json

   [

     {

       "relation": [

         "delegate_permission/common.handle_all_urls"

       ],

       "target": {

         "namespace": "android_app",

         "package_name": "be.mygod.reactmap.com.mymap",

         "sha256_cert_fingerprints": [

           "insert your sha256 cert fingerprint"

         ]

       }

     }

   ]

   ```

   where the fingerprint can be obtained via `keytool -list -v -keystore /path/to/keystore`.

   (If you prefer to using Android Studio to create this file with a wizard, see [here](https://developer.android.com/studio/write/app-link-indexing#associatesite) for instructions.)

3. (Optional) Make modifications to the source code if you wish.

### Build instructions

Build with [injected properties](https://stackoverflow.com/a/47356720/2245107) (modifying these values as you wish):

```

./gradlew assembleRelease \

 -Pandroid.injected.signing.store.file=$KEYFILE \

 -Pandroid.injected.signing.store.password=$STORE_PASSWORD \

 -Pandroid.injected.signing.key.alias=$KEY_ALIAS \

 -Pandroid.injected.signing.key.password=$KEY_PASSWORD \

 -Preactmap.defaultHost=mymap.com \

 -Preactmap.packageName=be.mygod.reactmap.com.mymap

```

See `gradle.properties` for a complete list of supported properties.

An alternative to using `-P` switches is to adding your properties to the `gradle.properties` file in the root directory.

Success! Find your apk in `app/build/outputs/apk/release`.