Android 15 签名权限许可名单实战：为 3 类非系统应用配置 platform 权限

Android 15 平台签名权限许可名单深度配置指南

1. 平台签名权限机制解析

在Android生态系统中，平台签名权限（signature|privileged）是保护系统关键API的核心安全机制。这类权限的特点是：

• 签名验证严格：只有使用与系统相同的密钥签名的应用才能获得授权
• 权限级别高：通常涉及设备管理、硬件控制等敏感操作
• 配置方式特殊：需要通过系统级白名单机制进行授权

Android 15对此机制进行了重要升级，引入了更精细的权限控制策略。新特性包括：

1. 动态权限回收：系统可实时撤销已授予的权限
2. 使用场景追踪：记录权限调用堆栈和触发时机
3. 分级授权模型：区分基础权限和危险权限的授权流程

<!-- 典型平台权限声明示例 --> <permission android:name="android.permission.MANAGE_USB" android:protectionLevel="signature|privileged" />

2. 三类非系统应用配置场景

2.1 OEM预装应用配置

这类应用需要与系统深度集成，典型配置流程：

1. 在Android.mk中声明签名类型：

   LOCAL_CERTIFICATE := platform

2. 添加共享用户ID声明：

   <manifest xmlns:android="http://schemas.android.com/apk/res/android" android:sharedUserId="android.uid.shared">

3. 创建权限白名单文件：

   <!-- /etc/permissions/privapp-permissions-oem.xml --> <permissions> <privapp-permissions package="com.oem.preinstalled"> <permission name="android.permission.MANAGE_DEVICE_ADMINS"/> </privapp-permissions> </permissions>

2.2 系统服务配套应用

为系统服务提供管理界面时，需特别注意：

• 必须同时配置/etc/permissions和/etc/sysconfig目录下的XML文件

• 需要处理权限继承关系：

  父权限	子权限	继承规则
  A	B	自动继承
  A	C	需显式声明

• 调试版本特殊处理：

  # 在userdebug版本中启用调试权限 adb shell setprop persist.debug.privileged_apps 1

2.3 第三方特权应用

获得OEM授权的第三方应用配置要点：

1. 使用OEM提供的扩展签名：

   java -jar signapk.jar oem.x509.pem oem.pk8 input.apk output.apk

2. 验证签名有效性：

   apksigner verify --print-certs app-signed.apk

3. 配置分段权限模型：

   <!-- 在应用清单中声明权限使用目的 --> <uses-permission android:name="android.permission.READ_PRIVILEGED_PHONE_STATE" android:usesPermissionFlags="forSecurity"/>

3. 许可名单配置实战

3.1 XML文件规范

创建/etc/permissions目录下的配置文件时，需遵循以下结构：

<permissions> <!-- 基础权限授权 --> <allow-permission package="com.privileged.app" name="android.permission.BIND_DEVICE_ADMIN"/> <!-- 特权应用声明 --> <privapp-permissions package="com.privileged.app"> <permission name="android.permission.CONTROL_DEVICE_LIGHTS"/> <permission name="android.permission.ACCESS_SURFACE_FLINGER"/> </privapp-permissions> </permissions>

关键属性说明：

• package: 必须与应用的<manifest>中声明的包名完全一致
• name: 权限名称需与框架中定义的完全匹配
• maxSdkVersion: 可指定权限适用的最大API级别

3.2 多版本兼容处理

针对不同Android版本，应采用条件配置：

<permissions> <!-- 仅对Android 15+生效 --> <allow-permission package="com.privileged.app" name="android.permission.READ_SENSOR_CALIBRATION" minSdkVersion="35"/> <!-- 兼容旧版本的替代权限 --> <allow-permission package="com.privileged.app" name="android.permission.LEGACY_SENSOR_ACCESS" maxSdkVersion="34"/> </permissions>

3.3 调试与生产环境差异

不同构建类型的处理策略：

调试技巧：

# 查看当前生效的权限配置 adb shell dumpsys package permissions

4. 验证与问题排查

4.1 安装时验证

检查安装过程中的关键日志标记：

PackageManager: Granting platform permission android.permission.MANAGE_USB to package com.privileged.app

常见错误代码对照表：

4.2 运行时验证

使用以下命令实时监控权限使用：

adb shell appops get <package_name>

4.3 签名验证工具

推荐使用Android Studio的APK分析工具：

1. 打开Build > Analyze APK...
2. 检查META-INF目录下的签名文件
3. 验证证书指纹与系统证书匹配

5. 高级配置技巧

5.1 动态权限管理

通过DevicePolicyManager动态控制权限：

DevicePolicyManager dpm = (DevicePolicyManager)context.getSystemService( Context.DEVICE_POLICY_SERVICE); dpm.setPermissionPolicy( adminName, DevicePolicyManager.PERMISSION_POLICY_AUTO_GRANT);

5.2 权限继承优化

使用<permission-tree>声明权限组：

<permission-tree name="com.enterprise.PERMISSIONS" android:icon="@drawable/perm_group" android:label="@string/permlab_group"/>

5.3 模块化权限配置

对于组件化应用，建议采用分模块配置：

/system/etc/permissions/ ├── privapp-permissions-platform.xml ├── privapp-permissions-oem.xml └── privapp-permissions-vendor.xml

6. 安全最佳实践

