Android Management SDK 版本说明

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

最近更新时间

稳定版 候选版
2026 年 8 月 12 日 1.8.3

声明依赖项

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

repositories {
  ...
  google()
}

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

dependencies {
    def amapi_version = "1.8.3"

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

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

版本 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 设备政策应用安装过程中的可靠性和错误报告。
  • 增强了环境准备流程，以提高 Google Play 商店更新期间的兼容性和可靠性。

版本 1.8.0

2026 年 4 月 15 日

此版本引入了对 OEM 合作伙伴的支持，允许 OEM 的无线下载 (OTA) 客户端与 Android Device Policy (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 Device Policy (ADP) 应用来简化设备注册。
  • 提升了稳定性和性能，并在设备信任例外情况中提供了更多信息；请参阅 AmapiSdkException。

版本 1.5.0-rc01

2025 年 7 月 24 日

此版本针对自定义设备政策控制器 (DPC) 引入了改进的设备注册流程。这种简化的方法使用 AMAPI SDK 和 Android Device Policy (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 日

此版本包含 Android Enterprise 的第一个设备信任候选版本。

版本 1.1.5

2024 年 5 月 13 日

此版本包含以下更新：

  • 修复了多个 bug 并进行了一些内部改进。

版本 1.1.4

2024 年 1 月 24 日

此版本包含以下更新：

版本 1.0.1

2022 年 2 月 15 日

此版本包含以下更新：

  • 修复了 bug 并进行了内部改进。

版本 1.0.0

2021 年 9 月 20 日

此版本包含以下更新：

  • 初始版本。