すべてのプロダクト
Search

このプロダクト

    Mobile Platform as a Service:mPaaS が Honor メーカープッシュに適応

    ドキュメントセンター

    Mobile Platform as a Service:mPaaS が Honor メーカープッシュに適応

    最終更新日:Jan 17, 2025

    背景情報

    最近、HONOR から公式に通知を受けました。HONOR ブランドから新しくリリースされた機種と 2024 年にリリースされる新機種は、HONOR Push のみをサポートしています。 在庫機器は、2024 年の第 1 四半期にプッシュ サービスのアップグレードを完了する予定です。その時点で、在庫機器は HONOR Push のみをサポートし、Huawei Push はサポートしなくなります。 mPaaS プッシュ サービスに接続されているアプリがメーカー チャネルを通じて HONOR デバイスに引き続きプッシュされるようにするには、次のガイドラインに従って HONOR プッシュの適応とアップグレードをできるだけ早く完了することをお勧めします。

    クライアント アップグレード関連事項

    • 10.2.3 ベースラインを使用している場合は、バージョンを 10.2.3.38 以降にアップグレードしてください。

    • 現在、異なるカスタム ベースラインを使用している場合は、mPaaS ヘルプデスクに確認してください。

    mPaaS HONOR Push の Android 統合への適応

    以下では、HONOR Push の統合プロセスについて説明します。主に次の 3 つのステップが含まれます。

    1. HONOR Push を登録する

    2. HONOR Push を統合する

    3. HONOR Push をテストする

    HONOR Push を登録する

    HONOR 開発公式ウェブサイトにログインし、アカウントを登録してプッシュ サービスを開きます。詳細については、「プッシュ機能を有効にする」をご参照ください。

    HONOR Push を統合する

    1. プッシュ SDK を追加するのと同じ方法で、プッシュ> HONOR コンポーネントを追加します。詳細については、「プッシュ SDK を追加する」をご参照ください。

      説明

      Push> HONOR コンポーネントには、アダプテーション コードのみが含まれており、Honor Push SDK は含まれていません。 Honor Push SDK の依存関係は個別に追加する必要があります。

      対応するバージョンのベースライン バージョン (10.2.3.38 以降) を導入し、Honor Push の SDK 依存関係を追加します。サンプルコードは次のとおりです。

      implementation platform("com.mpaas.android:mpaas-baseline:10.2.3-38")
