ปฏิบัติตามข้อกำหนดของระดับ API เป้าหมายของ Google Play

ย้ายข้อมูลจากเวอร์ชันต่ำกว่า Android 11 (ระดับ API 30)

เลือกเวอร์ชัน Android ที่คุณจะย้ายข้อมูลมา

ย้ายข้อมูลไปยัง Android 5 (ระดับ API 21)

ดูหน้าการเปลี่ยนแปลงลักษณะการทำงานที่เกี่ยวข้องสำหรับแต่ละรุ่นต่อไปนี้เพื่อให้แน่ใจว่าแอปของคุณได้พิจารณาการเปลี่ยนแปลงที่เกิดขึ้นในรุ่นเหล่านี้แล้ว

• Android 5.0 (ระดับ API 21)
• Android 4.4 (API ระดับ 19)
• Android 4.1 (API ระดับ 16)

ดำเนินการต่อด้วยการปฏิบัติตามวิธีการในส่วนถัดไป

ย้ายข้อมูลไปยัง Android 6 (ระดับ API 23)

ข้อควรพิจารณาต่อไปนี้มีผลกับแอปที่กำหนดเป้าหมายเป็น Android 6.0 และแพลตฟอร์มเวอร์ชันที่สูงกว่า

• สิทธิ์รันไทม์

  • สิทธิ์ที่เป็นอันตรายจะได้รับการอนุญาตเมื่อรันไทม์เท่านั้น ขั้นตอน UI ต้องให้ความสามารถในการให้สิทธิ์เหล่านี้

  • ตรวจสอบว่าแอปของคุณพร้อมที่จะจัดการกับการปฏิเสธคำขอสิทธิ์เมื่อเป็นไปได้ เช่น หากผู้ใช้ปฏิเสธคำขอเข้าถึง GPS ของอุปกรณ์ ให้ตรวจสอบว่าแอปมีวิธีอื่นในการดำเนินการต่อ

ดูรายการการเปลี่ยนแปลงทั้งหมดที่เปิดตัวใน Android 6.0 (API ระดับ 23) ได้ที่หน้าการเปลี่ยนแปลงลักษณะการทำงานสำหรับแพลตฟอร์มเวอร์ชันนั้น

ดำเนินการต่อด้วยการปฏิบัติตามวิธีการในส่วนถัดไป

ย้ายข้อมูลไปยัง Android 7 (ระดับ API 24)

ข้อควรพิจารณาต่อไปนี้มีผลกับแอปที่กำหนดเป้าหมายเป็น Android 7.0 และแพลตฟอร์มเวอร์ชันที่สูงกว่า

• Doze และสแตนด์บายแอป

  ออกแบบสำหรับลักษณะการทำงานที่อธิบายไว้ในการเพิ่มประสิทธิภาพสำหรับโหมด Doze และสแตนด์บายแอป ซึ่งครอบคลุมการเปลี่ยนแปลงที่เพิ่มขึ้นซึ่งเปิดตัวในแพลตฟอร์มรุ่นต่างๆ

  เมื่ออุปกรณ์อยู่ในโหมด Doze และโหมดสแตนด์บายแอป ระบบจะทำงานดังนี้

  • จำกัดการเข้าถึงเครือข่าย
  • เลื่อนการปลุก การซิงค์ และงาน
  • จำกัดการสแกน GPS และ Wi-Fi
  • จำกัดข้อความ Firebase Cloud Messaging ที่มีความสำคัญปกติ

• การเปลี่ยนแปลงสิทธิ์

  • ระบบจะจำกัดการเข้าถึงไดเรกทอรีส่วนตัวของแอป
  • การเปิดเผย URI ของ file:// นอกแอปจะทริกเกอร์ FileUriExposedException หากต้องการแชร์ไฟล์ภายนอกแอป ให้ใช้ FileProvider

• ระบบห้ามไม่ให้ลิงก์กับไลบรารีที่ไม่ใช่ NDK

