Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revisionPrevious revision
Next revision
Previous revision
Next revisionBoth sides next revision
en:help:settings:storage [2015/09/03 12:19] – [How to change the location of stored data ?] psyberiaen:help:settings:storage [2020/03/30 10:48] – [Where does the application store its data?] alpinequest
Line 1: Line 1:
 <sub>[[en:help|Online Help]] > [[en:help:settings|Settings]]</sub> <sub>[[en:help|Online Help]] > [[en:help:settings|Settings]]</sub>
-====== How to change the location of stored data ? ====== 
  
-The application needs to store various data on the user device, including: +====== Where does the application store its data? ====== 
-  * Saved landmarks (waypointstracks, etc.)+\\ 
-  * Stored map areas of on-demand mapsso they can be used offline+The application folder is the unique folder used by the application to store all its data on the user device, including: 
-  * Various configuration and cache data, including added maps, favorite map sets, etc.+  * Stored maps for off-line use; 
 +  * User landmarks, when using the default landmarks folder
 +  * Imported and exported landmarksdetails or map images; 
 +  * Pictures used in waypoints
 +  * Various technical data.
  
-{{:icon_help.png?nolink}} For devices running Android versions less that 4.4, the application will try to detect and use by default the external SD memory card if any, otherwise the internal device memory will be used. For devices running Android version 4.4 and more, the application will use by default the internal device memory.+This folder is automatically chosen during the first application start, and is usually located on the external SD card (if available) for devices running Android lower than 4.4, or on the device memory for Android 4.4 and after (SD card storage behavior has considerably changed since then).
  
