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

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

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

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

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

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

เราจะทำการเปลี่ยนแปลงต่อไปนี้กับบริการที่ทำงานอยู่เบื้องหน้าใน Android 15

ลักษณะการหมดเวลาของบริการที่ทำงานอยู่เบื้องหน้าของการซิงค์ข้อมูล

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

ประเภทบริการที่ทำงานอยู่เบื้องหน้าใหม่สำหรับการประมวลผลสื่อ

Android 15 引入了一种新的前台服务类型 mediaProcessing。此服务类型适用于转码媒体文件等操作。例如，媒体应用可能会下载音频文件，并需要先将其转换为其他格式，然后才能播放。您可以使用 mediaProcessing 前台服务，确保即使应用在后台运行时转换也会继续。

系统允许应用的 mediaProcessing 服务在 24 小时内总共运行 6 小时，之后系统会调用正在运行的服务的 Service.onTimeout(int, int) 方法（在 Android 15 中引入）。此时，服务有几秒钟的时间来调用 Service.stopSelf()。如果服务未调用 Service.stopSelf()，系统会抛出内部异常。系统会在 Logcat 中记录此异常，并显示以下消息：

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

为避免出现此异常，您可以执行以下任一操作：

  1. 让您的服务实现新的 Service.onTimeout(int, int) 方法。当您的应用收到回调时，请务必在几秒钟内调用 stopSelf()。（如果您未立即停止应用，系统会生成失败情况。）
  2. 确保应用的 mediaProcessing 服务在任何 24 小时内总运行时间不超过 6 小时（除非用户与应用互动，重置计时器）。
  3. 仅在有直接用户互动时启动 mediaProcessing 前台服务；由于服务启动时应用位于前台，因此您的服务在应用进入后台后有完整的 6 小时时间。
  4. 请改用 替代 API（例如 WorkManager），而不是使用 mediaProcessing 前台服务。

如果您的应用的 mediaProcessing 前台服务在过去 24 小时内运行了 6 小时，则您无法启动其他 mediaProcessing 前台服务，除非用户将您的应用切换到前台（这会重置计时器）。如果您尝试启动另一个 mediaProcessing 前台服务，系统会抛出 ForegroundServiceStartNotAllowedException，并显示类似于“前台服务类型 mediaProcessing 的时间限制已用尽”的错误消息。

如需详细了解 mediaProcessing 服务类型，请参阅 Android 15 前台服务类型变更：媒体处理。

测试

如需测试应用的行为，您可以启用媒体处理超时，即使您的应用并非以 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 media_processing_fgs_timeout_duration duration-in-milliseconds

ข้อจำกัดเกี่ยวกับ Broadcast Receiver BOOT_COMPLETED ที่เปิดบริการที่ทำงานอยู่เบื้องหน้า

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

หากตัวรับสัญญาณ 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

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

ก่อนหน้านี้ หากแอปมีสิทธิ์ 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 ที่เจ้าของเปิดใช้งานไว้ก่อนหน้านี้

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

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

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

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

    ตัวอย่างเช่น ระบบจะแสดงข้อยกเว้นต่อไปนี้เมื่อใช้อาร์กิวเมนต์ดัชนี 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() จะตรงกับ Random.nextInt()

SequencedCollection API ใหม่นี้อาจส่งผลต่อความเข้ากันได้ของแอปหลังจากที่คุณอัปเดต 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() แบบคงที่ไปยัง List API ใหม่แทนที่จะเป็นฟังก์ชันส่วนขยายใน 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' } ออกหากปิดใช้ตัวเลือก Lint แล้ว

  • ความขัดแย้งกับเมธอดอื่นๆ ใน 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 ขอแนะนำ StrictMode สำหรับ Intent

หากต้องการดูบันทึกโดยละเอียดเกี่ยวกับการละเมิดการใช้งาน Intent ให้ใช้วิธีต่อไปนี้

Kotlin

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

Java

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

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

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

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

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

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

如果应用以 Android 15（API 级别 35）为目标平台，则在搭载 Android 15 的设备上默认以无边框显示。

以 Android 14 为目标平台且在 Android 15 设备上未以无边框显示的应用。


