開発者コンソール
ログイン
ログイン
開発者コンソール

Appstore SDKの統合

Appstore SDKの統合

Appstore SDKをプロジェクトに追加する方法については、このガイドを参照してください。

Appstore SDKをプロジェクトに追加する方法

Appstore SDKをAndroidプロジェクトに統合するには、次の手順を実行します。

手順1： Appstore SDKにパブリックキーを設定する

このパブリックキーはアプリごとに一意で、Amazonアプリストアとアプリ間の安全な通信チャネルを確立します。開発者コンソールでパブリックキーを生成すると、対応するプライベートキーがAmazonによって生成されます。パブリックキーとプライベートキーは、ライセンス応答に署名するためのキーペアとなります。このキーのペアリングにより、アプリをインストールするユーザーが確実に承認されます。

既存のアプリにパブリックキーを設定するには、次の手順を実行します。

  1. 開発者アカウントで開発者コンソールにログインします。
  2. [アプリ＆サービス] > [マイアプリ] に移動します。次に、アプリをクリックします。まだアプリを公開していない場合は、Amazonアプリストアにアプリを申請する方法を参照してください。

  3. アプリの新しいバージョンを作成します。アプリ名の下にある [次期バージョン] をクリックします。

  4. [アプリファイルをアップロード] 画面に移動します。
  5. [関連情報] セクションで、[パブリックキーを表示] をクリックします。

  6. [パブリックキー] ダイアログボックスが表示されたら、AppstoreAuthenticationKey.pemリンクをクリックしてPEMファイルをダウンロードします。このファイルにパブリックキーが含まれています。

    パブリックキーの文字列を表示する [パブリックキー] ウィンドウ。ダウンロードアイコンの後にリンクテキスト「AppStoreAuthenticationKey.pem」が表示されます。
    PEMファイルのダウンロードリンク

  7. AppstoreAuthenticationKey.pemファイルをコピーします。それを、Android Studioプロジェクトのapp/src/main/assetsフォルダに貼り付けます。

    [Project] ビューでは、通常assetsフォルダは、app/src/main/assetsにあります。アプリにassetsフォルダがない場合は、新たに作成する必要があります。作成したら、その中にPEMファイルをドラッグします。

手順2（推奨）： Maven Centralを使用してAppstore SDKをプロジェクトに追加する

Maven CentralのAmazon SDKリリースを使用すると、Android StudioでのAmazon Appstore SDKの統合と更新がより簡単になります。Maven Centralはビルドアーティファクトのリポジトリです。これらのアーティファクトは、Android Studio、およびオープンソースビルド自動化システムのGradleに直接統合できます。Android StudioとGradleを使用してアプリを開発する場合は、アプリのbuild.gradleファイルをセットアップすることでAmazon Appstore SDKを統合できます。この方法では、プロジェクトで常に最新バージョンのSDKが使用されます。

以下の手順を実行します。

  1. 開発者アカウントで開発者コンソールにログインし、アプリのパブリックキーをダウンロードします（まだこの作業を行っていない場合）。

  2. Android Studioのプロジェクトに戻ります。コードに旧バージョンのAmazon Appstore SDKが含まれている場合は、そのSDKを削除します。

  3. Android Studioで [Project] ビューに切り替えます。

    [Project] ビュー
    [Project] ビュー

  4. appフォルダを展開し、アプリのbuild.gradleファイルを開きます。

  5. build.gradleファイルの依存関係セクションに、Amazon Appstore SDKを以下のように挿入します。

     dependencies {
     ...
     implementation 'com.amazon.device:amazon-appstore-sdk:3.+'
 }

    注： 上の例は、メジャーバージョンが3である最新のAmazon Appstore SDKを取得する方法を示しています。このコード行では、特定のバージョンを指定することも、ワイルドカードを使用することもできます。予期しない安定性の問題が発生する可能性があるため、公開中のプロジェクトにワイルドカードを使用することは適切ではありません。ただし、最新バージョンのAmazon Appstore SDKを使用してプロジェクトのデバッグやテストを行う際は、バージョン宣言でワイルドカードを使用すると便利です。以下のように、バージョン番号の部分を+に置き換えると、最新バージョンを使用できます。

     // Amazon Appstore SDKの特定のリリースをプルし、コンパイルします
 implementation 'com.amazon.device:amazon-appstore-sdk:3.0.5'

 // Amazon Appstore SDKの最新の3.xリリースをプルし、コンパイルします
 implementation 'com.amazon.device:amazon-appstore-sdk:3.+'

 // Amazon Appstore SDKの最新リリースをプルし、コンパイルします
 implementation 'com.amazon.device:amazon-appstore-sdk:+'

    アプリの次回ビルド時に、このメソッドによって必要なファイルがすべてプロジェクトにインポートされます。

  6. プロジェクトの最上位のbuild.gradleで、Maven Centralリポジトリが定義されていることを確認します。定義されていない場合は、以下のように追加します。

     allprojects {
     repositories {
         mavenCentral()
     }
     dependencies {
         ...
     }
 }

  7. プロジェクトを再ビルドします （[Build] > [Rebuild Project]）。

上記の手順を実行する場合、次のセクションを読む必要はありません。

代替の手順2： Appstore SDKをプロジェクトライブラリに手動で追加する

まず、amazon-appstore-sdk-[x].jarをAndroidプロジェクトに追加します。

  1. Android Studioで [Project] ビューに切り替えます。

    [Project] ビュー
    [Project] ビュー

  2. appフォルダを展開し、libsを選択します（libsフォルダがない場合は、新たに作成します）。amazon-appstore-sdk-[x].jarファイルをこのディレクトリに貼り付けます。

  3. アプリのbuild.gradleファイルを開き、amazon-appstore-sdk-[x].jarへの依存関係を追加します。たとえば、JARがバージョン3.0.5の場合、コードは次のようになります。

    dependencies {
    implementation files('libs/amazon-appstore-sdk-3.0.5.jar')
}

    上記の名前は、使用するamazon-appstore-sdk-[x].jarバージョンに合わせてカスタマイズしてください。

    複数の依存関係がある場合は、次のようにすることで、特定のJARを参照するのではなく、すべてのJARをまとめて参照できます。

    dependencies {
    ...
    api fileTree(dir: 'libs', include: ['*.jar'])
}

次のステップ

IAP、DRM、SSIのAPIを使用して、アプリに必要な機能を利用できるようになりました。詳細については、次のトピックを参照してください。

よくある質問（FAQ）

詳細については、次のトピックのよくある質問（FAQ）セクションを参照してください。

Last updated: 2023年12月4日