การเปลี่ยนแปลงลักษณะการทำงาน: แอปที่กำหนดเป้าหมายเป็น Android 15 ขึ้นไป

Android 15 มีการเปลี่ยนแปลงลักษณะการทำงานที่อาจส่งผลต่อแอปของคุณเช่นเดียวกับรุ่นก่อนหน้า การเปลี่ยนแปลงลักษณะการทำงานต่อไปนี้จะมีผลกับแอปที่กำหนดเป้าหมายเป็น Android 15 ขึ้นไปเท่านั้น หากแอปกำหนดเป้าหมายเป็น Android 15 ขึ้นไป คุณควรแก้ไขแอปให้รองรับลักษณะการทำงานเหล่านี้อย่างเหมาะสมในกรณีที่ เกี่ยวข้อง

นอกจากนี้ โปรดตรวจสอบรายการการเปลี่ยนแปลงลักษณะการทำงานที่ส่งผลต่อแอปทั้งหมด ที่ทำงานบน Android 15 ไม่ว่า targetSdkVersion ของแอปจะเป็นอย่างไร

ฟังก์ชันหลัก

Android 15 จะแก้ไขหรือขยายความสามารถหลักต่างๆ ของระบบ Android

การเปลี่ยนแปลงบริการที่ทำงานอยู่เบื้องหน้า

We are making the following changes to foreground services with Android 15.

• Data sync foreground service timeout behavior
• New media processing foreground service type
• Restrictions on BOOT_COMPLETED broadcast receivers launching foreground services
• Restrictions on starting foreground services while an app holds the SYSTEM_ALERT_WINDOW permission

Data sync foreground service timeout behavior

Android 15 เปิดตัวลักษณะการหมดเวลาใหม่สำหรับ dataSync ในแอปที่กำหนดเป้าหมายเป็น Android 15 (API ระดับ 35) ขึ้นไป ลักษณะการทำงานนี้มีผลกับmediaProcessingบริการที่ทำงานอยู่เบื้องหน้าประเภทใหม่ด้วย

ระบบอนุญาตให้บริการ dataSync ของแอปทำงานได้นาน 6 ชั่วโมงโดยรวมในระยะเวลา 24 ชั่วโมง หลังจากนั้นระบบจะเรียกใช้เมธอด Service.onTimeout(int, int) ของบริการที่ทำงานอยู่ (เปิดตัวใน Android 15) ในขณะนี้บริการมีเวลา 2-3 วินาทีในการเรียกใช้ Service.stopSelf() เมื่อมีการเรียกใช้ Service.onTimeout() บริการดังกล่าวจะไม่ถือว่าเป็นบริการที่ทำงานอยู่เบื้องหน้าอีกต่อไป หากบริการไม่ได้เรียกใช้ Service.stopSelf() ระบบจะแสดงข้อผิดพลาดภายใน ระบบจะบันทึกข้อยกเว้นใน Logcat โดยมีข้อความต่อไปนี้

Fatal Exception: android.app.RemoteServiceException: "A foreground service of
type dataSync did not stop within its timeout: [component name]"

หากต้องการหลีกเลี่ยงปัญหาการเปลี่ยนแปลงลักษณะการทำงานนี้ คุณสามารถทำอย่างใดอย่างหนึ่งต่อไปนี้

1. ขอให้บริการของคุณใช้วิธีการ Service.onTimeout(int, int) ใหม่ เมื่อแอปได้รับการติดต่อกลับ ให้โทรหา stopSelf() ภายใน 2-3 วินาที (หากคุณไม่หยุดแอปทันที ระบบจะสร้างสถานะ "ไม่สำเร็จ")
2. ตรวจสอบว่าบริการ dataSync ของแอปไม่ทำงานเป็นเวลารวม 6 ชั่วโมงในช่วง 24 ชั่วโมงใดก็ได้ (เว้นแต่ผู้ใช้โต้ตอบกับแอป จะเป็นการรีเซ็ตตัวจับเวลา)
3. เริ่มบริการที่ทำงานอยู่เบื้องหน้าdataSyncเฉพาะในกรณีที่มีการโต้ตอบโดยตรงจากผู้ใช้ เนื่องจากแอปของคุณอยู่เบื้องหน้าเมื่อบริการเริ่มทำงาน บริการของคุณจึงมีเวลา 6 ชั่วโมงเต็มหลังจากที่แอปเปลี่ยนไปทำงานในเบื้องหลัง
4. ใช้API อื่นแทนdataSyncบริการที่ทำงานอยู่เบื้องหน้า

หากบริการที่ทำงานอยู่เบื้องหน้า dataSync ของแอปทำงานเป็นเวลา 6 ชั่วโมงในช่วง 24 ชั่วโมงที่ผ่านมา คุณจะไม่สามารถเริ่มบริการที่ทำงานอยู่เบื้องหน้า dataSync อื่นได้เว้นแต่ผู้ใช้จะนำแอปของคุณไปไว้ที่เบื้องหน้า (ซึ่งจะรีเซ็ตตัวจับเวลา) หากคุณพยายามเริ่มบริการที่ทำงานอยู่เบื้องหน้า dataSync อื่น ระบบจะแสดง ForegroundServiceStartNotAllowedException พร้อมข้อความแสดงข้อผิดพลาด เช่น "หมดเวลาสำหรับบริการที่ทำงานอยู่เบื้องหน้าประเภท dataSync แล้ว"

