From 5942134bc6129e078b11e1661485638678b3fa1c Mon Sep 17 00:00:00 2001 From: Jorge Luis Carrillo Date: Fri, 8 Sep 2023 18:43:34 -0700 Subject: [PATCH] Add Storage Scopes section and ToC entry --- static/usage.html | 77 ++++++++++++++++++++++++++--------------------- 1 file changed, 42 insertions(+), 35 deletions(-) diff --git a/static/usage.html b/static/usage.html index 06f7de66..3afe5524 100644 --- a/static/usage.html +++ b/static/usage.html @@ -49,7 +49,12 @@
  • 3-button navigation
    • -
  • Storage access
    • +
  • + Storage access + +
  • Accessibility
  • Auditor
  • @@ -265,47 +270,49 @@ providers and modern Android has removed the legacy approach for accessing external drives.

    -

    Storage Scopes

    +
    +

    Storage Scopes

    -

    GrapheneOS provides the Storage Scopes feature as a fully compatible alternative - to the standard Android storage permissions. - Storage Scopes can be enabled only if the app doesn't have any storage permission. - Enabling Storage Scopes makes the app assume that it has all of storage permissions - that were requested by it, despite not actually having any of them.

    +

    GrapheneOS provides the Storage Scopes feature as a fully compatible alternative + to the standard Android storage permissions. + Storage Scopes can be enabled only if the app doesn't have any storage permission. + Enabling Storage Scopes makes the app assume that it has all of storage permissions + that were requested by it, despite not actually having any of them.

    -

    This means that the app can't see any of the files that were created by other apps. - The app is still allowed to create files and directories, same as any other modern - app that doesn't have any storage access permission.

    +

    This means that the app can't see any of the files that were created by other apps. + The app is still allowed to create files and directories, same as any other modern + app that doesn't have any storage access permission.

    -

    Apps that would normally use the legacy storage mode are switched to the - modern storage mode when Storage Scopes is enabled.

    +

    Apps that would normally use the legacy storage mode are switched to the + modern storage mode when Storage Scopes is enabled.

    -

    If the app requests the "All files access" permission (or is a legacy app - that requests WRITE_EXTERNAL_STORAGE permission), then the write - restrictions that are normally applied to apps that don't have a storage access - permission are relaxed to provide the same write access that the app would have if - it was granted the "All files access" permission. - This is done to ensure compatibility with apps that, for example, create a new - directory in the root of shared storage, or write a text file (eg lyrics.txt) to - the Music/ directory (normally, only audio files can be placed there). - No additional read access is granted to such apps, they still can see only their - own files. -

    +

    If the app requests the "All files access" permission (or is a legacy app + that requests WRITE_EXTERNAL_STORAGE permission), then the write + restrictions that are normally applied to apps that don't have a storage access + permission are relaxed to provide the same write access that the app would have if + it was granted the "All files access" permission. + This is done to ensure compatibility with apps that, for example, create a new + directory in the root of shared storage, or write a text file (eg lyrics.txt) to + the Music/ directory (normally, only audio files can be placed there). + No additional read access is granted to such apps, they still can see only their + own files. +

    -

    For all other apps, enabling Storage Scopes doesn't grant any additional - storage access beyond what a modern app that doesn't have any storage permission - already has.

    +

    For all other apps, enabling Storage Scopes doesn't grant any additional + storage access beyond what a modern app that doesn't have any storage permission + already has.

    -

    Optionally, users can specify which of the files created by other apps the app - can access. Access can be granted to a specific file or to all files in - a directory. The standard SAF picker is used for this purpose in a special mode - where it shows only shared storage files/directories.

    +

    Optionally, users can specify which of the files created by other apps the app + can access. Access can be granted to a specific file or to all files in + a directory. The standard SAF picker is used for this purpose in a special mode + where it shows only shared storage files/directories.

    -

    The most significant limitation of Storage Scopes is the fact that the app - will lose access to files that it created if it's uninstalled and then installed - again, same as any other app that doesn't have a storage access permission. - As a workaround, users can manually grant access to these files/directories via - SAF picker.

    +

    The most significant limitation of Storage Scopes is the fact that the app + will lose access to files that it created if it's uninstalled and then installed + again, same as any other app that doesn't have a storage access permission. + As a workaround, users can manually grant access to these files/directories via + SAF picker.

    +