uses-permission 解析

本文面向已经读过 Manifest 解析入口、四大组件解析和 PackageParser2 架构的读者。前文解释了 Manifest 标签路由和 ParsingPackage 的创建；本文聚焦 uses-permission、uses-permission-sdk-m、uses-permission-sdk-23 三个标签，追踪权限声明如何经过属性读取、子标签、SDK/feature 条件和重复检查，最终写入 PackageImpl。

本文讨论的是“Manifest 权限请求数据如何被解析和保存”，不是运行时权限授予策略的完整教程。解析阶段产生 requested permission mapping 和 implicit permission 集合；PermissionManager 后续才根据保护级别、用户状态、安装来源和策略决定是否授予。Android 17 的 ParsedUsesPermission 已包含 purpose、general-purpose 和 purposeStringResource 字段，不能只按旧版 name/flags 模型理解。

读完后，读者应能从 ParsingPackageUtils.parseBaseApkTag() 进入 parseUsesPermission()；解释 minSdk/maxSdk 和 required-feature/required-not-feature 如何让一个声明“成功解析但不加入包”；判断重复权限何时静默忽略、何时因 flags/purpose 冲突失败；还能沿 convertCompatPermissions() 和 convertSplitPermissions() 看懂隐式权限从何而来。

1. 权限数据流

1.1 三个阶段

源码文件：

frameworks/base/core/java/com/android/internal/pm/pkg/parsing/ParsingPackageUtils.java
frameworks/base/core/java/com/android/internal/pm/pkg/component/ParsedUsesPermission.java
frameworks/base/core/java/com/android/internal/pm/parsing/pkg/PackageImpl.java

阶段	owner	数据	消费者
Manifest parse	ParsingPackageUtils	name、flags、purpose、feature 条件	PackageImpl.addUsesPermission
兼容转换	ParsingPackageUtils	implicitPermissions	权限查询/安装策略
安装后权限	PermissionManager	requested permissions、用户 grant	ApplicationInfo/权限检查

解析成功只表示 parser 没有错误。SDK/feature 不满足时，方法也返回 success，但不调用 addUsesPermission()；重复声明且字段一致时同样返回 success。只有结构错误或同名声明字段冲突才返回 ParseResult error。

1.2 标签变体

parseBaseApkTag() 把三个标签变体路由到同一个方法；后缀不再单独决定逻辑，当前资源 SDK、feature callback、flags 和子标签才决定最终结果。

2. 数据模型

2.1 权限接口

源码文件：frameworks/base/core/java/com/android/internal/pm/pkg/component/ParsedUsesPermission.java

java

public interface ParsedUsesPermission {
    int FLAG_NEVER_FOR_LOCATION = PackageInfo.REQUESTED_PERMISSION_NEVER_FOR_LOCATION;
    int FLAG_ONLY_FOR_LOCATION_BUTTON = PackageInfo.REQUESTED_PERMISSION_ONLY_FOR_LOCATION_BUTTON;

    @UsesPermissionFlags
    int getUsesPermissionFlags();
    @NonNull String getName();
    @NonNull Set<String> getPurposes();
    @NonNull Set<String> getGeneralPurposes();
    int getPurposeStringResource();
}

Android 17 有 NEVER_FOR_LOCATION 和 ONLY_FOR_LOCATION_BUTTON 两个 permission flags，并保存 purpose、general-purpose 和 purpose string resource。feature flag 关闭时，相关字段通常为空或 0，但接口仍保留完整模型。

2.2 实现类

源码文件：frameworks/base/core/java/com/android/internal/pm/pkg/component/ParsedUsesPermissionImpl.java

java

@DataClass(genGetters = true, genSetters = true, genBuilder = false,
        genParcelable = true, genAidl = false)
public class ParsedUsesPermissionImpl implements ParsedUsesPermission, Parcelable {
    @DataClass.ParcelWith(Parcelling.BuiltIn.ForInternedString.class)
    @NonNull private String name;
    private int usesPermissionFlags;
    private int purposeStringResource;
    @DataClass.ParcelWith(Parcelling.BuiltIn.ForStringSet.class)
    @NonNull private Set<String> purposes;
    @DataClass.ParcelWith(Parcelling.BuiltIn.ForStringSet.class)
    @NonNull private Set<String> generalPurposes;

    public ParsedUsesPermissionImpl(@NonNull String name, int usesPermissionFlags,
            int purposeStringResource, @NonNull Set<String> purposes,
            @NonNull Set<String> generalPurposes) {
        this.name = name;
        this.usesPermissionFlags = usesPermissionFlags;
        this.purposeStringResource = purposeStringResource;
        this.purposes = purposes;
        this.generalPurposes = generalPurposes;
    }
}

实现类可 Parcelable 化，权限名使用 interned string，purpose 集合使用 StringSet parcelling。Manifest 语义校验不在构造函数中完成，而由 parseUsesPermission 负责。

2.3 PackageImpl 存储

源码文件：frameworks/base/core/java/com/android/internal/pm/parsing/pkg/PackageImpl.java

java

@NonNull
private Map<String, ParsedUsesPermission> usesPermissionMapping = emptyMap();
@NonNull
private Set<String> implicitPermissions = emptySet();

@Override
public PackageImpl addUsesPermission(ParsedUsesPermission permission) {
    // Duplicate requests were resolved during parsing.
    usesPermissionMapping = CollectionUtils.add(usesPermissionMapping,
            permission.getName(), permission);
    return this;
}

@Override
public PackageImpl addImplicitPermission(String permission) {
    addUsesPermission(new ParsedUsesPermissionImpl(permission, 0, 0,
            emptySet(), emptySet()));
    implicitPermissions = CollectionUtils.add(implicitPermissions,
            TextUtils.safeIntern(permission));
    return this;
}

@Override
public Set<String> getRequestedPermissions() {
    return usesPermissionMapping.keySet();
}

权限名 map 让 effective requested permissions 天然去重；implicit permission 同时进入 mapping 和独立集合，消费者可以区分 Manifest 显式请求与兼容性转换结果。