Merge "Document restricted app private file permissions" into nyc-dev
am: c875a42
* commit 'c875a420a485e8b5144d521cbbb5001e5bef0721':
Document restricted app private file permissions
This commit is contained in:
@@ -178,6 +178,19 @@ android.content.Context#MODE_APPEND}, {@link
|
|||||||
android.content.Context#MODE_WORLD_READABLE}, and {@link
|
android.content.Context#MODE_WORLD_READABLE}, and {@link
|
||||||
android.content.Context#MODE_WORLD_WRITEABLE}.</p>
|
android.content.Context#MODE_WORLD_WRITEABLE}.</p>
|
||||||
|
|
||||||
|
<p class="note"><strong>Note:</strong> The constants {@link
|
||||||
|
android.content.Context#MODE_WORLD_READABLE} and {@link
|
||||||
|
android.content.Context#MODE_WORLD_WRITEABLE} have been deprecated since API level 17. Since
|
||||||
|
API level 24 their use will result in a {@link java.lang.SecurityException} to be thrown.
|
||||||
|
This means that apps targeting API level 24 and higher
|
||||||
|
cannot share private files by name, and attempts to share a "file://" URI will result in a
|
||||||
|
{@link android.os.FileUriExposedException} to be thrown. If your app needs to share private
|
||||||
|
files with other apps, it may use a {@link android.support.v4.content.FileProvider} with
|
||||||
|
the {@link android.content.Intent.FLAG_GRANT_READ_URI_PERMISSION}.
|
||||||
|
See also <a
|
||||||
|
href="{@docRoot}training/secure-file-sharing/index.html">Sharing Files</a>.
|
||||||
|
</p>
|
||||||
|
|
||||||
<p>To read a file from internal storage:</p>
|
<p>To read a file from internal storage:</p>
|
||||||
|
|
||||||
<ol>
|
<ol>
|
||||||
|
|||||||
@@ -59,7 +59,7 @@ The following lists summarize the facts about each storage space.</p>
|
|||||||
<p><b>Internal storage:</b></p>
|
<p><b>Internal storage:</b></p>
|
||||||
<ul>
|
<ul>
|
||||||
<li>It's always available.</li>
|
<li>It's always available.</li>
|
||||||
<li>Files saved here are accessible by only your app by default.</li>
|
<li>Files saved here are accessible by only your app.</li>
|
||||||
<li>When the user uninstalls your app, the system removes all your app's files from
|
<li>When the user uninstalls your app, the system removes all your app's files from
|
||||||
internal storage.</li>
|
internal storage.</li>
|
||||||
</ul>
|
</ul>
|
||||||
@@ -83,6 +83,12 @@ place for files that don't require access restrictions and for files that you wa
|
|||||||
with other apps or allow the user to access with a computer.</p>
|
with other apps or allow the user to access with a computer.</p>
|
||||||
</div>
|
</div>
|
||||||
|
|
||||||
|
<p class="note">
|
||||||
|
<strong>Note:</strong> Before API level 24, internal files could be made accessible to other
|
||||||
|
apps by means of relaxing file system permissions. This is no longer the case. If you wish
|
||||||
|
to make the content of a private file accessible to other apps, your app may use the
|
||||||
|
{@link android.support.v4.content.FileProvider}. See <a
|
||||||
|
href="{@docRoot}training/secure-file-sharing/index.html">Sharing Files</a>.</p>
|
||||||
|
|
||||||
<p class="note" style="clear:both">
|
<p class="note" style="clear:both">
|
||||||
<strong>Tip:</strong> Although apps are installed onto the internal storage by
|
<strong>Tip:</strong> Although apps are installed onto the internal storage by
|
||||||
|
|||||||
Reference in New Issue
Block a user