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

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

นอกจากนี้ โปรดดูรายการการเปลี่ยนแปลงลักษณะการทำงานที่ส่งผลต่อแอปทั้งหมดที่ทำงานใน Android 12 ด้วย

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

การแจ้งเตือนที่กำหนดเอง

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

สําหรับแอปที่กําหนดเป้าหมายเป็น Android 12 การแจ้งเตือนที่มีมุมมองเนื้อหาที่กําหนดเองจะไม่ใช้พื้นที่การแจ้งเตือนแบบเต็มอีกต่อไป ระบบจะใช้เทมเพลตมาตรฐานแทน เทมเพลตนี้ช่วยให้มั่นใจว่าการแจ้งเตือนที่กําหนดเองจะมีการตกแต่งเหมือนกับการแจ้งเตือนอื่นๆ ในทุกสถานะ เช่น ไอคอนและการขยายการแจ้งเตือน (ในสถานะยุบ) รวมถึงไอคอน การแจ้งเตือน ชื่อแอป และการยุบการแจ้งเตือน (ในสถานะขยาย) ลักษณะการทํางานนี้เกือบจะเหมือนกับลักษณะการทํางานของ Notification.DecoratedCustomViewStyle

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

ภาพต่อไปนี้แสดงการแจ้งเตือนที่กําหนดเองในเทมเพลตมาตรฐาน

ตัวอย่างต่อไปนี้แสดงวิธีที่การแจ้งเตือนที่กําหนดเองจะแสดงผลในสถานะแบบยุบและแบบขยาย

การเปลี่ยนแปลงใน Android 12 จะส่งผลต่อแอปที่กำหนดคลาสย่อยที่กำหนดเองของ Notification.Style หรือใช้เมธอดของ Notification.Builder ซึ่งได้แก่ setCustomContentView(RemoteViews), setCustomBigContentView(RemoteViews) และ setCustomHeadsUpContentView(RemoteViews)

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

1. เปิดใช้การเปลี่ยนแปลงการแจ้งเตือนที่กำหนดเอง

   1. เปลี่ยน targetSdkVersion ของแอปเป็น S เพื่อเปิดใช้ลักษณะการทำงานใหม่
   2. คอมไพล์อีกครั้ง
   3. ติดตั้งแอปในอุปกรณ์หรือโปรแกรมจำลองที่ใช้ Android 12

2. ทดสอบการแจ้งเตือนทั้งหมดที่ใช้มุมมองที่กำหนดเองเพื่อให้แน่ใจว่าดูดีในโหมดแสงน้อย ขณะทดสอบ ให้พิจารณาสิ่งต่อไปนี้และทำการปรับเปลี่ยนที่จำเป็น

   • มิติข้อมูลของมุมมองที่กําหนดเองมีการเปลี่ยนแปลง โดยทั่วไปแล้ว ความสูงที่กําหนดให้กับการแจ้งเตือนที่กําหนดเองจะน้อยกว่าก่อนหน้านี้ ในสภาวะยุบ ความสูงสูงสุดของเนื้อหาที่กําหนดเองลดลงจาก 106 dp เป็น 48 dp และมีพื้นที่ในแนวนอนน้อยกว่า

   • การแจ้งเตือนทั้งหมดจะขยายได้สำหรับแอปที่กำหนดเป้าหมายเป็น Android 12 โดยทั่วไปแล้ว หมายความว่าหากคุณใช้ setCustomContentView ก็ควรใช้ setBigCustomContentView ด้วยเพื่อให้สถานะแบบยุบและแบบขยายสอดคล้องกัน

   • อย่าลืมเพิ่มความสำคัญของช่องทางการแจ้งเตือนเป็น "สูง" (ปรากฏบนหน้าจอ) เพื่อให้สถานะ "แจ้งเตือน" ปรากฏตามที่คาดไว้

การเปลี่ยนแปลงการยืนยัน App Link ของ Android

ในแอปที่กำหนดเป้าหมายเป็น Android 12 ขึ้นไป ระบบจะทำการเปลี่ยนแปลงหลายอย่างเกี่ยวกับวิธียืนยัน App Link ของ Android การเปลี่ยนแปลงเหล่านี้จะช่วยเพิ่มความน่าเชื่อถือของประสบการณ์การลิงก์แอปและมอบการควบคุมที่มากขึ้นให้แก่นักพัฒนาแอปและผู้ใช้ปลายทาง

