Android API Level31以上に対応する(QuasarとCapacitor4を利用)

少し前からGoogle PlayStoreはAPI Level 31以上を必須としました。 Quasar Frame workを使って API Lv31以上のAABを作成してPlay Storeにアップロードするまでに至った手順を紹介します。 色々手間取りましたが無事提出できました。とりあえず以下の作業を進める前に別ブランチで作業することを推奨します。

Capacitor4を使う

API LV31以上に対応するにはCapacirot4に更新します。しかしQuasarの公式サイトにはCapacitor4に関する言及がありません。 記事はCapacitor3で止まっています。サポートされていないように見えますが、Capasitor4でも動作しました。

具体的なフロー

いつものようにQuasarからAndroidのビルドを行います.

quasar build -m capacitor -T android --ide

src-capacirorフォルダを開き、package.jsonを修正します。 capacitorのバージョンを4以上にします。

{
  "name": "nipo_plus",
  "version": "1.21.0",
  "description": "レポートWeb管理システム",
  "author": "sandbox LLC <info@sndbox.jp>",
  "private": true,
  "dependencies": {
    "@capacitor/android": "^4.0.0",
    "@capacitor/cli": "^4.0.0",
    "@capacitor/core": "^4.0.0",
    "@capacitor/ios": "^4.0.0"
  }
}

変更したら作業ディレクトリを移動し、最新版に更新します

cd src-capacitor
yarn

src-capacitor内で以下のコマンドを入力します。以下の処理は若干時間がかかります。

npx cap migrate

Capacitorの公式移行ガイドも参照してください。

migrate中にエラーが発生する場合は、エラー内容を確認してください。 私の環境では以下のようなエラーが発生しました。

[error] gradle wrapper files were not updated
[info] Warning: The Android Gradle plugin was updated and it requires Java 11 to run. You may need to select this in
       Android Studio.

java 11を使えということですね。 Android Studio -> Preferenceを開きます。 Build, Execution, Deploymentを開き、Build tools -> Gradleの順にアクセスします。

AndroidStudioのメニューからBuildBundlesを選びます
AndroidStudioのメニューからBuildBundlesを選びます
AndroidStudioのメニューからBuildBundlesを選びます

Gradle JDKを11に修正します。 修正後に再び同じコマンドを入力します。

npx cap migrate

エラーが出なくなれば成功です。

android studio上での作業

npx cap openでAndroid Studioを立ち上げます。起動と同時にビルド処理?が始まりますが、ここでエラーが発生することがあります。

Android StudioでGradle sync failed: Timeout waiting to lock journal cacheというエラーが出る場合は、前回のビルドのキャッシュが原因で失敗しています。 プロセスを終了して再実行すれば改善される可能性が高いです。

/Users/ユーザ名/.gradle/caches/journal-1/journal-1.lockというファイルを削除してしまえばOKです。 または

sudo kill -9 <Owner PID>

とすることでも解消できます。AABファイルとしてビルドする手順についてはAndroidビルドの記事を参照してください。

詳しい原因は不明ですが、ビルドを終えてPlay StoreにUPすると「APIレベル22を対象としています」と表示されます。

アップロード時に警告が表示される
アップロード時に警告が表示される
アップロード時に警告が表示される

以前は「APIレベル30を対象としています」だったのでむしろ悪化したような感じですね。 valiables.gradleでは以下のようになっています

ext {
    minSdkVersion = 28
    compileSdkVersion = 31
    targetSdkVersion = 31
    androidxActivityVersion = '1.4.0'
    androidxAppCompatVersion = '1.4.2'
    androidxCoordinatorLayoutVersion = '1.2.0'
    androidxCoreVersion = '1.8.0'
    androidxFragmentVersion = '1.4.1'
    junitVersion = '4.13.2'
    androidxJunitVersion = '1.1.3'
    androidxEspressoCoreVersion = '3.4.0'
    cordovaAndroidVersion = '10.1.1'
    coreSplashScreenVersion = '1.0.0-rc01'
    androidxWebkitVersion = '1.4.0'
}

何故かminSDKを31にしてもこの問題は解決しませんでした。 build.gradleの方で直接バージョンを指定することでこの問題は解決できました。(反映が遅れただけなのか?)

android {
    compileSdkVersion 31 // ◀ここで直接バージョンを指定
    defaultConfig {
        applicationId "jp.sndbox.nipoplus"
        minSdkVersion 28 // ◀ここで直接バージョンを指定
        targetSdk 31 // ◀ここで直接バージョンを指定
        versionCode 100
        // 以下略
    }
}

これで再度ビルドし、アップロードしたところ無事にAPI Lv31を対象とすることができました。

API Lv31になりました
API Lv31になりました
API Lv31になりました

最後に

AndroidのAPILv31については当初ビルドが失敗して色々調べました。Quasarでは次のようなPull Requestがあります。 このプルリクが実装されればもう少しスマートに移行できたかもしれません。ただ更新が止まっているためこのプルリクが実装される見込みは低そうです。 また、IssueにもAPI Lv31に関する議題があがっていました。

今回は色々試行錯誤して問題が解決できましたが、この辺の手順を公式Quasarでしっかり書いてくれないので使う側は色々調べ回る必要があるのが辛いところですね。