Androidアプリ開発の紆余曲折

Amazon Distribution Portalの公式マニュアル(英語)は下記URL先です。
(https://developer.amazon.com/sdk/in-app-purchasing/documentation/testing-iap.html)
開発環境と動かしたいアプリが揃ったら、次は動かす環境の整備です。

Amazon SDK APIのテストについて

　Amazon In-App Purchasing API には、検証環境というものが存在しません。しかも、Amazon SDK APIを通じてAmazon Client経由で通信を行う為には、Distribution Portalを通じて公開されているアプリでなければなりません。

SDK Tester

　それじゃ公開するまでテストもできないの？そんな訳ありません。Amazonはテストの為のAmazon Clientの動きをエミュレートするアプリを用意しています。

"SDK Tester" は、Amazon SDK の開発者がアプリ公開前に本番環境を想定してテストすることができる開発ツールです。これにより開発者は、Amazon SDK APIによって生成される全てのレスポンスをカバーするテストをアプリ公開前に実行できます。Amazonは、このSDK Testerでテストして動作したコードは本番でも同じく動作することを保証しています。

　SDK Testerでは、テストユーザーの購入情報（レシート）を消したり、キャンセル処理を行うことができます。また、ユーザーを変更したり、IAP-APIのレスポンスステータスを任意に変更することができます。

SDK Tester の仕組み

　IAP-APIは、動作しているアプリがDistribution Portalで公開されているアプリかどうかを判別し、公開されていない（開発中の）アプリである場合、SDKTesterアプリへ接続します。（もちろんSDK Testerをインストールしていないとだめですが。。。）

　公開後は勝手にIAP-APIがAmazonClient側へ接続しに行ってくれるので、テスト時と本番時に設定を変えるとかの差異がなく非常に便利です。

SDK Tester のインストール

　Amazon Distribution Portal (https://developer.amazon.com/sdk.html) からダウンロードできる、Amazon SDK (Apps-SDK.zip)に含まれています。

格納されている場所は、
"<Apps-SDK.zipを解凍したディレクトリ>/Apps-SDK/InAppPurchasing/tools/AmazonSDKTester.apk"です。

この AmazonSDKTester.apk をデバイスにインストールします。
※インストールには、Android 2.3.3 (Android API Level 10) 以上の端末が必要です。
　Kindleなら第１世代からインストールできます。

Windowsならコマンドプロンプトから以下のコマンドでインストールできます。
※<Android SDKのインストールされているディレクトリ>\sdk\platform-toolsへパスを通しておいてください。

C:\>adb install -s <デバイスID> <App-SDK.zipを解凍したディレクトリ>\Apps-SDK\InAppPurchasing\tools\AmazonSDKTester.apk

デバイスIDの調べ方は、"adb devices" コマンドで接続されているデバイス、エミュレータのデバイスIDを確認することができます。

アイテムデータ定義ファイルの準備

　Distribution Portalでも課金アイテムは定義しなければなりませんが、同じくSDK Testerにも課金アイテムの定義が必要です。
SDK Testerでは、JSONファイルで課金アイテムの定義を行います。

　SDK Testerは、デバイスの "/mmt/sdcard/amazon.sdktester.json"ファイルを読み込み、その情報をもとにIAP-APIへレスポンスしてくれます。このときJSONファイルに定義する課金アイテムの情報へ本番と同じデータを入力できるのがいいところです。

定義構造
　amazon.sdktester.json の定義はJSON形式に従い、以下のような構造で行います。この時、SKUの順序は関係ありません。
```
{
    SKU_1:{IAP_Item_1_Description},
    SKU_2:{IAP_Item_2_Description},
    .
    .
    .
    SKU_n:{IAP_Item_n_Description
}
        
```
上記のとおり、複数のSKUを並べて定義できます。この時、SKU定義間の "," に注意してください。尚、コンテンツタイプによって項目の定義内容は異なります。

定義要素：Consumable / Entitled

　Consumable Content（消費型コンテンツ）と Entitled Content（買いきり型コンテンツ）の課金アイテム定義項目は以下のとおりです。

{
  ...
  ”(SKU文字列)” : 
  {
    "itemType": "ENTITLED" または "CONSUMABLE", 
    "price": (金額の数字),
    "title": "(商品名称)"
    "description": "(商品説明文)",
    "smallIconUrl": "(商品画像アイコン(サムネイル)URL)"
  }
  ...
}

定義要素：Subscription
　期間購入(Subscription)型コンテンツのアイテム定義項目は以下のとおりです。
```
{
  ...
  ”com.amazon.buttonclicker.subscription.1mo (SKU文字列)” : 
  {
    "itemType": "SUBSCRIPTION",
    "price": (金額の数字),
    "title": "(商品名称)",
    "description": "(商品説明文)",
    "smallIconUrl": "(商品画像アイコン(サムネイル)URL)",
    "subscriptionParent": "com.amazon.buttonclicker.subscription"
  }
   ...
}
        
```
　定義自体はほとんど変わりません。しかし、他と大きく違うのが "subscriptionParent"（親SKU）を指定している点です。サブスクリプションの親SKUは、サブスクリプションが何のためにあるのかを表します。そしてその親SKUに紐づく子SKUは、価格や期間を表す条件のSKUとなります。
　この紐付けを行うことで、例えば「○○新聞の定期購読」の「１か月間のサブスクリプション」を購入したのに、「１週間のサブスクリプション」を重複して買うことを防ぐことができます。

SDK Testerの使い方

　SDKテスターのスタート画面です。真ん中の３つのボタンをタップすると、それぞれの機能の画面を表示します。

Active Transactions

　有効な取引情報を表示します。また、テストの為にその取引をキャンセル（返品）すること取引情報をクリアすることができます。

Change Logged in User

　現在ログイン中のユーザー名を表示します。またログイン中のユーザー名を変更することができます。

Interactive Mode Preferences

　IAP-APIからのレスポンスを任意に設定できます。
1. Purchase API
  PurchasingManager.initiatePurchaseRequest() -> ObserverのonPurchaseResponse()へのレスポンスの設定。
  - Default：正常
  - Already Entitled：既に購入済み
  - Invalid Sku：SKUが不正
  - Failed：リクエスト失敗
2. Purchase Updates API
  PurchasingManager.initiatePurchaseUpdatesRequest() -> ObserverのPurchaseUpdatesResponse()へのレスポンスの設定。
  - Default：正常
  - Failed：リクエスト失敗
3. Item Data API
  PurchasingManager.initiateItemDataRequest() -> ObserverのonItemDataResponse()へのレスポンスの設定。
  - Default：正常
  - Failed：リクエスト失敗

　これでアプリ内課金処理周りのテストケース前パターンをサクサクこなすことができます。

はじめる前に

　In-App Purchasing API は、Amazon Mobile App SDKパッケージの一部として利用可能です。これは、Androidアプリケーションプロジェクトに含めることができるJARライブラリとして提供されています。

　In-App PurchasingのJARライブラリは任意のIDEで利用可能ですが、ここではEclipseを使用して説明しています。この作業を行う前に、Android開発環境が構築されている必要があります。また、この説明ではIn-App Purchasingを実装する対象となるAndroidアプリケーションプロジェクトが作成されていることを想定しています。作成されていない場合は作成してから作業を行ってください。

App-SDKをダウンロードして展開する

[Apps-SDK.zip] ファイルを Amazon mobile app distribution Portal よりダウンロードしてください。 (https://developer.amazon.com/sdk/download/in-app-purchasing.html)
ダウンロードした [Apps-SDK.zip] ファイルを解凍し、わりやすい場所へ置いてください。
（※このディレクトリはプロジェクトから参照するようにするため後々移動しなくてよい場所へ配置してください。）

In-App Purchasing JARライブラリをクラスパスに追加する

追加するプロジェクトのルートフォルダを選択し、コンテキストメニューから [プロパティ] を選択します。
プロパティウィンドウの左ツリーより、[Javaのビルドパス]を選択。
上部の[ライブラリ] タブをクリック。
右側の [外部 JAR 追加] ボタンをクリック。
"JAR の選択"ダイアログで、/InAppPurchasing/lib/in-app-purchasing-1.0.3.jarを選択し [開く] ボタンをクリック。
ビルドパスに "in-app-purchasing-1.0.3.jar" が追加されたことを確認して [OK] ボタンでプロパティウィンドウを閉じます。

In-App Purchasing APIリファレンスを追加する

追加するプロジェクトのルートフォルダを選択し、コンテキストメニューから [プロパティ] を選択します。
プロパティウィンドウの左ツリーより、[Javaのビルドパス]を選択。
上部の[ライブラリ] タブをクリック。
先の手順で追加した、"in-app-purchasing-1.0.3.jar" の左側▲をクリックして詳細を表示させる。
[Javadoc ロケーション: (なし)]をダブルクリックまたは、選択して右側の[編集]ボタンをクリック。
"’in-app-purchasing-1.0.3.jar' の Javadoc" ウィンドウで、 Javadoc URLラジオボタンを選択し、Javadoc ロケーション・パスに "/InAppPurchasing/documentation/API-Reference" を指定する。
[in-app-purchasing-1.0.3.jar] の Javadoc ロケーションが変更されたことを確認して、[プロパティ]ウィンドウを [OK]ボタンで閉じる。

これでプロジェクト内でアプリ内課金関連のパッケージのリファレンスがEclipse上で直接見れるようになります。

Androidアプリ開発の紆余曲折

2013年5月31日金曜日

Amazon In-App Purchasing API (アプリ内課金) テスト方法

定義構造

定義要素：Consumable / Entitled

定義要素：Subscription

Active Transactions

Change Logged in User

Interactive Mode Preferences

Purchase API

Purchase Updates API

Item Data API

2013年5月25日土曜日

Amazon AppStore アプリ内課金の実装--準備