From 9ec08f8bb014ae99e61651577e6f4af6356c84f0 Mon Sep 17 00:00:00 2001
From: Daniel Yu StorageManager.getVolumesList().
+On secondary volumes, such as external SD cards, pass in null when calling
+StorageVolume.createAccessIntent() to request access to the entire
+volume, instead of a specific directory.
+StorageVolume.createAccessIntent() returns null if you pass in
+null to the primary volume, or if you pass in an invalid directory name.
+
The following code snippet is an example of how to open the
Pictures directory in the primary shared storage:
If the user denies access to an external directory, do not immediately request access again. Repeatedly insisting on access results in a poor user -experience.
+experience. If a request is denied by the user, and the app requests access +again, the UI displays a Don't ask again checkbox: + +
+Figure 1. An application making a +second request for access to removable media.
+ +If the user selects Don't ask again 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.
\ No newline at end of file diff --git a/docs/html/preview/images/scoped-folder-access-dont-ask.png b/docs/html/preview/images/scoped-folder-access-dont-ask.png new file mode 100644 index 0000000000000000000000000000000000000000..5c505d956f5e743f9323ce90f6e8abfdddddb83e GIT binary patch literal 67327 zcmeENQ+Fjyu$_r>V%xSgv7MYGC$??dHYav6v2ELSCQc@{ll$GjaG&o}uhsojT~)if zch!yrDo7##Z~;Gl{6LVF5>x*1<7dK;A7C{wQ2*`3Q^~~q_z5*4EhY@|*tqD1&bL)p z5)f#d?S5W!C+S)*UavL1r?uFuuiv$H;I4Bx^gXt`XV=a1bXRf(c7Jf=BZd#|IsE_f
zf4Bm_8Sazt-!{%!c#NMl`qbfrx6a^i6fduPtNx!{W-C=%9Ic* W=eL9K`f=`w8W8+O<-bOTP1&_tO$c*Qf+C!Q|hEeaUOeL(KS$I4=n
zX!J?jGP!6#X=Hn&!#D0U0i^G68m@0;`|N}VaYak4LvIAsB6cjSQ2S&T4fm{Ty29!4
zQ9f|M+IBDT-)$@H3G<(AMV7RX(%O$r0#0jbloRgDWn!n0Ct?ROI8jXbi&tgaJeU
zheK(yIf^lsQq<^D-nou`+9GPs6;>cAu@*<^G0$E%Z^73mBOq#tP%#gXyw8mM3Jg<>
zL4{E}1v8UnDCfIu{Ns?-VoXEF;p!8?>6taKB~GEv6R}J!9JGX<&R~X(M e5a65uiiGgmfK
zogDY$d<_IbIsV)(eRz1=W=ng}0rsm}NJqZ?fczp*Z24m
z6BFxdou9pT3pO^nBh
3qBo&$npJG-lyDzfQ{lTpWbfd7)yqAN;W*3
zW0}Kko{p|!ZQj>GnJ5%ppa2xjNxygXB1iL;1+|`)TKUl?M;Bdx%Cf-A2G-0UxaD0^
zQO2WVX;Ps}XAuXg+=VN-QIXOurk0k)qP(x_P4~9qOFIma4%`3x5mt$`@COTW@qDQ*
z_*V$Jp$?;O3AVhArUiBf6NZVmp)iZDtV#YUJuP%dsz2
z8dt)TbprDdewPC2>bKZZIQ!gMX<&-32N*QxPVrkumw_>HmU`ar(I6d6?4Rgw2gezt
z)ne~N?8c<-E?=*Py4#bTOW^tcP7Z+zx1EZ>JuLRI|F;d9CC*$}w$(R;x4C9>EUqMp
z?j&8}UK%`uY<1HP7SN{}VFW5gH53U)>HR`HjETE<%th-4dSRo}^oD+30f?bp@ykt(W*cXnuFk95Wj`!PG>mJ60U${Z`p@8%xxq*$@o>{LqD9qSDwP6D
f4v}o#gdC}G4QRz@~{BCY#Eye4NGE0SGZEd4#7yOsxsn(
zNYhvY+vgbneS-*eJ