InAppUpdate実装&InAppBillingClientVer2.0実装例

Transcript

1. Google I/O 2019 振り返り +In-App Update &In-App billing migration例 Osaka Mix Leap Study #47 - Android&Flutter 勉強会
2. Speaker 中谷　克紀 仕事 　Enterprise Server Engineer GDG 神戸スタッフ Twitter 　@KatsukiNakatani
3. Google I/O 2019
4. Android関連 ・CameraX ・JetPack Compose ・Kotlin first ・Android Q ・Android Studio 3.5 Beta1 ・PlayCoreLibrary stable ・PlayBillingLibrary 2.0 and more ...
5. さて、今日の本題 アプリ開発で問題になること アプリがアップデートされない（してくれない）
6. アップデートされない理由 ・アップデートに気づかないタイプ ・アップデートしたくないタイプ
7. みんなどうしていた？ ・WebAPI機能を実装している場合 起動時にWebAPI側でVersionCodeチェック Versionが違う場合は、ダイアログを表示してPlayStore に飛ばす
8. 私の場合 さくらのVPSにVerCode書いたファイルを置く 起動時にokhttpなどでVersionCodeチェック Versionが違う場合は、notificationを表示する
9. いらぬパーミッション <uses-permission android:name="android.permission.INTERNET" />
10. 複数トラックの管理どうする？ トラックごとにVerCodeをもたせて ロールアウトするごとに管理ファイルを更新するの？
11. 段階的リリースどうする？ ・段階リリースは同じトラック内にはいるが 　インストールユーザーのパーセンテージを指定して 　徐々にユーザーにアップデートを提供する機能
12. ちょっと脱線 クローズドトラック使ってる人いますか？
13. 結論 いや。もうWebAPIでは開発者がバージョン管理をするのは無 理がある
14. アップデートされない理由 ・アップデートに気づかないタイプ ・アップデートしたくないタイプ 少しでも改善したい
15. 救世主登場 In-App Update API!!
16. In-App Updateとは？ Play Core Libraryに含まれるAPI アプリケーションのアップデートを促すことができる INTERNET Permissionは不要 複数トラックも見分けすることが可能 段階的リリースにも対応
17. 実装見ていきましょう implementation "com.google.android.play:core:1.6.1" build.gradle
18. 初期化 lateinit var appUpdateManager: AppUpdateManager override fun onCreate(savedInstanceState: Bundle?) { super.onCreate(savedInstanceState) setContentView(R.layout.activity_main) appUpdateManager = AppUpdateManagerFactory.create(this) } MainActivity.kt
19. リスナーの追加 lateinit var appUpdateManager: AppUpdateManager override fun onCreate(savedInstanceState: Bundle?) { super.onCreate(savedInstanceState) setContentView(R.layout.activity_main) appUpdateManager = AppUpdateManagerFactory.create(this) appUpdateManager.appUpdateInfo.addOnSuccessListener { task -> when (task.updateAvailability()) { } } } MainActivity.kt Why Service Bind ??
20. ServiceBind 2019-07-05 00:12:20.248 10696-10696/org.gdgkobe.sample.inappupdate I/PlayCore: UID: [10081] PID: [10696] AppUpdateService : requestUpdateInfo(org.gdgkobe.sample.inappupdate) 2019-07-05 00:12:20.306 10696-10696/org.gdgkobe.sample.inappupdate I/PlayCore: UID: [10081] PID: [10696] AppUpdateListenerRegistry : registerListener 2019-07-05 00:12:20.408 10696-10730/org.gdgkobe.sample.inappupdate I/PlayCore: UID: [10081] PID: [10696] AppUpdateService : Initiate binding to the service. 2019-07-05 00:12:21.126 10696-10696/org.gdgkobe.sample.inappupdate I/PlayCore: UID: [10081] PID: [10696] AppUpdateService : ServiceConnectionImpl.onServiceConnected(ComponentInfo{com.android.vending/com.google.android.finsky.installservice.DevTriggeredU pdateService}) 2019-07-05 00:12:21.135 10696-10730/org.gdgkobe.sample.inappupdate I/PlayCore: UID: [10081] PID: [10696] AppUpdateService : linkToDeath 2019-07-05 00:12:21.255 10696-10718/org.gdgkobe.sample.inappupdate I/PlayCore: UID: [10081] PID: [10696] OnRequestInstallCallback : onRequestInfo 2019-07-05 00:12:21.257 10696-10730/org.gdgkobe.sample.inappupdate I/PlayCore: UID: [10081] PID: [10696] AppUpdateService : Unbind from service. bind PlayStoreアプリのサービスへ バインドをしている
21. InternetPermissionがいらない仕組み ではなく これだからです
22. 戻り値で更新があるかどうか判断 lateinit var appUpdateManager: AppUpdateManager override fun onCreate(savedInstanceState: Bundle?) { super.onCreate(savedInstanceState) setContentView(R.layout.activity_main) appUpdateManager = AppUpdateManagerFactory.create(this) appUpdateManager.appUpdateInfo.addOnSuccessListener { task -> when (task.updateAvailability()) { } } } MainActivity.kt UpdateAvailability.UNKNOWN UpdateAvailability.UPDATE_AVAILABLE UpdateAvailability.UPDATE_NOT_AVAILABLE UpdateAvailability.DEVELOPER_TRIGGERED_UPDATE_IN_PROGRESS
23. イベントフロー 初期化 Listener登録 Bind、状態返却 更新するUIを表示 Available Immediate Flexible
24. パターンが２つ Immediate Flexible
25. Immediate(即時更新) 更新ボタンを押すとダウンロードが開始 ダウンロード後自動インストール インストール後、アプリは自動再起動 ダウンロード時はアプリが利用できない
26. flexible 更新ボタンを押すとダウンロードが開始 ダウンロード後は開発者がインストールを促すアクションを提示 インストール後、アプリは自動再起動 ダウンロード時にアプリを利用することが可能
27. 更新するUIを提示するコード appUpdateManager.appUpdateInfo.addOnSuccessListener { task -> when (task.updateAvailability()) { UpdateAvailability.UPDATE_AVAILABLE -> { appUpdateManager.startUpdateFlowForResult( task, AppUpdateType.IMMEDIATE, // or flexible this, ImmediateActivity.UPDATE_CHECK_REQUEST_CODE ) }
28. Immediateの場合 特に終了を意識する必要はないので、 Flowを開始すればいい。 ただし、Foregroundで処理が実行される関係上、アプリが裏側に行ってしまう場合は、 Resume処理が必要 override fun onResume() { super.onResume() appUpdateManager.appUpdateInfo.addOnSuccessListener { task -> when (task.updateAvailability()) { UpdateAvailability.DEVELOPER_TRIGGERED_UPDATE_IN_PROGRESS -> { appUpdateManager.startUpdateFlowForResult( task, AppUpdateType.IMMEDIATE, this, ImmediateActivity.UPDATE_CHECK_REQUEST_CODE ) } } } }
29. flexibleの場合 Flow開始後にダウンロード完了検知が必要 private fun registerInstallStateListener() { installStateUpdateListener = InstallStateUpdatedListener { Log.d("resumeState", "State " + it) if (it.installStatus() == InstallStatus.DOWNLOADED) { showUpdateMessage() //Snackbarを表示 appUpdateManager.unregisterListener(installStateUpdateListener) installStateUpdateListener = null } } appUpdateManager.registerListener(installStateUpdateListener) } private fun showUpdateMessage() { Snackbar.make(findViewById(R.id.root_layout), "Update Available", Snackbar.LENGTH_LONG) .setAction("Update") { _ -> appUpdateManager.completeUpdate() }.show() }
30. Tips
31. Tips Immediateは強制インストールではない ☓ボタンで閉じることが出来る バックキーも有効 override fun onActivityResult(requestCode: Int, resultCode: Int, data: Intent?) { super.onActivityResult(requestCode, resultCode, data) if(requestCode == UPDATE_CHECK_REQUEST_CODE && resultCode == Activity.RESULT_CANCELED){ Toast.makeText(this,"更新してくれ〜",Toast.LENGTH_LONG).show() } } onActivityResultで検知して、対応をしましょう
32. Tips Updateするパッケージごとに Immediate,Flexibleを分けたい appUpdateManager.appUpdateInfo.addOnSuccessListener { task -> when (task.updateAvailability()) { UpdateAvailability.UPDATE_AVAILABLE -> { val versionCode = task.availableVersionCode() { "state": [ { "vname": "1.0.1", "vcode": 2, "type": "Flexible" }, { "vname": "1.0.2", "vcode": 3, "type": "Immediate" }, { "vname": "1.0.3", "vcode": 4, "type": "Cancel" } ] }
33. Tips APIを初期化した際のリクエストでは外部へストアアプリが見に行ってくれるわけではない NotAvailable ストアアプリを開いて、アプリの更新を押す Available！
34. Tips In-App Updateでは、Playストアアプリでアプリが公開されており一度でもインストールされていないといけ ない
35. Tips 署名キーはAPIに影響しない パッケージ名が違う場合は動作しない
36. まとめ In-App UpdateはPlay Core Libraryに含まれるAPI PlayStoreは必要 INTERNET Permissionは不要 複数トラックも見分けすることが可能 段階的リリースにも対応 アプリケーションのアップデートを簡易的に促すことができる 公開しないと使えないので公開は必須
37. Play Billing Library 2.0 Google Play Billing Library 1.0 リリース（2017-09-19) Google Play Billing Library 1.1 リリース（2018-05-07） Google Play Billing Library 1.2 リリース（2018-10-18） Google Play Billing Library 1.2.1 リリース（2019-03-04） Google Play Billing Library 2.0 リリース（2019-05-07）
38. Play Billing Library 1.x系実装 //billing implementation "com.android.billingclient:billing:${billing_version}"
39. 初期化とConnectionの開始 class MainActivity : AppCompatActivity(), PurchasesUpdatedListener { lateinit private var billingClient: BillingClient ... billingClient = BillingClient.newBuilder(context).setListener(this).build() billingClient.startConnection(object : BillingClientStateListener { override fun onBillingSetupFinished(@BillingClient.BillingResponse response: Int) { when (response) { OK -> { } else -> { } } } override fun onBillingServiceDisconnected() { } })
40. 購入 val params = BillingFlowParams.newBuilder() .setType(BillingClient.SkuType.INAPP) .setSku(AppParameter.CATALOG[0]) .build() val responseCode = activity.billingClient.launchBillingFlow(activity, params)
41. 流れ(1.x) 初期化 Connection開始 購入Flow開始 アイテム所持
42. Play Billing Library 2.x系実装 //billing implementation "com.android.billingclient:billing:${billing_version}"
43. 初期化とConnectionの開始 class MainActivity : AppCompatActivity(), PurchasesUpdatedListener { lateinit private var billingClient: BillingClient ... billingClient = BillingClient.newBuilder(context).enablePendingPurchases().setListener(this).build() billingClient.startConnection(object : BillingClientStateListener { override fun onBillingSetupFinished(billingResult: BillingResult) { when (billingResult.responseCode) { OK -> { } else -> { } } } override fun onBillingServiceDisconnected() { } })
44. 購入 fun startPurchase() { val params = SkuDetailsParams.newBuilder() val skuList = arrayListOf<String>().toMutableList().apply { add(“item001”) } params.setSkusList(skuList).setType(BillingClient.SkuType.INAPP) 　//一度、アイテムの詳細情報を取得する activity.billingClient.querySkuDetailsAsync(params.build()) { billingResult, skuDetailsList -> if (billingResult.responseCode == BillingClient.BillingResponseCode.OK) { val flowParams = BillingFlowParams.newBuilder() .setSkuDetails(skuDetailsList.first()) .build() val responseCode = activity.billingClient.launchBillingFlow(activity, flowParams) } } }
45. とても大事なこと 承認すること override fun onPurchasesUpdated(billingResult: BillingResult?, purchases: MutableList<Purchase>?) { when (billingResult?.responseCode) { OK -> { if (purchases != null) { queryPurchase() } else {} } else -> { } } } fun queryPurchase() { //購入情報を取得 val result = activity.billingClient.queryPurchases(BillingClient.SkuType.INAPP) result?.purchasesList?.firstOrNull()?.run { if(purchaseState == Purchase.PurchaseState.PURCHASED){ //承認フラグが承認されていない場合 if (!isAcknowledged) { val acknowledgePurchaseParams = AcknowledgePurchaseParams.newBuilder().setPurchaseToken(purchaseToken).build() activity.billingClient.acknowledgePurchase(acknowledgePurchaseParams, acknowledgePurchaseResponseListener) } } } }
46. 流れ(2.x) 初期化 Connection開始 購入Flow開始 アイテム所持 承認！！
47. 承認は必要です
48. テストを怠るとこうなる もう一回買ってもらえばええやん？ クレジットは払い戻せない
49. どう対応したか PlayConsoleからプロモーションコードを発行し無料で提供
50. まとめ In-App Billing 2.x系の対応は、承認処理が必要 それ以外は大きく変わっていないのでMigrationは比較的ラクです テストはやろう。絶対
51. ご清聴ありがとうございました GDG神戸のDoorKeeperにもぜひご登録ください https://gdgkobe.doorkeeper.jp/