以 Android 15（API 级别 35）为目标平台且以无边框显示 的 Android 15 设备上的应用。此应用主要使用会自动应用边衬区的 Material 3 Compose 组件 。此屏幕不会受到 Android 15 无边框强制执行的不利影响。

这是一项重大变更，可能会对应用的界面产生不利影响。这些变更会影响以下界面区域：

  • 手势提示条导航栏
    • 默认透明。
    • 底部偏移已停用，因此除非应用了边衬区，否则内容会绘制在系统导航栏后面。
    • setNavigationBarColor 和 R.attr#navigationBarColor 已弃用，不会影响手势导航。
    • setNavigationBarContrastEnforced 和 R.attr#navigationBarContrastEnforced 仍不会影响手势导航。
  • 三按钮导航
    • 默认情况下，不透明度设置为 80%，颜色可能与窗口背景颜色一致。
    • 底部偏移已停用，因此除非应用了边衬区，否则内容会绘制在系统导航栏后面。
    • setNavigationBarColor 和 R.attr#navigationBarColor 默认设置为与窗口背景颜色一致。窗口背景必须是颜色可绘制对象，才能应用此默认设置。此 API 已弃用，但仍会影响三按钮导航。
    • setNavigationBarContrastEnforced 和 R.attr#navigationBarContrastEnforced 默认值为 true，这会在三按钮导航中添加 80% 不透明的背景。
  • 状态栏
    • 默认透明。
    • 顶部偏移已停用，因此除非应用了边衬区，否则内容会绘制在状态栏后面。
    • 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 上可能会显示不同的效果。

以 Android 14 为目标平台且在 Android 15 设备上未以无边框显示的应用。
以 Android 15（API 级别 35）为目标平台且在 Android 15 设备上以无边框显示的应用。不过，由于 Android 15 无边框强制执行，许多元素现在会被状态栏、三按钮导航栏或刘海屏遮盖。被遮盖的界面包括 Material 2 顶部应用栏、悬浮操作按钮和列表项。
以 Android 15（API 级别 35）为目标平台且在 Android 15 设备上以无边框显示的应用，并应用了边衬区，因此界面不会被 遮盖。
如果您的应用已以无边框显示，需要检查哪些内容

如果您的应用已以 无边框 显示并应用了边衬区，则大部分情况下 不会受到影响，但在以下情形中除外。不过，即使您认为自己不会受到影响，我们也建议您测试应用。

  • 您有一个非浮动窗口，例如使用 SHORT_EDGES、NEVER 或 DEFAULT 而不是 LAYOUT_IN_DISPLAY_CUTOUT_MODE_ALWAYS 的 Activity。如果您的应用在启动时崩溃，可能是因为启动画面所致。您可以将 核心 启动画面 依赖项升级到 1.2.0-alpha01 或更高版本，也可以设置 window.attributes.layoutInDisplayCutoutMode = WindowManager.LayoutInDisplayCutoutMode.always。
  • 可能存在流量较低的屏幕，其界面被遮盖。验证这些访问量较少的屏幕是否没有被遮盖的界面。流量较低的屏幕包括：
    • 新手入门或登录屏幕
    • “设置”页面
如果您的应用尚未以无边框显示，需要检查哪些内容

如果您的应用尚未以无边框显示，则很可能会受到影响。除了已以无边框显示的应用的情形之外，您还应考虑以下情况：

  • 如果您的应用在 Compose 中使用了 Material 3 组件 ( androidx.compose.material3)，例如 TopAppBar、 BottomAppBar 和 NavigationBar，这些组件可能不会 受到影响，因为它们会自动处理边衬区。
  • 如果应用使用的是 Compose 中的 Material 2 组件 ( androidx.compose.material)，这些组件 本身并不会自动处理边衬区。不过，您可以获得边衬区的访问权限，然后手动应用边衬区。在 androidx.compose.material 1.6.0 及更高版本中，使用 windowInsets 参数可为 BottomAppBar、TopAppBar、 BottomNavigation 和 NavigationRail 手动应用边衬区。 同样，对于 Scaffold，请使用 contentWindowInsets 参数。
  • 如果应用使用了视图和 Material 组件 (com.google.android.material)，则大多数基于视图的 Material 组件（例如 BottomNavigationView、BottomAppBar、 NavigationRailView 或 NavigationView）都会处理边衬区，因此不需要执行额外的操作。不过，您需要添加 android:fitsSystemWindows="true" ，如果使用 AppBarLayout。
  • 对于自定义可组合项，请手动应用边衬区作为内边距。如果您的 内容位于 Scaffold 中，则可以使用 Scaffold 内边距值来使用边衬区。否则，请使用其中一个 WindowInsets应用内边距。
  • 如果应用使用的是视图和 BottomSheet、SideSheet 或自定义 容器，请使用 ViewCompat.setOnApplyWindowInsetsListener应用内边距。对于 RecyclerView，请使用此监听器应用内边距，同时添加 clipToPadding="false"。
