drgreen/android_frameworks_base
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

add maxSdkVersion attribute to uses-permission doc

Browse Source 
Change-Id: I612aeb9444a360ca3ebf4675dca05145beae5b04
This commit is contained in:
Scott Main
2013-11-06 16:58:36 -08:00
parent 57c9886d4b
commit 334cc4874f
1 changed files with 21 additions and 1 deletions
Download Patch File Download Diff File Expand all files Collapse all files

22
docs/html/guide/topics/manifest/uses-permission-element.jd
View File

@ -35,7 +35,8 @@ href="{@docRoot}guide/topics/manifest/uses-feature-element.html#permissions-feat
</div>
<dt>syntax:</dt>
<dd><pre class="stx">&lt;uses-permission android:<a href="#nm">name</a>="<i>string</i>" /&gt;</pre></dd>
<dd><pre class="stx">&lt;uses-permission android:<a href="#nm">name</a>="<i>string</i>"
android:<a href="#maxSdk">maxSdkVersion</a>="<i>integer</i>" /&gt;</pre></dd>
<dt>contained in:</dt>
<dd><code><a href="{@docRoot}guide/topics/manifest/manifest-element.html">&lt;manifest&gt;</a></code></dd>
@ -63,6 +64,25 @@ standard system permissions, such as "{@code android.permission.CAMERA}"
or "{@code android.permission.READ_CONTACTS}". As these examples show,
a permission name typically includes the package name as a prefix.</dd>
<dt><a name="maxSdk"></a>{@code android:maxSdkVersion}</dt>
<dd>The highest API level at which this permission should be granted to your app.
Setting this attribute is useful if the permission your app requires is no longer needed beginning
at a certain API level.
<p>For example, beginning with Android 4.4 (API level 19), it's no longer necessary for your app
to request the {@link android.Manifest.permission#WRITE_EXTERNAL_STORAGE} permission when your
app wants to write to its own application-specific directories on external storage (the directories
provided by {@link android.content.Context#getExternalFilesDir getExternalFilesDir()}). However,
the permission <em>is required</em> for API level 18 and lower. So you can declare that this
permission is needed only up to API level 18 with a declaration such as this:
<pre>
&lt;uses-permission
android:name="android.permission.WRITE_EXTERNAL_STORAGE"
android:maxSdkVersion="18" />
</pre>
<p>This way, beginning with API level 19, the system will no longer grant your app the
{@link android.Manifest.permission#WRITE_EXTERNAL_STORAGE} permission.</p>
</dd>
</dl></dd>
<!-- ##api level indication## -->