1page.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 16permission 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 18presented together in the user interface. 19 20<p> 21Note that this element does not declare a permission itself, only a category in 22which 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 24on 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 31longer and more explanatory than the label. This attribute must be 32set as a reference to a string resource. Unlike the {@code label} 33attribute, 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 37as 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 41be directly set as a raw string while you're developing the application. 42However, when the application is ready to be published, it should be set 43as a reference to a string resource, so that it can be localized like other 44strings 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> 49element's 50<code><a href="{@docRoot}guide/topics/manifest/permission-element.html#pgroup"><permissionGroup></a></code> 51attribute.</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