หากคุณใช้การยืนยัน App Link ของ Android เพื่อเปิดเว็บลิงก์ในแอป ให้ตรวจสอบว่าคุณใช้รูปแบบที่ถูกต้องเมื่อเพิ่มตัวกรอง Intent สำหรับการยืนยัน App Link ของ Android โดยเฉพาะอย่างยิ่ง โปรดตรวจสอบว่าตัวกรอง Intent เหล่านี้มีหมวดหมู่ BROWSABLE และรองรับรูปแบบ https

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

การปรับปรุงลักษณะการทํางานของภาพซ้อนภาพ

Android 12 มีการปรับปรุงลักษณะการทํางานของโหมดภาพในภาพ (PiP) และแนะนําการปรับปรุงภาพเคลื่อนไหวการเปลี่ยนภาพสําหรับทั้งการไปยังส่วนต่างๆ ด้วยท่าทางสัมผัสและการไปยังส่วนต่างๆ ตามองค์ประกอบ

ดูข้อมูลเพิ่มเติมเกี่ยวกับการปรับปรุงฟีเจอร์ภาพในภาพ

การออกแบบใหม่ของข้อความ Toast

ใน Android 12 มุมมองข้อความแจ้งได้รับการออกแบบใหม่ ตอนนี้ระบบจะจำกัดข้อความของป๊อปอัปไว้ที่ 2 บรรทัด และแสดงไอคอนแอปพลิเคชันข้างข้อความ

ดูรายละเอียดเพิ่มเติมได้ที่ภาพรวมของ Toast

ความปลอดภัยและความเป็นส่วนตัว

ตำแหน่งโดยประมาณ

ในอุปกรณ์ที่ใช้ Android 12 ขึ้นไป ผู้ใช้จะขอความแม่นยำของตำแหน่งโดยประมาณสำหรับแอปของคุณได้

คุกกี้ SameSite สมัยใหม่ใน WebView

คอมโพเนนต์ WebView ของ Android อิงตาม Chromium ซึ่งเป็นโปรเจ็กต์โอเพนซอร์สที่ขับเคลื่อนเบราว์เซอร์ Chrome ของ Google Chromium ได้เปิดตัวการเปลี่ยนแปลงการจัดการคุกกี้ของบุคคลที่สามเพื่อเพิ่มความปลอดภัยและความเป็นส่วนตัว ตลอดจนเพิ่มความโปร่งใสและการควบคุมให้แก่ผู้ใช้ ตั้งแต่ Android 12 เป็นต้นไป การเปลี่ยนแปลงเหล่านี้จะรวมอยู่ใน WebView ด้วยเมื่อแอปกำหนดเป้าหมายเป็น Android 12 (API ระดับ 31) ขึ้นไป

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

• ระบบจะถือว่าคุกกี้ที่ไม่มีแอตทริบิวต์ SameSite เป็น SameSite=Lax
• คุกกี้ที่มี SameSite=None จะต้องระบุแอตทริบิวต์ Secure ด้วย ซึ่งหมายความว่าคุกกี้เหล่านี้ต้องมีบริบทที่ปลอดภัยและควรส่งผ่าน HTTPS
• ตอนนี้ระบบจะถือว่าลิงก์ระหว่างเวอร์ชัน HTTP และ HTTPS ของเว็บไซต์เป็นคำขอข้ามเว็บไซต์ ดังนั้นระบบจะไม่ส่งคุกกี้ เว้นแต่จะมีการทําเครื่องหมายคุกกี้เป็น SameSite=None; Secure อย่างเหมาะสม

สําหรับนักพัฒนาซอฟต์แวร์ หลักเกณฑ์ทั่วไปคือให้ระบุความเชื่อมโยงของคุกกี้ข้ามเว็บไซต์ในเส้นทางของผู้ใช้ที่สําคัญ และตรวจสอบว่าได้ตั้งค่าแอตทริบิวต์ SameSite อย่างชัดเจนด้วยค่าที่เหมาะสมตามที่ต้องการ คุณต้องระบุคุกกี้ที่อนุญาตให้ทํางานในเว็บไซต์ต่างๆ หรือในการนําทางในเว็บไซต์เดียวกันซึ่งเปลี่ยนจาก HTTP เป็น HTTPS อย่างชัดเจน

