レガシー Java サポート (JDK 11)
当社のメインの Unity Billing SDK はモダンな環境 (JDK 17 以上) 向けに最適化されていますが、一部のプロジェクトは特定のビルドパイプラインやエンジンの制約により JDK 11 に依存していることを認識しています。
リリース 3.3.0 以降、JDK 11 は MavenCentral 経由で直接サポートされるため、AAR ファイルを手動でインポートする必要はなくなりました。最新バージョンへの移行と、標準の MavenCentral 連携のご利用をお勧めします。
以下で説明する手動の AAR ベースのフローは、古いリリースを使用し続ける場合にのみ必要です。手動連携を維持する場合は、Assets/Plugins/Android 配下に古いファイルが残っていないこと、および JDK 11 ブランチから正しい AAR ファイルをインポートしていることを確認してください。
手動フローを使用し続けるプロジェクトをサポートするために、配布フローを MavenCentral から手動の AAR ベース連携に戻した専用ブランチを維持しています。
前提条件と互換性
要件 | 値 |
|---|---|
Java バージョン | JDK 11 |
配布 | 手動 AAR インポート + UPM ブランチ |
Unity バージョン | Unity 2022.3 LTS |
ブランチ URL |
|
連携手順
JDK 11 をサポートする Aptoide Unity Billing SDK を連携するには、以下の手順に従ってください。
1. UPM を介して SDK をインポートする
メインブランチではなく、Unity Package Manager で特定の #support-jdk-11 タグをターゲットにする必要があります。
- Unity プロジェクトを開きます。
- Window > Package Manager に移動します。
- + アイコンをクリックし、Add package from git URL... を選択します。
- 次の URL を貼り付けます。
https://github.com/Aptoide/aptoide-unity-billing-sdk.git#support-jdk-11
2. 手動 AAR デプロイ
このバージョンは (JDK 11 の互換性を維持するために) Native SDK を MavenCentral から取得しないため、Android バイナリを手動で移動する必要があります。
- Unity プロジェクトウィンドウで、Aptoide パッケージフォルダーに移動します。
Packages/Aptoide Unity Billing SDK/Runtime/Plugins/Android - そのディレクトリにあるすべての
.aarファイルをコピーします。 - それらをプロジェクトのローカルフォルダーに貼り付けます。
Assets/Plugins/Android
注:
Assets/Plugins/Androidフォルダーが存在しない場合は、手動で作成してください。
3. mainTemplate.gradle を変更する
バージョンの競合を回避し、すべてのロジックがローカルの AAR によって処理されるようにするには、Gradle 設定を調整する必要があります。
mainTemplate.gradle(通常はAssets/Plugins/Androidにあります) を開きます。- Aptoide Native Billing SDK の既存の
implementationインポートをすべて削除します。 - Native SDK に必要な手動の依存関係を追加します。手動の AAR は MavenCentral のように推移的依存関係を「自動解決」しないため、これらが必要です。SDK が機能するために必要な標準の AndroidX および Material ライブラリを含めるようにしてください。
4. 設定
AAR と Gradle のセットアップが完了したら、標準の Unity SDK 設定ガイドに従って、課金クライアントを初期化し、商品を定義します。
JDK 11 の問題のトラブルシューティング
- 重複クラスエラー: ビルド中に「Duplicate Class」エラーが表示される場合は、SDK が
Pluginsフォルダー内の AAR によってローカルで提供されるようになったため、Gradle ファイルから Aptoide SDK のimplementation行を削除したことを確認してください。また、Aptoide Unity Billing SDK フォルダーからPluginフォルダーとその.metaファイルを削除したことを確認してください。 - 依存関係の欠落: ビルドが「Symbol not found」エラーで失敗する場合は、必要な AndroidX および Material 依存関係を
mainTemplate.gradleに手動で追加したことを再確認してください。