如果您的应用必须提供自定义背景保护，需要检查哪些内容

如果您的应用必须为“三按钮”导航或 状态栏提供自定义背景保护，则应用应使用 WindowInsets.Type#tappableElement() 将可组合函数或视图放置在系统栏后面 ，以获取“三按钮” 导航栏高度或 WindowInsets.Type#statusBars。

其他无边框资源

如需了解有关应用边衬区的其他注意事项，请参阅无边框视图和无边框 Compose 指南。

已弃用的 API

以下 API 已弃用，但未停用：

以下 API 已弃用并已停用：

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

如果您的应用以 Android 15（API 级别 35）或更高版本为目标平台，Configuration 不再排除系统栏。如果您在 Configuration 类中使用屏幕尺寸进行布局计算，则应根据需要将其替换为更好的替代方案，例如适当的 ViewGroup、WindowInsets 或 WindowMetricsCalculator。

Configuration 自 API 1 起可用。它通常从 Activity.onConfigurationChanged 获取。它提供窗口密度、屏幕方向和尺寸等信息。从 Configuration 返回的窗口尺寸的一个重要特征是，它之前排除了系统栏。

配置尺寸通常用于资源选择，例如 /res/layout-h500dp，这仍然是一个有效的用例。但是，我们一直不建议将其用于布局计算。如果您这样做，现在应该停止。您应该根据自己的用例，将 Configuration 的使用替换为更合适的内容。

如果您使用它来计算布局，请使用适当的 ViewGroup，例如 CoordinatorLayout 或 ConstraintLayout。如果您使用它来确定系统导航栏的高度，请使用 WindowInsets。如果您想知道应用窗口的当前尺寸，请使用 computeCurrentWindowMetrics。

以下列表介绍了受此更改影响的字段：

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

สําหรับแอปที่กําหนดเป้าหมายเป็น Android 15 (API ระดับ 35) แอตทริบิวต์ elegantTextHeight TextView จะเปลี่ยนเป็น true โดยค่าเริ่มต้น โดยแทนที่แบบอักษรแบบกะทัดรัดที่ใช้โดยค่าเริ่มต้นด้วยสคริปต์บางรายการที่มีเมตริกแนวตั้งขนาดใหญ่ด้วยแบบอักษรที่อ่านง่ายกว่ามาก แบบอักษรแบบกะทัดรัดมีไว้เพื่อป้องกันการแบ่งเลย์เอาต์ Android 13 (API ระดับ 33) ป้องกันปัญหาการแบ่งเลย์เอาต์เหล่านี้ได้หลายอย่างโดยอนุญาตให้เลย์เอาต์ข้อความยืดความสูงแนวตั้งโดยใช้แอตทริบิวต์ fallbackLineSpacing

ใน Android 15 ฟอนต์แบบกะทัดรัดจะยังคงอยู่ในระบบ แอปของคุณจึงตั้งค่า elegantTextHeight เป็น false เพื่อให้มีลักษณะการทำงานเหมือนเดิมได้ แต่ไม่น่าจะได้รับการสนับสนุนในรุ่นที่กำลังจะเปิดตัว ดังนั้น หากแอปของคุณรองรับสคริปต์ต่อไปนี้ อาหรับ ลาว พม่า ทมิฬ คุชราต กันนาดา มาลายาลัม โอเดีย เตลูกู หรือไทย ให้ทดสอบแอปโดยตั้งค่า elegantTextHeight เป็น true

ลักษณะการทํางานของ
elegantTextHeight สําหรับแอปที่กําหนดเป้าหมายเป็น Android 14 (API ระดับ 34) และต่ำกว่า
ลักษณะการทํางานของ
elegantTextHeight สําหรับแอปที่กําหนดเป้าหมายเป็น Android 15

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

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

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

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

