• Home
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
1page.title=<uses-permission>
2@jd:body
3
4<dl class="xml">
5<dt>syntax:</dt>
6<dd><pre class="stx">&lt;uses-permission android:<a href="#nm">name</a>="<i>string</i>" /&gt;</pre></dd>
7
8<dt>contained in:</dt>
9<dd><code><a href="{@docRoot}guide/topics/manifest/manifest-element.html">&lt;manifest&gt;</a></code></dd>
10
11<dt>description:</dt>
12<dd>Requests a permission that the application must be granted in
13order for it to operate correctly.  Permissions are granted when the
14application is installed, not while it's running.
15
16<p>
17For more information on permissions, see the
18<a href="{@docRoot}guide/topics/manifest/manifest-intro.html#perms">Permissions</a></code>
19section in the introduction and the separate
20<a href="{@docRoot}guide/topics/security/security.html">Security and Permissions</a> document.
21A list of permissions defined by the base platform can be found at
22{@link android.Manifest.permission android.Manifest.permission}.
23
24<dt>attributes:</dt>
25<dd><dl class="attr">
26<dt><a name="nm"></a>{@code android:name}</dt>
27<dd>The name of the permission.  It can be a permission defined by the
28application with the <code><a href="{@docRoot}guide/topics/manifest/permission-element.html">&lt;permission&gt;</a></code>
29element, a permission defined by another application, or one of the
30standard system permissions, such as "{@code android.permission.CAMERA}"
31or "{@code android.permission.READ_CONTACTS}".  As these examples show,
32a permission name typically includes the package name as a prefix.</dd>
33
34</dl></dd>
35
36<!-- ##api level indication## -->
37<dt>introduced in:</dt>
38<dd>API Level 1</dd>
39
40<dt>see also:</dt>
41<dd><code><a href="{@docRoot}guide/topics/manifest/permission-element.html">&lt;permission&gt;</a></code></dd>
42
43</dl>
44