permission-group-element.jd revision 3155825c256b150cfa635ad27ac7a2bab76371b0 
1page.title=<permission-group>
2parent.title=The AndroidManifest.xml File
3parent.link=manifest-intro.html
4@jd:body
5
6<dl class="xml">
7<dt>syntax:</dt>
8<dd><pre class="stx">&lt;permission-group android:<a href="#desc">description</a>="<i>string resource</i>"
9                  android:<a href="#icon">icon</a>="<i>drawable resource</i>"
10                  android:<a href="#label">label</a>="<i>string resource</i>"
11                  android:<a href="#nm">name</a>="<i>string</i>" /&gt;</pre></dd>
12
13<dt>contained in:</dt>
14<dd><code><a href="{@docRoot}guide/topics/manifest/manifest-element.html">&lt;manifest&gt;</a></code></dd>
15
16<dt>description:</dt>
17<dd itemprop="description">Declares a name for a logical grouping of related permissions.  Individual
18permission join the group through the {@code permissionGroup} attribute of the
19<code><a href="{@docRoot}guide/topics/manifest/permission-element.html">&lt;permission&gt;</a></code> element.  Members of a group are
20presented together in the user interface.
21
22<p>
23Note that this element does not declare a permission itself, only a category in 
24which permissions can be placed.  See the 
25<code><a href="{@docRoot}guide/topics/manifest/permission-element.html">&lt;permission&gt;</a></code> element for element for information 
26on declaring permissions and assigning them to groups.
27</p></dd>
28
29<dt>attributes:</dt>
30<dd><dl class="attr">
31<dt><a name="desc"></a>{@code android:description}</dt>
32<dd>User-readable text that describes the group.  The text should be 
33longer and more explanatory than the label.  This attribute must be 
34set as a reference to a string resource.  Unlike the {@code label}
35attribute, it cannot be a raw string.</dd>
36
37<dt><a name="icon"></a>{@code android:icon}</dt>
38<dd>An icon representing the permission.  This attribute must be set
39as a reference to a drawable resource containing the image definition.</dd>
40
41<dt><a name="label"></a>{@code android:label}</dt>
42<dd>A user-readable name for the group.  As a convenience, the label can 
43be directly set as a raw string while you're developing the application.  
44However, when the application is ready to be published, it should be set 
45as a reference to a string resource, so that it can be localized like other 
46strings in the user interface.</dd>
47
48<dt><a name="nm"></a>{@code android:name}</dt>
49<dd>The name of the group.  This is the name that can be assigned to a
50<code><a href="{@docRoot}guide/topics/manifest/permission-element.html">&lt;permission&gt;</a></code>
51element's
52<code><a href="{@docRoot}guide/topics/manifest/permission-element.html#pgroup">&lt;permissionGroup&gt;</a></code>
53attribute.</dd>
54</dl></dd>
55
56<!-- ##api level indication## -->
57<dt>introduced in:</dt>
58<dd>API Level 1</dd>
59
60<dt>see also:</dt>
61<dd><code><a href="{@docRoot}guide/topics/manifest/permission-element.html">&lt;permission&gt;</a></code>
62<br/><code><a href="{@docRoot}guide/topics/manifest/permission-tree-element.html">&lt;permission-tree&gt;</a></code>
63<br/><code><a href="{@docRoot}guide/topics/manifest/uses-permission-element.html">&lt;uses-permission&gt;</a></code></dd>
64
65</dl>
66