Esquema para paquetes de metadatos de app

从 Android 14 开始，Android 软件包安装程序可以提取有关应用的元数据（例如数据安全做法），以用于 Android 平台功能（例如更新后的位置信息权限提示）。

您可以通过以下两种方式提供此元数据：

• 对于预加载到系统映像的应用，设备制造商可以使用下文所述的可持久化软件包将 XML 文件添加到系统映像，从而提供应用的相关元数据。

• 对于正在安装或更新的应用，如需指定此元数据，应用安装程序应将 PersistableBundle 对象传入 setAppMetadata() 方法。

注意 ：您还可以将 null 或 PersistableBundle.EMPTY 传入 setAppMetadata()。在这些情况下，系统会假定没有可用的应用元数据。

顶级持久化软件包由以下键值对组成。除非另有说明，否则每个键都是可选的。

重要提示 ：所有键都应采用小写形式。

version（必需）

应用元数据格式的版本号。使用 2 作为此当前版本的值，并使用 long 作为类型。如果预期的键或 AppMetadata 内容类型发生变化，Android 会更改版本号。

safety_labels

一个 PersistableBundle 对象，用于指定应用的安全标签。

system_app_safety_label

一个 PersistableBundle 对象，用于指定应用的系统应用安全标签。对于充当系统服务的应用，请使用 system_app_safety_label 软件包，而不是 safety_labels 软件包。

transparency_info

一个 PersistableBundle 对象，用于指定应用的透明度信息。

安全标签格式

safety_labels 软件包包含以下键值对：

注意：您还可以将 null 或 PersistableBundle.EMPTY 传入 safety_labels。在这些情况下，系统会假定没有可显示的信息。

version（必需）

安全标签格式的版本号。使用 1 作为此当前版本的值，并使用 long 作为类型。

data_labels

一个 PersistableBundle 对象，用于指定应用收集和分享的数据。

security_labels

一个 PersistableBundle 对象，用于指定应用的数据删除和加密做法。

third_party_verification

一个 PersistableBundle 对象，用于指定应用的数据安全做法如何由第三方验证。

收集和分享的数据

data_labels 软件包包含以下键值对：

注意：您还可以将 null 或 PersistableBundle.EMPTY 传入 data_labels。在这些情况下，系统会假定没有可显示的信息。

data_collected

一个 PersistableBundle 对象，用于指定应用收集的数据类型。

data_shared

一个 PersistableBundle 对象，用于指定应用分享的数据类型。

数据类别

data_collected 和 data_shared 键都使用 data_category 软件包格式，其中包含以下列表中所示的键值对。每个键都会映射到一个 PersistableBundle 对象，该对象可为特定类别指定数据类型。

注意 ：您还可以将 null 或 PersistableBundle.EMPTY 传入 data_collected 和 data_shared。在这些情况下，系统会假定不收集或共享数据类别。

• personal
• financial
• location
• email_text_message
• photo_video
• audio
• storage
• health_fitness
• contacts
• calendar
• identifiers
• app_performance
• actions_in_app
• search_and_browsing

数据类型

data_category 软件包中的每个键都会映射到使用 data_type 格式的不同软件包。您以 data_type 格式指定的键取决于您为 data_category 选择的内容。

可能的 data_type 键值对会显示在以下列表中。其中每个键的值都是一个 PersistableBundle 对象，用于描述应用针对该特定数据类型的数据使用做法。某些数据类型仅使用一个键。

个人

• name
• email_address
• physical_address
• phone_number
• race_ethnicity
• political_or_religious_beliefs
• sexual_orientation_or_gender_identity
• personal_identifiers
• other

金融

• card_bank_account
• purchase_history
• credit_score
• other

位置信息

• approx_location
• precise_location

电子邮件和短信

• emails
• text_messages
• other

照片和视频

• photos
• videos

音频

• sound_recordings
• music_files
• other

存储

files_docs

健康健身

• health
• fitness

通讯录

contacts

日历

calendar

标识符

other

应用性能

• crash_logs
• performance_diagnostics
• other

应用内操作

• user_interaction
• in_app_search_history
• installed_apps
• user_generated_content
• other

搜索和浏览

web_browsing_history

数据使用

data_usage 软件包包含以下键值对：

purposes（必填）

一个整数数组，表示收集或共享数据的具体原因，使用 PersistableBundle putIntArray 方法。每个软件包至少需要下面定义的一种用途。

• 1：PURPOSE_APP_FUNCTIONALITY
• 2：PURPOSE_ANALYTICS
• 3：PURPOSE_DEVELOPER_COMMUNICATIONS
• 4：PURPOSE_FRAUD_PREVENTION_SECURITY
• 5：PURPOSE_ADVERTISING
• 6：PURPOSE_PERSONALIZATION
• 7：PURPOSE_ACCOUNT_MANAGEMENT

is_collection_optional

布尔值。指定用户能否选择启用或停用数据收集。

注意 ：请仅为表示数据收集的 data_category 软件包设置此值；请勿将其用于数据共享。

ephemeral

布尔值。指定应用是否仅在内存中而不是磁盘上处理服务器端数据，并且应用保留数据的时间不会超过处理特定数据处理请求所需的时间。

注意 ：请仅为表示数据收集的 data_category 软件包设置此值；请勿将其用于数据共享。

数据删除和加密做法

security_labels 软件包中包含表示应用的数据删除和加密做法的键值对：