ดูรายการการเปลี่ยนแปลงทั้งหมดที่เปิดตัวใน Android 7.0 (API ระดับ 24) ได้ที่หน้าการเปลี่ยนแปลงลักษณะการทำงานสำหรับแพลตฟอร์มเวอร์ชันนั้น

ดำเนินการต่อด้วยการปฏิบัติตามวิธีการในส่วนถัดไป

ย้ายข้อมูลไปยัง Android 8 (ระดับ API 26)

ข้อควรพิจารณาต่อไปนี้มีผลกับแอปที่กำหนดเป้าหมายเป็น Android 8.0 และแพลตฟอร์มเวอร์ชันที่สูงกว่า

• ขีดจำกัดการดำเนินการในเบื้องหลัง
  • ระบบจะจำกัดบริการสำหรับแอปที่ไม่ได้ทำงานในพื้นหน้า
    • startService() จะส่งข้อยกเว้นเมื่อแอปพยายามเรียกใช้ขณะที่ห้ามใช้ startService()
    • หากต้องการเริ่มบริการที่ทำงานอยู่เบื้องหน้า แอปต้องใช้ startForeground() และ startForegroundService()
    • ตรวจสอบการเปลี่ยนแปลงที่เกิดขึ้นกับ JobScheduler API อย่างละเอียดตามที่ระบุไว้ในหน้าการเปลี่ยนแปลงลักษณะการทำงานของ Android 8.0 (API ระดับ 26)
    • Firebase Cloud Messaging ต้องใช้ SDK บริการ Google Play เวอร์ชัน 10.2.1 ขึ้นไป
    • เมื่อใช้ Firebase Cloud Messaging การส่งข้อความจะขึ้นอยู่กับขีดจำกัดการดำเนินการในเบื้องหลัง เมื่อจำเป็นต้องทำงานในเบื้องหลังเมื่อได้รับข้อความ เช่น เพื่อทำการซิงค์ข้อมูลในเบื้องหลัง แอปของคุณควรจัดกำหนดการงานโดยใช้ Firebase Job Dispatcher หรือ JobIntentService แทน ดูข้อมูลเพิ่มเติมได้ที่ เอกสารประกอบของ Firebase Cloud Messaging
  • การกระจายข้อมูลแบบไม่เจาะจงปลายทาง
    • มีการจำกัดการออกอากาศโดยนัย ดูข้อมูลเกี่ยวกับการจัดการเหตุการณ์ในเบื้องหลังได้ที่เอกสารประกอบสำหรับ JobScheduler API
  • ขีดจำกัดการเข้าถึงตำแหน่งในเบื้องหลัง
    • แอปที่ทำงานอยู่ในพื้นหลังมีสิทธิ์เข้าถึงข้อมูลตำแหน่งแบบจำกัด
      • ในอุปกรณ์ที่มีบริการ Google Play ให้ใช้ ผู้ให้บริการ Fused Location เพื่อรับการอัปเดตตำแหน่งเป็นระยะๆ
• ช่องทางการแจ้งเตือน
  • คุณควรกำหนด พร็อพเพอร์ตี้การรบกวนของการแจ้งเตือนตามแต่ละช่องทาง
  • คุณต้องกำหนดการแจ้งเตือนให้กับช่องทางเพื่อแสดงการแจ้งเตือน
  • แพลตฟอร์มเวอร์ชันนี้รองรับ NotificationCompat.Builder
• ความเป็นส่วนตัว
  • ANDROID_ID จะกำหนดขอบเขตตามคีย์ App Signing

ดูรายการการเปลี่ยนแปลงทั้งหมดที่เปิดตัวใน Android 8.0 (API ระดับ 26) ได้ที่หน้าการเปลี่ยนแปลงลักษณะการทำงานสำหรับแพลตฟอร์มเวอร์ชันนั้น

ย้ายข้อมูลจาก Android 8 (API 26) ไปยัง Android 9 (API 28)

