frameworks/base/docs/html/guide/topics/manifest/permission-group-element.jd

   1 page.title=&lt;permission-group&gt;
   2 @jd:body
   3
   4 <dl class="xml">
   5 <dt>syntax:</dt>
   6 <dd><pre class="stx">&lt;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>" /&gt;</pre></dd>
  10
  11 <dt>contained in:</dt>
  12 <dd><code><a href="{@docRoot}guide/topics/manifest/manifest-element.html">&lt;manifest&gt;</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">&lt;permission&gt;</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">&lt;permission&gt;</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">&lt;permission&gt;</a></code>
  49 element's
  50 <code><a href="{@docRoot}guide/topics/manifest/permission-element.html#pgroup">&lt;permissionGroup&gt;</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">&lt;permission&gt;</a></code>
  60 <br/><code><a href="{@docRoot}guide/topics/manifest/permission-tree-element.html">&lt;permission-tree&gt;</a></code>
  61 <br/><code><a href="{@docRoot}guide/topics/manifest/uses-permission-element.html">&lt;uses-permission&gt;</a></code></dd>
  62
  63 </dl>