- Sintaxe:
<permission-tree android:icon="drawable resource" android:label="string resource" android:name="string" />
- contido em:
<manifest>
- descrição:
- Declara o nome base de uma árvore de permissões. O aplicativo assume
a propriedade de todos os nomes da árvore. Ele pode adicionar dinamicamente novas permissões
à árvore chamando
PackageManager.addPermission()
. Os nomes dentro da árvore são separados por pontos (.
). Por exemplo, se o nome base forcom.example.project.taxes
, será possível adicionar permissões como estas:com.example.project.taxes.CALCULATE
com.example.project.taxes.deductions.STORE_RECEIPTS
com.example.project.taxes.deductions.ACCESS_RECORDS
Esse elemento não declara uma permissão, apenas um namespace em que as permissões podem ser colocadas. Para mais informações sobre como declarar permissões, consulte o elemento
<permission>
. - atributos:
android:icon
- Um ícone representando todas as permissões na árvore. Esse atributo precisa ser definido como uma referência a um recurso drawable que contém a definição da imagem.
android:label
- Um nome legível pelo usuário para o grupo. Por conveniência, o rótulo pode ser definido diretamente como uma string bruta durante o desenvolvimento. No entanto, quando o aplicativo estiver pronto para ser publicado, defina o rótulo como uma referência a um recurso de string, para que ele possa ser localizado como outras strings da interface do usuário.
android:name
- O nome na base da árvore de permissões. Ele serve como
prefixo para todos os nomes de permissões na árvore. Crie o escopo no estilo Java
para que o nome seja exclusivo. O nome precisa ter mais de
dois segmentos separados por ponto no caminho. Por exemplo,
com.example.base
está correto, mascom.example
não.
- introduzido em:
- Nível 1 da API
- confira também:
<permission>
<permission-group>
<uses-permission>
<permission-tree>
O conteúdo e os exemplos de código nesta página estão sujeitos às licenças descritas na Licença de conteúdo. Java e OpenJDK são marcas registradas da Oracle e/ou suas afiliadas.
Última atualização 2025-07-27 UTC.
[null,null,["Última atualização 2025-07-27 UTC."],[],[],null,["# <permission-tree\u003e\n\nsyntax:\n:\n\n ```xml\n \u003cpermission-tree android:icon=\"drawable resource\"\n android:label=\"string resource\"\n android:name=\"string\" /\u003e\n ```\n\ncontained in:\n: [\u003cmanifest\u003e](/guide/topics/manifest/manifest-element)\n\ndescription:\n: Declares the base name for a tree of permissions. The application takes\n ownership of all names within the tree. It can dynamically add new permissions\n to the tree by calling [PackageManager.addPermission()](/reference/android/content/pm/PackageManager#addPermission(android.content.pm.PermissionInfo)).\n Names within the tree are separated by\n periods ('`.`'). For example, if the base name is\n `com.example.project.taxes`, permissions like the following might be\n added:\n\n `com.example.project.taxes.CALCULATE`\n\n `com.example.project.taxes.deductions.STORE_RECEIPTS`\n\n `com.example.project.taxes.deductions.ACCESS_RECORDS`\n\n\n This element doesn't declare a permission itself, only a\n namespace in which permissions can be placed. For more information about declaring permissions, see the\n [\u003cpermission\u003e](/guide/topics/manifest/permission-element)\n element.\n\nattributes:\n:\n\n `android:icon`\n : An icon representing all the permissions in the tree. This attribute\n must be set as a reference to a drawable resource containing the image\n definition.\n\n `android:label`\n : A user-readable name for the group. As a convenience, the label\n can be directly set as a raw string during development. However,\n when the application is ready to be published, set it as a\n reference to a string resource, so that it can be localized like other\n strings in the user interface.\n\n `android:name`\n : The name at the base of the permission tree. It serves as\n a prefix to all permission names in the tree. Use Java-style scoping\n so that the name is unique. The name must have more than\n two period-separated segments in its path. For example,\n `com.example.base` is OK, but `com.example` isn't.\n\nintroduced in:\n: API level 1\n\nsee also:\n: [\u003cpermission\u003e](/guide/topics/manifest/permission-element)\n\n [\u003cpermission-group\u003e](/guide/topics/manifest/permission-group-element)\n\n [\u003cuses-permission\u003e](/guide/topics/manifest/uses-permission-element)"]]