lastmiler-knowledge-base
/
Manager
3
0
Fork 0
Code Wiki

Enhance clarity and formatting in installation guide for Lastmiler mobile app

This commit is contained in:
Milos Djakovic 2025-07-17 13:50:31 +02:00
parent 61285c525f
commit f10248cde2
1 changed files with 46 additions and 43 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

89
setup-and-run-mobile-app/setup-and-run-mobile-app.md
View File

@ -1,26 +1,27 @@
# How to securely install and run the Lastmiler mobile app # How to securely install and run the Lastmiler mobile app
(English Android version - May 2025) *(English Android version - May 2025)*
## Prerequisites ## 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. 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. 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 ## The installation
![Installing Lastmiler app from Google Play Store](https://gitea.redburst.com/lastmiler-knowledge-base/Manager/raw/branch/main/setup-and-run-mobile-app/android/installing-1.v1.png) ![Installing Lastmiler app from Google Play Store](https://gitea.redburst.com/lastmiler-knowledge-base/Manager/raw/branch/main/setup-and-run-mobile-app/android/installing-1.v1.png)
1. Start the "Play Store App" 1. Start the **"Play Store App"**
2. Select "Search" in the bottom menu 2. Select **"Search"** in the bottom menu
3. Search for "lastmiler" in the top search bar 3. Search for **"lastmiler"** in the top search bar
![Installing Lastmiler app from Google Play Store](https://gitea.redburst.com/lastmiler-knowledge-base/Manager/raw/branch/main/setup-and-run-mobile-app/android/installing-2.v1.png) ![Installing Lastmiler app from Google Play Store](https://gitea.redburst.com/lastmiler-knowledge-base/Manager/raw/branch/main/setup-and-run-mobile-app/android/installing-2.v1.png)
4. Select the Lastmiler App in the results list 4. Select the Lastmiler App in the results list
5. Tap "Install" 5. Tap **"Install"**
6. Wait until the installation is ready and go back to your device's main screen 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 ## When starting the app
@ -28,9 +29,9 @@ Make sure your device is signed in and has access to the Google Play Store. Devi
![Allow notifications on first app run](https://gitea.redburst.com/lastmiler-knowledge-base/Manager/raw/branch/main/setup-and-run-mobile-app/android/first-run-1.v2.png) ![Allow notifications on first app run](https://gitea.redburst.com/lastmiler-knowledge-base/Manager/raw/branch/main/setup-and-run-mobile-app/android/first-run-1.v2.png)
Tap Allow if the app is asking about Notifications at first start up. 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. > 💡 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. Continue with the next steps in this document and complete them all.
@ -40,42 +41,38 @@ Continue with the next steps in this document and complete them all.
Make sure that the Lastmiler App is started on your device and that you can see the Login Page. 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" 1. Fill out **"Email"**, **"Password"** and tap **"Login"**
2. Tap "Tracking" in the main menu 2. Tap **"Tracking"** in the main menu
3. Tap "Start Tracking" in the tracking menu 3. Tap **"Start Tracking"** button located in the bottom of the screen
## Configuration of the App 1/5 ## Configuration of the App 1/5
![Configuring Lastmiler when starting tracking for the first time](https://gitea.redburst.com/lastmiler-knowledge-base/Manager/raw/branch/main/setup-and-run-mobile-app/android/configuration-1.v1.png) ![Configuring Lastmiler when starting tracking for the first time](https://gitea.redburst.com/lastmiler-knowledge-base/Manager/raw/branch/main/setup-and-run-mobile-app/android/configuration-1.v2.png)
When starting tracking for the first time, a few When starting tracking for the first time, a few
questions are automatically asked: questions are automatically asked:
1. At "Background Locations Access" answer: "I understand" 1. At **"Background Locations Access"** answer: **"I understand"**
2. At: "Allow Lastmiler to access this device's location?" answer: "While using the app" 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" 3. At: **"Allow Lastmiler to access your physical activity?"** answer: **"Allow"**
## Configuration of the App 2/5 ## Configuration of the App 2/5
![Configuring Lastmiler location permission](https://gitea.redburst.com/lastmiler-knowledge-base/Manager/raw/branch/main/setup-and-run-mobile-app/android/configuration-2.v2.png) ![Configuring Lastmiler location permission](https://gitea.redburst.com/lastmiler-knowledge-base/Manager/raw/branch/main/setup-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" 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" 2. At settings of **"Location permission"** set: **"Allow all the time"**
## Configuration of the App 3/5 ## Configuration of the App 3/5
Before continuing, you need to open the Lastmiler app settings screen. There are two ways to do this: 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 ### Option 1: From the home screen or app drawer
You can tap and hold the Lastmiler app icon in either location to access the same shortcut menu.
> 💡 Use either method below to open the "App info" screen.
![Accessing Lastmiler system settings through home screen or app drawer](https://gitea.redburst.com/lastmiler-knowledge-base/Manager/raw/branch/main/setup-and-run-mobile-app/android/configuration-3.v3.png) ![Accessing Lastmiler system settings through home screen or app drawer](https://gitea.redburst.com/lastmiler-knowledge-base/Manager/raw/branch/main/setup-and-run-mobile-app/android/configuration-3.v3.png)
1. From the home screen (left image): tap and hold the Lastmiler app icon, then tap "App info". - Tap and hold the **"Lastmiler"** app icon on the home screen or in the app drawer
2. From the app drawer (right image): tap and hold the Lastmiler app icon, then select "App info". - From the menu that appears, select **"App info"**
### Option 2: From the device settings ### Option 2: From the device settings
@ -83,29 +80,34 @@ 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/Manager/raw/branch/main/setup-and-run-mobile-app/android/configuration-4.v2.png) ![Accessing Lastmiler system settings through device settings search](https://gitea.redburst.com/lastmiler-knowledge-base/Manager/raw/branch/main/setup-and-run-mobile-app/android/configuration-4.v2.png)
1. Open your device's Settings app (left image). 1. Open your device's Settings.
2. Use the search bar at the top to type Lastmiler and select it from the results (right image). 2. Use the search bar at the top to type **"lastmiler"** and select it from the results.
## Configuration of the App 4/5 ## Configuration of the App 4/5
Once you reach the "App info" screen using either method, continue with the steps below: 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/Manager/raw/branch/main/setup-and-run-mobile-app/android/configuration-5.v3.png) ![Force stopping Lastmiler, and turning off battery optimization](https://gitea.redburst.com/lastmiler-knowledge-base/Manager/raw/branch/main/setup-and-run-mobile-app/android/configuration-5.v3.png)
1. Tap: "Force stop" 1. Tap: **"Force stop"**
2. Confirm by tapping: "OK" *(On some devices this might be named "Force stop" or something similar)* 2. Confirm by tapping: **"OK"**
3. Untick: "Manage app if unused" *(On some devices this might be named "Force stop" or something similar)*
4. Tap: "App battery usage" *(On some devices this might be named just "Battery usage" 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 ## Configuration of the App 5/5
![Force stopping Lastmiler, and turning off battery optimization](https://gitea.redburst.com/lastmiler-knowledge-base/Manager/raw/branch/main/setup-and-run-mobile-app/android/configuration-6.v2.png) ![Force stopping Lastmiler, and turning off battery optimization](https://gitea.redburst.com/lastmiler-knowledge-base/Manager/raw/branch/main/setup-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". 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.)* 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.)* 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.)*
## Running the App ## Running the App
@ -113,9 +115,10 @@ Once you have completed the configuration steps, you can now run the Lastmiler A
![Start tracking after the configuration](https://gitea.redburst.com/lastmiler-knowledge-base/Manager/raw/branch/main/setup-and-run-mobile-app/android/running-1.v1.png) ![Start tracking after the configuration](https://gitea.redburst.com/lastmiler-knowledge-base/Manager/raw/branch/main/setup-and-run-mobile-app/android/running-1.v1.png)
1. To start tracking simply tap: "Start Tracking" 1. To start tracking simply tap **"Start Tracking"**
2. To stop tracking tap: "Stop Tracking" (The locations collected will instantly upload to the cloud) 2. To stop tracking tap **"Stop Tracking"**
3. To view a list of active report maps in Lastmiler tap: "My Active Maps" *(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/Manager/raw/branch/main/setup-and-run-mobile-app/android/running-2.v2.png) ![Viewing active maps](https://gitea.redburst.com/lastmiler-knowledge-base/Manager/raw/branch/main/setup-and-run-mobile-app/android/running-2.v2.png)
@ -129,14 +132,14 @@ 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/Manager/raw/branch/main/setup-and-run-mobile-app/android/tracking-active-indicator.v1.png) ![Tracking active OS indicator](https://gitea.redburst.com/lastmiler-knowledge-base/Manager/raw/branch/main/setup-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! > 💡 **The "Location indicator" icon must be active and visible in the top of your device's screen at all time**!
## Important notes ## 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! - 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. - 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. - 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. - 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.