1 page.title=<permission-group> 2 parent.title=The AndroidManifest.xml File 3 parent.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 18 permission 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 20 presented together in the user interface. 21 22 <p> 23 Note that this element does not declare a permission itself, only a category in 24 which 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 26 on 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 33 longer and more explanatory than the label. This attribute must be 34 set as a reference to a string resource. Unlike the {@code label} 35 attribute, 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 39 as 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 43 be directly set as a raw string while you're developing the application. 44 However, when the application is ready to be published, it should be set 45 as a reference to a string resource, so that it can be localized like other 46 strings 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> 51 element's 52 <code><a href="{@docRoot}guide/topics/manifest/permission-element.html#pgroup"><permissionGroup></a></code> 53 attribute.</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
