ปฏิบัติตามข้อกำหนดของระดับ 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 ที่มีลำดับความสำคัญปกติ

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

  • ระบบจะจำกัดการเข้าถึงไดเรกทอรีส่วนตัวของแอป
  • การเปิดเผย file:// URI ภายนอกแอปจะทําให้เกิด 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 ต้องใช้ เวอร์ชัน 10.2.1 ของ SDK ของบริการ Google Play ขึ้นไป
    • เมื่อใช้ Firebase Cloud Messaging การนำส่งข้อความจะขึ้นอยู่กับขีดจำกัดการดำเนินการในเบื้องหลัง เมื่อจำเป็นต้องมีการทำงานในเบื้องหลังเมื่อได้รับข้อความ เช่น เพื่อทำการซิงค์ข้อมูลในเบื้องหลัง แอปควรตั้งเวลาให้งานโดยใช้ Firebase Job Dispatcher หรือ JobIntentService แทน ดูข้อมูลเพิ่มเติมได้ที่ เอกสารประกอบของ Firebase Cloud Messaging
  • การออกอากาศโดยนัย
    • มีการจำกัดการออกอากาศโดยนัย ดูข้อมูลเกี่ยวกับการจัดการเหตุการณ์ในเบื้องหลังได้ในเอกสารประกอบสำหรับ JobScheduler API
  • ขีดจำกัดของตำแหน่งในเบื้องหลัง
    • แอปที่ทำงานอยู่ในพื้นหลังมีสิทธิ์เข้าถึงข้อมูลตำแหน่งแบบจำกัด
      • ในอุปกรณ์ที่มีบริการ Google Play ให้ใช้ ผู้ให้บริการตำแหน่งแบบรวมเพื่อรับการอัปเดตตำแหน่งเป็นระยะๆ
• ช่องการแจ้งเตือน
  • คุณควรกำหนด พร็อพเพอร์ตี้การขัดจังหวะการแจ้งเตือนตามช่องทาง
  • คุณต้องกำหนดการแจ้งเตือนให้กับช่องทางเพื่อแสดงการแจ้งเตือน
  • แพลตฟอร์มเวอร์ชันนี้รองรับ 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 เพิ่มเติมได้ ซึ่งจะใส่ขอบดำด้านข้างของแอปโดยอัตโนมัติในสัดส่วนภาพที่แคบกว่า
• การเปลี่ยนแปลงด้านความเป็นส่วนตัว
  • พื้นที่เก็บข้อมูลที่จำกัดขอบเขต
    • การเข้าถึงพื้นที่เก็บข้อมูลภายนอกจะจำกัดไว้เฉพาะไดเรกทอรีเฉพาะแอป และสื่อบางประเภทที่แอปสร้างขึ้น เท่านั้น
  • จำกัดการเข้าถึงตำแหน่งขณะที่แอปทำงานในเบื้องหลัง โดยต้องมีสิทธิ์ 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 ระดับ 30 ใช้อินเทอร์เฟซที่ไม่ใช่ SDK เนื่องจากตอนนี้ระบบได้บล็อกอินเทอร์เฟซที่ไม่ใช่ SDK บางรายการแล้ว ดูรายการอินเทอร์เฟซที่ไม่ได้อยู่ใน SDK ที่ถูกบล็อกทั้งหมดได้ที่อินเทอร์เฟซที่ไม่ได้อยู่ใน SDK ที่ ถูกบล็อกใน Android 11 แล้ว

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

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