Donate to e Foundation | Murena handsets with /e/OS | Own a part of Murena! Learn more

Commit 101d1e20 authored by Dan Yu's avatar Dan Yu Committed by android-build-merger
Browse files

Merge "docs: Updating Scoped Directory Access preview docs for DP2" into mnc-mr-docs am: bc90f38e 

am: d77a4db2

* commit 'd77a4db2':
  docs: Updating Scoped Directory Access preview docs for DP2

Change-Id: I250012196586889f9617e33861a0b851004e2d12
parents 1888ee6e d77a4db2

docs/html/preview/_book.yaml

+2 −0
Original line number Original line Diff line number Diff line
@@ -70,6 +70,8 @@ toc: 
    path: /preview/j8-jack.html

    path: /preview/j8-jack.html

  - title: Android for Work Updates

  - title: Android for Work Updates

    path: /preview/features/afw.html

    path: /preview/features/afw.html

  - title: Scoped Directory Access

    path: /preview/features/scoped-folder-access.html





- title: Samples

- title: Samples

  path: /preview/samples.html

  path: /preview/samples.html

docs/html/preview/features/scoped-folder-access.jd

+20 −1
Original line number Original line Diff line number Diff line
@@ -44,6 +44,14 @@ Use this intent to access external storage directories. To get a list of 
all available volumes, including removable media volumes, use

all available volumes, including removable media volumes, use

<code>StorageManager.getVolumesList()</code>.</p>

<code>StorageManager.getVolumesList()</code>.</p>





<p>

On secondary volumes, such as external SD cards, pass in null when calling

<code>StorageVolume.createAccessIntent()</code> to request access to the entire

volume, instead of a specific directory.

<code>StorageVolume.createAccessIntent()</code> returns null if you pass in

null to the primary volume, or if you pass in an invalid directory name.

</p>



<p>The following code snippet is an example of how to open the

<p>The following code snippet is an example of how to open the

<code>Pictures</code> directory in the primary shared storage:</p>

<code>Pictures</code> directory in the primary shared storage:</p>
@@ -122,4 +130,15 @@ user.</p> 




<p>If the user denies access to an external directory, do not immediately

<p>If the user denies access to an external directory, do not immediately

request access again. Repeatedly insisting on access results in a poor user

request access again. Repeatedly insisting on access results in a poor user

experience.</p>
 
experience. If a request is denied by the user, and the app requests access

again, the UI displays a <b>Don't ask again</b> checkbox:</p>



<img src="{@docRoot}preview/images/scoped-folder-access-dont-ask.png"

srcset="{@docRoot}preview/images/scoped-folder-access-dont-ask.png 1x,

{@docRoot}preview/images/scoped-folder-access-dont-ask_2x.png 2x" />

<p class="img-caption"><strong>Figure 1.</strong> An application making a

second request for access to removable media.</p>



<p>If the user selects <b>Don't ask again</b> and denies the request, all

future requests for the given directory from your app will be automatically

denied, and no request UI will be presented to the user.</p>
 
 No newline at end of file

docs/html/preview/images/scoped-folder-access-dont-ask.png

0 → 100644
+65.7 KiB
Loading image diff...

docs/html/preview/images/scoped-folder-access-dont-ask_2x.png

0 → 100644
+221 KiB
Loading image diff...

docs/html/preview/preview_toc.cs

+5 −2
Original line number Original line Diff line number Diff line
@@ -88,6 +88,9 @@ 




        <li><a href="<?cs var:toroot ?>preview/features/afw.html"

        <li><a href="<?cs var:toroot ?>preview/features/afw.html"

        >Android for Work Updates</a></li>

        >Android for Work Updates</a></li>



        <li><a href="<?cs var:toroot ?>preview/features/scoped-folder-access.html"

        >Scoped Directory Access</a></li>

      </ul>

      </ul>

  </li>

  </li>