移行ガイド
新しい課金システムへの移行が頭痛の種であってはなりません。競合製品から移行する場合でも、旧来の Aptoide ソリューションからアップグレードする場合でも、これらのガイドはメソッド、リスナー、ロジックの明確なマッピングを提供し、できるだけ早く新しい Aptoide Billing SDK で稼働できるようにします。
新しい SDK は、業界標準との高い互換性を提供するモダンなアーキテクチャで設計されており、ほとんどの Android 開発者にとって直感的に切り替えられます。
- ネイティブなボトムシート決済 — ユーザーは Wallet のインストールを必要とせずにアプリ内で購入できるため、決済のコンバージョンが向上します。
- 不正削減 UI — フロー途中の誤ったキャンセルをブロックします。
- 16 KB ページサイズのサポート — 新しい Android デバイスとの互換性に必要です。
移行パスの選択
下の表で現在の構成を見つけ、推奨されるターゲット SDK、所要時間の見積もり、および該当するガイドまたはドキュメントへの直接リンクを確認してください。
| 現在の構成 | 推奨ターゲット | 所要時間 | 内容 | ガイド |
|---|---|---|---|---|
1.2.0 未満の Aptoide Billing SDK（com.aptoide:android-aptoide-billing） | Aptoide Billing SDK 1.+（com.aptoide:android-aptoide-billing） | 約 5 分 | 依存関係バージョンのドロップイン更新 — API の変更は不要です。 | リリースノート |
0.7.3.0 より上かつ 0.10 未満の AppCoins SDK（io.catappult:android-appcoins-billing） | AppCoins SDK 0.10.+（io.catappult:android-appcoins-billing） | 約 5 分 | 依存関係バージョンのドロップイン更新 — API の変更は不要です。 | リリースノート |
Google Play Billing SDK（com.android.billingclient:billing） | Aptoide Billing SDK 1.+（com.aptoide:android-aptoide-billing） | 約 10 分 （AI プロンプト使用時） | BillingClient のリスナーをマッピングし、Google 固有の依存関係を Aptoide の同等物に置き換えます。ほぼ 1 対 1 の API 互換性があります。 | 移行ガイド · AI プロンプト |
0.7.3.0 未満の レガシー AppCoins SDK（io.catappult:android-appcoins-billing） | AppCoins SDK 0.10.+（io.catappult:android-appcoins-billing）または Aptoide Billing SDK 1.+（com.aptoide:android-aptoide-billing） | 約 30 分 | レガシーフローから、コールバック駆動のネイティブ実装とより新しい Aptoide Connect バックエンド API へ移行します。 | 移行ガイド |
| One-Step Payment（OSP） | Aptoide Billing SDK 1.+（com.aptoide:android-aptoide-billing） | 約 1 時間 | URL 起動のウェブ決済を、Aptoide Wallet に直接接続するネイティブ SDK クライアントに置き換えます。 | 移行ガイド |
注記: AppCoins SDK（
io.catappult:android-appcoins-billing）はメンテナンスされているレガシーラインであり、Aptoide Billing SDK（com.aptoide:android-aptoide-billing）は新規および長期的な統合に推奨されるモダンな SDK です。時間がある場合は、Aptoide Billing SDK1.+への移行が最善の長期的選択です。
利用可能な移行パス
現在の実装に応じて、開始地点に合ったガイドを選択してください。
Google Play Billing からの移行
これまでに Google の Billing SDK を統合した開発者向けです。Aptoide Billing SDK は Google Play の Billing SDK と非常に似たパターンに従っており、このガイドはスムーズな移行を支援します。
- 主な焦点:
BillingClientのリスナーをマッピングし、Google 固有の依存関係を Aptoide の同等物に置き換えます。
レガシー AppCoins SDK からの移行
旧来の AppCoins 統合を使用している開発者向けです。この移行は、レガシー SDK のフローから、より堅牢でコールバック駆動のネイティブ実装への移行に焦点を当てています。
- 主な焦点: セキュリティの向上、より容易な統合、機能の改善、およびより新しい Aptoide Connect バックエンド API への移行。
OSP 統合からの移行
以前に One-Step Payment（OSP） のウェブベースのフローを使用していた場合、このガイドはそれらのインタラクションをネイティブな Android 体験にラップするのに役立ちます。
- 主な焦点: URL を使用して手動で起動していた決済を、高性能なネイティブ SDK に置き換えます。
一般的な移行のヒント
- デュアル統合: コード内でシンプルなフレーバーまたは「プロバイダー」パターンを使用することで、既存の Billing SDK を Aptoide SDK と並行して維持できます。
- これを実現する方法の詳細については、Aptoide Diceroll SDK の例を確認してください。
- サンドボックスでのテスト: 本番トラックにプッシュする前に、必ずサンドボックス環境を使用して移行を検証してください。