The new Android 11 operating system includes several changes that will impact the way CoPilot:
- Stores application files and map data on a device
- Requests permission to access your device's location
These changes were partially introduced in Android 10 and will now be required for Android 11. As a result:
- If you are planning to update your devices to Android 11 or higher, you also must upgrade to CoPilot v10.19.0.1405 to ensure full compatibility.
- If you are currently running Android 10 or below, older versions of CoPilot will still be compatible. However, we recommend you upgrade to the latest version of CoPilot to ensure full compatibility if you decide to upgrade your operating system in the future.
- If you are currently running Android 10, and you upgrade to the latest version of CoPilot, many of the same changes will occur as if you were installing it on Android 11. (Please see below.)
- Partners integrating CoPilot Android CPIK Xamarin version 10.14.0.487 and higher need to upgrade their development library to AndroidX. The AndroidX with Xamarin online developer site has info on how to upgrade.
In this article:
Who is Impacted?
Anyone using the Android version of the CoPilot GPS app downloaded from Google Play, as well as companies that have integrated CoPilot using our Android Common Bundle (SDK), Android CPIK, Android Xamarin CPIK or Android CPIK React Native.
What is Happening?
Android 11 includes several user privacy updates related to how apps are allowed to store data on a device and request permission for location services, which are necessary for CoPilot to provide GPS navigation. With version v10.19.0.1405, CoPilot will include the following changes to comply with the new Android requirements:
Change 1: CoPilot will store files, including map data, in a new location
The new version of Android will enforce "scoped storage," which limits each application on a device to accessing a specific directory. Because of this new restriction, no file or folder can be created in the root directory.
Impact on CoPilot
New Installations of CoPilot
Any new installation of CoPilot will install assets and map under the directory: /storage/Android/data/bundlename/files
Existing Installations of CoPilot
- Applications installed on Internal Device Storage: The asset and map installed directory will change from root directory to: /storage(0/1)/Android/data/bundlename/files/
- Applications installed on External Storage (SD): The asset and map installed directory name will change to: /storage(0/1)/Android/data/bundlename/files/
What You Need to Know
Upgrading to a Newer Version of CoPilot (Android 10 and Higher)
- When upgrading the CoPilot application, ALL of the existing map data and application files will be moved over to the new location: /storage/Android/data/bundlename/files
- (Android Common Bundle SDK Only) When upgrading from an older version of CoPilot (10.4 or 10.9), customers should uninstall their 10.4 or 10.9 build and do a complete re-install of CoPilot 10.19.0.487 or higher.
Sharing Maps with Dual Applications (Android 11 and Higher)
New Android permissions limit access to only a single application. Therefore, this functionality will no longer be supported.
Map Data Residing Outside of the Application Folder (Android 10 and Higher)
If your map data is located outside the application folder, then you will need to update your product.cfg to reflect the new location of the data.
Uninstalling CoPilot (Android 11 and Higher)
When you remove the application from your device, this will also remove all map data and other files that reside under:
CoPilot GPS App on Google Play (Android 10 and Higher)
Manual backup of Favorites, Recents and Trips will require using the files located in: /storage/Android/data/bundlename/files.
Reinstalling the app will not require the additional step of manually deleting the com.alk.mapviewer folder as it will be removed as part of the uninstall process.
Change 2: CoPilot will request extra permission to allow location access
This change does not apply if using devices with Android OS 9 or older
Impact on CoPilot
With Android 10, CoPilot will display screens similar to these, asking for permission.
With Android 11, CoPilot will display screens similar to these, asking for permission.
What You Need to Know
The new location permission will prompt the user to allow location access directly in the device's settings menu. No other changes to your CoPilot implementation are needed.
If you have questions about upgrading CoPilot to prepare for Android 11, please contact our Support team using the Submit Ticket button at the top of this screen.