บันทึกประจำรุ่นของ Android Management SDK

กระบวนการเผยแพร่ Android Management SDK (AMAPI SDK) อาจรวมถึงระยะรุ่นที่อาจได้รับการเผยแพร่ซึ่งเป็นส่วนหนึ่งของกระบวนการเผยแพร่มาตรฐาน

ประเด็นสำคัญ: รุ่นที่อาจได้รับการเผยแพร่คือรุ่นที่คาดว่าจะมีการเผยแพร่ซึ่งใช้แพลตฟอร์ม API เวอร์ชันสุดท้าย

อัปเดตล่าสุด

	รุ่นที่เสถียร	รุ่นที่อาจได้รับการเผยแพร่
28 ตุลาคม 2026	1.9.0

ประกาศทรัพยากร Dependency

หากต้องการเพิ่มทรัพยากร Dependency ใน AMAPI SDK คุณต้องเพิ่มที่เก็บ Maven ของ Google ลงในโปรเจ็กต์ โดยทำดังนี้

repositories {
  ...
  google()
}

เพิ่มทรัพยากร Dependency สำหรับอาร์ติแฟกต์ที่ต้องการในไฟล์ build.gradle สำหรับแอปหรือโมดูล ดังนี้

dependencies {
    def amapi_version = "1.9.0"

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

ดูข้อมูลเพิ่มเติมเกี่ยวกับการขึ้นต่อกันได้ที่เพิ่มการขึ้นต่อกันของบิลด์

ประเด็นสำคัญ: ใช้ไลบรารีเวอร์ชันเสถียรล่าสุดที่มีอยู่เสมอเพื่อรับประโยชน์จากการแก้ไขข้อบกพร่องและการปรับปรุงที่มี

เวอร์ชัน 1.9.0

28 ตุลาคม 2026

เวอร์ชันนี้มีการอัปเดตต่อไปนี้

• เพิ่มอินเทอร์เฟซ PolicyClient และ Policy.UnifiedUpdatePolicy เพื่ออนุญาตให้เครื่องมือควบคุมนโยบายด้านอุปกรณ์ (DPC) ที่กำหนดเองสามารถกำหนดค่า ดึงข้อมูล และล้างนโยบายการควบคุมการอัปเดตแบบรวม (UUC) ในอุปกรณ์ของบริษัทผ่านแอป Android Device Policy (ADP) ดูหัวข้อกำหนดค่าการควบคุมการอัปเดตแบบรวมด้วย AMAPI SDK
• เปิดตัวคำสั่ง Wipe ในเครื่อง (IssueCommandRequest.Wipe) และความสามารถพิเศษ LOCAL_DEVICE_WIPE_COMMAND_ALLOWED (Role.ExtraCapabilities) ซึ่งช่วยให้แอปที่ใช้ร่วมกันซึ่งได้รับมอบหมายบทบาท COMPANION_APP สามารถล้างข้อมูลอุปกรณ์ของบริษัทหรือโปรไฟล์งานในอุปกรณ์ส่วนตัวในเครื่องได้ ดูแอปส่วนขยายและคำสั่งภายในและจัดการบทบาทของแอปพลิเคชัน
• แก้ไขปัญหาที่การสื่อสารกับแอป Android Device Policy อาจล้มเหลวโดยมีข้อผิดพลาด PERMISSION_DENIED (เช่น ทันทีหลังจากลงทะเบียนอุปกรณ์หรืออัปเดตบริการ Google Play) จนกว่าอุปกรณ์หรือแอปไคลเอ็นต์จะรีสตาร์ท
• ชี้แจงเอกสารประกอบเกี่ยวกับข้อยกเว้นและการลบล้างสำหรับ OemSystemUpdateClient และ OemSystemUpdateHandler

เวอร์ชัน 1.8.4

10 กันยายน 2569

เวอร์ชันนี้มีการอัปเดตต่อไปนี้

• อัปเดตทรัพยากร Dependency แบบสกรรมกริยาของ SDK ให้เข้ากันได้กับ Kotlin 2.4.0 การดำเนินการนี้จะแก้ไขข้อขัดข้องที่เกิดขึ้นระหว่างการแจ้งเตือนบทบาทของแอปพลิเคชัน ซึ่งส่งผลต่อ v1.8.2 และ v1.8.3 เมื่อแอปที่ผสานรวมไม่ได้ระบุ kotlinx-coroutines-core 1.11.0 ขึ้นไป

• ชี้แจงเอกสารประกอบสำหรับ Instruction.InstructionType#FORCE

เวอร์ชัน 1.8.3

12 สิงหาคม 2569

เวอร์ชันนี้มีการอัปเดตต่อไปนี้

• แก้ไขปัญหาที่ SDK อาจแสดงสถานะ "ติดตั้งแล้วแต่ยังไม่พร้อม" ที่ล้าสมัยเมื่อใช้บทบาท DEVICE_POLICY_CONTROLLER หากกระบวนการของไคลเอ็นต์รีสตาร์ทหลังจากเตรียมสภาพแวดล้อมเสร็จสมบูรณ์
• ตอนนี้ระดับ API ขั้นต่ำของ Android ที่รองรับคือ 24 (เพิ่มขึ้นจาก 23)

เวอร์ชัน 1.8.2

15 กรกฎาคม 2569

เวอร์ชันนี้มีการอัปเดตต่อไปนี้

• แก้ไขปัญหาที่การเรียกใช้ prepareEnvironment อาจอัปเดต Google Play Store เป็นเวอร์ชันที่จำเป็นไม่สำเร็จ ซึ่งทำให้ติดตั้งนโยบายด้านอุปกรณ์ Android ไม่สำเร็จ

เวอร์ชัน 1.8.1

2 มิถุนายน 2026

เวอร์ชันนี้มีการอัปเดตต่อไปนี้

• ปรับปรุงความเสถียรและการรายงานข้อผิดพลาดระหว่างกระบวนการติดตั้งแอป Android Device Policy
• ปรับปรุงขั้นตอนการเตรียมสภาพแวดล้อมเพื่อเพิ่มความเข้ากันได้และความน่าเชื่อถือระหว่างการอัปเดต Google Play Store

เวอร์ชัน 1.8.0

15 เมษายน 2026

เวอร์ชันนี้เปิดตัวการรองรับคู่ค้า OEM ซึ่งช่วยให้ไคลเอ็นต์ Over-the-Air (OTA) ของ OEM สื่อสารแบบ 2 ทางกับแอปนโยบายด้านอุปกรณ์ Android (ADP) เกี่ยวกับการอัปเดตระบบได้

เวอร์ชันนี้มีการอัปเดตต่อไปนี้

• เพิ่มอินเทอร์เฟซ OemSystemUpdateClient ซึ่งช่วยให้ไคลเอ็นต์ OTA ของ OEM แจ้ง ADP เกี่ยวกับการอัปเดตและค้นหาคำสั่งได้ อินเทอร์เฟซประกอบด้วยเมธอดต่อไปนี้
  • สร้าง รับ และแสดงรายการการอัปเดตระบบ (เช่น createSystemUpdate, getSystemUpdate, listSystemUpdates)
  • รายงานขั้นตอนต่างๆ ของกระบวนการอัปเดต (เช่น reportSystemUpdateDownloading, reportSystemUpdateDownloaded, reportSystemUpdateApplied, reportSystemUpdateAborted)
  • รายงานการดำเนินการที่เกิดขึ้นเมื่อลบล้างคำสั่ง AMAPI หรือเมื่อถูกขัดขวางไม่ให้ปฏิบัติตามคำสั่ง (เช่น reportSystemUpdateDownloadingWithOverride, reportSystemUpdateDownloadPrevented)
  • จัดการและค้นหาสถานะการควบคุมการอัปเดต (เช่น updateUpdateControlState, getUpdateControlState)
• เพิ่มอินเทอร์เฟซ OemSystemUpdateHandler ซึ่งไคลเอ็นต์ OTA ของ OEM ต้องติดตั้งใช้งานเพื่อรับ Callback จาก ADP ซึ่งรวมถึงสิ่งต่างๆ ต่อไปนี้
  • onSystemUpdatesChanged: แจ้งเตือนไคลเอ็นต์ OEM เกี่ยวกับการเปลี่ยนแปลงวิธีการอัปเดต
  • listPendingSystemUpdates: ADP เรียกใช้เพื่อขอรายการอัปเดตที่รอดำเนินการ
  • getUpdateControlState: ADP เรียกใช้เพื่อดึงข้อมูลสถานะการควบคุมการอัปเดตปัจจุบันของไคลเอ็นต์ OEM

หมายเหตุ: ขณะนี้ ADP จะไม่ดำเนินการตามคำขอจากพาร์ทเนอร์ OEM เนื่องจากคาดว่าฟังก์ชันการทำงานของแพลตฟอร์มที่เกี่ยวข้องจะเปิดตัวพร้อมกับ Android 17 อย่างไรก็ตาม พาร์ทเนอร์สามารถเริ่มผสานรวมกับฟีเจอร์นี้ได้เลย เนื่องจากไม่จำเป็นต้องทำการเปลี่ยนแปลงใดๆ เมื่อฟีเจอร์ได้รับการรองรับอย่างเต็มรูปแบบ

เวอร์ชัน 1.7.1

19 มกราคม 2026

เวอร์ชันนี้มีการอัปเดตต่อไปนี้

• แก้ไขข้อบกพร่องที่ทำให้แอปพลิเคชันเรียกใช้ prepareEnvironment ใน Android 8 หรือต่ำกว่าไม่ได้เมื่อใช้บทบาท DEVICE_POLICY_CONTROLLER บทบาทอื่นๆ ยังคงต้องใช้ Android 10 ขึ้นไป
• ปรับปรุงการบันทึกเพื่อให้การวินิจฉัยดีขึ้น เราขอแนะนำให้พาร์ทเนอร์ใช้เวอร์ชันนี้

เวอร์ชัน 1.7.0

3 พฤศจิกายน 2025

เวอร์ชันนี้มีการอัปเดตต่อไปนี้

• เพิ่ม ManagementProviderInfo ลงในสัญญาณความน่าเชื่อถือของอุปกรณ์ที่ใช้ได้ ซึ่งมีชื่อธุรกิจที่มนุษย์อ่านได้ของผู้ให้บริการการจัดการ
• เปิดตัวคำสั่ง REQUEST_DEVICE_INFO เพื่ออนุญาตให้แอป DPC อ่าน EID ของอุปกรณ์ เรียกใช้ IssueCommandRequest ด้วยประเภท RequestDeviceInfo และระบุ DeviceInfo.EID เป็นตัวระบุอุปกรณ์ที่ขอ
• อัปเดตทรัพยากร Dependency เพื่อแก้ไข CVE-2023-2976

เวอร์ชัน 1.7.0-rc01

29 กันยายน 2025

เวอร์ชันนี้มีการอัปเดตต่อไปนี้

• เพิ่ม ManagementProviderInfo ลงในสัญญาณความน่าเชื่อถือของอุปกรณ์ที่ใช้ได้ ซึ่งมีชื่อธุรกิจที่มนุษย์อ่านได้ของผู้ให้บริการการจัดการ
• เปิดตัวคำสั่ง REQUEST_DEVICE_INFO เพื่ออนุญาตให้แอป DPC อ่าน EID ของอุปกรณ์ เรียกใช้ IssueCommandRequest ด้วยประเภท RequestDeviceInfo และระบุ DeviceInfo.EID เป็นตัวระบุอุปกรณ์ที่ขอ

เวอร์ชัน 1.6.0

11 กันยายน 2025

เวอร์ชันนี้มีการอัปเดตต่อไปนี้

• เปิดโอกาสให้ EMM ที่ใช้ Android Management API ติดตั้งแอปพลิเคชันที่กำหนดเองได้ ดูหัวข้อจัดการแอปที่กำหนดเองด้วย AMAPI
• เปิดตัวระบบใหม่เพื่อมอบหมายบทบาทให้กับแอปพลิเคชัน โปรดดูหัวข้อจัดการบทบาทของแอปพลิเคชัน
• เพิ่ม minSDK เป็น API ระดับ 23

เวอร์ชัน 1.6.0-rc01

28 สิงหาคม 2025

เวอร์ชันนี้มีการอัปเดตต่อไปนี้

• เปิดโอกาสให้ EMM ที่ใช้ Android Management API ติดตั้งแอปพลิเคชันที่กำหนดเองได้ ดูหัวข้อจัดการแอปที่กำหนดเองด้วย AMAPI
• เพิ่ม minSDK เป็น API ระดับ 23

เวอร์ชัน 1.5.0

11 สิงหาคม 2025

เวอร์ชันนี้มีการอัปเดตต่อไปนี้

• ปรับปรุงขั้นตอนการลงทะเบียนอุปกรณ์สำหรับเครื่องมือควบคุมนโยบายด้านอุปกรณ์ (DPC) ที่กำหนดเอง แนวทางที่ปรับปรุงใหม่นี้ใช้ AMAPI SDK และแอป Android Device Policy (ADP) เพื่อลดความซับซ้อนในการลงทะเบียนอุปกรณ์
• การปรับปรุงความเสถียรและประสิทธิภาพพร้อมข้อมูลเพิ่มเติมในข้อยกเว้นความน่าเชื่อถือของอุปกรณ์ โปรดดู AmapiSdkException

เวอร์ชัน 1.5.0-rc01

24 กรกฎาคม 2025

เวอร์ชันนี้จะเปิดตัวขั้นตอนการลงทะเบียนอุปกรณ์ที่ได้รับการปรับปรุงสำหรับเครื่องมือควบคุมนโยบายด้านอุปกรณ์ (DPC) ที่กำหนดเอง แนวทางที่ปรับปรุงประสิทธิภาพนี้ใช้ AMAPI SDK และแอป Android Device Policy (ADP) เพื่อลดความซับซ้อนในการลงทะเบียนอุปกรณ์

เวอร์ชัน 1.4.0

18 มิถุนายน 2025

เวอร์ชันนี้มีสัญญาณ Device.WorkProfileState เพื่อระบุสถานะการจัดการอุปกรณ์

ไม่มีความแตกต่างจาก v1.4.0-rc01

สำคัญ: การเข้าถึงสัญญาณความน่าเชื่อถือของอุปกรณ์จะถูกจำกัดโดยใช้รายการที่อนุญาตเพื่อป้องกันการใช้งานที่ไม่ได้รับอนุญาต ดูข้อมูลเพิ่มเติมได้ที่หัวข้อต่อไปนี้ Device Trust from Android Enterprise - การเข้าถึง API

เวอร์ชัน 1.4.0-rc01

2 มิถุนายน 2025

เวอร์ชันนี้มีสัญญาณ Device.WorkProfileState เพื่อระบุสถานะการจัดการอุปกรณ์

เวอร์ชัน 1.3.0

14 เม.ย. 2025

เวอร์ชันนี้ประกอบด้วย Device Trust from Android Enterprise รุ่นแรก

ไม่มีความแตกต่างจาก v1.3.0-rc01

สำคัญ: การเข้าถึงสัญญาณความน่าเชื่อถือของอุปกรณ์จะถูกจำกัดโดยใช้รายการที่อนุญาตเพื่อป้องกันการใช้งานที่ไม่ได้รับอนุญาต ดูข้อมูลเพิ่มเติมได้ที่หัวข้อต่อไปนี้ Device Trust from Android Enterprise - การเข้าถึง API

เวอร์ชัน 1.3.0-rc01

18 ก.พ. 2025

เวอร์ชันนี้มีรุ่นที่อาจได้รับการเผยแพร่รุ่นแรกสำหรับ Device Trust from Android Enterprise

• แพ็กเกจสัญญาณความน่าเชื่อถือของอุปกรณ์ใหม่ com.google.android.managementapi.device
• แพ็กเกจสภาพแวดล้อมใหม่ com.google.android.managementapi.environment เพื่อตั้งค่าอุปกรณ์สำหรับ Device Trust from Android Enterprise และติดตั้งหรืออัปเดตแอปนโยบายด้านอุปกรณ์ Android หากจำเป็น

เวอร์ชัน 1.1.5

13 พฤษภาคม 2024

เวอร์ชันนี้มีการอัปเดตต่อไปนี้

• แก้ไขข้อบกพร่องและปรับปรุงภายใน

เวอร์ชัน 1.1.4

24 มกราคม 2024

เวอร์ชันนี้มีการอัปเดตต่อไปนี้

• แพ็กเกจการย้ายข้อมูล DPC ใหม่ com.google.android.managementapi.dpcmigration เพื่อรองรับการย้ายข้อมูลอุปกรณ์ไปยัง AMAPI ดูข้อมูลเพิ่มเติมได้ในคู่มือย้ายข้อมูลอุปกรณ์ที่มีอยู่ไปยัง AMAPI

เวอร์ชัน 1.0.1

15 กุมภาพันธ์ 2022

เวอร์ชันนี้มีการอัปเดตต่อไปนี้

• แก้ไขข้อบกพร่องและปรับปรุงภายใน

เวอร์ชัน 1.0.0

20 กันยายน 2021

เวอร์ชันนี้มีการอัปเดตต่อไปนี้

• การเผยแพร่ครั้งแรก