From d71f2533fc23f736903141604ed286491852a719 Mon Sep 17 00:00:00 2001 From: Mario Baranzini Date: Sun, 24 Mar 2019 16:32:57 +0100 Subject: [PATCH 1/6] Add read-only sd card explanation --- en/project-management/project-selection.rst | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/en/project-management/project-selection.rst b/en/project-management/project-selection.rst index 88d8290f0..b3e882e9e 100644 --- a/en/project-management/project-selection.rst +++ b/en/project-management/project-selection.rst @@ -14,12 +14,14 @@ QField requires the project file to be physically on the device, so it is not po External SD card ---------------- -The file selector only shows the application-specific directory on an external SD card, as it is the only directory for which the app has write access. The directory is the following: +The file selector shows the root of the SD card labeled as "read-only" and the application-specific directory separated from the rest of the SD card, as it is the only directory for which the app has write access. The directory is the following: .. code-block:: none /Android/data/ch.opengis.qfield/files +Technically, this is due to the fact that Android intents ACTION_OPEN_DOCUMENT and ACTION_OPEN_DOCUMENT_TREE, work and grant read-write access on the content of the returning URI, not on the real linked file. This limitation which makes sense for how Android is structured but currently it is unusable with QField as QField needs to access the real file with a real path. + Warning! -------- By storing data in this folder, you risk losing data. From 5b8db52483b58aefe20b892fc3056997d8913634 Mon Sep 17 00:00:00 2001 From: Mario Baranzini Date: Sun, 24 Mar 2019 21:28:52 +0100 Subject: [PATCH 2/6] Add favorite directories explanation --- en/project-management/project-selection.rst | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/en/project-management/project-selection.rst b/en/project-management/project-selection.rst index b3e882e9e..2889ff4e6 100644 --- a/en/project-management/project-selection.rst +++ b/en/project-management/project-selection.rst @@ -12,6 +12,10 @@ Inside these directories, only subdirectories and files with the ".qgs" extensio QField requires the project file to be physically on the device, so it is not possible to use providers that work with remote files (e.g. Google Drive). On the other hand you can use apps like `syncthing `_ or `nextcloud `_ (or dropbox and probably many others) that allow you tho physically sync the file to your device. +Favorite directories +____________________ +In the first screen of the file selector, there is a section showing the favorite directories. To add a directory to the favorites, long click in the file selector on the directory name. To remove an entry from the favorites, long click on the entry in the favorites list. + External SD card ---------------- The file selector shows the root of the SD card labeled as "read-only" and the application-specific directory separated from the rest of the SD card, as it is the only directory for which the app has write access. The directory is the following: From d9e849de44d3431449b5cd9a37f8a9da376b9154 Mon Sep 17 00:00:00 2001 From: Mario Baranzini Date: Sun, 24 Mar 2019 21:30:50 +0100 Subject: [PATCH 3/6] Fix markup --- en/project-management/project-selection.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/en/project-management/project-selection.rst b/en/project-management/project-selection.rst index 2889ff4e6..7acda32c4 100644 --- a/en/project-management/project-selection.rst +++ b/en/project-management/project-selection.rst @@ -13,7 +13,7 @@ Inside these directories, only subdirectories and files with the ".qgs" extensio QField requires the project file to be physically on the device, so it is not possible to use providers that work with remote files (e.g. Google Drive). On the other hand you can use apps like `syncthing `_ or `nextcloud `_ (or dropbox and probably many others) that allow you tho physically sync the file to your device. Favorite directories -____________________ +-------------------- In the first screen of the file selector, there is a section showing the favorite directories. To add a directory to the favorites, long click in the file selector on the directory name. To remove an entry from the favorites, long click on the entry in the favorites list. External SD card From 1d816aff9f203bbd8b14511f86b01bb778dbe3f7 Mon Sep 17 00:00:00 2001 From: Mario Baranzini Date: Mon, 25 Mar 2019 09:07:58 +0100 Subject: [PATCH 4/6] Put technical note in a "note" section --- en/project-management/project-selection.rst | 2 ++ 1 file changed, 2 insertions(+) diff --git a/en/project-management/project-selection.rst b/en/project-management/project-selection.rst index 7acda32c4..9b6f904be 100644 --- a/en/project-management/project-selection.rst +++ b/en/project-management/project-selection.rst @@ -24,6 +24,8 @@ The file selector shows the root of the SD card labeled as "read-only" and the a /Android/data/ch.opengis.qfield/files +.. note:: + Technically, this is due to the fact that Android intents ACTION_OPEN_DOCUMENT and ACTION_OPEN_DOCUMENT_TREE, work and grant read-write access on the content of the returning URI, not on the real linked file. This limitation which makes sense for how Android is structured but currently it is unusable with QField as QField needs to access the real file with a real path. Warning! From 09633d39feda085c375465a0c2e06d3d7ef0a933 Mon Sep 17 00:00:00 2001 From: Mario Baranzini Date: Mon, 25 Mar 2019 09:09:06 +0100 Subject: [PATCH 5/6] Fix markup --- en/project-management/project-selection.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/en/project-management/project-selection.rst b/en/project-management/project-selection.rst index 9b6f904be..bbf462d1c 100644 --- a/en/project-management/project-selection.rst +++ b/en/project-management/project-selection.rst @@ -26,7 +26,7 @@ The file selector shows the root of the SD card labeled as "read-only" and the a .. note:: -Technically, this is due to the fact that Android intents ACTION_OPEN_DOCUMENT and ACTION_OPEN_DOCUMENT_TREE, work and grant read-write access on the content of the returning URI, not on the real linked file. This limitation which makes sense for how Android is structured but currently it is unusable with QField as QField needs to access the real file with a real path. + Technically, this is due to the fact that Android intents ACTION_OPEN_DOCUMENT and ACTION_OPEN_DOCUMENT_TREE, work and grant read-write access on the content of the returning URI, not on the real linked file. This limitation which makes sense for how Android is structured but currently it is unusable with QField as QField needs to access the real file with a real path. Warning! -------- From 9665c0dea0ca3d73b98361cb61b3d73e3702e6b2 Mon Sep 17 00:00:00 2001 From: Mario Baranzini Date: Mon, 25 Mar 2019 09:22:07 +0100 Subject: [PATCH 6/6] Fix rst2html warnings --- en/project-management/project-selection.rst | 7 ++++--- 1 file changed, 4 insertions(+), 3 deletions(-) diff --git a/en/project-management/project-selection.rst b/en/project-management/project-selection.rst index bbf462d1c..ff79e2a1b 100644 --- a/en/project-management/project-selection.rst +++ b/en/project-management/project-selection.rst @@ -20,13 +20,13 @@ External SD card ---------------- The file selector shows the root of the SD card labeled as "read-only" and the application-specific directory separated from the rest of the SD card, as it is the only directory for which the app has write access. The directory is the following: -.. code-block:: none +.. code-block:: /Android/data/ch.opengis.qfield/files .. note:: - Technically, this is due to the fact that Android intents ACTION_OPEN_DOCUMENT and ACTION_OPEN_DOCUMENT_TREE, work and grant read-write access on the content of the returning URI, not on the real linked file. This limitation which makes sense for how Android is structured but currently it is unusable with QField as QField needs to access the real file with a real path. + Technically, this is due to the fact that Android intents ACTION_OPEN_DOCUMENT and ACTION_OPEN_DOCUMENT_TREE, work and grant read-write access on the content of the returning URI, not on the real linked file. This limitation which makes sense for how Android is structured but currently it is unusable with QField as QField needs to access the real file with a real path. Warning! -------- @@ -34,7 +34,7 @@ By storing data in this folder, you risk losing data. The application-specific directory (`/Android/data/ch.opengis.qfield/`) will be deleted by the system if you uninstall QField from your Android device. This is important if you keep the data in the External sd card. How to turn external SD card into internal storage --------- +-------------------------------------------------- Starting from Android 6.0, you can use the SD card as internal storage for your Android phone. A feature called Adoptable Storage allows the Android OS to format an external storage media as a permanent internal storage. The data on the adopted SD card is encrypted and it can’t be mounted on another device. **Please be sure you start with an empty SD card. It needs to be empty because when the card is converted to "Internal" storage, it will be formatted (wiped).** @@ -44,6 +44,7 @@ Starting from Android 6.0, you can use the SD card as internal storage for your 3. Now select “Format as internal”, and then “Erase & Format”. 4. Your SD Card will now be formatted as internal storage. 5. Reboot your phone. + If you don't reboot the phone, many things may not work correctly, so make sure you do. It might be possible that the Adoptable Storage feature is not present on your device even if it is running Android 6.0 and above. The device manufacturer may have disabled the feature. However, command-line methods exist which allow you to force a device to adopt a storage.