commit 985b409532485b4e3088724a4aa1c3b6515495ba Author: Milos Djakovic Date: Mon Jul 21 16:09:08 2025 +0200 Add installation and configuration guide for Lastmiler mobile application Moved from Managers Lastmiler Wiki repo diff --git a/install-configure-and-run-mobile-app/android/configuration-1.v2.png b/install-configure-and-run-mobile-app/android/configuration-1.v2.png new file mode 100644 index 0000000..6342748 Binary files /dev/null and b/install-configure-and-run-mobile-app/android/configuration-1.v2.png differ diff --git a/install-configure-and-run-mobile-app/android/configuration-2.v2.png b/install-configure-and-run-mobile-app/android/configuration-2.v2.png new file mode 100644 index 0000000..10d3d63 Binary files /dev/null and b/install-configure-and-run-mobile-app/android/configuration-2.v2.png differ diff --git a/install-configure-and-run-mobile-app/android/configuration-3.v3.png b/install-configure-and-run-mobile-app/android/configuration-3.v3.png new file mode 100644 index 0000000..e16dc39 Binary files /dev/null and b/install-configure-and-run-mobile-app/android/configuration-3.v3.png differ diff --git a/install-configure-and-run-mobile-app/android/configuration-4.v2.png b/install-configure-and-run-mobile-app/android/configuration-4.v2.png new file mode 100644 index 0000000..fe28e82 Binary files /dev/null and b/install-configure-and-run-mobile-app/android/configuration-4.v2.png differ diff --git a/install-configure-and-run-mobile-app/android/configuration-5.v3.png b/install-configure-and-run-mobile-app/android/configuration-5.v3.png new file mode 100644 index 0000000..4ea21ad Binary files /dev/null and b/install-configure-and-run-mobile-app/android/configuration-5.v3.png differ diff --git a/install-configure-and-run-mobile-app/android/configuration-6.v2.png b/install-configure-and-run-mobile-app/android/configuration-6.v2.png new file mode 100644 index 0000000..7fc621e Binary files /dev/null and b/install-configure-and-run-mobile-app/android/configuration-6.v2.png differ diff --git a/install-configure-and-run-mobile-app/android/configuration-7.v3.png b/install-configure-and-run-mobile-app/android/configuration-7.v3.png new file mode 100644 index 0000000..04799bb Binary files /dev/null and b/install-configure-and-run-mobile-app/android/configuration-7.v3.png differ diff --git a/install-configure-and-run-mobile-app/android/first-run-1.v2.png b/install-configure-and-run-mobile-app/android/first-run-1.v2.png new file mode 100644 index 0000000..1f9de4b Binary files /dev/null and b/install-configure-and-run-mobile-app/android/first-run-1.v2.png differ diff --git a/install-configure-and-run-mobile-app/android/first-run-2.v2.png b/install-configure-and-run-mobile-app/android/first-run-2.v2.png new file mode 100644 index 0000000..0b34ab0 Binary files /dev/null and b/install-configure-and-run-mobile-app/android/first-run-2.v2.png differ diff --git a/install-configure-and-run-mobile-app/android/installing-1.v2.png b/install-configure-and-run-mobile-app/android/installing-1.v2.png new file mode 100644 index 0000000..5ed3369 Binary files /dev/null and b/install-configure-and-run-mobile-app/android/installing-1.v2.png differ diff --git a/install-configure-and-run-mobile-app/android/installing-2.v1.png b/install-configure-and-run-mobile-app/android/installing-2.v1.png new file mode 100644 index 0000000..2464f41 Binary files /dev/null and b/install-configure-and-run-mobile-app/android/installing-2.v1.png differ diff --git a/install-configure-and-run-mobile-app/android/running-1.v1.png b/install-configure-and-run-mobile-app/android/running-1.v1.png new file mode 100644 index 0000000..41dccf6 Binary files /dev/null and b/install-configure-and-run-mobile-app/android/running-1.v1.png differ diff --git a/install-configure-and-run-mobile-app/android/running-2.v2.png b/install-configure-and-run-mobile-app/android/running-2.v2.png new file mode 100644 index 0000000..9afd1c0 Binary files /dev/null and b/install-configure-and-run-mobile-app/android/running-2.v2.png differ diff --git a/install-configure-and-run-mobile-app/android/screenshots/configuration-1.v1.png b/install-configure-and-run-mobile-app/android/screenshots/configuration-1.v1.png new file mode 100644 index 0000000..f7d16dd Binary files /dev/null and b/install-configure-and-run-mobile-app/android/screenshots/configuration-1.v1.png differ diff --git a/install-configure-and-run-mobile-app/android/screenshots/configuration-10.v1.png b/install-configure-and-run-mobile-app/android/screenshots/configuration-10.v1.png new file mode 100644 index 0000000..e1097b9 Binary files /dev/null and b/install-configure-and-run-mobile-app/android/screenshots/configuration-10.v1.png differ diff --git a/install-configure-and-run-mobile-app/android/screenshots/configuration-11.v1.png b/install-configure-and-run-mobile-app/android/screenshots/configuration-11.v1.png new file mode 100644 index 0000000..7073862 Binary files /dev/null and b/install-configure-and-run-mobile-app/android/screenshots/configuration-11.v1.png differ diff --git a/install-configure-and-run-mobile-app/android/screenshots/configuration-12.v1.png b/install-configure-and-run-mobile-app/android/screenshots/configuration-12.v1.png new file mode 100644 index 0000000..f858aec Binary files /dev/null and b/install-configure-and-run-mobile-app/android/screenshots/configuration-12.v1.png differ diff --git a/install-configure-and-run-mobile-app/android/screenshots/configuration-13.v1.png b/install-configure-and-run-mobile-app/android/screenshots/configuration-13.v1.png new file mode 100644 index 0000000..bbf4b56 Binary files /dev/null and b/install-configure-and-run-mobile-app/android/screenshots/configuration-13.v1.png differ diff --git a/install-configure-and-run-mobile-app/android/screenshots/configuration-14.v1.png b/install-configure-and-run-mobile-app/android/screenshots/configuration-14.v1.png new file mode 100644 index 0000000..32dee0a Binary files /dev/null and b/install-configure-and-run-mobile-app/android/screenshots/configuration-14.v1.png differ diff --git a/install-configure-and-run-mobile-app/android/screenshots/configuration-15.v1.png b/install-configure-and-run-mobile-app/android/screenshots/configuration-15.v1.png new file mode 100644 index 0000000..10ed80e Binary files /dev/null and b/install-configure-and-run-mobile-app/android/screenshots/configuration-15.v1.png differ diff --git a/install-configure-and-run-mobile-app/android/screenshots/configuration-2.v1.png b/install-configure-and-run-mobile-app/android/screenshots/configuration-2.v1.png new file mode 100644 index 0000000..e650c38 Binary files /dev/null and b/install-configure-and-run-mobile-app/android/screenshots/configuration-2.v1.png differ diff --git a/install-configure-and-run-mobile-app/android/screenshots/configuration-3.v1.png b/install-configure-and-run-mobile-app/android/screenshots/configuration-3.v1.png new file mode 100644 index 0000000..127236b Binary files /dev/null and b/install-configure-and-run-mobile-app/android/screenshots/configuration-3.v1.png differ diff --git a/install-configure-and-run-mobile-app/android/screenshots/configuration-4.v1.png b/install-configure-and-run-mobile-app/android/screenshots/configuration-4.v1.png new file mode 100644 index 0000000..2a0f87b Binary files /dev/null and b/install-configure-and-run-mobile-app/android/screenshots/configuration-4.v1.png differ diff --git a/install-configure-and-run-mobile-app/android/screenshots/configuration-5.v1.png b/install-configure-and-run-mobile-app/android/screenshots/configuration-5.v1.png new file mode 100644 index 0000000..ade8a55 Binary files /dev/null and b/install-configure-and-run-mobile-app/android/screenshots/configuration-5.v1.png differ diff --git a/install-configure-and-run-mobile-app/android/screenshots/configuration-6.v1.png b/install-configure-and-run-mobile-app/android/screenshots/configuration-6.v1.png new file mode 100644 index 0000000..ab342c0 Binary files /dev/null and b/install-configure-and-run-mobile-app/android/screenshots/configuration-6.v1.png differ diff --git a/install-configure-and-run-mobile-app/android/screenshots/configuration-7.v1.png b/install-configure-and-run-mobile-app/android/screenshots/configuration-7.v1.png new file mode 100644 index 0000000..221ab0c Binary files /dev/null and b/install-configure-and-run-mobile-app/android/screenshots/configuration-7.v1.png differ diff --git a/install-configure-and-run-mobile-app/android/screenshots/configuration-8.v1.png b/install-configure-and-run-mobile-app/android/screenshots/configuration-8.v1.png new file mode 100644 index 0000000..8e1fcf1 Binary files /dev/null and b/install-configure-and-run-mobile-app/android/screenshots/configuration-8.v1.png differ diff --git a/install-configure-and-run-mobile-app/android/screenshots/configuration-9.v1.png b/install-configure-and-run-mobile-app/android/screenshots/configuration-9.v1.png new file mode 100644 index 0000000..b8233d9 Binary files /dev/null and b/install-configure-and-run-mobile-app/android/screenshots/configuration-9.v1.png differ diff --git a/install-configure-and-run-mobile-app/android/screenshots/first-run-1.v1.png b/install-configure-and-run-mobile-app/android/screenshots/first-run-1.v1.png new file mode 100644 index 0000000..65a374b Binary files /dev/null and b/install-configure-and-run-mobile-app/android/screenshots/first-run-1.v1.png differ diff --git a/install-configure-and-run-mobile-app/android/screenshots/first-run-2.v1.png b/install-configure-and-run-mobile-app/android/screenshots/first-run-2.v1.png new file mode 100644 index 0000000..21da369 Binary files /dev/null and b/install-configure-and-run-mobile-app/android/screenshots/first-run-2.v1.png differ diff --git a/install-configure-and-run-mobile-app/android/screenshots/first-run-3.v1.png b/install-configure-and-run-mobile-app/android/screenshots/first-run-3.v1.png new file mode 100644 index 0000000..598bb78 Binary files /dev/null and b/install-configure-and-run-mobile-app/android/screenshots/first-run-3.v1.png differ diff --git a/install-configure-and-run-mobile-app/android/screenshots/first-run-4.v1.png b/install-configure-and-run-mobile-app/android/screenshots/first-run-4.v1.png new file mode 100644 index 0000000..0deb7fa Binary files /dev/null and b/install-configure-and-run-mobile-app/android/screenshots/first-run-4.v1.png differ diff --git a/install-configure-and-run-mobile-app/android/screenshots/installing-1.v1.png b/install-configure-and-run-mobile-app/android/screenshots/installing-1.v1.png new file mode 100644 index 0000000..e877649 Binary files /dev/null and b/install-configure-and-run-mobile-app/android/screenshots/installing-1.v1.png differ diff --git a/install-configure-and-run-mobile-app/android/screenshots/installing-2.v1.png b/install-configure-and-run-mobile-app/android/screenshots/installing-2.v1.png new file mode 100644 index 0000000..11fdd00 Binary files /dev/null and b/install-configure-and-run-mobile-app/android/screenshots/installing-2.v1.png differ diff --git a/install-configure-and-run-mobile-app/android/screenshots/installing-3.v1.png b/install-configure-and-run-mobile-app/android/screenshots/installing-3.v1.png new file mode 100644 index 0000000..c2ad3b9 Binary files /dev/null and b/install-configure-and-run-mobile-app/android/screenshots/installing-3.v1.png differ diff --git a/install-configure-and-run-mobile-app/android/screenshots/installing-4.v1.png b/install-configure-and-run-mobile-app/android/screenshots/installing-4.v1.png new file mode 100644 index 0000000..7a0dd94 Binary files /dev/null and b/install-configure-and-run-mobile-app/android/screenshots/installing-4.v1.png differ diff --git a/install-configure-and-run-mobile-app/android/screenshots/installing-5.v1.png b/install-configure-and-run-mobile-app/android/screenshots/installing-5.v1.png new file mode 100644 index 0000000..566e7c8 Binary files /dev/null and b/install-configure-and-run-mobile-app/android/screenshots/installing-5.v1.png differ diff --git a/install-configure-and-run-mobile-app/android/screenshots/installing-6.v1.png b/install-configure-and-run-mobile-app/android/screenshots/installing-6.v1.png new file mode 100644 index 0000000..29cda8d Binary files /dev/null and b/install-configure-and-run-mobile-app/android/screenshots/installing-6.v1.png differ diff --git a/install-configure-and-run-mobile-app/android/screenshots/notifications-1.v1.png b/install-configure-and-run-mobile-app/android/screenshots/notifications-1.v1.png new file mode 100644 index 0000000..8e7fc5c Binary files /dev/null and b/install-configure-and-run-mobile-app/android/screenshots/notifications-1.v1.png differ diff --git a/install-configure-and-run-mobile-app/android/screenshots/notifications-2.v1.png b/install-configure-and-run-mobile-app/android/screenshots/notifications-2.v1.png new file mode 100644 index 0000000..10c8df2 Binary files /dev/null and b/install-configure-and-run-mobile-app/android/screenshots/notifications-2.v1.png differ diff --git a/install-configure-and-run-mobile-app/android/screenshots/notifications-3.v1.png b/install-configure-and-run-mobile-app/android/screenshots/notifications-3.v1.png new file mode 100644 index 0000000..c02bf54 Binary files /dev/null and b/install-configure-and-run-mobile-app/android/screenshots/notifications-3.v1.png differ diff --git a/install-configure-and-run-mobile-app/android/screenshots/running-1.v1.png b/install-configure-and-run-mobile-app/android/screenshots/running-1.v1.png new file mode 100644 index 0000000..c92b64f Binary files /dev/null and b/install-configure-and-run-mobile-app/android/screenshots/running-1.v1.png differ diff --git a/install-configure-and-run-mobile-app/android/screenshots/running-2.v1.png b/install-configure-and-run-mobile-app/android/screenshots/running-2.v1.png new file mode 100644 index 0000000..d27f9ae Binary files /dev/null and b/install-configure-and-run-mobile-app/android/screenshots/running-2.v1.png differ diff --git a/install-configure-and-run-mobile-app/android/screenshots/running-3.v1.png b/install-configure-and-run-mobile-app/android/screenshots/running-3.v1.png new file mode 100644 index 0000000..3f1175b Binary files /dev/null and b/install-configure-and-run-mobile-app/android/screenshots/running-3.v1.png differ diff --git a/install-configure-and-run-mobile-app/android/screenshots/running-4.v1.png b/install-configure-and-run-mobile-app/android/screenshots/running-4.v1.png new file mode 100644 index 0000000..16b8a27 Binary files /dev/null and b/install-configure-and-run-mobile-app/android/screenshots/running-4.v1.png differ diff --git a/install-configure-and-run-mobile-app/android/tracking-active-indicator.v1.png b/install-configure-and-run-mobile-app/android/tracking-active-indicator.v1.png new file mode 100644 index 0000000..bf28f0e Binary files /dev/null and b/install-configure-and-run-mobile-app/android/tracking-active-indicator.v1.png differ diff --git a/install-configure-and-run-mobile-app/install-configure-and-run-mobile-app.md b/install-configure-and-run-mobile-app/install-configure-and-run-mobile-app.md new file mode 100644 index 0000000..086f775 --- /dev/null +++ b/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.