• 2025/3/7
• 3分

【Android Studio】最新OS(APIレベル)アップデート対応！Developer Preview/ベータ版のインストール

＼ アプリをリリースしました ／

友達や家族の誕生日をメモ！通知も届く-みんなの誕生日-

posted withアプリーチ

環境(例)

• Android Studio： Meerkat Feature Drop | 2024.3.2 Canary 8
• Android：16 APIレベル (Baklava)

APIレベルとは

Androidの「APIレベル」とはAndroidプラットフォームにおけるリリースバージョンごとに更新されていく値です。これはOSのバージョン(Android 16など)と基本的に関係していてOSのバージョンが上がるとAPIレベルも上がります。

OSアップデート対応の期限

OSアップデート対応は毎年8月末を目処に期限が引かれています。対象の期限に達するまでにtargetSdkVersionの引き上げ対応が行われていないアプリはアプリ新規リリースまたはアップデートができなくなってしまう可能性があります。ただ11月ごろまでは申請すれば期間延長も可能なようです。

詳細は以下の公式サイトを参考にしてください。

公式リファレンス：Google Play アプリの対象 API レベル要件
公式リファレンス：Meet Google Play's target API level requirement

例

Developer Previewとベータ版の違い

AndroidのOSバージョンが新しくリリースされることが決定すると実際にリリースされる前に開発者や一般ユーザー向けに「Developer Preview」や「ベータ版」が先に公開されます。リリーススケジュールは公式から発表されています。

引用：公式リファレンス：Android 16 Preview

Android StudioのエミュレーターでDeveloper Previewを動作させる

Android StudioのエミュレーターでDeveloper Previewを動作させる手順を紹介していきます。

1. Android Studio を開く
2. 上部メニュー「Tools」＞「SDK Manager」を開く
3. 「SDK Platforms」タブの中にある最新のDeveloper Previewにチェックをいれてインストール(添付画像)
4. 「Device Manager」を開き最新のAPIレベルのデバイスを新規作成

これで最新のAPIレベルのエミューレーターを起動させることが可能になります。ただこの手順はあくまで最新のAPIレベルのエミューレーターで起動させているだけでアプリのcompileSdkを最新のAPIレベルに更新して動作させているわけではないので注意してください。

最新OS(APIレベル)に対応する手順が後述していきます。

参考文献

最新OS(APIレベル)アップデート対応

Androidアプリで最新OS(APIレベル)アップデート対応する手順を見ていきます

1. 最新のAndroid Studioをインストールする
2. compileSdkを最新のAPIレベルに更新する
3. 必要な対応を行う(※)

※ 必要な対応は様々ですが、Gradle、AGP、Kotlinのバージョンのアップデートとそれに伴う修正が多いかと思います。

最新のAndroid Studioをインストールする

まずは最新OS(APIレベル)に対応しているAndroid Studioをインストールするところから始めます。「Android Studio Archive」から最新のAndroid Studioを選択してインストールしておきます。

すでに最新バージョンの安定版がリリースされていれば良いですが先行して試したい場合は「Canary」などのDeveloper Previewをインストールして進めていきます。

compileSdkを最新のAPIレベルに更新する

インストールした最新版のAndroid Studioでアプリが最新OS(APIレベル)に対応を進めるにはcompileSdkとtargetSdkを最新のAPIレベルに更新します。もしPreview段階の場合はcompileSdkPreviewとtargetSdkPreviewを使用します。

build.gradle
android {
    namespace 'com.XXXXXX.XXXXXX'
    // compileSdk 36 // APIレベルが確定したら
    compileSdkPreview "Baklava" // Preview段階はこっち

    defaultConfig {
        applicationId "com.XXXXXX.XXXXXX"
        minSdk 24
        // targetSdk 36 // APIレベルが確定したら
        targetSdkPreview "Baklava" // Preview段階はこっち
        versionCode 1
        versionName "1.0"

        testInstrumentationRunner "androidx.test.runner.AndroidJUnitRunner"
    }

    // 〜〜〜〜〜〜〜〜〜
}