• การจัดการพลังงาน
  • ที่เก็บข้อมูลสแตนด์บายแอปนำข้อจำกัดใหม่ๆ ในเบื้องหลังมาใช้โดยอิงตามการมีส่วนร่วมของแอป เช่น งานที่เลื่อนออกไป การปลุก และโควต้าสำหรับข้อความที่มีลำดับความสำคัญสูง
  • การปรับปรุงโหมดประหยัดแบตเตอรี่ เพิ่มข้อจำกัดในแอปที่อยู่ในสแตนด์บายแอป
• สิทธิ์บริการที่ทำงานอยู่เบื้องหน้า
  • ต้องขอสิทธิ์ปกติ FOREGROUND_SERVICE (ไม่ใช่สิทธิ์รันไทม์)
• การเปลี่ยนแปลงด้านความเป็นส่วนตัว
  • สิทธิ์เข้าถึงเซ็นเซอร์ที่ทำงานอยู่เบื้องหลังแบบจำกัด
  • จำกัดการเข้าถึงบันทึกการโทร ซึ่งตอนนี้อยู่ในกลุ่มสิทธิ์ CALL_LOG
  • จำกัดการเข้าถึงหมายเลขโทรศัพท์ โดยต้องใช้สิทธิ์ READ_CALL_LOG
  • จำกัดการเข้าถึงข้อมูล Wi-Fi

ดูรายการการเปลี่ยนแปลงทั้งหมดที่เปิดตัวใน Android 9.0 (ระดับ API 28) ได้ที่การเปลี่ยนแปลงลักษณะการทำงาน

ย้ายข้อมูลจาก Android 9 (ระดับ API 28) ไปยัง Android 10 (ระดับ API 29)

• การแจ้งเตือนที่มี Intent เต็มหน้าจอ
  • ต้องขอสิทธิ์ปกติ USE_FULL_SCREEN_INTENT (ไม่ใช่สิทธิ์รันไทม์)
• การรองรับอุปกรณ์แบบพับได้และอุปกรณ์หน้าจอขนาดใหญ่
  • ตอนนี้กิจกรรมหลายรายการสามารถอยู่ในสถานะ "กลับมาทำงานอีกครั้ง" พร้อมกันได้ แต่มีเพียงกิจกรรมเดียวเท่านั้นที่โฟกัสอยู่จริงๆ
    • การเปลี่ยนแปลงนี้ส่งผลต่อลักษณะการทำงานของ onResume() และ onPause()
    • แนวคิดวงจรใหม่ของ "กลับมาทำงานต่อที่ด้านบนสุด" ซึ่งตรวจพบได้โดยการสมัครรับข้อมูล onTopResumedActivityChanged()
      • มีกิจกรรมเดียวเท่านั้นที่สามารถ "กลับมาทำงานต่อในระดับบนสุด" ได้
  • เมื่อตั้งค่า resizeableActivity เป็น false แอปจะระบุ minAspectRatio เพิ่มเติมได้ ซึ่งจะแสดงแอปแบบ Letterbox โดยอัตโนมัติในสัดส่วนภาพที่แคบลง
• การเปลี่ยนแปลงด้านความเป็นส่วนตัว
  • พื้นที่เก็บข้อมูลที่กำหนดขอบเขต
    • สิทธิ์เข้าถึงที่จัดเก็บข้อมูลภายนอกจะจำกัดไว้เฉพาะไดเรกทอรีเฉพาะแอปและสื่อบางประเภทที่แอปสร้างขึ้นเท่านั้น
  • จำกัดการเข้าถึงตำแหน่งขณะที่แอปทำงานอยู่เบื้องหลัง ซึ่งต้องใช้สิทธิ์ ACCESS_BACKGROUND_LOCATION
  • จำกัดการเข้าถึงตัวระบุที่รีเซ็ตไม่ได้ เช่น IMEI และหมายเลขซีเรียล
  • จำกัดการเข้าถึงข้อมูลกิจกรรมการเคลื่อนไหวร่างกาย เช่น จำนวนก้าวของผู้ใช้ ซึ่งต้องใช้สิทธิ์ ACTIVITY_RECOGNITION
  • จำกัดการเข้าถึง API บางรายการของโทรศัพท์ บลูทูธ และ Wi-Fi โดยต้องใช้สิทธิ์ ACCESS_FINE_LOCATION
  • จำกัดการเข้าถึงการตั้งค่า Wi-Fi
    • แอปจะไม่สามารถเปิดหรือปิดใช้ Wi-Fi โดยตรงได้อีกต่อไป และจะต้องดำเนินการโดยใช้แผงการตั้งค่า
    • ข้อจำกัดในการเริ่มการเชื่อมต่อกับเครือข่าย Wi-Fi ซึ่งกำหนดให้ใช้ WifiNetworkSpecifier หรือ WifiNetworkSuggestion