-To modify the local storage location+Inside the application folder, you'll find the following sub-folders
-  * Click on the main menu icon {{:icon_01.png?nolink}} and then on "''**Settings**''" {{:icon_02.png?nolink}}+  * ''**/datastore/**'', where the application stores downloaded data like [[en:help:maps#on-demand_maps|on-demand maps]]
-  * Select the "''**Storage device**''" {{:icon_03.png?nolink}} setting+  * ''**/icons/**'', where you can store your custom icons
-  * Choose one of the available choice {{:icon_04.png?nolink}}, either on the internal "''**Device storage**''"or on the external "''**SD Card**''". Multiple choices can be available for a particular storageyou can check the "''**Application path**''" {{:icon_05.png?nolink}} for each choices as well as the current space already used+  * ''**/landmarks/**'', where the application stores (by default) the landmarks you create (waypoints, routes, tracks, areas); 
-  * Click on the "''**Ok**''" {{:icon_06.png?nolink}} button to validate the change; +  * ''**/logs/**'', where the application store its technical logs
-  * Restart the application.+  * ''**/pictures/**'', where the application stores pictures associated with picture waypoints (on some devices these pictures are saved in the device common media folder);
  
-{{:icon_help.png?nolink}} If you want to use a particular location which is not listed, you can click on "''**More**''" {{:icon_07.png?nolink}} button and manually type any location path. Note that the application name will be appended to the entered path;+\\
  
-{{ :en:help:settings:storage.jpg?nolink }}+===== How to locate the application folder? ===== 
 +\\ 
 +To display the application folder: 
 +  * Click on the main menu icon {{:icon_01.png?nolink}}; 
 +  * Click on "''**Settings**''" {{:icon_02.png?nolink}}; 
 +  * Scroll the list and select "''**Storage device**''" {{:icon_03.png?nolink}}; 
 +  * Locate the ''"**Application path**"'' {{:icon_04.png?nolink}} of the selected storage device.
  
 +{{ :en:help:settings:application-folder.jpg?nolink }}
  
-===== Storage on the external SD card for Android 4.4 and more =====+\\
  
-As of Android 4.4, the memory management has been modified+===== How to change the application folder? ===== 
-  * The device memory is called "//Primary external memory//"This is the main storage memory, used by default by the applicationThis memory is usually quite large (up to hundred of GB)+\\ 
-  * The SD card memory (available on some devices only) is called "//Secondary external memory//"This space is not freely editable by applications anymore, only a specific folder per application can be used, as explained below.+To modify the storage location
 +  * Click on the main menu icon {{:icon_01.png?nolink}}; 
 +  * Click on "''**Settings**''{{:icon_02.png?nolink}}; 
 +  * Scroll the list and select "''**Storage device**''" {{:icon_03.png?nolink}}
 +  * Choose one of the available locations {{:icon_04.png?nolink}}; 
 +  * Click on "''**Ok**''{{:icon_05.png?nolink}} to validate the change; 
 +  * Restart the application.
  
 +{{:icon_help.png?nolink}} Be careful if you choose a storage location within the ''"**/Android/data/**"'' folder as Android will delete it when you un-install the application.
  
-==== Setting up the storage on the SD card ====+{{:icon_help.png?nolink}} If you see a small locker {{:icon_06.png?nolink}} icon, it means that the application isn't able to write in this location, and so it cannot be used. Check the troubleshooting section below for more details.
  
-As explained above, only a particular folder on the SD card is editable by the application on devices with Android 4.4 or more. This folder is: +{{ :en:help:settings:change-storage.jpg?nolink }}
-  * **''/Android/data/net.psyberia.offlinemaps/files/''** for the ad supported version; +
-  * **''/Android/data/net.psyberia.offlinemapsplus/files''** for the + (paid) version.+
  
-{{:icon_help.png?nolink}} This folder is created by the application, you mustn't create it manually.+\\
  
-To set up the storage on this folder, just process as explained above and choose the entry with this particular application path.+==== Storage on the external SD card troubleshooting ==== 
 +\\ 
 +In Android 4.4 and above, the memory management has been modified: 
 +  * The device internal memory is called "//Primary external memory//". This is the main storage memory, used by default by the application. This memory is usually quite large (up to hundred of GB); 
 +  * The SD card external memory (available on some devices only) is called "//Secondary external memory//". This space is not freely editable by applications anymore, only a specific folder per application can be usedthat's why you may only have one location available on the external SD card.
  
-{{:icon_help.png?nolink}} Note that when uninstalling the application, this folder will be automatically deleted by Android and all the stored data (landmarks, stored map areas, ...will be lost.+In Android 6.0 and above, you can now grant the application the right to write on the external SD card from the Android settings ("Applications" section).
  
-==== Re-using data stored before an Android 4.4 upgrade ====+If no storage location choices at all are available on the external SD card: 
 +  * Be sure that your device is not currently plugged to a computer using an USB cable; 
 +  * Be sure that the SD card is not currently being checked for errors (usually happens after starting the device or removing the USB cable); 
 +  * If you have Android 6.0 or above, you must grant the application to write on the external memory from the Android settings ("Applications" section), [[http://www.howtogeek.com/230683/how-to-manage-app-permissions-on-android-6.0/|see more details here]]; 
 +  * Try to restart the device; 
 +  * Try to un-install and re-install the application (be careful if you have stored data you want to keep); 
 +  * In the Android settings ("Storage" section), try to un-mount your SD card and check it for errors.
  
-If you stored data with the application on the external SD card before upgrading to Android 4.4 or more, this data is now read-only and cannot be used any-more.+\\ 
 +==== Re-using data stored before Android upgrade ==== 
 +\\ 
 +If you stored data with the application on the external SD card before upgrading to Android 4.4, this data is now read-only and cannot be used any-more.
  
 Here is the solution to retrieve it: Here is the solution to retrieve it:
   * Configure the storage to use the new location on the external SD card as explained above;   * Configure the storage to use the new location on the external SD card as explained above;
   * Quit the application, and connect your device to your computer using your USB cable;   * Quit the application, and connect your device to your computer using your USB cable;
-  * Using your computer's file explorer, move all content of the legacy folder (e.g. "''**/OfflineMaps/**''") into the new storage folder (e.g. "''**/Android/data/net.psyberia.offlinemaps/files/**''for the free version). Overwrite all items already there if necessary; +  * Using your computer's file manager, move all content of the legacy folder (usually ''"**/sdcard/OfflineMaps/**"'') into the new storage folder (usually ''"**/Android/data/net.psyberia.offlinemaps/files/**"'' for the free version, and ''"**/Android/data/net.psyberia.offlinemapsplus/files/**"'' for the full version). Overwrite all items already present if necessary; 
-  * Disconnect your device, wait for the SD card to be checked, and start the application. You should then be able to use your previously stored map areas, and store new ones+  * Disconnect your device, wait for the SD card to be checked (if needed), and restart the application. You should then be able to use your previously stored maps, and store new ones.
- +
-{{:icon_help.png?nolink}} Do not use your Android file manager to move the data, it will leave it read-only in the new location.+
  
-{{:icon_help.png?nolink}} A similar method can be used to use data stored using the free version with the paid one, the data must be moved from "''**/Android/data/net.psyberia.offlinemaps/files/**''" to "''**/Android/data/net.psyberia.offlinemapsplus/files/**''" using your computer's file explorer.