ปฏิบัติตามข้อกำหนดของระดับ 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 ต้องใช้ Google Play Services SDK เวอร์ชัน 10.2.1 ขึ้นไป
    • เมื่อใช้ 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 เราไม่แนะนำให้ใช้อินเทอร์เฟซที่ไม่ใช่ SDK สำหรับแอปที่กำหนดเป้าหมายเป็น API ระดับ 30 เนื่องจากอินเทอร์เฟซที่ไม่ใช่ SDK บางส่วนถูกบล็อกอยู่ในขณะนี้ ดูรายการอินเทอร์เฟซที่ไม่ใช่ SDK ซึ่งถูกบล็อกใน Android 11 ได้ที่อินเทอร์เฟซที่ไม่ใช่ SDK ซึ่งตอนนี้ถูกบล็อกใน Android 11

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

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