ปฏิบัติตามข้อกำหนดของระดับ 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 ของ Google Play services SDK ขึ้นไป
    • เมื่อใช้ 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)

• การจัดการพลังงาน
  • Bucket สแตนด์บายแอปนำข้อจำกัดใหม่ ในเบื้องหลังมาใช้โดยอิงตามการมีส่วนร่วมของแอป เช่น งานที่เลื่อนออกไป การปลุก และโควต้าสำหรับข้อความที่มีลำดับความสำคัญสูง
  • การปรับปรุงโหมดประหยัดแบตเตอรี่ เพิ่มข้อจำกัดเกี่ยวกับแอปที่อยู่ในโหมดสแตนด์บาย
• สิทธิ์สำหรับบริการที่ทำงานอยู่เบื้องหน้า
  • ต้องขอสิทธิ์ทั่วไป 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()
      • "กลับมาทำงานที่ด้านบนสุด" ได้ครั้งละ 1 กิจกรรมเท่านั้น
  • เมื่อตั้งค่า 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 ซึ่งถูกบล็อกใน Android 11

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

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