การทดสอบ

หากต้องการทดสอบลักษณะการทํางานของแอป คุณสามารถเปิดใช้การหมดเวลาการซิงค์ข้อมูลได้แม้ว่าแอปจะไม่กําหนดเป้าหมายเป็น Android 15 ก็ตาม (ตราบใดที่แอปทํางานบนอุปกรณ์ Android 15) หากต้องการเปิดใช้การหมดเวลา ให้เรียกใช้คำสั่ง adb ต่อไปนี้

adb shell am compat enable FGS_INTRODUCE_TIME_LIMITS your-package-name

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

adb shell device_config put activity_manager data_sync_fgs_timeout_duration duration-in-milliseconds

New media processing foreground service type

Android 15 introduces a new foreground service type, mediaProcessing. This service type is appropriate for operations like transcoding media files. For example, a media app might download an audio file and need to convert it to a different format before playing it. You can use a mediaProcessing foreground service to make sure the conversion continues even while the app is in the background.

The system permits an app's mediaProcessing services to run for a total of 6 hours in a 24-hour period, after which the system calls the running service's Service.onTimeout(int, int) method (introduced in Android 15). At this time, the service has a few seconds to call Service.stopSelf(). If the service does not call Service.stopSelf(), the system throws an internal exception. The exception is logged in Logcat with the following message:

Fatal Exception: android.app.RemoteServiceException: "A foreground service of
type mediaProcessing did not stop within its timeout: [component name]"

To avoid having the exception, you can do one of the following:

