news 2026/5/25 23:25:45

AI豆包手机权限文章补充:Mainfest中某个权限的protectionLevel具体是如何被系统定义的?

作者头像

张小明

前端开发工程师

1.2k 24
文章封面图
AI豆包手机权限文章补充:Mainfest中某个权限的protectionLevel具体是如何被系统定义的?

背景:

经常我们在做framework开发时候,看到某些权限时候会有对权限定义进行深入查看,例如上一篇文章:
聊一聊豆包AI手机助手高度敏感权限CAPTURE_SECURE_VIDEO_OUTPUT

中就有看到关键字保护级别:android:protectionLevel=“signature|role”。
也有其他权限看到是android:protectionLevel=“normal”:

看到这里就有vip学员朋友提出针对这个xml保护级别protectionLevel到底代表什么意思,除了常见的signature这个级别属于我们常见知道的的外又还有哪些protectionLevel呢?

这个问题确实是个好问题,要解答这个问题就需要深入看一下这块的源码分析,下面马哥带大家来一起解答。

源码剖析

protectionLevel对应的xml部分

先看看权限及保护级别的定义:
frameworks/base/core/res/AndroidManifest.xml

<!-- @SystemApi @TestApi @hide Allows an application to change to remove/kill tasks --><permissionandroid:name="android.permission.REMOVE_TASKS"android:protectionLevel="signature|recents|role"/><!-- @deprecated Use MANAGE_ACTIVITY_TASKS instead. @SystemApi @TestApi @hide Allows an application to create/manage/remove stacks --><permissionandroid:name="android.permission.MANAGE_ACTIVITY_STACKS"android:protectionLevel="signature"/>

一般这里里面的关键signature,recents,role一般都是有在对应attrs.xml中有定义,是不可以随意对写一个字符signaturexxx,role1xxx的,这样写的不对会直接报错。那么是在哪里进行定义的呢?

这里可以如果大家不知道具体在哪个attrs的xml文件定义,可以通过grep来查找定位:
在frameworks/base/core/res/res/values目录进行查找关键字“protectionLevel”。

test@test:~/disk_2T/aosp16/frameworks/base/core/res/res/values$grep"protectionLevel"./ -rn ./public-final.xml:37:<publictype="attr"name="protectionLevel"id="0x01010009"/>./attrs_manifest.xml:183: permanent protectionLevel. If you are creating a custom permissioninan ./attrs_manifest.xml:184: application, you can define a protectionLevel attribute with one of the ./attrs_manifest.xml:185: values listed below. If no protectionLevel is definedfora custom ./attrs_manifest.xml:194:<attrname="protectionLevel">./attrs_manifest.xml:2438:<attrname="protectionLevel"/>

可以看到这里查找到了,原来是在attrs_manifest.xml中进行的定义。
这里看看对应的xml定义部分:

frameworks/base/core/res/res/values/attrs_manifest.xml

