Add installation and configuration guide for Lastmiler mobile application

Moved from Managers Lastmiler  Wiki repo

install-configure-and-run-mobile-app/install-configure-and-run-mobile-app.md

@@ -0,0 +1,158 @@
+# How to securely install and run the Lastmiler mobile app
+
+*(English Android version - May 2025)*
+
+## Prerequisites
+
+Your Android device should be running at least Android version 13, though we recommend using the latest version available (currently Android 15). To check your Android version, go to `Settings > About device > Version`. On some devices, this path may differ slightly. If a system update is available, please install it by going to `Settings > System & updates > Software update` or similar.
+
+Make sure your device is signed in and has access to the **Google Play Store**. Devices that rely on *Huawei AppGallery* are not supported.
+
+## The installation
+
+![Installing Lastmiler app from Google Play Store](https://gitea.redburst.com/lastmiler-knowledge-base/Mobile-User/raw/branch/main/install-configure-and-run-mobile-app/android/installing-1.v2.png)
+
+1. Start the **"Play Store App"**
+2. Select **"Search"** in the bottom menu
+3. Search for **"lastmiler"** in the top search bar
+
+![Installing Lastmiler app from Google Play Store](https://gitea.redburst.com/lastmiler-knowledge-base/Mobile-User/raw/branch/main/install-configure-and-run-mobile-app/android/installing-2.v1.png)
+
+4. Select the Lastmiler App in the results list
+5. Tap **"Install"**
+6. Wait until the installation is completed and launch the app by tapping **"Open"**  
+*(you can also find the app in your app drawer or home screen)*
+
+## When starting the app
+
+**It is very important to follow all the steps in this setup document for optimal use of the Lastmiler App!**
+
+![Allow notifications on first app run](https://gitea.redburst.com/lastmiler-knowledge-base/Mobile-User/raw/branch/main/install-configure-and-run-mobile-app/android/first-run-1.v2.png)
+
+Tap **"Allow"** if the app is asking about Notifications at first start up.
+
+> 💡 On older Android versions, this prompt might not appear at first launch. If that is the case, or if you accidentally tap **"Don't allow"**, you would need to enable notifications through the system settings. The steps for that are covered later in the document.
+
+Continue with the next steps in this document and complete them all.
+
+## Using the App for the first time
+
+![Starting Lastmiler App For The First Time](https://gitea.redburst.com/lastmiler-knowledge-base/Mobile-User/raw/branch/main/install-configure-and-run-mobile-app/android/first-run-2.v2.png)
+
+Make sure that the Lastmiler App is started on your device and that you can see the Login Page.
+
+1. Fill out **"Email"**, **"Password"** and tap **"Login"**
+2. Tap **"Tracking"** in the main menu
+3. Tap **"Start Tracking"** button located in the bottom of the screen
+
+## Configuration of the App 1/5
+
+![Configuring Lastmiler when starting tracking for the first time](https://gitea.redburst.com/lastmiler-knowledge-base/Mobile-User/raw/branch/main/install-configure-and-run-mobile-app/android/configuration-1.v2.png)
+
+When starting tracking for the first time, a few
+questions are automatically asked:
+
+1. At **"Background Locations Access"** answer: **"I understand"**
+2. At: **"Allow Lastmiler to access this device's location?"** answer: **"While using the app"**
+3. At: **"Allow Lastmiler to access your physical activity?"** answer: **"Allow"**
+
+## Configuration of the App 2/5
+
+![Configuring Lastmiler location permission](https://gitea.redburst.com/lastmiler-knowledge-base/Mobile-User/raw/branch/main/install-configure-and-run-mobile-app/android/configuration-2.v2.png)
+
+1. At: **"Allow Lastmiler to access to this device's location in the background?"** answer: **"Change to Allow all the time"**
+2. At settings of **"Location permission"** set: **"Allow all the time"**
+
+## Configuration of the App 3/5
+
+Before continuing, you need to open the Lastmiler app settings screen in your device's system settings. There are two ways to do this:
+
+### Option 1: From the home screen or app drawer
+
+![Accessing Lastmiler system settings through home screen or app drawer](https://gitea.redburst.com/lastmiler-knowledge-base/Mobile-User/raw/branch/main/install-configure-and-run-mobile-app/android/configuration-3.v3.png)
+
+- Tap and hold the **"Lastmiler"** app icon on the home screen or in the app drawer
+- From the menu that appears, select **"App info"**
+
+### Option 2: From the device settings
+
+Alternatively, you can access the app settings through your system settings.
+
+![Accessing Lastmiler system settings through device settings search](https://gitea.redburst.com/lastmiler-knowledge-base/Mobile-User/raw/branch/main/install-configure-and-run-mobile-app/android/configuration-4.v2.png)
+
+ 1. Open your device's Settings.
+ 2. Use the search bar at the top to type **"lastmiler"** and select it from the results.
+
+## Configuration of the App 4/5
+
+After reaching the **"App info"** screen through one of the methods outlined above, proceed with the following steps.
+
+![Force stopping Lastmiler, and turning off battery optimization](https://gitea.redburst.com/lastmiler-knowledge-base/Mobile-User/raw/branch/main/install-configure-and-run-mobile-app/android/configuration-5.v3.png)
+
+ 1. Tap: **"Force stop"**
+ 2. Confirm by tapping: **"OK"**  
+ *(On some devices this might be named "Force stop" or something similar)*
+ 3. Untick: **"Manage app if unused"**
+ 4. Tap: **"App battery usage"**  
+ *(On some devices this might be named just "Battery usage" or something similar)*
+
+## Configuration of the App 5/5
+
+![Force stopping Lastmiler, and turning off battery optimization](https://gitea.redburst.com/lastmiler-knowledge-base/Mobile-User/raw/branch/main/install-configure-and-run-mobile-app/android/configuration-6.v2.png)
+
+1. In the App battery usage screen, enable **"Allow background usage"**.  
+*(If prompted, confirm by tapping **"Allow"**)*.
+
+2. Open your device's quick settings and make sure that **"Battery Saver"** is turned off.  
+*(On some devices this may be named "Power saving mode" or something similar. You might need to swipe down twice to reveal more options and possibly scroll left or right to find it)*
+
+3. Tap and hold the **"Battery Saver"** tile from step 2 to open its settings. Make sure that **"Use Battery Saver"** is turned off, **"Standard Battery Saver"** is selected (instead of **"Extreme Battery Saver"**), and **"Use Adaptive Battery"** is also turned off.  
+*(These options may vary slightly depending on your device model or Android version)*
+
+## Enabling Notifications
+
+If the app didn't prompt you to enable notifications the first time you opened it, or if you accidentally tapped **"Don't Allow"**, you can still turn on notifications later by going to your device's system settings.
+
+![Enabling notifications for Lastmiler](https://gitea.redburst.com/lastmiler-knowledge-base/Mobile-User/raw/branch/main/install-configure-and-run-mobile-app/android/configuration-7.v3.png)
+
+ 1. Open your device's **"Settings"**.  
+ *(You can find it in the app drawer or by tapping the gear icon in the **Quick Settings** panel you pull down from the top of the screen)*
+ 2. Tap on **"Notifications"**. This will bring you to a screen where you can manage notification settings for each app.  
+*(The name of this option might vary slightly depending on your device model or Android version)*
+ 3. In the list of apps, find **"Lastmiler"** and toggle notifications **"On"**.  
+*(Make sure you are seeing the full list of apps by selecting an option like **"All apps"** or tapping something like **"More"**, depending on your device and Android version)*
+
+## Running the App
+
+Once you have completed the configuration steps, you can now run the Lastmiler App and start tracking by logging in again, and tapping on "Tracking" in the main menu.
+
+![Start tracking after the configuration](https://gitea.redburst.com/lastmiler-knowledge-base/Mobile-User/raw/branch/main/install-configure-and-run-mobile-app/android/running-1.v1.png)
+
+1. To start tracking simply tap **"Start Tracking"**
+2. To stop tracking tap **"Stop Tracking"**  
+*(The locations collected will instantly upload to the cloud)*
+3. To view a list of active report maps in Lastmiler tap **"My Active Maps"**
+
+![Viewing active maps](https://gitea.redburst.com/lastmiler-knowledge-base/Mobile-User/raw/branch/main/install-configure-and-run-mobile-app/android/running-2.v2.png)
+
+Tap on the map from the list to view it.
+
+- You can now view and zoom the shape of the selected map
+- Tracked progress is indicated as red snail trails
+- If you are in the area a blue location dot will appear
+
+You can now go out of the App having it running and tracking in the background.
+
+![Tracking active OS indicator](https://gitea.redburst.com/lastmiler-knowledge-base/Mobile-User/raw/branch/main/install-configure-and-run-mobile-app/android/tracking-active-indicator.v1.png)
+
+> 💡 **The "Location indicator" icon must be active and visible in the top of your device's screen at all time**!
+
+## Important notes
+
+- It is very important to follow all the previous steps so that **"Notifications"**, **"Location access"**, **"Physical activity"**, **"Battery usage"** and **"Background activity"** is set correctly (On). Otherwise the tracking will not work!
+
+- While using the App: The Location indicator must be visible at all time in the top of your screen. If this icon is not shown or is marked disabled, it is a direct sign that the tracking is not working on your device.
+
+- Make sure that you are not using **"Power Saving Mode"** on your device while using the Lastmiler App. This might over time stop the app running in the background and the tracking will stop work.
+
+- During the running of the app you might be hinted by your device's system to **"Optimise battery"** or similar. Do not activate any such features while running the Lastmiler App or otherwise the device's system might over time stop the app running in the background and tracking will stop work.