compileSdkとtargetSdkを引き上げることで最新APIレベルでアプリが動作するようになる(※)のでそこでビルドが通らなくなったり、バージョン更新エラーが発生するので随時対応していけばOKです。

SDKをインストールする

実行するSDKを変更したのでSDKが未インストールの場合は先にインストールする必要があります。上部メニュー「Tools」＞「SDK Manager」から「SDK Tools」タブに移動し対象のSDK「Android SDK Build-Tools 36-rc5」にチェックを入れて「OK」をクリックしてインストールしておきます。

もし未導入のままビルドを試みようとすると「Error: please select android sdk」というエラーになるのでその場合は上記手順を試してみてください。

Minimum supported Gradle version is 8.7. Current version is 8.0.

compileSdkやtargetSdkを引き上げると現在のGradleのバージョンが最新OSに対応しておらず以下のようなエラーが発生することがあります。

Minimum supported Gradle version is 8.7. Current version is 8.0.

これは単純にGradleのバージョンを更新してあげれば良く、「Change Gradle version in Gradle wrapper to 8.7 and re-import project」のように表示されるのでこれをクリックすることで必要なバージョンに更新してくれます。

このボタンを押下しなくても「gradle-wrapper.properties」ファイルでバージョンは管理されているので以下のgradle-8.0-bin.zip部分をgradle-8.7-bin.zipのように変更し「Sync Now」をクリックすることでも更新することが可能です。

gradle-wrapper.properties
#Fri Feb 09 20:17:22 JST 2024
distributionBase=GRADLE_USER_HOME
distributionPath=wrapper/dists
distributionUrl=https\://services.gradle.org/distributions/gradle-8.0-bin.zip
zipStoreBase=GRADLE_USER_HOME
zipStorePath=wrapper/dists

Project update recommended

Gradleのバージョンを更新しても以下のような警告(お知らせ)が発生することがあります。これはAGP側のバージョンを最新に更新できることをお知らせする通知です。必ずしも更新がj必要なわけではありませんが後述しているAPIレベルサポートバージョンに含まれていない場合は更新しておく必要があります。

Project update recommended
Android Gradle plugin version 8.0.2 has an upgrade available. Start the AGP Upgrade...
Start AGP Upgrade Assistant

更新するには「Start AGP Upgrade Assistant」といボタンをクリックし、「Run Selected step」をクリックすると自動で更新してくれます。

このボタンを押下しなくても「build.gradle(Project)」ファイルでバージョンは管理されているので以下のversion '8.9.0'部分をversion 'X.X.X'のように変更し「Sync Now」をクリックすることでも更新することが可能です。

build.gradle(Project)
plugins {
    id 'com.android.application' version '8.9.0' apply false
    id 'com.android.library' version '8.9.0' apply false
    id 'org.jetbrains.kotlin.android' version '1.8.20' apply false
}

APIレベルサポートバージョン一覧

was compiled with an incompatible version of Kotlin. The actual metadata version is 2.1.0, but the compiler version 1.8.0 can read versions up to 1.9.0.

このエラーはKotlin2.1.0でコンパイルされたコードを、Kotlin 1.8.0 のコンパイラで読み込もうとしているため発生しています。Kotlinのバージョンの不一致が発生しているだけなのでバージョンを合わしてあげればOKです。Kotlinのバージョンは「build.gradle(Project)」で指定しているバージョンを更新してあげればOKです。

build.gradle(Project)
plugins {
    id 'com.android.application' version '8.9.0' apply false
    id 'com.android.library' version '8.9.0' apply false
    id 'org.jetbrains.kotlin.android' version '2.1.0' apply false
}

まだまだ勉強中ですので間違っている点や至らぬ点がありましたら教えていただけると助かります。

ご覧いただきありがとうございました。