1. Have your service implement the new Service.onTimeout(int, int) method. When your app receives the callback, make sure to call stopSelf() within a few seconds. (If you don't stop the app right away, the system generates a failure.)
2. Make sure your app's mediaProcessing services don't run for more than a total of 6 hours in any 24-hour period (unless the user interacts with the app, resetting the timer).
3. Only start mediaProcessing foreground services as a result of direct user interaction; since your app is in the foreground when the service starts, your service has the full six hours after the app goes to the background.
4. Instead of using a mediaProcessing foreground service, use an alternative API, like WorkManager.

If your app's mediaProcessing foreground services have run for 6 hours in the last 24, you cannot start another mediaProcessing foreground service unless the user has brought your app to the foreground (which resets the timer). If you try to start another mediaProcessing foreground service, the system throws ForegroundServiceStartNotAllowedException with an error message like "Time limit already exhausted for foreground service type mediaProcessing".

For more information about the mediaProcessing service type, see Changes to foreground service types for Android 15: Media processing.

Testing

To test your app's behavior, you can enable media processing timeouts even if your app is not targeting Android 15 (as long as the app is running on an Android 15 device). To enable timeouts, run the following adb command:

adb shell am compat enable FGS_INTRODUCE_TIME_LIMITS your-package-name

You can also adjust the timeout period, to make it easier to test how your app behaves when the limit is reached. To set a new timeout period, run the following adb command:

adb shell device_config put activity_manager media_processing_fgs_timeout_duration duration-in-milliseconds

Restrictions on BOOT_COMPLETED broadcast receivers launching foreground services

มีข้อจำกัดใหม่ในการเปิดตัว Broadcast Receiver ของ BOOT_COMPLETED บริการที่ทำงานอยู่เบื้องหน้า ระบบไม่อนุญาตให้ Receiver BOOT_COMPLETED เปิดบริการที่ทำงานอยู่เบื้องหน้าประเภทต่อไปนี้

• dataSync
• camera
• mediaPlayback
• phoneCall
• mediaProjection
• microphone (ข้อจำกัดนี้มีการใช้มาเป็นเวลา microphone ตั้งแต่ Android 14)

หากตัวรับสัญญาณ BOOT_COMPLETED พยายามเปิดเบื้องหน้าประเภทใดก็ตามเหล่านี้ ระบบอาจไม่แสดง ForegroundServiceStartNotAllowedException

การทดสอบ

หากต้องการทดสอบลักษณะการทำงานของแอป คุณสามารถเปิดใช้ข้อจำกัดใหม่เหล่านี้ได้ แม้ว่า แอปไม่ได้กําหนดเป้าหมายเป็น Android 15 (ตราบใดที่แอปยังทํางานอยู่ใน Android 15 อุปกรณ์) เรียกใช้คำสั่ง adb ต่อไปนี้

adb shell am compat enable FGS_BOOT_COMPLETED_RESTRICTIONS your-package-name

หากต้องการส่งประกาศBOOT_COMPLETEDโดยไม่ต้องรีสตาร์ทอุปกรณ์ ให้ทำดังนี้ เรียกใช้คำสั่ง adb ต่อไปนี้

adb shell am broadcast -a android.intent.action.BOOT_COMPLETED your-package-name

Restrictions on starting foreground services while an app holds the SYSTEM_ALERT_WINDOW permission

ก่อนหน้านี้ หากแอปมีสิทธิ์ SYSTEM_ALERT_WINDOW แอปจะเปิดบริการที่ทำงานอยู่เบื้องหน้าได้แม้ว่าในขณะนั้นแอปจะทำงานอยู่เบื้องหลังก็ตาม (ตามที่ได้อธิบายไว้ในการยกเว้นจากการจำกัดการเริ่มทำงานในเบื้องหลัง)

หากแอปกำหนดเป้าหมายเป็น Android 15 การยกเว้นนี้จะแคบลงแล้ว ตอนนี้แอปต้องมีสิทธิ์ SYSTEM_ALERT_WINDOW และต้องมีหน้าต่างวางซ้อนที่มองเห็นได้ กล่าวคือ แอปต้องเปิดหน้าต่าง TYPE_APPLICATION_OVERLAY ก่อน และหน้าต่างต้องปรากฏขึ้นก่อนที่คุณจะเริ่มบริการที่ทำงานอยู่เบื้องหน้า

หากแอปพยายามเริ่มบริการที่ทำงานอยู่เบื้องหน้าจากเบื้องหลังโดยไม่เป็นไปตามข้อกำหนดใหม่เหล่านี้ (และไม่มีข้อยกเว้นอื่นๆ) ระบบจะแสดงข้อผิดพลาด ForegroundServiceStartNotAllowedException

หากแอปประกาศสิทธิ์ SYSTEM_ALERT_WINDOW และเปิดบริการที่ทำงานอยู่เบื้องหน้าจากเบื้องหลัง แอปอาจได้รับผลกระทบจากการเปลี่ยนแปลงนี้ หากแอปได้รับ ForegroundServiceStartNotAllowedException ให้ตรวจสอบลําดับการทํางานของแอปและตรวจสอบว่าแอปมีหน้าต่างวางซ้อนที่ใช้งานอยู่ก่อนที่จะพยายามเริ่มบริการที่ทำงานอยู่เบื้องหน้าจากเบื้องหลัง คุณสามารถตรวจสอบว่าขณะนี้หน้าต่างวางซ้อนแสดงอยู่หรือไม่โดยเรียกใช้ View.getWindowVisibility() หรือจะลบล้าง View.onWindowVisibilityChanged() เพื่อรับการแจ้งเตือนทุกครั้งที่ระดับการแชร์มีการเปลี่ยนแปลงก็ได้

การทดสอบ

หากต้องการทดสอบลักษณะการทํางานของแอป คุณสามารถเปิดใช้ข้อจํากัดใหม่เหล่านี้ได้แม้ว่าแอปของคุณจะไม่กําหนดเป้าหมายเป็น Android 15 ก็ตาม (ตราบใดที่แอปทํางานบนอุปกรณ์ Android 15) หากต้องการเปิดใช้ข้อจำกัดใหม่เหล่านี้เกี่ยวกับการเริ่มบริการที่ทำงานอยู่เบื้องหน้าจากเบื้องหลัง ให้เรียกใช้คำสั่ง adb ต่อไปนี้

adb shell am compat enable FGS_SAW_RESTRICTIONS your-package-name

การเปลี่ยนแปลงเวลาที่แอปจะแก้ไขสถานะส่วนกลางของโหมดห้ามรบกวนได้

แอปที่กำหนดเป้าหมายเป็น Android 15 (API ระดับ 35) ขึ้นไปจะไม่สามารถเปลี่ยนแปลงสถานะหรือนโยบายแบบรวมของโหมดห้ามรบกวน (DND) ในอุปกรณ์ได้อีกต่อไป (ไม่ว่าจะแก้ไขการตั้งค่าของผู้ใช้หรือปิดโหมด DND) แต่แอปต้องส่งAutomaticZenRule ซึ่งระบบจะรวมเข้ากับนโยบายส่วนกลางโดยใช้รูปแบบ "นโยบายที่เข้มงวดที่สุดจะชนะ" ที่มีอยู่ การเรียก API ที่มีอยู่ซึ่งก่อนหน้านี้ส่งผลต่อสถานะส่วนกลาง (setInterruptionFilter, setNotificationPolicy) จะส่งผลให้มีการสร้างหรืออัปเดต AutomaticZenRule ที่ไม่ชัดแจ้ง ซึ่งจะเปิดและปิดอยู่โดยขึ้นอยู่กับรอบการเรียกของ API เหล่านั้น

โปรดทราบว่าการเปลี่ยนแปลงนี้มีผลต่อลักษณะการทำงานที่สังเกตได้เฉพาะในกรณีที่แอปเรียกใช้ setInterruptionFilter(INTERRUPTION_FILTER_ALL) และคาดว่าการเรียกใช้ดังกล่าวจะปิดใช้งาน AutomaticZenRule ที่เจ้าของเปิดใช้งานไว้ก่อนหน้านี้

การเปลี่ยนแปลง API ของ OpenJDK

Android 15 จะยังคงปรับปรุงไลบรารีหลักของ Android ให้สอดคล้องกับฟีเจอร์ใน OpenJDK LTS เวอร์ชันล่าสุด

การเปลี่ยนแปลงบางอย่างเหล่านี้อาจส่งผลต่อความเข้ากันได้ของแอปที่กำหนดเป้าหมายเป็น Android 15 (ระดับ API 35) ดังนี้

• การเปลี่ยนแปลง API การจัดรูปแบบสตริง: ตอนนี้การตรวจสอบดัชนีอาร์กิวเมนต์ แฟล็ก ความกว้าง และความแม่นยำจะเข้มงวดมากขึ้นเมื่อใช้ API String.format() และ Formatter.format() ต่อไปนี้

  • String.format(String, Object[])
  • String.format(Locale, String, Object[])
  • Formatter.format(String, Object[])
  • Formatter.format(Locale, String, Object[])

  ตัวอย่างเช่น ระบบจะแสดงข้อยกเว้นต่อไปนี้เมื่อใช้อาร์กิวเมนต์ดัชนี 0 (%0 ในสตริงรูปแบบ)

  IllegalFormatArgumentIndexException: Illegal format argument index = 0
  

  ในกรณีนี้ คุณสามารถแก้ไขปัญหาได้โดยใช้อาร์กิวเมนต์ดัชนี 1 (%1 ในสตริงรูปแบบ)

• การเปลี่ยนแปลงประเภทคอมโพเนนต์ของ Arrays.asList(...).toArray(): เมื่อใช้ Arrays.asList(...).toArray() ประเภทคอมโพเนนต์ของอาร์เรย์ผลลัพธ์จะเป็น Object ไม่ใช่ประเภทขององค์ประกอบของอาร์เรย์พื้นฐาน ดังนั้นโค้ดต่อไปนี้จะแสดง ClassCastException

  String[] elements = (String[]) Arrays.asList("one", "two").toArray();
  

  ในกรณีนี้ หากต้องการเก็บ String ไว้เป็นประเภทคอมโพเนนต์ในอาร์เรย์ผลลัพธ์ คุณสามารถใช้ Collection.toArray(Object[]) แทนได้

  String[] elements = Arrays.asList("two", "one").toArray(new String[0]);
  

• การเปลี่ยนแปลงการจัดการรหัสภาษา: เมื่อใช้ Locale API ระบบจะไม่แปลงรหัสภาษาสำหรับภาษาฮีบรู ภาษาอิดดิช และภาษาอินโดนีเซีย เป็นรูปแบบที่ล้าสมัยอีกต่อไป (ฮีบรู: iw, อิดดิช: ji และอินโดนีเซีย: in) เมื่อระบุรหัสภาษาสำหรับภาษาใดภาษาหนึ่งเหล่านี้ ให้ใช้รหัส จาก ISO 639-1 แทน (ฮีบรู: he, อิดดิช: yi และอินโดนีเซีย: id)

• การเปลี่ยนแปลงลำดับจำนวนเต็มแบบสุ่ม: หลังจากทำการเปลี่ยนแปลงใน https://bugs.openjdk.org/browse/JDK-8301574 แล้ว ตอนนี้เมธอดต่อไปนี้ Random.ints() จะแสดงลำดับตัวเลขที่แตกต่างจากเมธอด Random.nextInt()

  • Random.ints(long)
  • Random.ints(long, int, int)
  • Random.ints(int, int)
  • Random.ints()

  โดยทั่วไป การเปลี่ยนแปลงนี้ไม่น่าจะส่งผลให้แอปทำงานผิดปกติ แต่โค้ดของคุณไม่ควรคาดหวังว่าลำดับที่สร้างจากเมธอด Random.ints() จะตรงกับ Random.nextInt()

API SequencedCollection ใหม่นี้อาจส่งผลต่อความเข้ากันได้ของแอป หลังจากที่คุณอัปเดต compileSdk ในการกำหนดค่าบิลด์ของแอปเพื่อใช้ Android 15 (API ระดับ 35)

• การชนกันกับฟังก์ชันส่วนขยาย MutableList.removeFirst() และ MutableList.removeLast() ใน kotlin-stdlib

  ประเภท List ใน Java จะแมปกับประเภท MutableList ใน Kotlin เนื่องจากมีการเปิดตัว API List.removeFirst() และ List.removeLast() ใน Android 15 (API ระดับ 35) คอมไพเลอร์ Kotlin จึงแก้ไขการเรียกใช้ฟังก์ชัน เช่น list.removeFirst() แบบคงที่ไปยัง API List ใหม่แทนที่จะเป็นฟังก์ชันส่วนขยายใน kotlin-stdlib

  หากมีการคอมไพล์แอปอีกครั้งโดยตั้งค่า compileSdk เป็น 35 และตั้งค่า minSdk เป็น 34 หรือต่ำกว่า จากนั้นเรียกใช้แอปใน Android 14 และต่ำกว่า ระบบจะแสดงข้อผิดพลาดรันไทม์

  java.lang.NoSuchMethodError: No virtual method
  removeFirst()Ljava/lang/Object; in class Ljava/util/ArrayList;
  

  NewApi ตัวเลือก Lint ที่มีอยู่ในปลั๊กอิน Android Gradle สามารถตรวจพบการใช้ API ใหม่เหล่านี้ได้

  ./gradlew lint
  
  MainActivity.kt:41: Error: Call requires API level 35 (current min is 34): java.util.List#removeFirst [NewApi]
        list.removeFirst()
  

  หากต้องการแก้ไขข้อยกเว้นรันไทม์และข้อผิดพลาดของ Lint คุณสามารถแทนที่การเรียกใช้ฟังก์ชัน removeFirst() และ removeLast() ด้วย removeAt(0) และ removeAt(list.lastIndex) ตามลำดับใน Kotlin หากคุณใช้ Android Studio Ladybug | 2024.1.3 ขึ้นไป ก็จะมีตัวเลือกการแก้ไขด่วน สำหรับข้อผิดพลาดเหล่านี้ด้วย

  ลองนำ @SuppressLint("NewApi") และ lintOptions { disable 'NewApi' } ออกหากปิดใช้ตัวเลือกการตรวจสอบแล้ว

• การชนกันกับเมธอดอื่นๆ ใน Java

  เราได้เพิ่มวิธีการใหม่ๆ ลงในประเภทที่มีอยู่แล้ว เช่น List และ Deque วิธีการใหม่เหล่านี้อาจใช้ร่วมกับวิธีการที่มีชื่อและประเภทอาร์กิวเมนต์เดียวกันในอินเทอร์เฟซและคลาสอื่นๆ ไม่ได้ ในกรณีที่ลายเซ็นของเมธอดชนกันกับ ความไม่เข้ากัน คอมไพเลอร์ javac จะแสดงข้อผิดพลาดขณะสร้าง เช่น

  ตัวอย่างข้อผิดพลาด 1

  javac MyList.java
  
  MyList.java:135: error: removeLast() in MyList cannot implement removeLast() in List
    public void removeLast() {
                ^
    return type void is not compatible with Object
    where E is a type-variable:
      E extends Object declared in interface List
  

  ตัวอย่างข้อผิดพลาด 2

  javac MyList.java
  
  MyList.java:7: error: types Deque<Object> and List<Object> are incompatible;
  public class MyList implements  List<Object>, Deque<Object> {
    both define reversed(), but with unrelated return types
  1 error
  

  ตัวอย่างข้อผิดพลาด 3

  javac MyList.java
  
  MyList.java:43: error: types List<E#1> and MyInterface<E#2> are incompatible;
  public static class MyList implements List<Object>, MyInterface<Object> {
    class MyList inherits unrelated defaults for getFirst() from types List and MyInterface
    where E#1,E#2 are type-variables:
      E#1 extends Object declared in interface List
      E#2 extends Object declared in interface MyInterface
  1 error
  

  หากต้องการแก้ไขข้อผิดพลาดในการบิลด์เหล่านี้ คลาสที่ใช้การติดตั้งอินเทอร์เฟซเหล่านี้ควร ลบล้างเมธอดด้วยประเภทการคืนค่าที่เข้ากันได้ เช่น

  @Override
  public Object getFirst() {
      return List.super.getFirst();
  }
  

ความปลอดภัย

Android 15 มีการเปลี่ยนแปลงที่ส่งเสริมความปลอดภัยของระบบเพื่อช่วยปกป้องแอป และผู้ใช้จากแอปที่เป็นอันตราย

เวอร์ชัน TLS ที่ถูกจำกัด

Android 15 จำกัดการใช้ TLS เวอร์ชัน 1.0 และ 1.1 ก่อนหน้านี้ Android ได้เลิกใช้งานเวอร์ชันเหล่านี้แล้ว แต่ตอนนี้ไม่อนุญาตให้แอปที่กําหนดเป้าหมายเป็น Android 15 ใช้เวอร์ชันดังกล่าว

เปิดใช้กิจกรรมในเบื้องหลังที่ปลอดภัย

Android 15 ปกป้องผู้ใช้จากแอปที่เป็นอันตรายและให้ผู้ใช้ควบคุมอุปกรณ์ได้มากขึ้น โดยการเพิ่มการเปลี่ยนแปลงที่ป้องกันไม่ให้แอปที่เป็นอันตรายซึ่งทำงานในเบื้องหลัง นำแอปอื่นๆ มาไว้ที่เบื้องหน้า ยกระดับสิทธิ์ และละเมิด การโต้ตอบของผู้ใช้ การเปิดใช้กิจกรรมในเบื้องหลังถูกจำกัดตั้งแต่ Android 10 (API ระดับ 29)

การเปลี่ยนแปลงอื่นๆ

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

Intent ที่ปลอดภัยกว่า

Android 15 introduces StrictMode for intents.

In order to see detailed logs about Intent usage violations, use following method:

fun onCreate() {
    StrictMode.setVmPolicy(VmPolicy.Builder()
        .detectUnsafeIntentLaunch()
        .build()
    )
}

public void onCreate() {
    StrictMode.setVmPolicy(new VmPolicy.Builder()
            .detectUnsafeIntentLaunch()
            .build());
}

ประสบการณ์ของผู้ใช้และ UI ของระบบ

Android 15 มีการเปลี่ยนแปลงบางอย่างที่มีจุดประสงค์เพื่อสร้างประสบการณ์ของผู้ใช้ที่สอดคล้องกันมากขึ้น และใช้งานง่าย

การเปลี่ยนแปลงส่วนที่เว้นไว้ในหน้าต่าง

การเปลี่ยนแปลงที่เกี่ยวข้องกับส่วนแทรกของหน้าต่างใน Android 15 มี 2 อย่าง ได้แก่ ระบบจะบังคับใช้การแสดงผลแบบเต็มหน้าจอโดยค่าเริ่มต้น และยังมีการเปลี่ยนแปลงการกำหนดค่า เช่น การกําหนดค่าเริ่มต้นของแถบระบบ

การบังคับใช้แบบไร้ขอบ

แอปจะแสดงผลแบบไร้ขอบโดยค่าเริ่มต้นในอุปกรณ์ที่ใช้ Android 15 หากแอปกำหนดเป้าหมายเป็น Android 15 (API ระดับ 35)

นี่เป็นการเปลี่ยนแปลงที่ไม่รองรับการทำงานร่วมกันซึ่งอาจส่งผลเสียต่อ UI ของแอป การเปลี่ยนแปลงนี้ส่งผลต่อพื้นที่ UI ต่อไปนี้

• แถบนำทางด้วยแฮนเดิลท่าทางสัมผัส
  • โปร่งใสโดยค่าเริ่มต้น
  • ปิดใช้การชดเชยด้านล่างเพื่อให้เนื้อหาแสดงอยู่ด้านหลังแถบนำทางของระบบ เว้นแต่จะใช้ Inset
  • setNavigationBarColor และ R.attr#navigationBarColor เลิกใช้งานแล้วและไม่ส่งผลต่อการไปยังส่วนต่างๆ ด้วยท่าทางสัมผัส
  • setNavigationBarContrastEnforced และ R.attr#navigationBarContrastEnforced จะยังคงไม่มีผลต่อ การนำทางด้วยท่าทางสัมผัส
• การนำทางแบบ 3 ปุ่ม
  • ความทึบแสงตั้งค่าเป็น 80% โดยค่าเริ่มต้น โดยสีอาจตรงกับพื้นหลังของหน้าต่าง
  • ปิดใช้การชดเชยด้านล่างเพื่อให้เนื้อหาแสดงอยู่ด้านหลังแถบนำทางของระบบ เว้นแต่จะใช้ Inset
  • setNavigationBarColor และ R.attr#navigationBarColor จะ ตั้งค่าให้ตรงกับพื้นหลังของหน้าต่างโดยค่าเริ่มต้น พื้นหลังของหน้าต่าง ต้องเป็น Drawable สีเพื่อให้ค่าเริ่มต้นนี้มีผล API นี้ เลิกใช้งานแล้ว แต่ยังคงส่งผลต่อการนำทางด้วย 3 ปุ่ม
  • setNavigationBarContrastEnforced และ R.attr#navigationBarContrastEnforced เป็นจริงโดยค่าเริ่มต้น ซึ่งจะเพิ่มพื้นหลังทึบแสง 80% ในการนำทางแบบ 3 ปุ่ม
• แถบสถานะ
  • โปร่งใสโดยค่าเริ่มต้น
  • ระบบจะปิดใช้การชดเชยด้านบนเพื่อให้เนื้อหาแสดงอยู่ด้านหลังแถบสถานะ เว้นแต่จะมีการใช้ ระยะขอบ
  • setStatusBarColor และ R.attr#statusBarColor เลิกใช้งานแล้วและจะไม่มีผลกับ Android 15
  • setStatusBarContrastEnforced และ R.attr#statusBarContrastEnforced ถูกเลิกใช้งานแล้ว แต่ยังคงส่งผลต่อ Android 15
• รอยบากบนจอแสดงผล
  • layoutInDisplayCutoutMode ของหน้าต่างที่ไม่ลอยต้องเป็น LAYOUT_IN_DISPLAY_CUTOUT_MODE_ALWAYS ระบบจะตีความ SHORT_EDGES, NEVER และ DEFAULT เป็น ALWAYS เพื่อให้ผู้ใช้ไม่เห็นแถบสีดำ ที่เกิดจากการเว้นขอบจอแสดงผล และปรากฏแบบขอบจรดขอบ

ตัวอย่างต่อไปนี้แสดงแอปก่อนและหลังการกำหนดเป้าหมายเป็น Android 15 (API ระดับ 35) รวมถึงก่อนและหลังการใช้ส่วนที่เว้นไว้ ตัวอย่างนี้ไม่ครอบคลุมทั้งหมด และอาจปรากฏแตกต่างกันใน Android Auto

สิ่งที่ต้องตรวจสอบหากแอปเป็นแบบขอบจรดขอบอยู่แล้ว

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

• คุณมีหน้าต่างที่ไม่ลอย เช่น Activity ที่ใช้ SHORT_EDGES, NEVER หรือ DEFAULT แทน LAYOUT_IN_DISPLAY_CUTOUT_MODE_ALWAYS หากแอปขัดข้องเมื่อเปิดใช้งาน ปัญหานี้ อาจเกิดจากหน้าจอเริ่มต้น คุณจะอัปเกรดการขึ้นต่อcore splashscreen เป็น 1.2.0-alpha01 หรือใหม่กว่า หรือตั้งค่า window.attributes.layoutInDisplayCutoutMode = WindowManager.LayoutInDisplayCutoutMode.always ก็ได้
• อาจมีหน้าจอที่มีการเข้าชมต่ำซึ่งมี UI ที่ถูกบดบัง ตรวจสอบว่าหน้าจอที่มีการเข้าชมน้อยกว่าเหล่านี้ไม่มี UI ที่ถูกบดบัง หน้าจอที่มีการเข้าชมต่ำ ได้แก่
  • หน้าจอเริ่มต้นใช้งานหรือลงชื่อเข้าใช้
  • หน้าการตั้งค่า

สิ่งที่ต้องตรวจสอบหากแอปยังไม่แสดงแบบขอบจรดขอบ

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

• หากแอปใช้คอมโพเนนต์ Material 3 ( androidx.compose.material3) ใน Compose เช่น TopAppBar, BottomAppBar และ NavigationBar คอมโพเนนต์เหล่านี้ไม่ น่าจะได้รับผลกระทบเนื่องจากจะจัดการระยะขอบโดยอัตโนมัติ
• หากแอปใช้คอมโพเนนต์ Material 2 ( androidx.compose.material) ใน Compose คอมโพเนนต์เหล่านี้ จะไม่จัดการระยะขอบโดยอัตโนมัติ อย่างไรก็ตาม คุณสามารถเข้าถึงระยะขอบ และใช้ระยะขอบด้วยตนเองได้ ใน androidx.compose.material 1.6.0 ขึ้นไป ให้ใช้พารามิเตอร์ windowInsets เพื่อใช้ Inset ด้วยตนเองสำหรับ BottomAppBar, TopAppBar, BottomNavigation และ NavigationRail เช่นเดียวกัน ให้ใช้พารามิเตอร์ contentWindowInsets สำหรับ Scaffold
• หากแอปใช้ View และคอมโพเนนต์ Material (com.google.android.material) คอมโพเนนต์ Material ส่วนใหญ่ที่อิงตาม View เช่น BottomNavigationView, BottomAppBar, NavigationRailView หรือ NavigationView จะจัดการระยะขอบภายในและไม่จำเป็นต้องดำเนินการเพิ่มเติม แต่คุณต้องเพิ่ม android:fitsSystemWindows="true" หากใช้ AppBarLayout
• สำหรับ Composable ที่กำหนดเอง ให้ใช้ Inset เป็น Padding ด้วยตนเอง หากเนื้อหาอยู่ภายใน Scaffold คุณจะใช้ขอบในได้โดยใช้Scaffold ค่าระยะห่างภายใน หรือใช้ระยะห่างโดยใช้หนึ่งใน WindowInsets
• หากแอปของคุณใช้มุมมองและ BottomSheet, SideSheet หรือคอนเทนเนอร์ที่กำหนดเอง ให้ใช้ระยะห่างภายในโดยใช้ ViewCompat.setOnApplyWindowInsetsListener สำหรับ RecyclerView ให้ใช้ระยะห่างจากขอบโดยใช้ Listener นี้ และเพิ่ม clipToPadding="false" ด้วย

สิ่งที่ต้องตรวจสอบหากแอปต้องมีการคุ้มครองเบื้องหลังที่กำหนดเอง

หากแอปต้องมีการป้องกันพื้นหลังที่กำหนดเองสำหรับการนำทางด้วย 3 ปุ่มหรือแถบสถานะ แอปควรวาง Composable หรือ View ไว้ด้านหลังแถบระบบโดยใช้ WindowInsets.Type#tappableElement() เพื่อรับความสูงของแถบนำทางด้วย 3 ปุ่มหรือ WindowInsets.Type#statusBars

แหล่งข้อมูลเพิ่มเติมแบบขอบจรดขอบ

ดูข้อควรพิจารณาเพิ่มเติมเกี่ยวกับการใช้ระยะขอบได้ในคำแนะนำมุมมองแบบขอบจรดขอบและการเขียนแบบขอบจรดขอบ

API ที่เลิกใช้งานแล้ว

API ต่อไปนี้เลิกใช้งานแล้วแต่ยังไม่ได้ปิดใช้

• R.attr#enforceStatusBarContrast
• R.attr#navigationBarColor (สำหรับการนำทางแบบ 3 ปุ่มที่มีอัลฟ่า 80% )
• Window#isStatusBarContrastEnforced
• Window#setNavigationBarColor (สำหรับการนำทางแบบ 3 ปุ่ม โดยมี อัลฟ่า 80%)
• Window#setStatusBarContrastEnforced

API ต่อไปนี้เลิกใช้งานแล้วและถูกปิดใช้

• R.attr#navigationBarColor (สำหรับการนำทางด้วยท่าทางสัมผัส)
• R.attr#navigationBarDividerColor
• R.attr#statusBarColor
• Window#setDecorFitsSystemWindows
• Window#getNavigationBarColor
• Window#getNavigationBarDividerColor
• Window#getStatusBarColor
• Window#setNavigationBarColor (สำหรับการนำทางด้วยท่าทางสัมผัส)
• Window#setNavigationBarDividerColor
• Window#setStatusBarColor

การกำหนดค่าที่เสถียร

If your app targets Android 15 (API level 35) or higher, Configuration no longer excludes the system bars. If you use the screen size in the Configuration class for layout calculation, you should replace it with better alternatives like an appropriate ViewGroup, WindowInsets, or WindowMetricsCalculator depending on your need.

Configuration has been available since API 1. It is typically obtained from Activity.onConfigurationChanged. It provides information like window density, orientation, and sizes. One important characteristic about the window sizes returned from Configuration is that it previously excluded the system bars.

The configuration size is typically used for resource selection, such as /res/layout-h500dp, and this is still a valid use case. However, using it for layout calculation has always been discouraged. If you do so, you should move away from it now. You should replace the use of Configuration with something more suitable depending on your use case.

If you use it to calculate the layout, use an appropriate ViewGroup, such as CoordinatorLayout or ConstraintLayout. If you use it to determine the height of the system navbar, use WindowInsets. If you want to know the current size of your app window, use computeCurrentWindowMetrics.

The following list describes the fields affected by this change:

• Configuration.screenWidthDp and screenHeightDp sizes no longer exclude the system bars.
• Configuration.smallestScreenWidthDp is indirectly affected by changes to screenWidthDp and screenHeightDp.
• Configuration.orientation is indirectly affected by changes to screenWidthDp and screenHeightDp on close-to-square devices.
• Display.getSize(Point) is indirectly affected by the changes in Configuration. This was deprecated beginning in API level 30.
• Display.getMetrics() has already worked like this since API level 33.

แอตทริบิวต์ elegantTextHeight จะมีค่าเริ่มต้นเป็น true

For apps targeting Android 15 (API level 35), the elegantTextHeight TextView attribute becomes true by default, replacing the compact font used by default with some scripts that have large vertical metrics with one that is much more readable. The compact font was introduced to prevent breaking layouts; Android 13 (API level 33) prevents many of these breakages by allowing the text layout to stretch the vertical height utilizing the fallbackLineSpacing attribute.

In Android 15, the compact font still remains in the system, so your app can set elegantTextHeight to false to get the same behavior as before, but it is unlikely to be supported in upcoming releases. So, if your app supports the following scripts: Arabic, Lao, Myanmar, Tamil, Gujarati, Kannada, Malayalam, Odia, Telugu or Thai, test your app by setting elegantTextHeight to true.

การเปลี่ยนแปลงความกว้างของ TextView สำหรับรูปร่างตัวอักษรที่ซับซ้อน

In previous versions of Android, some cursive fonts or languages that have complex shaping might draw the letters in the previous or next character's area. In some cases, such letters were clipped at the beginning or ending position. Starting in Android 15, a TextView allocates width for drawing enough space for such letters and allows apps to request extra paddings to the left to prevent clipping.

Because this change affects how a TextView decides the width, TextView allocates more width by default if the app targets Android 15 (API level 35) or higher. You can enable or disable this behavior by calling the setUseBoundsForWidth API on TextView.

Because adding left padding might cause a misalignment for existing layouts, the padding is not added by default even for apps that target Android 15 or higher. However, you can add extra padding to preventing clipping by calling setShiftDrawingOffsetForStartOverhang.

The following examples show how these changes can improve text layout for some fonts and languages.

Standard layout for English text in a cursive font. Some of the letters are clipped. Here is the corresponding XML:

<TextView
    android:fontFamily="cursive"
    android:text="java" />

Layout for the same English text with additional width and padding. Here is the corresponding XML:

<TextView
    android:fontFamily="cursive"
    android:text="java"
    android:useBoundsForWidth="true"
    android:shiftDrawingOffsetForStartOverhang="true" />

Standard layout for Thai text. Some of the letters are clipped. Here is the corresponding XML:

<TextView
    android:text="คอมพิวเตอร์" />

Layout for the same Thai text with additional width and padding. Here is the corresponding XML:

<TextView
    android:text="คอมพิวเตอร์"
    android:useBoundsForWidth="true"
    android:shiftDrawingOffsetForStartOverhang="true" />

ความสูงของบรรทัดเริ่มต้นที่รับรู้ภาษาสำหรับ EditText

In previous versions of Android, the text layout stretched the height of the text to meet the line height of the font that matched the current locale. For example, if the content was in Japanese, because the line height of the Japanese font is slightly larger than the one of a Latin font, the height of the text became slightly larger. However, despite these differences in line heights, the EditText element was sized uniformly, regardless of the locale being used, as illustrated in the following image:

For apps targeting Android 15 (API level 35), a minimum line height is now reserved for EditText to match the reference font for the specified Locale, as shown in the following image:

If needed, your app can restore the previous behavior by specifying the useLocalePreferredLineHeightForMinimum attribute to false, and your app can set custom minimum vertical metrics using the setMinimumFontMetrics API in Kotlin and Java.

กล้องและสื่อ

Android 15 จะทำการเปลี่ยนแปลงลักษณะการทำงานของกล้องและสื่อสำหรับแอปที่กำหนดเป้าหมายเป็น Android 15 ขึ้นไปดังนี้

ข้อจำกัดในการขอโฟกัสเสียง

แอปที่กำหนดเป้าหมายเป็น Android 15 (API ระดับ 35) ต้องเป็นแอปที่ทำงานอยู่ด้านบนหรือกำลังใช้บริการที่ทำงานอยู่เบื้องหน้าเพื่อขอโฟกัสเสียง หากแอปพยายามขอโฟกัสเมื่อไม่เป็นไปตามข้อกำหนดข้อใดข้อหนึ่งเหล่านี้ การเรียกใช้จะแสดงผลเป็น AUDIOFOCUS_REQUEST_FAILED

ดูข้อมูลเพิ่มเติมเกี่ยวกับโหมดโฟกัสเสียงได้ที่จัดการโหมดโฟกัสเสียง

ข้อจำกัดที่ไม่ใช่ SDK ที่อัปเดตแล้ว

Android 15 includes updated lists of restricted non-SDK interfaces based on collaboration with Android developers and the latest internal testing. Whenever possible, we make sure that public alternatives are available before we restrict non-SDK interfaces.

If your app does not target Android 15, some of these changes might not immediately affect you. However, while it's possible for your app to access some non-SDK interfaces depending on your app's target API level, using any non-SDK method or field always carries a high risk of breaking your app.

If you are unsure if your app uses non-SDK interfaces, you can test your app to find out. If your app relies on non-SDK interfaces, you should begin planning a migration to SDK alternatives. Nevertheless, we understand that some apps have valid use cases for using non-SDK interfaces. If you can't find an alternative to using a non-SDK interface for a feature in your app, you should request a new public API.

To learn more about the changes in this release of Android, see Updates to non-SDK interface restrictions in Android 15. To learn more about non-SDK interfaces generally, see Restrictions on non-SDK interfaces.