Mobile Platform as a Service：Adaptasi mPaaS untuk targetSdkVersion 33

Mulai dari versi 10.2.3.35, mPaaS telah menambahkan dukungan untuk targetSdkVersion 33. Jika aplikasi Anda perlu ditingkatkan ke targetSdkVersion 33, gunakan Plugin mPaaS untuk memperbarui SDK ke versi 10.2.3.35 atau yang lebih baru. Lakukan adaptasi dan pengujian regresi sesuai dengan panduan berikut.

Adaptasi ke targetSdkVersion 33

Prasyarat

Pastikan aplikasi Anda telah menyelesaikan adaptasi untuk targetSdkVersion versi sebelumnya dengan merujuk pada dokumen berikut:

• Adaptasi mPaaS targetSdkVersion 28

• Adaptasi mPaaS targetSdkVersion 29

• Adaptasi mPaaS targetSdkVersion 30

• Adaptasi mPaaS targetSdkVersion 31

Ubah targetSdkVersion

Mode integrasi AAR

Ubah atribut targetSdkVersion menjadi 33 di file build.gradle modul utama proyek.

Metode integrasi Portal&Bundle

Ubah atribut targetSdkVersion menjadi 33 di file build.gradle modul utama proyek Portal.

targetSdkVersion di proyek Bundle tidak wajib diubah, tetapi tidak boleh lebih tinggi daripada yang ada di proyek Portal.

Izin waktu proses Notifikasi

Android 13 menambahkan izin POST_NOTIFICATIONS untuk:

• Untuk aplikasi dengan targetSdkVersion < 33, sistem akan otomatis menampilkan jendela untuk mengajukan izin ini ketika aplikasi membuat saluran notifikasi pertama;

• Untuk aplikasi dengan targetSdkVersion ≥ 33, aplikasi harus mengajukan izin ini secara mandiri.

Untuk informasi lebih lanjut, lihat Izin waktu proses Notifikasi.

Layanan Push Pesan

Jika Anda menggunakan Layanan Push Pesan dan perlu mendorong pesan melalui saluran yang dibangun sendiri serta menampilkannya di bilah notifikasi, tambahkan izin berikut di AndroidManifest.xml:

<uses-permission android:name="android.permission.POST_NOTIFICATIONS"/>

Ajukan izin ini secara dinamis pada waktu yang tepat. Jika izin tidak diajukan atau ditolak oleh pengguna, pesan yang diterima melalui saluran yang dibangun sendiri tidak dapat ditampilkan di bilah notifikasi, meskipun Anda telah menyesuaikan pemrosesan pesan.

Izin media granular

Sejak Android 13, izin READ_EXTERNAL_STORAGE tidak lagi berlaku dan digantikan oleh tiga izin berikut:

• READ_MEDIA_IMAGES

• READ_MEDIA_VIDEO

• READ_MEDIA_AUDIO

Untuk aplikasi dengan targetSdkVersion ≥ 33:

• Mengajukan izin READ_EXTERNAL_STORAGE secara dinamis tidak akan menampilkan jendela pop-up;

• Aplikasi baru yang menggunakan checkSelfPermission untuk memeriksa izin READ_EXTERNAL_STORAGE selalu mengembalikan nilai false;

• Jika aplikasi dengan targetSdkVersion sebelumnya < 33 telah diberikan izin READ_EXTERNAL_STORAGE, setelah diperbarui ke targetSdkVersion ≥ 33 melalui instalasi override, aplikasi akan otomatis diberikan ketiga izin di atas.

Tambahkan satu atau lebih izin berikut ke AndroidManifest.xml sesuai kebutuhan bisnis Anda:

<uses-permission android:name="android.permission.READ_MEDIA_IMAGES"/>
<uses-permission android:name="android.permission.READ_MEDIA_VIDEO"/>
<uses-permission android:name="android.permission.READ_MEDIA_AUDIO"/>

Perbarui logika untuk mengajukan atau memeriksa izin READ_EXTERNAL_STORAGE secara dinamis dalam kode menjadi salah satu atau lebih dari tiga izin di atas.

Multimedia mini program

Untuk menggunakan API multimedia mini program, tambahkan izin berikut ke AndroidManifest.xml:

<uses-permission android:name="android.permission.READ_MEDIA_IMAGES"/>

Ajukan izin tersebut secara dinamis pada waktu yang tepat. Jika izin tidak diajukan atau ditolak oleh pengguna, API multimedia mini program tidak akan dapat mengakses gambar di album sistem.

Pemindaian

Jika Anda terhubung ke Pemindaian atau Pemindaian AI, perhatikan skenario berikut:

• Untuk menggunakan fungsi pemindaian jendela, ajukan izin berikut;

• Untuk menggunakan fungsi pemindaian layar penuh dan mengintegrasikan multimedia atau multimedia mini program, ajukan izin berikut;

• Untuk menggunakan fungsi pemindaian layar penuh tanpa mengintegrasikan multimedia atau multimedia mini program, tidak perlu mengajukan izin berikut;

• Untuk menggunakan fungsi pemindaian kode kustom dan menggunakan komponen multimedia untuk mendapatkan gambar album, ajukan izin berikut;

• Untuk menggunakan fungsi pemindaian kode kustom dan langsung memanggil album sistem, tidak perlu mengajukan izin berikut.

Tambahkan izin berikut ke AndroidManifest.xml:

<uses-permission android:name="android.permission.READ_MEDIA_IMAGES"/>

Ajukan izin tersebut secara dinamis pada waktu yang tepat. Jika izin tidak diajukan atau ditolak oleh pengguna, komponen multimedia mPaaS tidak akan dapat mengakses gambar di album sistem saat tombol album diklik.

Uji regresi

Perangkat untuk uji regresi penuh harus mencakup perangkat dengan Android 13 atau yang lebih baru.

Selama uji regresi, fokuskan pada fitur komponen berikut (jika digunakan):