注意：您还可以将 null 或 PersistableBundle.EMPTY 传入 security_labels。在这些情况下，系统会假定没有信息。

is_data_deletable

布尔值。指定应用是否允许用户请求应用删除其用户数据。

is_data_encrypted

布尔值。指定应用收集的所有用户数据在传输过程中是否会加密。

第三方验证

third_party_verification 软件包由单个键 url 组成。此网址以字符串值表示，指定了用于验证应用的数据安全信息的第三方网站。

系统服务安全标签格式

对于充当系统服务的应用，会使用 system_app_safety_label 软件包（而非 safety_labels 软件包），并包含以下键值对：

注意：您还可以将 null 或 PersistableBundle.EMPTY 传入 system_app_safety_label。在这些情况下，系统会假定没有信息。

url（必需）

• 指向包含相关应用（作为系统服务应用）安全信息的页面的网址。
• 使用 string 作为类型。
• 如果未提供，则应使用隐私权政策网址作为后备网址。
• 注意：Google Play 商店使用 privacy_policy 作为后备选项。

透明度信息格式

注意：您还可以将 null 或 PersistableBundle.EMPTY 传入 transparency_info。在这些情况下，系统会假定没有信息。

transparency_info 软件包包含以下键值对：

developer_info

一个 PersistableBundle 对象，用于指定应用开发者的相关信息。

app_info

一个 PersistableBundle 对象，用于指定应用相关信息。

开发者信息

注意：您还可以将 null 或 PersistableBundle.EMPTY 传入 developer_info。在这些情况下，系统会假定没有信息。

developer_info 软件包包含以下键值对：

developer_#

一个用于标识开发者的 PersistableBundle 对象。developer_info 包含一个或多个 developer_#，其中 # 为整数。例如 developer_0、developer_1、developer_2 等。

开发者

注意：您还可以将 null 或 PersistableBundle.EMPTY 传入 developer_#。在这些情况下，系统会假定没有信息。

developer_# 软件包包含以下键值对：

name（必需）

指明开发者名称的字符串。

email（必需）

表示开发者电子邮件地址的字符串。

address（必需）

一个字符串，表示开发者的邮寄地址。

country_region（必需）

一个字符串，用于说明开发者所在的国家/地区。

website

一个字符串，用于说明开发者的网站。

app_registry

• 说明开发者的商店或注册表的字符串。
• 如果开发者还在商店或其他注册表中注册，该值应为商店的 Android 软件包名称或注册表的网址。
• 允许为多个商店设置多个条目。
• 对于 Google Play，请使用 com.android.vending。
• 如果开发者是 Google Play SDK 索引中列出的 SDK，请省略此属性。
• 如果开发者未在任何应用商店或注册表中注册，请省略此属性。

app_registry_id

• 一个字符串，用于说明所声明 app_registry 的开发者 ID。
• 如果开发者还在商店或其他注册表中注册，则此值应为其商店或注册表身份。
• 允许为多个商店设置多个条目。
• 对于在 Google Play 中注册的开发者，此值必须是开发者页面的网址（例如，https://play.google.com/store/apps/dev?id=5700313618786177705 是开发者 Google LLC 的网址）。
• 如果开发者是 Google Play SDK 索引中列出的 SDK 开发者，请使用该 SDK 的 Google Play SDK 索引网址（例如，https://play.google.com/sdks/details/com-google-android-gms-play-services-ads 是 Google 移动广告 (GMA) SDK 的 Google Play SDK 索引网址）。
• 如果开发者是在其他商店或注册表中注册的，可以提供应用商店网址或其他标识符。
• 如果开发者未在任何应用商店中注册，则可以省略此属性。

应用信息

app_info 软件包包含以下键值对：

title（必需）

一个声明应用名称的字符串。

description（必需）

一个字符串，以人类可读的英语 blob 表示应用的用途。

contains_ads（必需）

一个布尔值，声明应用是否会展示任何广告。

privacy_policy（必需）

• 一个字符串，其中包含指向隐私权政策（详细说明了用户数据的处理方式）的网址属性。
• 对于传输用户数据的应用而言是必需的。
• 如果应用不包含此链接，则系统会假定应用不处理用户数据。

category（必需）

一个字符串，包含以下其中一个应用类别，最能准确描述应用的主要用途：

• Android（仅适用于 AOSP 组件）*
• 艺术与设计
• 汽车与交通工具
• 美容时尚
• 图书与工具书
• 商家
• 漫画
• 通信
• 交友
• 教育
• 娱乐
• 事件
• 财经
• 饮食
• 游戏
• 健康与健身
• 家居
• 安装程序（仅适用于应用商店或其他安装程序）*
• 媒体库与演示
• 生活方式
• 地图与导航
• 医疗
• 音乐和音频
• 新闻与杂志
• 育儿
• 个性化
• 摄影
• 效率
• 安全性*
• 带货
• 社交
• 体育
• 工具
• 旅行与本地出行
• 更新程序（仅适用于设备的默认无线下载 (OTA) 更新应用）*
• 视频播放器和编辑器
• 天气

注意 ：标有星号* 的类别未在 Google Play 商店中提供，这些类别仅适用于预加载的应用。

contact_info

一个 PersistableBundle 对象，其中包含应用的联系信息（见下文）。

联系信息

contact_info 软件包包含以下键值对：

email（必需）

一个字符串，用于说明应用的电子邮件地址。

website

一个字符串，用于说明应用的网站。