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

Add comprehensive setup guide for Lastmiler App installation and configuration

This commit is contained in:
Milos Djakovic 2025-07-17 12:15:10 +02:00
parent d8021e6ae1
commit 8cd178846c
2 changed files with 144 additions and 98 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

144
setup-and-run-mobile-app/setup-and-run-mobile-app.md Normal file
View File

@ -0,0 +1,144 @@
# How to securely install and run the Lastmiler App
(English Android version - May 2025)
## Prerequisites
- Make sure that your Android device runs minimum Android version 13 or preferably the latest one version 15.
- You can view this information in: "Settings > About device > Version" or similar on various models.
- If your device requires a system update, please attempt do so now in: "Settings > System & updates > Software update" or similar on various models.
- Make sure that your device has logged in access to Google Play Store
- …and not Huawei AppGallery.
## 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)
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/Manager/raw/branch/main/setup-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 ready and go back to your device's main 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/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.
> 💡 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/Manager/raw/branch/main/setup-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" in the tracking menu
## 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)
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/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"
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. There are two ways to do this:
### 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)
1. From the home screen (left image): tap and hold the Lastmiler app icon, then tap "App info".
2. From the app drawer (right image): tap and hold the Lastmiler app icon, then 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/Manager/raw/branch/main/setup-and-run-mobile-app/android/configuration-4.v2.png)
1. Open your device's Settings app (left image).
2. Use the search bar at the top to type Lastmiler and select it from the results (right image).
## Configuration of the App 4/5
Once you reach the "App info" screen using either method, continue with the steps below:
![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"
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/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".
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.)*
## 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/Manager/raw/branch/main/setup-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/Manager/raw/branch/main/setup-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/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!
## 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.

98
wiki/setup-and-run-mobile-app.md
View File

@ -1,98 +0,0 @@
# How to securely install and run the Lastmiler App
(English Android version - May 2025)
## Prerequisites
- Make sure that your Android device runs minimum Android version 13 or preferably the latest one version 15.
- You can view this information in: "Settings > About device > Version" or similar on various models.
- If your device requires a system update, please attempt do so now in: "Settings > System & updates > Software update" or similar on various models.
- Make sure that your device has logged in access to Google Play Store
- …and not Huawei AppGallery.
## The installation
1. Start the "Play Store App"
2. Select "Search" in the bottom menu
3. Search for "lastmiler" in the top search bar
4. Select the Lastmiler App in the results list
5. Tap "Install"
6. Wait until the installation is ready and go back to your device's main screen
![Installing Lastmiler App From Play Store](https://gitea.redburst.com/lastmiler-knowledge-base/Manager/raw/branch/main/setup-and-run-mobile-app/group-app-instalation-1.png)
## When starting the app
**It is very important to follow all the steps in this setup document for optimal use of the Lastmiler App!**
- Tap Allow if the app is asking about Notifications at first start up.
- Continue with the next steps in this document and complete them all.
## Using the App for the first time
1. Make sure that the Lastmiler App is started on your device and that you can see the Login Page.
2. Fill out "Email", "Password" and tap "Login"
3. Tap "Tracking" in the main menu
4. Tap "Start Tracking" in the tracking menu
![Starting Lastmiler App For The First Time](https://gitea.redburst.com/lastmiler-knowledge-base/Manager/raw/branch/main/setup-and-run-mobile-app/group-app-first-startup-1.png)
## Configuration of the App 1/4
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"
![Configuring Lastmiler App Step 1](https://gitea.redburst.com/lastmiler-knowledge-base/Manager/raw/branch/main/setup-and-run-mobile-app/group-app-configuration-1-1.png)
## Configuration of the App 2/4
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"
3. Go back out of the settings
4. Go out of the App to your device's main screen
![Configuring Lastmiler App Step 2](https://gitea.redburst.com/lastmiler-knowledge-base/Manager/raw/branch/main/setup-and-run-mobile-app/group-app-configuration-2-1.png)
## Configuration of the App 3/4
1. Tap: "Force stop"
2. Confirm by tapping: "Force stop"
3. Untick: "Manage app if unused"
4. Tap: "Battery usage"
## Configuration of the App 4/4
1. Tick (On): "Allow background activity"
2. Confirm by tapping: "Allow"
3. Go back out of the settings
4. Go to your device's tile menu (usually drag
the screen top down an inch)
Make sure that "Power saving mode" is
Off.
## Running the App
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"
4. Select one map
- 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
- NOTE: 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.