[Scummvm-git-logs] scummvm branch-2-7 -> 1374ace110fba298d1eeff650bb930edb7fecda6

sev- noreply at scummvm.org
Fri Mar 3 20:13:19 UTC 2023 

This automated email contains information about 1 new commit which have been
pushed to the 'scummvm' repo located at https://github.com/scummvm/scummvm .

Summary:
1374ace110 DOCS: Describe SAF protocol for Android


Commit: 1374ace110fba298d1eeff650bb930edb7fecda6
    https://github.com/scummvm/scummvm/commit/1374ace110fba298d1eeff650bb930edb7fecda6
Author: Eugene Sandulenko (sev at scummvm.org)
Date: 2023-03-03T21:13:12+01:00

Commit Message:
DOCS: Describe SAF protocol for Android

Changed paths:
  A doc/docportal/images/android/browser-folder-in-list.png
  A doc/docportal/images/android/browser-root.png
  A doc/docportal/images/android/fs-folder.png
  A doc/docportal/images/android/fs-permission.png
  A doc/docportal/images/android/fs-root.png
  A doc/docportal/images/android/gui-remove-list.png
  A doc/docportal/images/android/gui-remove-permissions.png
    doc/docportal/other_platforms/android.rst


diff --git a/doc/docportal/images/android/browser-folder-in-list.png b/doc/docportal/images/android/browser-folder-in-list.png
new file mode 100644
index 00000000000..53b20bb1413
Binary files /dev/null and b/doc/docportal/images/android/browser-folder-in-list.png differ
diff --git a/doc/docportal/images/android/browser-root.png b/doc/docportal/images/android/browser-root.png
new file mode 100644
index 00000000000..50a08261aae
Binary files /dev/null and b/doc/docportal/images/android/browser-root.png differ
diff --git a/doc/docportal/images/android/fs-folder.png b/doc/docportal/images/android/fs-folder.png
new file mode 100644
index 00000000000..c10236c39b3
Binary files /dev/null and b/doc/docportal/images/android/fs-folder.png differ
diff --git a/doc/docportal/images/android/fs-permission.png b/doc/docportal/images/android/fs-permission.png
new file mode 100644
index 00000000000..55ca855a2a6
Binary files /dev/null and b/doc/docportal/images/android/fs-permission.png differ
diff --git a/doc/docportal/images/android/fs-root.png b/doc/docportal/images/android/fs-root.png
new file mode 100644
index 00000000000..86d75fd802c
Binary files /dev/null and b/doc/docportal/images/android/fs-root.png differ
diff --git a/doc/docportal/images/android/gui-remove-list.png b/doc/docportal/images/android/gui-remove-list.png
new file mode 100644
index 00000000000..3af4b062420
Binary files /dev/null and b/doc/docportal/images/android/gui-remove-list.png differ
diff --git a/doc/docportal/images/android/gui-remove-permissions.png b/doc/docportal/images/android/gui-remove-permissions.png
new file mode 100644
index 00000000000..d81b6640b2d
Binary files /dev/null and b/doc/docportal/images/android/gui-remove-permissions.png differ
diff --git a/doc/docportal/other_platforms/android.rst b/doc/docportal/other_platforms/android.rst
index da352a0e09d..c208e718656 100644
--- a/doc/docportal/other_platforms/android.rst
+++ b/doc/docportal/other_platforms/android.rst
@@ -12,7 +12,7 @@ What you'll need
 
 .. note::
 
-    ScummVM has been tested to work up to Android 10. Currently there are some file browsing limitations with Android 11. The ScummVM team are working to resolve these.
+    ScummVM has been tested to work up to Android 12.
 
 Installing ScummVM
 ====================================
@@ -59,6 +59,62 @@ There are a few other options to transfer the game files:
 See :doc:`../use_scummvm/game_files` for more information about game file requirements.
 
 
+Adding SAF paths to ScummVM directory list
+==========================================
+Starting with version 2.7.0 of ScummVM for Android, significant changes were made to the file access system to allow support for modern versions of the Android Operating System.
+If you find that your existing added games or custom paths no longer work, please edit those paths and this time use the SAF system to browse to the desired locations.
+To do that:
+
+1. For each game whose data is not found, go to the "Paths" tab in the "Game Options" and change the "Game path"
+
+2. Inside the ScummVM file browser, use "Go Up" until you reach the "root" folder where you will see the "<Add a new folder>" option.
+
+.. figure:: ../images/android/browser-root.png
+
+    File Browser root with <Add a new folder> item
+
+3. Choose that, then browse and select the "parent" folder for your games subfolders, e.g. "SD Card > ScummVMgames". Click on "Use this folder".
+
+.. figure:: ../images/android/fs-root.png
+    :width: 300 px
+
+    OS file browser root
+
+.. figure:: ../images/android/fs-folder.png
+    :width: 300 px
+
+    OS file browser selectable folder with "Use this folder" button
+
+.. figure:: ../images/android/fs-permission.png
+    :width: 300 px
+
+    OS file browser ask to grant ScummVM directory access permission
+
+4. Then, a new folder "ScummVMgames" will appear on the "root" folder of the ScummVM browser.
+
+.. figure:: ../images/android/browser-folder-in-list.png
+
+    File browser with added SAF folder in root
+
+5. Browse through this folder to your game data.
+
+Steps 2 and 3 need to be done only once for all of your games.
+
+
+Removing SAF path authorizations
+=============================
+In case you would like to revoke any of the granted SAF authorizations, there is an option for this in the "Global Options > Backend" tab as shown on the screenshot below:
+
+.. figure:: ../images/android/gui-remove-permissions.png
+
+    GUI tab with "Remove folder authorizations..." button
+
+.. figure:: ../images/android/gui-remove-list.png
+
+    GUI dialog with list of authorizations to revoke
+
+In case you revoke authorization to a path, still used for specific games/titles, please follow the procedure of fixing them outlined in the previous subheading.
+
 
 Controls
 =============
@@ -163,10 +219,4 @@ For more information, see the :doc:`../use_scummvm/LAN` page.
 Known issues
 ===============
 
-- On some newer devices, there is an issue if the saved path is outside the app's internal (or external) storage. The ScummVM team is currently working on a fix.
-
 - If ScummVM is uninstalled or downgraded, its internal and external app spaces are fully deleted. If you want to keep saved games use ScummVM's :doc:`cloud <../use_scummvm/connect_cloud>` or LAN functionality to keep those files. Alternatively, change the saved game path to a shared location such as an SD card.
-
-
-
-

More information about the Scummvm-git-logs mailing list