ย้ายข้อมูลจาก Android 10 (ระดับ API 29) ไปยัง Android 11 (ระดับ API 30)

• ความเป็นส่วนตัว
  • การบังคับใช้พื้นที่เก็บข้อมูลที่กำหนดขอบเขต : แอปควรใช้โมเดลพื้นที่เก็บข้อมูลที่กำหนดขอบเขตซึ่งจะบันทึกและเข้าถึงไฟล์เฉพาะแอป สื่อ และไฟล์ประเภทอื่นๆ โดยใช้ตำแหน่งเฉพาะ
  • รีเซ็ตสิทธิ์อัตโนมัติ: หากผู้ใช้ไม่ได้โต้ตอบกับแอปเป็นเวลา 2-3 เดือน ระบบจะรีเซ็ตสิทธิ์ที่มีความละเอียดอ่อนของแอปโดยอัตโนมัติ ซึ่งไม่น่าจะส่งผลกระทบต่อแอปส่วนใหญ่ หากแอปของคุณทำงานในเบื้องหลังเป็นหลักโดยไม่มีการโต้ตอบของผู้ใช้ คุณอาจพิจารณาขอให้ผู้ใช้ปิดใช้การรีเซ็ตอัตโนมัติ
  • การเข้าถึงตำแหน่งในเบื้องหลัง: แอปต้องขอสิทธิ์เข้าถึงตำแหน่งในเบื้องหน้าและเบื้องหลังแยกกัน การให้สิทธิ์เข้าถึงตำแหน่งในเบื้องหลังทำได้ในการตั้งค่าแอปเท่านั้น ไม่ใช่กล่องโต้ตอบสิทธิ์รันไทม์
  • ระดับการเข้าถึงแพ็กเกจ: เมื่อแอปค้นหารายการแอปและบริการที่ติดตั้งในอุปกรณ์ ระบบจะกรองรายการที่แสดงผล
    • หากใช้บริการการอ่านออกเสียงข้อความหรือ การจดจำเสียงพูด คุณจะต้องเพิ่มองค์ประกอบการค้นหาสำหรับบริการลงในไฟล์ Manifest
• ความปลอดภัย
  • ระบบไม่รองรับไฟล์ `resource.arsc` ที่บีบอัดอีกต่อไป
  • ตอนนี้ต้องใช้ APK Signature Scheme v2 นักพัฒนาแอปควรลงชื่อด้วย APK Signature Scheme v1 ต่อไปเพื่อเหตุผลด้านความเข้ากันได้แบบย้อนหลัง
  • ข้อจำกัดของอินเทอร์เฟซที่ไม่ใช่ SDK เราไม่แนะนำให้ใช้ API ที่ไม่ใช่ SDK สำหรับแอปที่กำหนดเป้าหมายเป็น API ระดับ 30 เนื่องจากอินเทอร์เฟซที่ไม่ใช่ SDK บางรายการถูกบล็อกแล้วในตอนนี้ ดูรายการอินเทอร์เฟซที่ไม่ใช่ SDK ที่ถูกบล็อกทั้งหมดได้ที่อินเทอร์เฟซที่ไม่ใช่ SDK ซึ่งถูกบล็อกใน Android 11

ดูรายการการเปลี่ยนแปลงทั้งหมดที่เกิดขึ้นใน Android 11 (API ระดับ 30) ได้ที่หน้าการเปลี่ยนแปลงลักษณะการทำงาน

อัปเดตเป็น API 31 ต่อโดยทำตามวิธีการในส่วนก่อนหน้า