Updating Mapeo Mobile
Like most existing apps, Mapeo Mobile is in continuous development. We frequently release new versions of the application to fix technical issues or add new functionality. When you update Mapeo Mobile, you do not lose data you have collected or synchronized using a previous version.
The process to update Mapeo Mobile is very similar to the installation process and there are 3 ways to do it:
  • Update from Play Store If you have an
    internet connection, update to the latest version of Mapeo Mobile from the
    Google Play Store. The steps are the same as for installing Mapeo: Install from Play Store
  • Update from an APK file To update Mapeo Mobile on smartphones that have
    no internet connection, follow the same steps as for installing the app using an installation file (.apk), this time using a more recent installation file: Install from APK file
  • ​Update via P2P App Updates (*Experimental) Mapeo Mobile currently includes an experimental feature that allows you to update the version of the application offline via a peer-to-peer connection over Wi-Fi. For more on how to update this way, seeUpdating Mapeo Mobile via P2P (peer-to-peer) App Updates​
To update files used within Mapeo Mobile, such as configurations or background maps, follow the same steps detailed in the sections below using the new files: Importing configurations into Mapeo Mobile​Adding custom background maps to Mapeo Mobile

Mapeo versions - information and naming conventions

Mapeo uses a numerical system to name versions ( for example v.5.4.0). The numbers are labeled as follows: v.MAJOR.MINOR.PATCH.
  • The MAJOR number indicates a breaking change - a change in this number could be related to how the software work or a change in how you use it. The MAJOR number increases if features that were previously part of the app are now removed.
  • The MINOR number increases when new features have been added to Mapeo.
  • The PACTH number increases if there are small updates or fixes that don’t introduce any new behavior or features.
If the MAJOR number increases, the MINOR and PATCH numbers are reset to 0. If the MINOR number increases, the PATH number is reset to 0.
To identify which version is more recent, compare the version numbers (excluding the dots between digits). The bigger the number is, the newer the version is. For example, Mapeo v.5.4.0 is newer than Mapeo v.5.3.2, because 540 is a bigger number than 532.

Installation files for older versions of Mapeo Mobile

To view all previous versions of Mapeo Mobile, including release notes for changes made in each version, see the Mapeo Mobile Releases page on GitHub.

Updating Mapeo Mobile via P2P (peer-to-peer) App Updates

Peer-to-peer (P2P) App Updates is an experimental feature that allows you to share and receive newer versions of the Mapeo app by connecting to other Mapeo devices via Wi-Fi (no internet connection required).
When updating the Mapeo app version in this way, NONE of your Mapeo data (observations, configurations, or maps) is shared between devices.
To search for and share Mapeo app updates between Mapeo Mobile devices, both smartphones must:
  • have the P2P App Updates feature enabled
  • have Mapeo open to the Synchronize screen
  • be connected to the same Wi-Fi network

Enable the P2P App Updates feature

To use this feature, you will need to enable it within the Experiments menu. To do so, tap the
Observations list button, then tap
Settings, and select Experiments. Select P2P App Updates, then check the box to Use P2P App Updater.
​
​
​

Check for available updates

Once you have enabled the P2P App Updates feature, you will be able to use it on the
Synchronize screen. To search for and share Mapeo app updates between Mapeo Mobile devices, both smartphones must have the P2P App Updates feature enabled, have Mapeo open to the Synchronize screen, and be connected to the same Wi-Fi network.
​
​
If a newer version of the app is available from another Mapeo device on the network, the update will be automatically downloaded.
(If your device has a newer version than other devices the network, you will see the message "Sharing app updates with other devices.")

Install app update

To install the newer version of Mapeo, wait until the download completes, then tap INSTALL on the Synchronize screen.
​
​
​

Allow installs from Mapeo

After tapping INSTALL, you may see a security pop-up window saying that your phone is not allowed to install apps from this source.
To enable Mapeo to install updates, tap Settings in the pop-up window and toggle the switch to Allow from this source in the following Android Settings screen.
​
​
Tap the
Back button to return to Mapeo and confirm that you would like to install the update.

Reopen Mapeo

When the installation is complete, Mapeo will close automatically. When you re-open Mapeo, you will see an update confirmation window. Tap OK to close the window and start using the new version of Mapeo.
​