Added in API level 1

PermissionGroupInfo


open class PermissionGroupInfo : PackageItemInfo, Parcelable

Information you can retrieve about a particular security permission group known to the system. This corresponds to information collected from the AndroidManifest.xml's <permission-group> tags.

Summary

Constants
static Int

Flag for flags, corresponding to personalInfo value of android.R.attr#permissionGroupFlags.

Inherited constants
Int CONTENTS_FILE_DESCRIPTOR

Descriptor bit used with describeContents(): indicates that the Parcelable object's flattened representation includes a file descriptor.

Int PARCELABLE_WRITE_RETURN_VALUE

Flag for use with writeToParcel: the object being written is a return value, that is the result of a function such as "Parcelable someFunction()", "void someFunction(out Parcelable)", or "void someFunction(inout Parcelable)". Some implementations may want to release resources at this point.

Public methods
open Int

open CharSequence?

Retrieve the textual description of this permission.

open String

open Unit
writeToParcel(dest: Parcel, parcelableFlags: Int)

Inherited functions
Unit dumpBack(pw: Printer!, prefix: String!)

Unit dumpFront(pw: Printer!, prefix: String!)

Drawable! loadBanner(pm: PackageManager!)

Retrieve the current graphical banner associated with this item. This will call back on the given PackageManager to load the banner from the application.

Drawable! loadIcon(pm: PackageManager!)

Retrieve the current graphical icon associated with this item. This will call back on the given PackageManager to load the icon from the application.

CharSequence loadLabel(pm: PackageManager)

Retrieve the current textual label associated with this item. This will call back on the given PackageManager to load the label from the application.

Drawable! loadLogo(pm: PackageManager!)

Retrieve the current graphical logo associated with this item. This will call back on the given PackageManager to load the logo from the application.

Drawable! loadUnbadgedIcon(pm: PackageManager!)

Retrieve the current graphical icon associated with this item without the addition of a work badge if applicable. This will call back on the given PackageManager to load the icon from the application.

XmlResourceParser! loadXmlMetaData(pm: PackageManager!, name: String!)

Load an XML resource attached to the meta-data of this item. This will retrieved the name meta-data entry, and if defined call back on the given PackageManager to load its XML file from the application.

Properties
static Parcelable.Creator<PermissionGroupInfo!>

Int

A string resource identifier (in the package's resources) of this permission's description.

Int

Additional flags about this group as given by android.R.attr#permissionGroupFlags.

CharSequence?

The description string provided in the AndroidManifest file, if any.

Int

Prioritization of this group, for visually sorting with other groups.

Inherited properties
Int banner

A drawable resource identifier (in the package's resources) of this component's banner. From the "banner" attribute or, if not set, 0.

Int icon

A drawable resource identifier (in the package's resources) of this component's icon. From the "icon" attribute or, if not set, 0.

Boolean isArchived

Whether the package is currently in an archived state.

Packages can be archived through PackageInstaller.requestArchive and do not have any APKs stored on the device, but do keep the data directory.

Int labelRes

A string resource identifier (in the package's resources) of this component's label. From the "label" attribute or, if not set, 0.

Int logo

A drawable resource identifier (in the package's resources) of this component's logo. Logos may be larger/wider than icons and are displayed by certain UI elements in place of a name or name/icon combination. From the "logo" attribute or, if not set, 0.

Bundle! metaData

Additional meta-data associated with this component. This field will only be filled in if you set the PackageManager.GET_META_DATA flag when requesting the info.

String! name

Public name of this item. From the "android:name" attribute.

CharSequence! nonLocalizedLabel

The string provided in the AndroidManifest file, if any. You probably don't want to use this. You probably want PackageManager.getApplicationLabel

String! packageName

Name of the package that this item is in.

Constants

FLAG_PERSONAL_INFO

Added in API level 17
static val FLAG_PERSONAL_INFO: Int

Flag for flags, corresponding to personalInfo value of android.R.attr#permissionGroupFlags.

Value: 1

Public constructors

PermissionGroupInfo

Added in API level 1
PermissionGroupInfo()

Deprecated: Should only be created by the system.

PermissionGroupInfo

Added in API level 1
PermissionGroupInfo(orig: PermissionGroupInfo)

Deprecated: Should only be created by the system.

Parameters
orig PermissionGroupInfo: This value cannot be null.

Public methods

describeContents

Added in API level 1
open fun describeContents(): Int
Return
Int a bitmask indicating the set of special object types marshaled by this Parcelable object instance. Value is either 0 or android.os.Parcelable#CONTENTS_FILE_DESCRIPTOR

loadDescription

Added in API level 1
open fun loadDescription(pm: PackageManager): CharSequence?

Retrieve the textual description of this permission. This will call back on the given PackageManager to load the description from the application.

Parameters
pm PackageManager: A PackageManager from which the label can be loaded; usually the PackageManager from which you originally retrieved this item. This value cannot be null.
Return
CharSequence? Returns a CharSequence containing the permission's description. If there is no description, null is returned.

toString

Added in API level 1
open fun toString(): String
Return
String a string representation of the object.

writeToParcel

Added in API level 1
open fun writeToParcel(
    dest: Parcel,
    parcelableFlags: Int
): Unit
Parameters
dest Parcel: The Parcel in which the object should be written. This value cannot be null.
flags Additional flags about how the object should be written. May be 0 or PARCELABLE_WRITE_RETURN_VALUE. Value is either 0 or a combination of android.os.Parcelable#PARCELABLE_WRITE_RETURN_VALUE, and android.os.Parcelable.PARCELABLE_ELIDE_DUPLICATES

Properties

CREATOR

Added in API level 1
static val CREATOR: Parcelable.Creator<PermissionGroupInfo!>

descriptionRes

Added in API level 1
var descriptionRes: Int

A string resource identifier (in the package's resources) of this permission's description. From the "description" attribute or, if not set, 0.

flags

Added in API level 17
var flags: Int

Additional flags about this group as given by android.R.attr#permissionGroupFlags.
Value is either 0 or android.content.pm.PermissionGroupInfo#FLAG_PERSONAL_INFO

nonLocalizedDescription

Added in API level 1
var nonLocalizedDescription: CharSequence?

The description string provided in the AndroidManifest file, if any. You probably don't want to use this, since it will be null if the description is in a resource. You probably want PermissionInfo.loadDescription instead.

priority

Added in API level 17
var priority: Int

Prioritization of this group, for visually sorting with other groups.