Mobile Platform as a Service：mPaaS 適配 targetSdkVersion 33

從 mPaaS 10.2.3.35 起，mPaaS 增加了對 targetSdkVersion 33 的支援。如果您的應用需要將 targetSdkVersion 升級到 33，請使用 使用 mPaaS 外掛程式 將 SDK 更新到 10.2.3.35 或以上版本，並按照下文進行適配和迴歸相關功能。

適配 targetSdkVersion 33

前置條件

請先參考以下文檔，確保您的應用已經完成了 targetSdkVersion 舊版本的適配：

• mPaaS 適配 targetSdkVersion 28

• mPaaS 適配 targetSdkVersion 29

• mPaaS 適配 targetSdkVersion 30

• mPaaS 適配 targetSdkVersion 31

修改 targetSdkVersion

AAR 接入方式

在工程主 module 下的 build.gradle 檔案中修改屬性 targetSdkVersion 33。

Portal&Bundle 接入方式

在 Portal 工程主 module 下的 build.gradle 檔案中修改屬性 targetSdkVersion 33。

在 Bundle 工程中的 targetSdkVersion 可不修改，但不得高於 Portal 工程。

通知的運行時許可權

Android 13 新增了許可權 POST_NOTIFICATIONS，對於：

• targetSdkVersion < 33 的應用，系統將會在應用建立首個通知渠道時自動彈窗申請該許可權；

• targetSdkVersion ≥ 33 的應用，應用可自主申請該許可權；

更多內容請參考 通知運行時許可權。

訊息推送

如果您接入了訊息推送，需要通過自建通道推送訊息並在通知欄展示，您需要在 AndroidManifest.xml 中添加該許可權：

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

並在合適的時機動態申請該許可權，如未申請或使用者拒絕該許可權，無論您是否 自訂處理訊息，自建通道收到的訊息都無法發送通知到通知欄展示。

細化的媒體許可權

Android 13 開始，READ_EXTERNAL_STORAGE 許可權不再生效，該許可權被拆分為了以下三個許可權：

• READ_MEDIA_IMAGES

• READ_MEDIA_VIDEO

• READ_MEDIA_AUDIO

對於 targetSdkVersion ≥ 33 的應用：

• 動態申請 READ_EXTERNAL_STORAGE 許可權，將不會有彈窗；

• 新安裝的應用使用 checkSelfPermission 檢查 READ_EXTERNAL_STORAGE 許可權永遠返回 false；

• 如果之前 targetSdkVersion < 33 的應用已被授予 READ_EXTERNAL_STORAGE 許可權，通過覆蓋安裝升級到 targetSdkVersion ≥ 33 的應用後，將自動被授予以上三個許可權；

您需要根據自身業務需求，在 AndroidManifest.xml 中添加以下許可權中的一個或幾個：

<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"/>

並將代碼中動態申請或檢查 READ_EXTERNAL_STORAGE 許可權的邏輯修改為以上三個許可權中的一個或幾個。

小程式 - 多媒體

如果您接入了小程式，並且需要使用小程式 - 多媒體 API ，您需要在 AndroidManifest.xml 中添加該許可權：

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

並在合適的時機動態申請該許可權，如未申請或使用者拒絕該許可權，小程式 - 多媒體 API 將無法擷取系統相簿中的圖片。

掃一掃

如果您接入了掃一掃或掃一掃 AI ，並且：

• 使用視窗掃碼功能，您需要申請下述許可權；

• 使用全屏掃碼功能，同時接入了多媒體或小程式 - 多媒體，您需要申請下述許可權；

• 使用全屏掃碼功能，同時未接入多媒體或小程式 - 多媒體，您不需要申請下述許可權；

• 使用自訂掃碼功能，同時使用了多媒體組件來擷取相簿圖片，您需要申請下述許可權；

• 使用自訂掃碼功能，同時直接調用系統相簿，不需要申請下述許可權；

您需要在 AndroidManifest.xml 中添加該許可權：

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

並在合適的時機動態申請該許可權，如未申請或使用者拒絕該許可權，當您點擊相簿按鈕時，mPaaS 多媒體組件將無法擷取系統相簿中的圖片。

迴歸測試

全量迴歸測試的裝置中必須包含 Android 13 或以上版本的裝置。

迴歸測試中您需要重點關注以下組件功能（如果使用）：