implementation 'com.mpaas.android:push-honor'

    2. 開発環境を準備します。開発環境は、Honor Push の統合環境と互換性がある必要があります。詳細については、「開発準備 > 環境情報」をご参照ください。

    3. 構成ファイルを追加します。HONOR デベロッパー サービス プラットフォームから mcs-services.json 構成ファイルをダウンロードします。詳細については、「アプリケーション構成ファイルを追加する」をご参照ください。

    4. SDK のリポジトリ アドレスを構成します。詳細については、「SDK の Maven リポジトリの URL を構成する」をご参照ください。

    5. 依存関係の構成を追加します。アプリケーション レベルの build.gradle ファイルで、dependencies フィールドに次のコンパイル依存関係を追加します。詳細については、「依存関係を追加する」をご参照ください。

      dependencies {
    // 次の構成を追加します
    implementation 'com.hihonor.mcs:push:7.0.61.302'
}

      • バージョンの更新方法の詳細については、「バージョン情報」をご参照ください。

      • mPaaS の現在のバージョンは 7.0.61.302 です。以降のバージョンを使用する場合は、必要に応じて変更できます。一般的に、メーカー SDK は下位互換性があります。

    6. 難読化を使用するには、関連する難読化構成を追加します。

    HONOR Push をテストする

    1. Honor Push を有効にした後、Honor 携帯電話でアプリケーションを起動し、初期化メソッドが呼び出されていることを確認します。詳細については、「クイック スタート」をご参照ください。次に、プッシュ SDK は Honor Push プロバイダーのトークンを取得し、トークンを報告します。

    2. 起動後しばらくしてからアプリを手動で終了し、テスト メッセージをプッシュできます。

      • 引き続きメッセージを受信できる場合は、アプリケーションは HONOR Push に正常に接続されています。

      • メッセージを受信できない場合は、次のように問題のトラブルシューティングを行ってください。

    クライアントの問題のトラブルシューティング

    1. HONOR の構成とパラメーターが HONOR プッシュ バックグラウンドと一致しているかどうか、AndroidManifest.xml に関連する構成が追加されているかどうか、com.hihonor.push.app_id が HONOR プッシュ バックグラウンドと一致しているかどうかを確認します。

    1. mcs-services.json ファイルが存在するかどうか、およびストレージの場所が正しいかどうかを確認します。

    2. mPaaS コンソールで Honor チャンネルが有効になっているかどうかを確認します。詳細については、「Honor チャンネルを構成する」をご参照ください。

    3. トラブルシューティングのために logcat ログを表示します。

      1. プッシュプロセスを選択し、mPush.PushProxyFactory をフィルタリングし、次のログが存在するかどうかを確認します。

        D/mPush.PushProxyFactory: found proxy com.mpaas.push.external.honor.Creator

      2. メインプロセスを選択し、mHonor をフィルタリングし、トークンが取得されているかどうかを確認します。get token failed というログが表示された場合は、トークンの取得に失敗しています。エラーコードについては、「エラーコード」をご参照ください。

      3. メインプロセスを選択し、report channel token をフィルタリングし、HONOR メーカー トークンのレポートが成功したかどうかを確認します。次のログが表示された場合:

        report channel token error: xxxx

        これは、製造トークンが報告されていないことを示しています。プロジェクトに構成ファイルを追加する際の base64Code に値が設定されているかどうか、および構成ファイルの取得時にアップロードされた APK 署名が現在のアプリケーションと一致するかどうかを確認してください。

        Push> HONOR コンポーネントが使用できない場合は、HONOR コンポーネントを追加できます。 HONOR コンポーネントが追加されているかどうかを確認します。

    サーバー アップグレード関連事項

    HONOR プッシュ チャネルを構成する

    1. 左側のナビゲーション ウィンドウで、[メッセージプッシュ] > [設定] > [チャネル設定] を選択します。

    2. HONOR Push Channel 構成セクションの右上隅にある [構成] をクリックします。構成エントリが表示されます。

    パラメーター

    必須

    説明

    ステータス

    はい

    チャネルの統合ステータス スイッチ。スイッチをオンにすると、MPS は構成に従って HONOR プッシュ チャネルを統合します。スイッチをオフにすると、統合がキャンセルされます。

    SDK パッケージ

    はい

    カスタム HONOR アプリケーション パッケージ名をサポートします。

    HONOR AppID

    はい

    一意のアプリケーション識別子。対応するアプリケーションの HONOR Push サービスが開発者プラットフォームでアクティブ化されると生成されます。

    HONOR アプリケーション ID

    はい

    アプリケーションの顧客 ID。メッセージ送信トークンの ID を取得するために使用されます。対応するアプリケーションの PUSH サービスが開発者プラットフォームでアクティブ化されると生成されます。

    HONOR アプリケーション キー

    はい

    アプリのキーを入力します。

    1. HONOR Developer Alliance ウェブサイトにログインし、[管理センター] > [マイ プロダクト] > [モバイル アプリケーション 詳細] ページに移動して、アプリケーション パッケージ名、アプリケーション ID、およびキーを取得できます。

    2. [OK] をクリックして構成を保存します。

    Honor メーカーのチャネル プッシュ機能を確認する

    Magic OS 8.0 以上の HONOR スマートフォンを使用し、新しい mPaaS プッシュ SDK と統合されたアプリをインストールします。アプリが起動した後、一定 時間 アプリを手動で終了します。mPaaS メッセージプッシュコンソールで 最小メッセージプッシュ> 優先メーカーチャネルポリシー を使用して、ターゲット デバイス にプッシュ配信します。HONOR 端末が通知バー メッセージ を正常に受信できた場合、HONOR メーカーチャネル統合が成功したことを意味します。