Mobile Platform as a Service:targetSdkVersion 33 への mPaaS の適応

mPaaS は、mPaaS 10.2.3.35 から 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 統合モード

プロジェクトのメインモジュールにある build.gradle ファイルの targetSdkVersion 33 属性を変更します。

Portal&Bundle 統合方法

Portal プロジェクトのメインモジュールにある build.gradle ファイルの targetSdkVersion 33 属性を変更します。

Bundle プロジェクトの targetSdkVersion は変更されない場合がありますが、Portal プロジェクトの targetSdkVersion より高くすることはできません。

通知の実行時パーミッション

Android 13 では、POST_NOTIFICATIONS パーミッションが追加されました。

• targetSdkVersion が 33 未満のアプリケーションの場合、アプリケーションが最初の通知チャネルを作成するときに、システムによってこのパーミッションを申請するためのウィンドウが自動的にポップアップ表示されます。

• targetSdkVersion が 33 以上のアプリケーションの場合、アプリケーションはこのパーミッションを個別に申請できます。

詳細については、「通知の実行時パーミッション」をご参照ください。

メッセージプッシュサービス

メッセージプッシュサービスにアクセスしていて、セルフビルドチャネルを介してメッセージをプッシュし、通知バーに表示する必要がある場合は、AndroidManifest.xml に次のパーミッションを追加する必要があります。

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

そして、適切なタイミングでこのパーミッションを動的に申請します。このパーミッションを申請しない場合、またはユーザーがこのパーミッションを拒否した場合、メッセージ処理をカスタマイズするかどうかに関係なく、セルフビルドチャネルで受信したメッセージは通知バーに通知および表示されません。

きめ細かいメディアパーミッション

Android 13 以降、READ_EXTERNAL_STORAGE パーミッションは有効ではなくなりました。このパーミッションは、次の 3 つのパーミッションに分割されています。

• 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 以上のアプリケーションは、オーバーライドインストールによってアップグレードされた後に上記の 3 つのパーミッションが自動的に付与されます。

ビジネス要件に基づいて、AndroidManifest.xml に次のパーミッションを 1 つ以上追加できます。

<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 パーミッションを動的に申請または確認するロジックを、上記の 3 つのパーミッションの 1 つ以上に変更します。

ミニプログラムマルチメディア

ミニプログラムマルチメディア 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 以降を搭載したデバイスを含める必要があります。

回帰テストでは、次のコンポーネント機能（使用されている場合）に焦点を当てる必要があります。