Skip to content

Android Gradle Pluginの更新とcompileSdk=33の問題解決

問題の概要

AndroidプロジェクトでcompileSdkVersion 33を使用する際に、以下の警告メッセージが表示される場合があります:

We recommend using a newer Android Gradle plugin to use compileSdk = 33

This Android Gradle plugin (7.2.1) was tested up to compileSdk = 32

This warning can be suppressed by adding android.suppressUnsupportedCompileSdk=33 to this project's gradle.properties

この警告は、現在使用しているAndroid Gradle Plugin(AGP)のバージョンが、compileSdk 33の完全なサポートに対応していないことを示しています。

解決方法

方法1: Android Gradle Pluginのバージョンアップ(推奨)

最も適切な解決策は、Android Gradle Pluginを最新バージョンに更新することです。

build.gradle(プロジェクトレベル) で以下のようにプラグインバージョンを更新します:

gradle
buildscript {
    dependencies {
        classpath 'com.android.tools.build:gradle:8.2.2' // 最新バージョンに変更
        // 他のクラスパス設定...
    }
}

方法2: Gradle Wrapperの更新

Gradleのバージョンも併せて更新する必要がある場合があります:

gradle-wrapper.properties を以下のように変更します:

properties
distributionUrl=https\://services.gradle.org/distributions/gradle-8.4-bin.zip

方法3: Android Studioのアップグレードアシスタントを使用

Android Studioでは、専用のアップグレードアシスタントを使用して簡単に更新できます:

  1. ToolsAGP Upgrade Assistant を選択
  2. 現在のバージョン(例:7.4.2)から最新バージョン(例:8.2.2)へのアップグレードを実行
  3. 指示に従ってプロジェクトを更新

WARNING

アップグレード後は、プロジェクトのビルドとテストを十分に行い、互換性の問題がないことを確認してください。

方法4: 一時的な警告の抑制(非推奨)

緊急時の一時的な対応として、警告を抑制することもできます:

gradle.properties に以下を追加:

properties
android.suppressUnsupportedCompileSdk=33

注意

この方法は警告を非表示にするだけで、根本的な解決にはなりません。互換性の問題が発生する可能性があるため、できるだけ早く適切なプラグインバージョンにアップデートすることを推奨します。

互換性テーブル

以下はAndroid Gradle PluginとGradleバージョンの互換性表です:

AGPバージョンGradleバージョンcompileSdk最大対応
7.2.x7.3.3+32
7.3.x7.4+33
7.4.x7.5+33
8.0.x8.0+33
8.1.x8.0+34
8.2.x8.4+34

トラブルシューティング

よくある問題と解決策

  1. ビルドエラーが発生する場合

    • 依存ライブラリの互換性を確認
    • 段階的にバージョンを上げてテスト
  2. Android Studioのバージョンが古い場合

    • Android Studio自体を最新バージョンに更新
  3. カスタムプラグインを使用している場合

    • プラグインの互換性を確認し、必要に応じて更新

ベストプラクティス

  • 定期的にAndroid Gradle PluginとGradleを最新バージョンに更新する
  • アップデート前には必ずバックアップを取得する
  • 変更履歴を確認し、破壊的変更がないか事前に調査する

リソース

適切なバージョン管理により、Androidプロジェクトの安定性とパフォーマンスを確保し、最新のAndroid機能を活用できるようになります。