Android Management SDK 版本说明

Android Management SDK (AMAPI SDK) 发布流程可能包含候选版本阶段，作为标准发布流程的一部分。

最近更新时间

稳定版 候选版
2026 年 10 月 28 日 1.9.0

声明依赖项

如需添加 AMAPI SDK 的依赖项，您必须将 Google Maven 仓库添加到项目中：

repositories {
  ...
  google()
}

在应用或模块的 build.gradle 文件中添加所需工件的依赖项：

dependencies {
    def amapi_version = "1.9.0"

    implementation "com.google.android.libraries.enterprise.amapi:amapi:$amapi_version"
}

如需详细了解依赖项，请参阅添加 build 依赖项。

版本 1.9.0

2026 年 10 月 28 日

此版本包含以下更新：

版本 1.8.4

2026 年 9 月 10 日

此版本包含以下更新：

  • 更新了 SDK 传递依赖项，使其与 Kotlin 2.4.0 兼容。 此版本修复了在应用角色通知期间发生的崩溃问题，该问题影响 v1.8.2 和 v1.8.3，当集成应用未指定 kotlinx-coroutines-core 1.11.0 或更高版本时会出现此问题。

  • 阐明了 Instruction.InstructionType#FORCE 的文档。

版本 1.8.3

2026 年 8 月 12 日

此版本包含以下更新：

  • 修复了以下问题：如果客户端进程在环境准备成功后重启，则在使用 DEVICE_POLICY_CONTROLLER 角色时，SDK 可能会返回过时的“已安装但未准备就绪”状态。
  • 支持的最低 Android API 级别现在为 24（之前为 23）。

1.8.2 版

2026 年 7 月 15 日

此版本包含以下更新：

  • 修复了以下问题：调用 prepareEnvironment 可能会导致无法将 Google Play 商店更新到所需版本，从而导致 Android 设备政策安装失败。

1.8.1 版

2026 年 6 月 2 日

此版本包含以下更新：

  • 提高了 Android Device Policy 应用安装过程中的可靠性，并改进了错误报告。
  • 增强了环境准备流程，以提高 Google Play 商店更新期间的兼容性和可靠性。

版本 1.8.0

2026 年 4 月 15 日

此版本引入了对原始设备制造商 (OEM) 合作伙伴的支持，使原始设备制造商 (OEM) 的无线下载 (OTA) 客户端能够与 Android 设备政策 (ADP) 应用就系统更新进行双向通信。

此版本包含以下更新：

  • 添加 OemSystemUpdateClient 接口，以便 OEM OTA 客户端向 ADP 告知更新并查询指令。该接口包含以下方法：
    • 创建、获取和列出系统更新（例如 createSystemUpdate、getSystemUpdate、listSystemUpdates）。
    • 报告更新过程的各个阶段（例如 reportSystemUpdateDownloading、reportSystemUpdateDownloaded、reportSystemUpdateApplied、reportSystemUpdateAborted）。
    • 报告在覆盖 AMAPI 指令或无法遵守这些指令时采取的操作（例如 reportSystemUpdateDownloadingWithOverride、reportSystemUpdateDownloadPrevented）。
    • 管理和查询更新控制状态（例如 updateUpdateControlState、getUpdateControlState）。
  • 添加 OemSystemUpdateHandler 接口，OEM OTA 客户端必须实现该接口才能接收来自 ADP 的回调。其中包括：
    • onSystemUpdatesChanged：将更新指令的更改通知 OEM 客户端。
    • listPendingSystemUpdates：由 ADP 调用，用于请求待处理更新的列表。
    • getUpdateControlState：由 ADP 调用，用于检索 OEM 客户端的当前更新控制状态。

版本 1.7.1

2026 年 1 月 19 日

此版本包含以下更新：

  • 修复了以下 bug：在使用 DEVICE_POLICY_CONTROLLER 角色时，应用无法在 Android 8 或更低版本上调用 prepareEnvironment。其他角色仍需要 Android 10 或更高版本。
  • 改进了日志记录功能，以便更好地进行诊断。我们建议合作伙伴采用此版本。

版本 1.7.0

2025 年 11 月 3 日

此版本包含以下更新：

  • 向可用的设备信任信号添加 ManagementProviderInfo，其中包含管理提供商的人类可读商家名称。
  • 引入 REQUEST_DEVICE_INFO 命令，以允许 DPC 应用读取设备 EID。使用 RequestDeviceInfo 类型调用 IssueCommandRequest，并将 DeviceInfo.EID 指定为所请求的设备标识符。
  • 更新依赖项以修复 CVE-2023-2976。

版本 1.7.0-rc01

2025 年 9 月 29 日

此版本包含以下更新：

  • 向可用的设备信任信号添加 ManagementProviderInfo，其中包含管理提供商的人类可读商家名称。
  • 引入 REQUEST_DEVICE_INFO 命令，以允许 DPC 应用读取设备 EID。使用 RequestDeviceInfo 类型调用 IssueCommandRequest，并将 DeviceInfo.EID 指定为所请求的设备标识符。

版本 1.6.0

2025 年 9 月 11 日

此版本包含以下更新：

版本 1.6.0-rc01

2025 年 8 月 28 日

此版本包含以下更新：

版本 1.5.0

2025 年 8 月 11 日

此版本包含以下更新：

  • 改进了自定义设备政策控制器 (DPC) 的设备注册流程。 这种简化的方法使用 AMAPI SDK 和 Android 设备政策 (ADP) 应用来简化设备注册。
  • 提升了稳定性和性能，并在设备信任例外情况中提供了更多信息；请参阅 AmapiSdkException。

版本 1.5.0-rc01

2025 年 7 月 24 日

此版本为自定义设备政策控制器 (DPC) 引入了改进的设备注册流程。这种简化的方法使用 AMAPI SDK 和 Android 设备政策 (ADP) 应用来简化设备注册。

版本 1.4.0

2025 年 6 月 18 日

此版本包含 Device.WorkProfileState 信号，用于识别设备管理状态。

与 v1.4.0-rc01 相比没有变化。

版本 1.4.0-rc01

2025 年 6 月 2 日

此版本包含 Device.WorkProfileState 信号，用于识别设备管理状态。

版本 1.3.0

2025 年 4 月 14 日

此版本包含 Device Trust from Android Enterprise 的第一个版本。

与 v1.3.0-rc01 相比没有任何变化。

版本 1.3.0-rc01

2025 年 2 月 18 日

此版本包含 Device Trust from Android Enterprise 的第一个候选版本。

版本 1.1.5

2024 年 5 月 13 日

此版本包含以下更新：

  • 问题修复和内部改进。

1.1.4 版

2024 年 1 月 24 日

此版本包含以下更新：

版本 1.0.1

2022 年 2 月 15 日

此版本包含以下更新：

  • 问题修复和内部改进。

版本 1.0.0

2021 年 9 月 20 日

此版本包含以下更新：

  • 初始版本。