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:v2:settings:storage [2016/05/09 12:29] alpinequesten:help:v2:settings:storage [2022/04/13 19:48] alpinequest
Line 1: Line 1:
 <sub>[[en:help|Online Help]] > [[en:help:v2|AlpineQuest 2.x]] > [[en:help:v2:settings|Settings]]</sub> <sub>[[en:help|Online Help]] > [[en:help:v2|AlpineQuest 2.x]] > [[en:help:v2:settings|Settings]]</sub>
  
-====== Where does the application store its data? ======+====== Data storage and access ====== 
 + 
 +===== Where does the application store its data? =====
 \\ \\
 The application folder is the unique folder used by the application to store all its data on the user device, including: The application folder is the unique folder used by the application to store all its data on the user device, including:
Line 11: Line 13:
  
 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). 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).
 +
 +Inside the application folder, you'll find the following sub-folders:
 +  * ''**/datastore/**'', where the application stores downloaded data like [[en:help:v2:maps#on-demand_maps|on-demand maps]], [[en:help:v2:elevations#digital_elevation_model_dem|elevations]], etc;
 +  * ''**/icons/**'', where you can store your [[en:help:v2:landmarks:custom-icons|custom icons]];
 +  * ''**/landmarks/**'', where the application stores (by default) the landmarks you create (waypoints, routes, tracks, areas);
 +  * ''**/logs/**'', where the application store its technical logs;
 +  * ''**/maps/**'', where you can store your [[en:help:v2:maps#file-based_maps|file-based maps]];
 +  * ''**/pictures/**'', where the application stores pictures associated with picture waypoints (on some devices these pictures are saved in the device common media folder);
  
 \\ \\
  
-===== How to locate the application folder? =====+==== How to locate the application folder? ====
 \\ \\
 To display the application folder: To display the application folder:
Line 26: Line 36:
 \\ \\
  
-===== How to change the application folder? =====+==== How to change the application folder? ====
 \\ \\
 To modify the storage location: To modify the storage location:
Line 32: Line 42:
   * Click on "''**Settings**''" {{:icon_02.png?nolink}};   * Click on "''**Settings**''" {{:icon_02.png?nolink}};
   * Scroll the list and select "''**Storage device**''" {{:icon_03.png?nolink}};   * Scroll the list and select "''**Storage device**''" {{:icon_03.png?nolink}};
-  * Choose on of the available choice {{:icon_04.png?nolink}};+  * Choose one of the available locations {{:icon_04.png?nolink}};
   * Click on "''**Ok**''" {{:icon_05.png?nolink}} to validate the change;   * Click on "''**Ok**''" {{:icon_05.png?nolink}} to validate the change;
   * Restart the application.   * 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.
 +
 +{{: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.
  
 {{ :en:help:v2:settings:change-storage.jpg?nolink }} {{ :en:help:v2:settings:change-storage.jpg?nolink }}
Line 40: Line 54:
 \\ \\
  
-===== Storage on the external SD card for Android 4.4 and more ===== +==== Application folder on the external SD card troubleshooting ==== 
- +\\ 
-As of Android 4.4, the memory management has been modified:+**Android 4.4** 
 +\\ 
 +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 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 used, as explained below.+  * 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 used, that's why you may only have one location available on the external SD card.
  
 +**Android 6.0**
 +\\
 +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).
 +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.
  
-==== Set up storage on the SD card for Android 4.4 and 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: 
 +  * 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; 
 +  * Using your computer's file manager, move all content of the legacy folder (usually ''"**/sdcard/alpinequest/**"'') into the new storage folder (usually ''"**/Android/data/psyberia.alpinequest.full/files/**"'' for the full version). Overwrite all items already present if necessary; 
 +  * 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.
  
-As explained above, only a particular folder is editable by the application. This folder is: +\\
-  * **''/Android/data/psyberia.alpinequest.full/files/''** for the Full (paid) version; +
-  * **''/Android/data/psyberia.alpinequest.free/files/''** for the Lite (free) version.+
  
-{{:icon_help.png?nolink}} Note that when un-installing the application, this folder will be automatically deleted by Android, so all stored data will be lost.+===== How to access data stored outside of the application folder in Android 11 and above? ===== 
 +\\ 
 +Starting with Android 11drastic changes have been made by Google regarding how applications can access data stored outside of the application specific folders: except for file managers (and a few other specific cases), applications are only able to access media files from the shared storage spaces (internal device and removable SD card). It means that all your file-based maps and placemarks saved outside of the application specific folders are no more accessible.
  
-To set up the storage on this folder: +{{:icon_help.png?nolink}} Those limitations don't apply if you update the application from version 2.2.9 (or below) to version 2.3.0 (or above).
-  * Click on the main menu icon {{:icon_01.png?nolink}}+
-  * Click on the "''**Settings**''" {{:icon_02.png?nolink}} menu item; +
-  * Select the "''**Storage device**''" {{:icon_03.png?nolink}} setting; +
-  * Choose the device that matches both your SD card {{:icon_04.png?nolink}} and the folder listed above {{:icon_05.png?nolink}}; +
-  * Click on the "''**Ok**''" {{:icon_06.png?nolink}} button to validate the change; +
-  * Restart the application.+
  
-{{:icon_help.png?nolink}} This folder is created by the application, you mustn't create it manually.+However, applications still keep a total access on their application specific folders (read and write everything)There is one application specific folder on the internal device memory, and one application specific folder on the removable SD card (if any).\\ 
 +For AlpineQuest Prothe path of this folder is "''**/Android/data/psyberia.alpinequest.full/files/**''".\\ 
 +For AlpineQuest Lite, the path of this folder is "''**/Android/data/psyberia.alpinequest.free/files/**''".
  
-{{ :en:help:1.4:settings:storage-external.jpg?nolink }}+Until better solutions are found, here are some workarounds:
  
 +**Placemarks**
 +  * Move your placemarks inside an application specific folder, inside the "''**landmarks/**''" sub-folder. For AlpineQuest Pro, that would be "''**/Android/data/psyberia.alpinequest.full/files/landmarks/**''";
 +  * Open your placemarks from your file manager, the application will be listed in the possible choices for handling this file.
  
-==== Re-using data stored before Android 4.4 upgrade ====+**Maps** 
 +  * Move your maps inside an application specific folder, inside the "''**maps/**''" sub-folder. For AlpineQuest Pro, that would be "''**/Android/data/psyberia.alpinequest.full/files/maps/**''"; 
 +  * Add the file extension ''".mp3"'' to your maps, this way the Android system will consider the map file as a media file and will allow the application to access it. For example, rename your QCT map "''my_map.qct''" to "''my_map.qct.mp3''" (do not remove the original "''.qct''" file extension).
  
-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: +==== How to move your files? ==== 
-  * 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; +In order to move your files from or into into an application specific folder, you can either: 
-  * Using your computer'file explorer, move all content of the legacy folder (e.g. "''**/sdcard/alpinequest/**''") into the new storage folder (e.g. "''**/Android/data/psyberia.alpinequest.full/files/**''" for the full version). Overwrite all items already there if necessary; +  * Plug your device on your desktop computer (using your USB cable) and use it to move the files
-  * 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. +  * Use an Android 11 compatible file manager ("''Cx File Explorer''" or "''X-plore File Manager''" for example).
- +
-{{: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 Lite version with the Full one, the data must be moved from "''**/Android/data/psyberia.alpinequest.free/files/**''" to "''**/Android/data/psyberia.alpinequest.full/files/**''" using your computer's file explorer.