Merge "Document restricted app private file permissions" into nyc-dev (b52a874f) · Commits · e / os / android_frameworks_base

docs/html/guide/topics/data/data-storage.jd

+14 −0

Original line number	Diff line number	Diff line
		@@ -178,6 +178,20 @@ android.content.Context#MODE_APPEND}, {@link
		android.content.Context#MODE_WORLD_READABLE}, and {@link
		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.
		Starting from Android N their use will result in a {@link java.lang.SecurityException}
		to be thrown.
		This means that apps targeting Android N 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>

		<ol>

+7 −1

Original line number	Diff line number	Diff line
		@@ -59,7 +59,7 @@ The following lists summarize the facts about each storage space.</p>
		<p><b>Internal storage:</b></p>
		<ul>
		<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
		internal storage.</li>
		</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>
		</div>

		<p class="note">
		<strong>Note:</strong> Before Android N, 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">
		<strong>Tip:</strong> Although apps are installed onto the internal storage by