1. 最小权限原则：仅申请必要的权限
2. 定期审计：使用以下命令检查权限使用情况：

   adb shell dumpsys package <package_name> | grep -A10 "Granted Permissions"

3. 权限使用透明化：在应用设置中添加权限使用说明
4. 防御性编程：关键操作前验证权限有效性：

   if (checkSelfPermission(Manifest.permission.CAMERA) != PackageManager.PERMISSION_GRANTED) { throw new SecurityException("Camera permission required"); }

7. 性能优化建议

1. 延迟权限初始化：

   // 在需要时才检查权限 val hasPermission = remember { derivedStateOf { checkSelfPermission(permission) == PERMISSION_GRANTED } }

2. 权限缓存机制：

   private val permissionCache = mutableMapOf<String, Boolean>() fun checkPermissionCached(permission: String): Boolean { return permissionCache.getOrPut(permission) { checkSelfPermission(permission) == PERMISSION_GRANTED } }

3. 批量权限请求：

   requestPermissions( new String[]{ Manifest.permission.READ_CONTACTS, Manifest.permission.ACCESS_FINE_LOCATION }, REQUEST_CODE_MULTIPLE );

8. 兼容性处理

处理不同厂商ROM的差异时：

1. 检测系统特性：

   <uses-feature android:name="android.hardware.type.pc" android:required="false"/>

2. 备用实现方案：

   if (Build.MANUFACTURER.equals("Xiaomi")) { // 小米特有实现 } else if (Build.MANUFACTURER.equals("Huawei")) { // 华为特有实现 }

3. 分级降级策略：

   graph TD A[尝试标准API] -->|成功| B[正常流程] A -->|失败| C[尝试厂商扩展API] C -->|成功| D[记录兼容方案] C -->|失败| E[启用备用功能]

9. 测试验证方案

9.1 单元测试配置

在AndroidTest中添加权限验证：

@RunWith(AndroidJUnit4.class) public class PermissionTest { @Test public void verifyPlatformPermissions() { InstrumentationRegistry.getInstrumentation() .getUiAutomation() .adoptShellPermissionIdentity( "android.permission.MANAGE_USB"); // 执行需要权限的测试 } }

9.2 自动化测试脚本

使用Shell脚本批量验证：

#!/system/bin/sh for pkg in $(pm list packages -3 | cut -d: -f2); do echo "Checking $pkg" dumpsys package $pkg | grep "granted=true" done

9.3 压力测试方案

1. 权限频繁申请/释放测试
2. 多进程并发权限访问测试
3. 系统资源耗尽场景测试

10. 版本升级策略

当系统升级到Android 15时：

1. 清单合并规则变更：

   • 必须显式声明<uses-permission-sdk-m>标签
   • 权限组别需要重新评估

2. 签名证书轮换：

   # 生成新证书 ./development/tools/make_key platform-release '/C=US/ST=California/L=Mountain View/O=Android/OU=Android'

3. 兼容性测试矩阵：

   测试项	Android 14	Android 15
   权限自动授予	支持	需白名单
   动态权限回收	不支持	支持
   使用场景跟踪	部分	完整

11. 厂商定制扩展

各厂商可扩展的配置点：

1. 新增权限组：

   <permission-group android:name="com.samsung.permission-group.KEYS" android:label="@string/permgrouplab_samsung_keys" android:description="@string/permgroupdesc_samsung_keys"/>

2. 自定义授权策略：

   public class CustomPermissionPolicy extends PermissionPolicyService { @Override public boolean shouldGrantPermission(String packageName, String perm) { // 实现自定义逻辑 } }

3. 白名单动态加载：

   # 动态加载新配置 adb shell cmd package reset-permission-policies

12. 工具链集成

12.1 构建系统集成

在Soong构建系统中添加配置：

android_app { name: "PrivilegedApp", certificate: "platform", privileged: true, overrides: ["OriginalApp"], }

12.2 IDE配置技巧

Android Studio中配置签名信息：

android { signingConfigs { platform { storeFile file("platform.keystore") storePassword "android" keyAlias "platform" keyPassword "android" } } }

12.3 自定义Lint检查

创建权限使用检查规则：

public class PermissionChecker extends Detector implements Detector.UastScanner { @Override public List<String> getApplicableMethodNames() { return Collections.singletonList("checkSelfPermission"); } @Override public void visitMethodCall(JavaContext context, UCallExpression node) { // 实现检查逻辑 } }

13. 疑难问题解决

13.1 常见问题排查表

13.2 日志分析技巧

关键日志标签：

PackageManager: Permission revocation for [package] ActivityManager: Permission denial: [reason]

13.3 厂商特定问题

已知厂商差异：

• 华为EMUI：需要额外配置/vendor/etc/permissions
• 小米MIUI：需在安全中心手动授权
• 三星Knox：受MDM策略影响

14. 未来演进方向

1. 权限使用预测：基于机器学习预测权限需求
2. 临时授权令牌：限时权限访问机制
3. 硬件级隔离：利用TrustZone实现权限隔离
4. 跨设备权限同步：通过Google Play Services同步

15. 资源与参考

1. 官方文档：

   • Android权限系统
   • 特权应用指南

2. 工具下载：

   • signapk.jar
   • apksigner

3. 参考实现：

   public void checkSystemFeature() { if (!getPackageManager().hasSystemFeature( PackageManager.FEATURE_AUTOMOTIVE)) { // 处理不支持的情况 } }