ดูคําแนะนําทั้งหมดสําหรับนักพัฒนาเว็บเกี่ยวกับการเปลี่ยนแปลงเหล่านี้ได้ที่คำอธิบายคุกกี้ SameSite และ SameSite แบบมีรูปแบบ

ทดสอบลักษณะการทํางานของ SameSite ในแอป

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

ตรวจสอบปัญหาในการเข้าสู่ระบบและเนื้อหาที่ฝัง รวมถึงขั้นตอนการลงชื่อเข้าใช้ การซื้อ และขั้นตอนการตรวจสอบสิทธิ์อื่นๆ ที่ผู้ใช้เริ่มต้นในหน้าเว็บที่ไม่ปลอดภัยและเปลี่ยนไปใช้หน้าเว็บที่ปลอดภัย

หากต้องการทดสอบแอปด้วย WebView คุณต้องเปิดใช้ลักษณะการทํางาน SameSite ใหม่สําหรับแอปที่ต้องการทดสอบโดยทําตามขั้นตอนใดขั้นตอนหนึ่งต่อไปนี้

• เปิดใช้ลักษณะการทำงาน SameSite ในอุปกรณ์ทดสอบด้วยตนเองโดยเปิด/ปิด Flag UI webview-enable-modern-cookie-same-site ใน เครื่องมือสำหรับนักพัฒนาซอฟต์แวร์ WebView

  วิธีนี้ช่วยให้คุณทดสอบในอุปกรณ์ที่ใช้ Android 5.0 (API ระดับ 21) ขึ้นไป รวมถึง Android 12 และ WebView เวอร์ชัน 89.0.4385.0 ขึ้นไปได้

• คอมไพล์แอปให้กำหนดเป้าหมายเป็น Android 12 (API ระดับ 31) ภายในวันที่ targetSdkVersion

  หากใช้แนวทางนี้ คุณต้องใช้อุปกรณ์ที่ใช้ Android 12

ดูข้อมูลเกี่ยวกับการแก้ไขข้อบกพร่องจากระยะไกลสําหรับ WebView ใน Android ได้ที่เริ่มต้นใช้งานการแก้ไขข้อบกพร่องจากระยะไกลในอุปกรณ์ Android

ทรัพยากรอื่นๆ

ดูข้อมูลเพิ่มเติมเกี่ยวกับลักษณะการทำงานสมัยใหม่ของ SameSite และการเปิดตัวใน Chrome และ WebView ได้ที่หน้าอัปเดต SameSite ของ Chromium หากพบข้อบกพร่องใน WebView หรือ Chromium คุณสามารถรายงานได้ในเครื่องมือติดตามปัญหา Chromium สาธารณะ

เซ็นเซอร์ตรวจจับการเคลื่อนไหวมีการจำกัดอัตรา

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

ดูข้อมูลเพิ่มเติมเกี่ยวกับการจำกัดอัตราการส่งข้อมูลเซ็นเซอร์

การพักใช้งานแอป

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

ดูข้อมูลเพิ่มเติมในคู่มือเกี่ยวกับโหมดพักของแอป

การประกาศการระบุแหล่งที่มาในการตรวจสอบการเข้าถึงข้อมูล

API การตรวจสอบการเข้าถึงข้อมูลซึ่งเปิดตัวใน Android 11 (API ระดับ 30) ช่วยให้คุณสร้างแท็กการระบุแหล่งที่มาตาม Use Case ของแอปได้ แท็กเหล่านี้ช่วยให้คุณระบุส่วนที่แอปทำการเข้าถึงข้อมูลประเภทหนึ่งๆ ได้ง่ายขึ้น

หากแอปกำหนดเป้าหมายเป็น Android 12 ขึ้นไป คุณต้องประกาศแท็กการระบุแหล่งที่มาเหล่านี้ในไฟล์ Manifest ของแอป

ข้อจำกัดการสำรองข้อมูล ADB

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

หากเวิร์กโฟลว์การทดสอบหรือการพัฒนาของคุณใช้ข้อมูลแอปโดยใช้ adb backup ตอนนี้คุณเลือกส่งออกข้อมูลของแอปได้โดยการตั้งค่า android:debuggable เป็น true ในไฟล์ Manifest ของแอป

