[Android] In-app Billing v3を使ってライセンス購入を実装するLicenseManagerをアップデートしました

憂鬱なムックを助ける友の会: [Android] In-app Billing v3を使ってライセンス購入を実装する で紹介していたLicenseManagerクラスですが、onCreateでnewして、onResumeでisLicensePurchased()メソッドにて購入状態を判定するという作りにしていましたが、onCreateからonResumeが走るまでにIn-app Billing APIが結果を返しきる保証は何もないので、判定を誤るという可能性がありました。

そこで、そのバグ（そう、これはバグです！すみませんっ！！）を修正しましたのでご案内します（そして、コミットログ、ミスりました。。。恥ずかしい。。）

https://github.com/shinchit/LicenseManager

使い方はほぼ変わりません。ただ、newした段階でIn-app Billing APIが結果を返し済みであることを確認してから先の処理に進むように改修していますので、newの直後にisLicensePurchased()メソッドを使っても問題ありません。

技術的には、非同期処理の順番、完了待ちを保証するために、JDeferredというライブラリを利用しています。
そのため、appレベルのbuild.gradleのdependenciesに

　compile 'org.jdeferred:jdeferred-android-aar:1.2.4'

といった記述が必要です（バージョンは適宜調整してください。動作確認をとっているのは1.2.4です）。

JDeferredの細かい使い方については、公式、または次のページがわかりやすいです。

Java - Androidの非同期処理を綺麗に書けるjdeferredが便利！ - Qiita

LicenseManagerでは、以下の記述でnewの中でIn-app Billing APIへの非同期リクエストが帰ってくるのを待ち合わせています。

	// ライセンス購入セットアップ開始
	AndroidDeferredManager dm = new AndroidDeferredManager();
	try {
	dm.when(() -> {
	mHelper.startSetup(new IabHelper.OnIabSetupFinishedListener() {
	public void onIabSetupFinished(IabResult result) {
	if (!result.isSuccess()) {
	Log.d(TAG, "セットアップ失敗 結果: " + result);
	return;
	}
	// オブジェクトが生成されていない
	if (mHelper == null) return;
	Log.d(TAG, "セットアップ成功。 購入情報照会へ");
	mHelper.queryInventoryAsync(mGotInventoryListener);
	}
	});
	}).done(result -> {
	// do nothing
	}).fail(tr -> {
	tr.printStackTrace();
	}).waitSafely();
	} catch (InterruptedException e) {
	e.printStackTrace();
	}
	}

view raw JDeferredSample.parts.java hosted with ❤ by GitHub

ちなみに、ここではJavaのλ式（ラムダ式）を利用しています。が、別に使わなくても問題ないです^^
ただ、見てお分かりの通り、λ式を使うと型の迂遠な明示が省略できるので楽に読み書きでき、スッキリして見えます。

また、GitHub上のLicenseManagerでは、アプリのライセンスキーを暗号化せずにそのまま渡していますが、実際のリリースapkを作る際にはそれはオススメできません。ライセンスキーは暗号化して保持し、これを復号化してLisenceManagerに渡すようにするべきです。とはいえ、暗号化のseedはapk内に持つため、その気になれば簡単に復号化もできてしまうのですが。。。万全を期すなら、seedを外部のサーバ（Webサーバなど）において、SSLでそれを取得してというのが良いのでしょうが、、、そこまでやる必要もないかと（というか、それをやると実装によってはオフラインでアプリを使用できないシーンが出てくるし）。
この辺の、暗号化・復号化の話はまた別エントリーで取り上げます。