アプリ内課金(IAP)の実装について


アプリ内課金(IAP)の実装について

このページでは、これまでAmazonアプリ内課金(IAP)SDKを使用したことがない開発者の方、またはIAP APIを実装した経験がない開発者の方を対象に、IDEのセットアップ方法と、IAPで推奨される開発、テスト、申請のワークフローについて説明します。

最初はサンプルを使用したほうがわかりやすいため、ここでは新規プロジェクトを一から作成するのではなく、IAPサンプルアプリをIDEにインポートする方法を説明します。IAP APIの実装方法の詳細については、Android用アプリ内課金(IAP)APIを組み込む方法を参照してください。

SDKのダウンロード

Amazon Android SDKをまだダウンロードしていない場合は、コンピューターにダウンロードします。

Amazon Android SDKはこちらからダウンロードできます[Android] リンクをクリックしてください)。

ファイルを展開すると、IAP SDKのファイルがAmazonInAppPurchasingというフォルダに作成されます。

開発環境のセットアップ: Android Studio

IDEとしてAndroid Studioを使用している場合でも、サンプルプロジェクトをインポートし、APKとしてエクスポートすることで、Androidデバイスで実行できるようになります。

Android Studio開発環境でIAPサンプルアプリを使用できるように設定するには、次の手順に従います。

  1. Amazon-Android-SDKs.zipファイルをローカルコンピューターの任意の場所に展開します。
  2. Android Studioを起動します。
  3. IAPサンプルアプリをワークスペースにインポートします。

    1. [Welcome to Android Studio] 画面で、[Import Project (Eclipse ADT, Gradle, etc.)] をクリックして、プロジェクトインポートウィンドウを開きます。
    2. [Select Eclipse or Gradle Project to Import] ウィンドウで、Amazon-Android-SDKs.zipファイルの内容を展開した場所に移動し、/AmazonInAppPurchasing/examplesを選択します。
    3. 3つのIAPサンプルプロジェクトのいずれかのディレクトリを選択し、[OK] をクリックします。[Import Project from ADT] 画面が表示されます。
    4. [Import Project from ADT] 画面で、インポート先のディレクトリを選択し、[Next] をクリックします。
    5. 表示された画面で、デフォルト設定のチェックボックスをすべてオンのままにし、[Finish] をクリックします。IAPサンプルアプリプロジェクトのインポートが開始されます。
    6. これらの手順をサンプルアプリごとに繰り返します。
  4. IAP 2.0 JAR/ライブラリファイルを追加します。
    1. Android Studioの左上隅(プロジェクトのタブのすぐ下)のドロップダウンメニューから [Project] を選択します(ほかの選択肢には [Android][Packages] があります)。プロジェクトのディレクトリ構造がツリー形式で表示されます。
    2. プロジェクトのappディレクトリの下に、「libs」という名前の新しいディレクトリを作成します。
    3. IAP 2.0 JARファイルを新しいlibsディレクトリにコピーします。

      Macを使用している場合は、libsファイルを右クリックし、コンテキストメニューから [Reveal in Finder] を選択します。これで、IAP 2.0 JARファイルをAmazonInAppPurchasingから新しいlibsディレクトリにコピーできるようになります。ディレクトリ表示を更新すると、このディレクトリ内のファイルがAndroid Studioに表示されます。

    4. IAP 2.0 JARファイルを右クリックし、[Add as Library] を選択します。

      IAPライブラリがプロジェクトのgradle依存関係のリストに追加されます。これで、サンプルアプリプロジェクトを正しくビルドできるようになりました。

      : gradleを使用してライブラリを追加するには、build.gradleファイルを開き、このファイルの依存関係セクションに以下のコードを追加します。次に、build.gradleファイルの上部に表示された [Sync Now] リンクをクリックして、変更を同期します。

      dependencies {

      ...

      compile fileTree(dir: 'libs', include: ['*.jar'])

      }

    5. これらの手順をサンプルアプリプロジェクトごとに繰り返します。
  5. サンプルアプリのAPKを生成します。
    1. Androidモバイルデバイスを開発用コンピューターに接続します。
    2. Android Studioで、[Debug] をクリックし、実行中のデバイスを選択して、そのデバイスにアプリをインストールします。

: 現在、Android StudioのプロジェクトにAmazon Android SDKのJavadocを追加することはできません。Android StudioではJavadocを独自のJARファイルとして用意する必要がありますが、これは現時点でAmazon Android SDKに含まれていません。

これで、このサンプルアプリをモバイルデバイス上で実行できるようになりました。

開発した実際のアプリをAmazonアプリストアに申請すると、APKが署名されているかどうかにかかわらず、アプリにAmazonの署名が適用されることに注意してください。

App Testerをセットアップする

: 実際にテストを始める前に、IAPのテストに関するオプションと、推奨されるテストプロセスについて理解することをお勧めします。詳細については、アプリ内課金(IAP)のテストの概要を参照してください。

Amazonでは、IAPのユニットテスト用にApp Testerというツールを提供しています。このツールをIAPサンプルアプリで試すことができます。

App Testerをインストールし、App Testerでサンプルアプリを実行できるようにするには、次の手順に従います。

  1. App Testerのインストールおよび構成の手順を実行します。
  2. サンプルアプリから、adb pushコマンドを使用して、amazon.sdktester.jsonファイルをデバイスの/mnt/sdcard/amazon.sdktester.jsonパスにコピーします。

    $ adb push <JSONファイルのフォルダ名>/amazon.sdktester.json /mnt/sdcard/

  3. App Testerを使用したアプリのテストの詳細については、App Testerユーザーガイドを参照してください。App Testerで実行するテストケースのセットアップ方法については、アプリ内課金(IAP)のテストケースを設計および実行する方法を参照してください。

アプリとアプリ内課金(IAP)アイテムの申請

アプリのテストが完了したら、アプリとアプリ内課金(IAP)アイテムをAmazonに申請することができます。

単一のアプリ内課金(IAP)アイテムを作成および申請する方法を参照してください。