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"><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>" /></pre></dd> 12 13<dt>contained in:</dt> 14<dd><code><a href="{@docRoot}guide/topics/manifest/manifest-element.html"><manifest></a></code></dd> 15 16<dt>description:</dt> 17<dd>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"><permission></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"><permission></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"><permission></a></code> 51element's 52<code><a href="{@docRoot}guide/topics/manifest/permission-element.html#pgroup"><permissionGroup></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"><permission></a></code> 62<br/><code><a href="{@docRoot}guide/topics/manifest/permission-tree-element.html"><permission-tree></a></code> 63<br/><code><a href="{@docRoot}guide/topics/manifest/uses-permission-element.html"><uses-permission></a></code></dd> 64 65</dl> 66