๊ฐ์
Android์ TargetSDK๋ 1๋ ์ ํ๋ฒ์ฉ ์ ๊ทธ๋ ์ด๋๋ฅผ ํด์ผํ๋ค.
์๋ ๊ฐ ๊ฐ๋ฐ์๋ค์ ๊ดด๋กญํ์จ Gradle ๋ฒ์ ์์ ์์ ์ด๊ธฐ ๋๋ฌธ์ ๋ด ๋๋ฆ๋๋ก ์ฝ๊ฒ ํด๊ฒฐํ ์ ์๋ ๋ ธํ์ฐ๋ฅผ ์ ๋ฆฌํ์ฌ ๋ฌธ์ํ๋ฅผ ํ๋ค.
2025.07์์ ์์ฑํ ๊ธ์ด๋ผ ์ต์ ๋ฒ์ ์์๋ ํตํ์ง ์์ ์ ์์.
๊ตฌ์ฑ
- AndroidStudio v2025.1.1
- Flutter v3.22.3
- Gradle v7.4
- AGP(Android Gradle Plugin) v7.3.1
- Java v17
์งํ
1. ํ๋ก์ ํธ์ SDK ๋ฒ์ ๋จผ์ ์ฌ๋ ค๋ณด๊ธฐ
Android์ app/build.gradle ์ targetSdkVersion, compileSdk๋ฅผ ๋จผ์ ์ฌ๋ ค๋ณด๊ธฐ.
๋๋ 34 ๋ฒ์ ์์ 35๋ก ๋ณ๊ฒฝ์ ํด๋ดค๋ค.
๊ทธ๋ฆฌ๊ณ ๋ฐ๋ก ๋น๋ ํ
์คํธ๋ฅผ ํด๋ณธ๋ค.
2-A. ๋น๋๊ฐ ์ ๋๋ฉด ์ด์ ์์.
๋ง์ฝ ๋ฒ์ ์ ์ฌ๋ฆฐ ์ดํ ์ด์์ด ์๋ค๋ฉด ๋์ด์ ์๋ ๊ฒ์ด ์๋ค. (์ด์)
2. ๋น๋์ค๋ฅ์ ๊ฒฝ์ฐ AGP ๋ฒ์ ํธํ์ฑ ์ฒดํฌ (์ด๋ฐ๊ฒ ์์ผ๋ ํ์ด๋ณด๊ธฐ)
๋๋ถ๋ถ CompileSDK ๋ฒ์ ์ ์ฌ๋ฆฌ๋ฉด ์์ฃผ ๋์ ํ๋ฅ ๋ก ์ค๋ฅ๊ฐ ๋ฐ์ํจ.
์ด๋ด๋๋ ๋ณดํต Gradle ๋๋ AGP(Android Gradle Plugin)์ ๋ฒ์ ์ด์์ผ ๊ฒฝ์ฐ๊ฐ ๋๋ถ๋ถ.
๋ฐ๋ผ์ AGP(Android Gradle Plugin)์ ๊ธฐ์ค์ผ๋ก Gradle์ ์ ์ ๋ฒ์ ์ ์ฐพ๊ณ ,
Gradle์ ๊ธฐ์ค์ผ๋ก Java์ ์ ์ ๋ฒ์ ์ ์ฐพ์์ผ ํ๋ค.
(SDK ๋ฒ์ > AGP ๋ฒ์ > Gradle ๋ฒ์ > Java ๋ฒ์ ์)
- ํ๋ก์ ํธ ๋ด์ ๋ฒ์ ์์น
SDK: prj/android/app/build.gradle > targetSdkVersion & compileSdk
AGP: prj/android/settings.gradle > id "com.android.application" version "[AGP๋ฒ์ ]" apply false
Gradle: prj/android/gradle/gradle-wrapper.properties > distributionUrl=https://services.gradle.org/distributions/gradle-[Gradle๋ฒ์ ]-all.zip
Java: ํ๋ฌํฐ๊ฐ ๋ฐ๋ผ๋ณด๋ ๋ฒ์ ์ ๋ฐ๋ผ ๋ค๋ฆ (ํฐ๋ฏธ๋์flutter doctor -v๋ก Android Toolchain๋ถ๋ถ์์ ํ์ธ ๊ฐ๋ฅ, ๋ํ ํ๋ฌํฐ๊ฐ ๋ฐ๋ผ๋ณด๋ ๋ฒ์ ์ง์ ์์ ๊ฐ๋ฅ)
์ฃผ์!! ๋ฒ์ ์ ์์ค ๋ด์์ ์ง์ ์์ ํ๋ฉด ๋จธ๋๋จผ ๋ ธ๊ฐ๋ค์ ๊ธธ์ ๊ฑธ์ ์ ์์.
(์ถ๊ฐ) ๋ฒ์ ํธํ์ฑ์ ๋ํ ์ฐธ๊ณ ๋ฌธ์๋ ์ฌ๊ธฐ์ ํ์ธํ ์ ์์.
AGP์ ๋ง๋ Gradle ๋ฒ์ ์ฒดํฌ: (https://developer.android.com/build/releases/gradle-plugin?hl=ko#updating-gradle)
Gradle์ ๋ง๋ Java๋ฒ์ ์ฒดํฌ: (https://docs.gradle.org/current/userguide/compatibility.html)
3. ๋ณธ๊ฒฉ์ ์ผ๋ก Android Studio์ ์์ฒด ๊ธฐ๋ฅ์ผ๋ก AGP ๋ฒ์ ์ฌ๋ฆฌ๊ธฐ
AndroidStudio๋ก ํ๋ก์ ํธ์ android ๋ค์ดํฐ๋ธ ํ๋ซํผ ํด๋๋ฅผ ์ง์ ์ด์ด๋ณด๊ธฐ.
์ผ์ชฝ ํ๋จ์ Build๋ฉ๋ด์์ Gradle Sync๊ฐ ์ ์์ ์ผ๋ก ์๋ฃ๋์ด์ผ ํ๋ค. (์ค๋๊ฑธ๋ฆด ์ ์์)

๊ทธ ๋ค์
์๋จ์ Tools > AGP Upgrade Assistant ๋ฉ๋ด๋ฅผ ํด๋ฆญ.
๋์ ๊ฒฝ์ฐ, SDK35 ๋ฒ์ ์ด Gradle 8.0(ํ์ฌ๋ 7.4) ์ด์๋ถํฐ ํธํ์ด ๋๊ธฐ ๋๋ฌธ์ AGP ๋ฒ์ ์ 8.1.4๋ก ์ก์๋ดค๋ค.
์ฒ์ฒํ ํ ๋จ๊ณ์ฉ ์ฌ๋ฆฌ๋ฉด์ ๋น๋ ํ
์คํธ๋ฅผ ํด๋ณด๋ฉด ๋๋ค.
(๊ฐ์๊ธฐ AGP๋ฒ์ ์ ํฌ๊ฒ ์ฌ๋ฆฌ๋ฉด ํ๋ฒ์ ๋ง์ดํ๊ฒ ๋ ๋น๋์ค๋ฅ ์ข๋น๋ค์ด ๋ชฐ๋ ค์จ๋ค.)
์ด ๋ฐฉ๋ฒ์ ์ถ์ฒํ๋ ์ด์ ๋
AGP ๋ฒ์ ์ด ์ฌ๋ผ๊ฐ๋ฉด์ Gradle ๋ฒ์ ๋ ์๋์ผ๋ก ์ฌ๋ผ๊ฐ๋๋ฐ,
๊ทธ๋ก ์ธํ Native ์ฝ๋๋ค๋ Android Studio๊ฐ ์์์ ๋ณ๊ฒฝํด์ฃผ๊ธฐ ๋๋ฌธ์ด๋ค.
์๋ ์ฌ์ง์ ๋นจ๊ฐ ๋ฐ์ค๋ ์
๊ทธ๋ ์ด๋๋ฅผ ํ ๊ฒฝ์ฐ ์์ ํ๊ฒ ๋ ์ฌํญ๋ค์.

๋๋ถ์ ๊ฐ๋ฐ์๋ Assistant ๊ธฐ๋ฅ๋ง์ ํ์ฉํด Gradle ๋ฒ์ ์ ์ฌ๋ฆด๋,
Native ์ฝ๋๋ค์ ์์ ์์ ์ ํ ๋นํ๋ ์๋์ง๋ฅผ ์ค์ผ ์ ์๋ค.
(๋จ, ์ค์ฌ์ง๋ค๊ณ ๋ ํ์ง, ์์ด์ง๋ค๊ณ ๋ ์ํจ)
4. ๋น๋ ํ ์คํธ
๋ฒ์ ์์ ์ด ์๋ฃ๋์๋ค๋ฉด, --debug ์ --release ๋ชจ๋ ๋น๋ํด๋ณด๊ธฐ.
--release์ ๊ฒฝ์ฐ proguard ๋๋ ์๋ช ๋ฌธ์ ๋ก ์ธํด ์ถ๊ฐ์ ์ธ ๋น๋์ค๋ฅ๊ฐ ๋ฐ์ํ ์ ์์.
๋น๋ ์ค๋ฅ๊ฐ ๋ฐ์ํ๋ค๋ฉด ํ์๋๋ ์ค๋ฅ ๋ฉ์์ง๋ฅผ ์ ๋ณด๊ณ GPT๋ฅผ ํตํด ์ ๋์ํด๋ณด๊ธฐ.
๋ณดํต ์ธ๋ถ ํจํค์ง์ ์ํ ์ค๋ฅ์ผ ํ๋ฅ ์ด ๋๊ธดํ๋ค.
๋ด๊ฐ ์์ ํ ํ ์์ ์์๋ inappwebview(์ฑ ๋ด์์ ์นํ์๋ฅผ ํ๋ ํจํค์ง)์ ๋ค์ดํฐ๋ธ ์ฝ๋์์ ์ค๋ฅ๊ฐ ๋ฐ์ํ๋ค. ์ต์ ๋ฒ์ ์ผ๋ก ์ฌ๋ฆฌ๋ฉด ํด๊ฒฐ ๊ฐ๋ฅํ๋ Flutter ๋ฒ์ ๋ ์ต์ ์ด์ด์ผ ๊ฐ๋ฅํ๊ธฐ ๋๋ฌธ์ ์ผ๋จ์ ํด๋นํจํค์ง์ Android ์ฝ๋๋ฅผ ์ง์ ์์ ํด์ ํด๊ฒฐ์ ํ๋ค.
5. ์ปค๋ฐ ํ ๋ค๋ฅธ PC์์ Pull์ ํ ๋ค์ ๋น๋ ํ ์คํธ ํด๋ณด๊ธฐ
๋น์ ์ ์ปดํจํฐ์์๋ง ๋ง๋ฒ๊ฐ์ด ์ ๋๋ ๊ฒ์ผ ์ ์๋ค.
๋ฐ๋์ ๋ค๋ฅธ PC ํ๊ฒฝ์์๋ ํน๋ณํ ์กฐ์น ์์ด ์ ๋๋ก ๋น๋๊ฐ ๋๋์ง ํ์ธํด๋ด๋ผ.
์ด์.
์ฐธ๊ณ ์๋ฃ:
https://docs.flutter.dev/release/breaking-changes/android-java-gradle-migration-guide