การส่งออกคอมโพเนนต์ที่ปลอดภัยยิ่งขึ้น

หากแอปกำหนดเป้าหมายเป็น Android 12 ขึ้นไป และมี activity, service หรือ broadcast receiver ที่ใช้ Intent Filter คุณต้องประกาศแอตทริบิวต์ android:exported อย่างชัดเจนสำหรับคอมโพเนนต์แอปเหล่านี้

หากคอมโพเนนต์แอปมีหมวดหมู่ LAUNCHER ให้ตั้งค่า android:exported เป็น true ในกรณีอื่นๆ ส่วนใหญ่ ให้ตั้งค่า android:exported เป็น false

ข้อมูลโค้ดต่อไปนี้แสดงตัวอย่างบริการที่มีตัวกรอง Intent ที่ตั้งค่าแอตทริบิวต์ android:exported เป็น false

<service android:name="com.example.app.backgroundService"
         android:exported="false">
    <intent-filter>
        <action android:name="com.example.app.START_BACKGROUND" />
    </intent-filter>
</service>

Messages ใน Android Studio

หากแอปมีกิจกรรม บริการ หรือ Broadcast Receiver ที่ใช้ตัวกรอง Intent แต่ไม่ได้ประกาศ android:exported ระบบจะแสดงข้อความเตือนต่อไปนี้ ทั้งนี้ขึ้นอยู่กับเวอร์ชัน Android Studio ที่คุณใช้

Android Studio 2020.3.1 Canary 11 ขึ้นไป

ข้อความต่อไปนี้จะปรากฏขึ้น

1. คำเตือนเกี่ยวกับ Lint ต่อไปนี้จะปรากฏในไฟล์ Manifest

   When using intent filters, please specify android:exported as well
   

2. เมื่อพยายามคอมไพล์แอป ข้อความแสดงข้อผิดพลาดต่อไปนี้จะปรากฏขึ้น

   Manifest merger failed : Apps targeting Android 12 and higher are required \
   to specify an explicit value for android:exported when the corresponding \
   component has an intent filter defined.
   

Android Studio เวอร์ชันเก่า

หากคุณพยายามติดตั้งแอป Logcat จะแสดงข้อความแสดงข้อผิดพลาดต่อไปนี้

Installation did not succeed.
The application could not be installed: INSTALL_FAILED_VERIFICATION_FAILURE
List of apks:
[0] '.../build/outputs/apk/debug/app-debug.apk'
Installation failed due to: 'null'

ความสามารถในการเปลี่ยนแปลงได้ของ Intent ที่รอดำเนินการ

หากแอปกำหนดเป้าหมายเป็น Android 12 คุณต้องระบุการเปลี่ยนแปลงของออบเจ็กต์ PendingIntent แต่ละรายการที่แอปสร้างขึ้น ข้อกำหนดเพิ่มเติมนี้จะช่วยปรับปรุงความปลอดภัยของแอป

ทดสอบการเปลี่ยนแปลงความสามารถในการเปลี่ยนแปลงของ PendingIntent

หากต้องการตรวจสอบว่าแอปของคุณขาดการประกาศความสามารถในการเปลี่ยนแปลงหรือไม่ ให้มองหาคำเตือนเกี่ยวกับ Lint ต่อไปนี้ใน Android Studio

Warning: Missing PendingIntent mutability flag [UnspecifiedImmutableFlag]

การเปิดตัว Intent ที่ไม่ปลอดภัย

Android 12 ขึ้นไปมีฟีเจอร์การแก้ไขข้อบกพร่องที่ตรวจหาการเปิด Intent ที่ไม่เป็นอันตราย เพื่อปรับปรุงความปลอดภัยของแพลตฟอร์ม เมื่อระบบตรวจพบการเปิดตัวที่ไม่ปลอดภัยดังกล่าว จะมีการละเมิด StrictMode

ประสิทธิภาพ

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

แอปที่กำหนดเป้าหมายเป็น Android 12 ขึ้นไปจะเริ่มบริการที่ทำงานอยู่เบื้องหน้าขณะทำงานอยู่เบื้องหลังไม่ได้ ยกเว้นบางกรณีพิเศษ หากแอปพยายามเริ่มบริการที่ทำงานอยู่เบื้องหน้าขณะที่ทำงานอยู่เบื้องหลัง ระบบจะยกเว้น (ยกเว้นบางกรณีที่พิเศษ)