<!-- Characterizes the potential risk implied in a permission and indicates the procedure the system should follow when determining whether to grant the permission to an application requesting it. {@link android.Manifest.permission Standard permissions} have a predefined and permanent protectionLevel. If you are creating a custom permission in an application, you can define a protectionLevel attribute with one of the values listed below. If no protectionLevel is defined for a custom permission, the system assigns the default ("normal"). <p>Each protection level consists of a base permission type and zero or more flags. Use the following functions to extract those. <pre> int basePermissionType = permissionInfo.getProtection(); int permissionFlags = permissionInfo.getProtectionFlags(); </pre> --><attrname="protectionLevel"><!-- <strong>Base permission type</strong>: a lower-risk permission that gives an application access to isolated application-level features, with minimal risk to other applications, the system, or the user. The system automatically grants this type of permission to a requesting application at installation, without asking for the user's explicit approval (though the user always has the option to review these permissions before installing). --><flagname="normal"value="0"/><!-- <strong>Base permission type</strong>: a higher-risk permission that would give a requesting application access to private user data or control over the device that can negatively impact the user. Because this type of permission introduces potential risk, the system may not automatically grant it to the requesting application. For example, any dangerous permissions requested by an application may be displayed to the user and require confirmation before proceeding, or some other approach may be taken to avoid the user automatically allowing the use of such facilities. --><flagname="dangerous"value="1"/><!-- <strong>Base permission type</strong>: a permission that the system is to grant only if the requesting application is signed with the same certificate as the application that declared the permission. If the certificates match, the system automatically grants the permission without notifying the user or asking for the user's explicit approval. --><flagname="signature"value="2"/><!-- Old synonym for "signature|privileged". Deprecated in API level 23. Base permission type: a permission that the system is to grant only to packages in the Android system image <em>or</em> that are signed with the same certificates. Please avoid using this option, as the signature protection level should be sufficient for most needs and works regardless of exactly where applications are installed. This permission is used for certain special situations where multiple vendors have applications built in to a system image which need to share specific features explicitly because they are being built together. --><flagname="signatureOrSystem"value="3"/><!-- <strong>Base permission type</strong>: a permission that is managed internally by the system and only granted according to the protection flags. --><flagname="internal"value="4"/><!-- Additional flag from base permission type: this permission can also be granted to any applications installed as privileged apps on the system image. Please avoid using this option, as the signature protection level should be sufficient for most needs and works regardless of exactly where applications are installed. This permission flag is used for certain special situations where multiple vendors have applications built in to a system image which need to share specific features explicitly because they are being built together. --><flagname="privileged"value="0x10"/><!-- Old synonym for "privileged". Deprecated in API level 23. --><flagname="system"value="0x10"/><!-- Additional flag from base permission type: this permission can also (optionally) be granted to development applications. Although undocumented, the permission state used to be shared by all users (including future users), but it is managed per-user since API level 31. --><flagname="development"value="0x20"/><!-- Additional flag from base permission type: this permission is closely associated with an app op for controlling access. --><flagname="appop"value="0x40"/><!-- Additional flag from base permission type: this permission can be automatically granted to apps that target API levels below {@link android.os.Build.VERSION_CODES#M} (before runtime permissions were introduced). --><flagname="pre23"value="0x80"/><!-- Additional flag from base permission type: this permission can be automatically granted to system apps that install packages. --><flagname="installer"value="0x100"/><!-- Additional flag from base permission type: this permission can be automatically granted to system apps that verify packages. --><flagname="verifier"value="0x200"/><!-- Additional flag from base permission type: this permission can be automatically granted any application pre-installed on the system image (not just privileged apps). --><flagname="preinstalled"value="0x400"/><!-- Additional flag from base permission type: this permission can be automatically granted to the setup wizard app --><flagname="setup"value="0x800"/><!-- Additional flag from base permission type: this permission can be granted to instant apps --><flagname="instant"value="0x1000"/><!-- Additional flag from base permission type: this permission can only be granted to apps that target runtime permissions ({@link android.os.Build.VERSION_CODES#M} and above) --><flagname="runtime"value="0x2000"/><!-- Additional flag from base permission type: this permission can be granted only if its protection level is signature, the requesting app resides on the OEM partition, and the OEM has allowlisted the app to receive this permission by the OEM. --><flagname="oem"value="0x4000"/><!-- Additional flag from base permission type: this permission can be granted to privileged apps in vendor partition. --><flagname="vendorPrivileged"value="0x8000"/><!-- Additional flag from base permission type: this permission can be automatically granted to the system default text classifier --><flagname="textClassifier"value="0x10000"/><!-- Additional flag from base permission type: this permission automatically granted to device configurator --><flagname="configurator"value="0x80000"/><!-- Additional flag from base permission type: this permission designates the app that will approve the sharing of incident reports. --><flagname="incidentReportApprover"value="0x100000"/><!-- Additional flag from base permission type: this permission can be automatically granted to the system app predictor --><flagname="appPredictor"value="0x200000"/><!-- Additional flag from base permission type: this permission can also be granted if the requesting application is included in the mainline module}. --><flagname="module"value="0x400000"/><!-- Additional flag from base permission type: this permission can be automatically granted to the system companion device manager service --><flagname="companion"value="0x800000"/><!-- Additional flag from base permission type: this permission will be granted to the retail demo app, as defined by the OEM. This flag has been replaced by the retail demo role and is a no-op since Android V. --><flagname="retailDemo"value="0x1000000"/><!-- Additional flag from base permission type: this permission will be granted to the recents app. --><flagname="recents"value="0x2000000"/><!-- Additional flag from base permission type: this permission is managed by role. --><flagname="role"value="0x4000000"/><!-- Additional flag from base permission type: this permission can also be granted if the requesting application is signed by, or has in its signing lineage, any of the certificate digests declared in {@link android.R.attr#knownCerts}. --><flagname="knownSigner"value="0x8000000"/></attr>

上面xml其实也自带了相关的注释非常详细,大概意思就是protectionLevel中在xml中的只可以是上面这些,每个保护字符都是有自己的含义,具体含义可以看注释哈,这些字符都会变成一个个的int类型的数字。
比如name=“signature”,这种最后就被转换成数字2。

<flagname="signature"value="2"/>

那么数字2又被谁使用呢?这里注释中可以看看出来是PermissionInfo的getProtectionFlags方法:

/** * Return the additional flags in {@link #protectionLevel}. */@ProtectionFlagspublicintgetProtectionFlags(){returnprotectionLevel&~PROTECTION_MASK_BASE;}

protectionLevel代码部分

frameworks/base/core/java/android/content/pm/PermissionInfo.java

代表权限保护级别的变量:

/** * The level of access this permission is protecting, as per * {@link android.R.attr#protectionLevel}. Consists of * a base permission type and zero or more flags. Use the following functions * to extract them. * * <pre> * int basePermissionType = permissionInfo.getProtection(); * int permissionFlags = permissionInfo.getProtectionFlags(); * </pre> * * <p></p>Base permission types are {@link #PROTECTION_NORMAL}, * {@link #PROTECTION_DANGEROUS}, {@link #PROTECTION_SIGNATURE}, {@link #PROTECTION_INTERNAL} * and the deprecated {@link #PROTECTION_SIGNATURE_OR_SYSTEM}. * Flags are listed under {@link android.R.attr#protectionLevel}. * * @deprecated Use #getProtection() and #getProtectionFlags() instead. */@DeprecatedpublicintprotectionLevel;

一般这个变量值有以下这些:

/** * Information you can retrieve about a particular security permission * known to the system. This corresponds to information collected from the * AndroidManifest.xml's &lt;permission&gt; tags. */publicclassPermissionInfoextendsPackageItemInfoimplementsParcelable{/** * A normal application value for {@link #protectionLevel}, corresponding * to the <code>normal</code> value of * {@link android.R.attr#protectionLevel}. */publicstaticfinalintPROTECTION_NORMAL=0;/** * Dangerous value for {@link #protectionLevel}, corresponding * to the <code>dangerous</code> value of * {@link android.R.attr#protectionLevel}. */publicstaticfinalintPROTECTION_DANGEROUS=1;/** * System-level value for {@link #protectionLevel}, corresponding * to the <code>signature</code> value of * {@link android.R.attr#protectionLevel}. */publicstaticfinalintPROTECTION_SIGNATURE=2;/** * @deprecated Use {@link #PROTECTION_SIGNATURE}|{@link #PROTECTION_FLAG_PRIVILEGED} * instead. */@DeprecatedpublicstaticfinalintPROTECTION_SIGNATURE_OR_SYSTEM=3;/** * System-level value for {@link #protectionLevel}, corresponding * to the <code>internal</code> value of * {@link android.R.attr#protectionLevel}. */publicstaticfinalintPROTECTION_INTERNAL=4;/** @hide */@IntDef(flag=false,prefix={"PROTECTION_"},value={PROTECTION_NORMAL,PROTECTION_DANGEROUS,PROTECTION_SIGNATURE,PROTECTION_SIGNATURE_OR_SYSTEM,PROTECTION_INTERNAL,})@Retention(RetentionPolicy.SOURCE)public@interfaceProtection{}/** * Additional flag for {@link #protectionLevel}, corresponding * to the <code>privileged</code> value of * {@link android.R.attr#protectionLevel}. */publicstaticfinalintPROTECTION_FLAG_PRIVILEGED=0x10;/** * @deprecated Old name for {@link #PROTECTION_FLAG_PRIVILEGED}, which * is now very confusing because it only applies to privileged apps, not all * apps on the system image. */@DeprecatedpublicstaticfinalintPROTECTION_FLAG_SYSTEM=0x10;/** * Additional flag for {@link #protectionLevel}, corresponding * to the <code>development</code> value of * {@link android.R.attr#protectionLevel}. */publicstaticfinalintPROTECTION_FLAG_DEVELOPMENT=0x20;/** * Additional flag for {@link #protectionLevel}, corresponding * to the <code>appop</code> value of * {@link android.R.attr#protectionLevel}. */publicstaticfinalintPROTECTION_FLAG_APPOP=0x40;/** * Additional flag for {@link #protectionLevel}, corresponding * to the <code>pre23</code> value of * {@link android.R.attr#protectionLevel}. */publicstaticfinalintPROTECTION_FLAG_PRE23=0x80;/** * Additional flag for {@link #protectionLevel}, corresponding * to the <code>installer</code> value of * {@link android.R.attr#protectionLevel}. */publicstaticfinalintPROTECTION_FLAG_INSTALLER=0x100;/** * Additional flag for {@link #protectionLevel}, corresponding * to the <code>verifier</code> value of * {@link android.R.attr#protectionLevel}. */publicstaticfinalintPROTECTION_FLAG_VERIFIER=0x200;/** * Additional flag for {@link #protectionLevel}, corresponding * to the <code>preinstalled</code> value of * {@link android.R.attr#protectionLevel}. */publicstaticfinalintPROTECTION_FLAG_PREINSTALLED=0x400;/** * Additional flag for {@link #protectionLevel}, corresponding * to the <code>setup</code> value of * {@link android.R.attr#protectionLevel}. */publicstaticfinalintPROTECTION_FLAG_SETUP=0x800;/** * Additional flag for {@link #protectionLevel}, corresponding * to the <code>instant</code> value of * {@link android.R.attr#protectionLevel}. */publicstaticfinalintPROTECTION_FLAG_INSTANT=0x1000;/** * Additional flag for {@link #protectionLevel}, corresponding * to the <code>runtime</code> value of * {@link android.R.attr#protectionLevel}. */publicstaticfinalintPROTECTION_FLAG_RUNTIME_ONLY=0x2000;/** * Additional flag for {@link #protectionLevel}, corresponding * to the <code>oem</code> value of * {@link android.R.attr#protectionLevel}. * * @hide */@SystemApipublicstaticfinalintPROTECTION_FLAG_OEM=0x4000;/** * Additional flag for {${link #protectionLevel}, corresponding * to the <code>vendorPrivileged</code> value of * {@link android.R.attr#protectionLevel}. * * @hide */@SystemApipublicstaticfinalintPROTECTION_FLAG_VENDOR_PRIVILEGED=0x8000;/** * Additional flag for {@link #protectionLevel}, corresponding * to the <code>text_classifier</code> value of * {@link android.R.attr#protectionLevel}. * * @hide */@SystemApipublicstaticfinalintPROTECTION_FLAG_SYSTEM_TEXT_CLASSIFIER=0x10000;/** * Additional flag for {${link #protectionLevel}, corresponding * to the <code>wellbeing</code> value of * {@link android.R.attr#protectionLevel}. * * @deprecated this protectionLevel is obsolete. Permissions previously granted through this * protectionLevel have been migrated to use <code>role</code> instead * @hide */@SystemApipublicstaticfinalintPROTECTION_FLAG_WELLBEING=0x20000;/** * Additional flag for {@link #protectionLevel}, corresponding to the * {@code documenter} value of {@link android.R.attr#protectionLevel}. * * @deprecated this protectionLevel is obsolete. Permissions previously granted * through this protectionLevel have been migrated to use <code>role</code> instead * @hide */@SystemApipublicstaticfinalintPROTECTION_FLAG_DOCUMENTER=0x40000;/** * Additional flag for {@link #protectionLevel}, corresponding to the * {@code configurator} value of {@link android.R.attr#protectionLevel}. * * @hide */@SystemApipublicstaticfinalintPROTECTION_FLAG_CONFIGURATOR=0x80000;/** * Additional flag for {${link #protectionLevel}, corresponding * to the <code>incident_report_approver</code> value of * {@link android.R.attr#protectionLevel}. * * @hide */@SystemApipublicstaticfinalintPROTECTION_FLAG_INCIDENT_REPORT_APPROVER=0x100000;/** * Additional flag for {@link #protectionLevel}, corresponding * to the <code>app_predictor</code> value of * {@link android.R.attr#protectionLevel}. * * @hide */@SystemApipublicstaticfinalintPROTECTION_FLAG_APP_PREDICTOR=0x200000;/** * Additional flag for {@link #protectionLevel}, corresponding * to the <code>module</code> value of * {@link android.R.attr#protectionLevel}. * * @hide */@SystemApipublicstaticfinalintPROTECTION_FLAG_MODULE=0x400000;/** * Additional flag for {@link #protectionLevel}, corresponding * to the <code>companion</code> value of * {@link android.R.attr#protectionLevel}. * * @hide */@SystemApipublicstaticfinalintPROTECTION_FLAG_COMPANION=0x800000;/** * Additional flag for {@link #protectionLevel}, corresponding * to the <code>retailDemo</code> value of * {@link android.R.attr#protectionLevel}. * * @deprecated This flag has been replaced by the * {@link android.R.string#config_defaultRetailDemo retail demo role} and is a * no-op since {@link Build.VERSION_CODES#VANILLA_ICE_CREAM}. * * @hide */@SystemApipublicstaticfinalintPROTECTION_FLAG_RETAIL_DEMO=0x1000000;/** * Additional flag for {@link #protectionLevel}, corresponding * to the <code>recents</code> value of * {@link android.R.attr#protectionLevel}. * * @hide */@SystemApipublicstaticfinalintPROTECTION_FLAG_RECENTS=0x2000000;/** * Additional flag for {@link #protectionLevel}, corresponding to the <code>role</code> value of * {@link android.R.attr#protectionLevel}. * * @hide */@SystemApipublicstaticfinalintPROTECTION_FLAG_ROLE=0x4000000;/** * Additional flag for {@link #protectionLevel}, correspoinding to the {@code knownSigner} value * of {@link android.R.attr#protectionLevel}. * * @hide */@SystemApipublicstaticfinalintPROTECTION_FLAG_KNOWN_SIGNER=0x8000000;/** @hide */@IntDef(flag=true,prefix={"PROTECTION_FLAG_"},value={PROTECTION_FLAG_PRIVILEGED,PROTECTION_FLAG_SYSTEM,PROTECTION_FLAG_DEVELOPMENT,PROTECTION_FLAG_APPOP,PROTECTION_FLAG_PRE23,PROTECTION_FLAG_INSTALLER,PROTECTION_FLAG_VERIFIER,PROTECTION_FLAG_PREINSTALLED,PROTECTION_FLAG_SETUP,PROTECTION_FLAG_INSTANT,PROTECTION_FLAG_RUNTIME_ONLY,PROTECTION_FLAG_OEM,PROTECTION_FLAG_VENDOR_PRIVILEGED,PROTECTION_FLAG_SYSTEM_TEXT_CLASSIFIER,PROTECTION_FLAG_CONFIGURATOR,PROTECTION_FLAG_INCIDENT_REPORT_APPROVER,PROTECTION_FLAG_APP_PREDICTOR,PROTECTION_FLAG_COMPANION,PROTECTION_FLAG_RETAIL_DEMO,PROTECTION_FLAG_RECENTS,PROTECTION_FLAG_ROLE,PROTECTION_FLAG_KNOWN_SIGNER,PROTECTION_FLAG_MODULE,})

xml中值如何转换成java的protectionLevel变量,这块可以看一下如下代码:
到此就把学员关于权限的protectionLevel保护级别部分进行了全面的剖析。

原文参考:
https://mp.weixin.qq.com/s/3GNkarfoiab7akLtdtZanA

版权声明: 本文来自互联网用户投稿,该文观点仅代表作者本人,不代表本站立场。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如若内容造成侵权/违法违规/事实不符,请联系邮箱:809451989@qq.com进行投诉反馈,一经查实,立即删除!
网站建设 2026/5/25 18:09:11

10、SSH 认证机制全解析:从密码到公钥的安全之旅

SSH 认证机制全解析:从密码到公钥的安全之旅 1. SSH 密码认证开启方法 在 Windows 平台上,开启 SSH Communications 的 SSH 服务器的密码认证十分简单。通过配置菜单(开始➪程序➪SSH Secure Shell Server➪配置),能找到用户认证部分的认证选项。在用户认证部分,有诸多…

作者头像 李华
网站建设 2026/5/26 0:19:19

25、SSH应用案例解析:安全访问与数据传输方案

SSH应用案例解析:安全访问与数据传输方案 在网络安全领域,SSH(Secure Shell)协议凭借强大的加密和身份验证功能,为远程访问和数据传输提供了安全保障。本文将通过三个具体案例,深入探讨SSH在不同场景下的配置与应用。 案例一:多用途SSH服务器配置 本案例涉及两个VShe…

作者头像 李华
网站建设 2026/5/25 17:53:31

1、深入了解 SSH:功能、优势与实施指南

深入了解 SSH:功能、优势与实施指南 1. SSH 概述 Secure Shell(SSH)是一种用途广泛的实用工具,它可以被描述为协议、加密工具、客户端/服务器应用程序或命令接口。SSH 凭借其多样的服务以及安全提供这些服务的能力,成为许多企业网络中的重要组成部分。 1.1 SSH1 与 SSH…

作者头像 李华
网站建设 2026/5/25 14:43:20

17、文本处理与输入输出操作指南

文本处理与输入输出操作指南 1. 常用文本处理命令 在文本处理中,有几个常用的命令可以帮助我们完成各种任务。 1.1 tr 命令 tr 命令可以用于字符替换和文件加密。例如,在显示 MyFile 文件时,tr 可以将单词 “Halloween” 改为 “Haloween”。同时,它还能使用 ROT13 方法…

作者头像 李华