meshtastic/website/docs/software/android/installation.md

23 lines
2.7 KiB
Markdown
Raw Normal View History

2021-04-24 14:32:38 -07:00
---
2021-04-24 14:51:11 -07:00
id: android-installation
title: Android application installation
2021-04-24 14:58:20 -07:00
sidebar_label: Installation
2021-04-24 14:32:38 -07:00
---
Our Android application is available to download on Google Play.
2021-04-28 15:49:05 -07:00
[<img alt="Download at https://play.google.com/store/apps/details?id=com.geeksville.mesh" src="https://play.google.com/intl/en_us/badges/static/images/badges/en_badge_web_generic.png" style={{zoom:'35%'; align:'center'}} />](https://play.google.com/store/apps/details?id=com.geeksville.mesh&referrer=utm_source%3Dgithub-homepage)
2021-04-24 14:32:38 -07:00
The application may not be found if your phone/Android version are too old. The minimum Android version is 5.0 (Lollipop 2014, first BLE support). However Android 6, Marshmallow 2015, is recommended as the Bluetooth is more stable.
2021-04-24 17:14:39 -07:00
On installing the Meshtastic app, load it and navigate to the settings page. The app will ask you to give it permissions to access your location. This is needed for any app to use bluetooth, as the app is then able to scan the local area for bluetooth devices and, in theory, could triangulate your location based the devices it sees. If you give location permissions "only while using the app", the app will only be able to use bluetooth while it is open and visible to the user. This means if the screen is locked, or you are using another app, Meshtastic will not be able to use bluetooth, and will not be able to receive any messages from the node.
2021-04-24 14:32:38 -07:00
2021-04-25 12:03:41 -07:00
[![Messages page](/img/android/android-messages-sm.png)](/img/android/android-messages-sm.png) [![Nodes page](/img/android/android-nodes-sm.png)](/img/android/android-nodes.png) [![Channel page](/img/android/android-channel-sm.png)](/img/android/android-channel.png) [![Settings page](/img/android/android-settings-sm.png)](/img/android/android-settings.png) [![Debug page](/img/android/android-debug-sm.png)](/img/android/android-debug.png)
2021-04-24 14:32:38 -07:00
2021-04-24 17:14:39 -07:00
There is a [beta program](https://play.google.com/apps/testing/com.geeksville.mesh) for the app, which will let you test the cutting edge changes, though this may come with extra bugs. You can join this via Google Play. It is recommended that you follow the [Meshtastic Discourse Alpha Testers](https://meshtastic.discourse.group/c/development/alpha-testers) channel if you decide to join this.
2021-04-24 14:32:38 -07:00
2021-04-24 17:14:39 -07:00
The app uses anonymous usage statistics and crash reports to allow us to catch problems with Meshtastic and fix them. Analytics are also required to be able to use the "free" plan of our map provider [Mapbox](https://docs.mapbox.com/help/how-mapbox-works/). You can disable this by unticking the checkbox on the settings page.
2021-04-24 14:32:38 -07:00
2021-04-25 12:03:41 -07:00
[![Settings page with statistics consent box highlighted](/img/android/android-stats-consent-sm.png)](/img/android/android-stats-consent.png)
2021-04-24 14:32:38 -07:00
2021-04-24 17:14:39 -07:00
Google Play and the Google Play logo are trademarks of Google LLC.