ลองใช้ WorkManager เพื่อตั้งเวลาและเริ่มการทํางานแบบเร่งด่วนขณะที่แอปทํางานอยู่เบื้องหลัง หากต้องการดำเนินการตามเวลาจริงที่ผู้ใช้ร้องขอ ให้เริ่มบริการที่ทำงานอยู่เบื้องหน้าภายในการปลุกที่เจาะจง

สิทธิ์การปลุกในเวลาที่แน่นอน

แอปที่กำหนดเป้าหมายเป็น Android 12 ขึ้นไปและตั้งการปลุกที่เจาะจงต้องเข้าถึงความสามารถ "การปลุกและการช่วยเตือน" ซึ่งปรากฏในหน้าจอการเข้าถึงแบบพิเศษสำหรับแอปในการตั้งค่าระบบ เพื่อกระตุ้นให้แอปประหยัดทรัพยากรของระบบ

หากต้องการรับสิทธิ์เข้าถึงแอปพิเศษนี้ ให้ขอสิทธิ์ SCHEDULE_EXACT_ALARM ในไฟล์ Manifest

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

ปิดใช้การเปลี่ยนแปลงลักษณะการทำงาน

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

• ในหน้าจอการตั้งค่าตัวเลือกสำหรับนักพัฒนาแอป ให้เลือกการเปลี่ยนแปลงความเข้ากันได้ของแอป ในหน้าจอที่ปรากฏขึ้น ให้แตะชื่อแอป แล้วปิด REQUIRE_EXACT_ALARM_PERMISSION

• ในหน้าต่างเทอร์มินัลบนเครื่องที่ใช้พัฒนา ให้เรียกใช้คําสั่งต่อไปนี้

  adb shell am compat disable REQUIRE_EXACT_ALARM_PERMISSION PACKAGE_NAME
  

Indirect notification activity start (trampoline) from PACKAGE_NAME, \
this should be avoided for performance reasons.

adb shell dumpsys activity service \
  com.android.systemui/.dump.SystemUIAuxiliaryDumpService

<full-backup-content>
    <include domain=["file" | "database" | "sharedpref" | "external" |
                     "root"] path="string"
    requireFlags=["clientSideEncryption" | "deviceToDeviceTransfer"] />
    <exclude domain=["file" | "database" | "sharedpref" | "external" |
                     "root"] path="string" />
</full-backup-content>

<data-extraction-rules>
  <cloud-backup [disableIfNoEncryptionCapabilities="true|false"]>
    ...
    <include domain=["file" | "database" | "sharedpref" | "external" |
                        "root"] path="string"/>
    ...
    <exclude domain=["file" | "database" | "sharedpref" | "external" |
                        "root"] path="string"/>
    ...
  </cloud-backup>
  <device-transfer>
    ...
    <include domain=["file" | "database" | "sharedpref" | "external" |
                        "root"] path="string"/>
    ...
    <exclude domain=["file" | "database" | "sharedpref" | "external" |
                        "root"] path="string"/>
    ...
  </device-transfer>
</data-extraction-rules>

<application
    ...
    <!-- The below attribute is ignored. -->
    android:fullBackupContent="old_config.xml"
    <!-- You can point to your new configuration using the new
         dataExtractionRules attribute . -->
    android:dataExtractionRules="new_config.xml"
    ...>
</application>

val networkCallback = object : ConnectivityManager.NetworkCallback() {
  ...
  override fun onCapabilitiesChanged(
           network : Network,
           networkCapabilities : NetworkCapabilities) {
    val transportInfo = networkCapabilities.getTransportInfo()
    if (transportInfo !is WifiInfo) return
    val wifiInfo : WifiInfo = transportInfo
    ...
  }
}

final NetworkCallback networkCallback = new NetworkCallback() {
  ...
  @Override
  public void onCapabilitiesChanged(
         Network network,
         NetworkCapabilities networkCapabilities) {
    final TransportInfo transportInfo = networkCapabilities.getTransportInfo();
    if (!(transportInfo instanceof WifiInfo)) return;
    final WifiInfo wifiInfo = (WifiInfo) transportInfo;
    ...
  }
  ...
};