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