ตัวอย่างต่อไปนี้แสดงให้เห็นว่าการเปลี่ยนแปลงเหล่านี้ช่วยปรับปรุงเลย์เอาต์ข้อความสำหรับแบบอักษรและภาษาบางแบบได้อย่างไร

เลย์เอาต์มาตรฐานสำหรับข้อความภาษาอังกฤษในแบบอักษรที่ตัวห้อย ตัวอักษรบางตัวถูกตัด XML ที่เกี่ยวข้องมีดังนี้

<TextView
    android:fontFamily="cursive"
    android:text="java" />
เลย์เอาต์สำหรับข้อความภาษาอังกฤษเดียวกันนี้โดยเพิ่มความกว้างและการเว้นวรรค XML ที่เกี่ยวข้องมีดังนี้

<TextView
    android:fontFamily="cursive"
    android:text="java"
    android:useBoundsForWidth="true"
    android:shiftDrawingOffsetForStartOverhang="true" />
เลย์เอาต์มาตรฐานสำหรับข้อความภาษาไทย ตัวอักษรบางตัวถูกตัด XML ที่เกี่ยวข้องมีดังนี้

<TextView
    android:text="คอมพิวเตอร์" />
เลย์เอาต์สำหรับข้อความภาษาไทยเดียวกันนี้ที่มีความกว้างและระยะห่างจากขอบเพิ่มเติม นี่คือ XML ที่เกี่ยวข้อง:

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

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

在较低版本的 Android 中，文本布局会拉伸文本的高度，以满足与当前语言区域匹配的字体的行高。例如，如果内容是日语，由于日语字体的行高略高于拉丁字体，因此文本的高度会略高。不过，尽管行高存在这些差异，但无论使用的是哪种语言区域，EditText 元素的大小都是统一的，如下图所示：

三个框，表示可以包含英语 (en)、日语 (ja) 和缅甸语 (my) 文本的 EditText 元素。EditText 的高度相同，即使这些语言的行高各不相同。

对于以 Android 15（API 级别 35）为目标平台的应用，现在为 EditText 预留了最小行高，以匹配指定语言区域的参考字体，如下图所示：

三个框，表示可以包含英语 (en)、日语 (ja) 和缅甸语 (my) 文本的 EditText 元素。EditText 的高度现在包含足够的空间来容纳这些语言字体的默认行高。

如有需要，您的应用可以将 useLocalePreferredLineHeightForMinimum 属性指定为 false，以恢复之前的行为；您的应用还可以在 Kotlin 和 Java 中使用 setMinimumFontMetrics API 设置自定义最小垂直指标。

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

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

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

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

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

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

Android 15 包含更新后的受限非 SDK 接口列表（基于与 Android 开发者之间的协作以及最新的内部测试）。在限制使用非 SDK 接口之前，我们会尽可能确保有可用的公开替代方案。

如果您的应用并非以 Android 15 为目标平台，其中一些变更可能不会立即对您产生影响。不过，虽然您的应用可以访问某些非 SDK 接口（具体取决于应用的目标 API 级别），但只要您使用任何非 SDK 方法或字段，就很有可能会造成应用功能异常。

如果您不确定自己的应用是否使用了非 SDK 接口，则可以通过 测试该应用来进行确认。如果您的应用依赖非 SDK 接口，则应开始计划迁移到 SDK 替代方案。不过，我们知道某些应用存在使用非 SDK 接口的合理场景。如果您无法为应用中的某项功能找到使用非 SDK 接口的替代方案，则应该请求新的公共 API。

ดูข้อมูลเพิ่มเติมเกี่ยวกับการเปลี่ยนแปลงใน Android เวอร์ชันนี้ได้ที่การอัปเดตข้อจำกัดของอินเทอร์เฟซที่ไม่ใช่ SDK ใน Android 15 ดูข้อมูลเพิ่มเติมเกี่ยวกับอินเทอร์เฟซที่ไม่ใช่ SDK โดยทั่วไปได้ที่ข้อจำกัดเกี่ยวกับอินเทอร์เฟซที่ไม่ใช่ SDK