Windows 10 Android 构建配置指南本文档记录在 Windows 10 上构建 Android APK 的环境配置、依赖安装和常见问题解决。环境信息组件版本操作系统Windows 10 专业版 22H2Flutter3.38.9 (Dart 3.10.8)Java1.8.0_301 OpenJDK 21 (Android Studio 自带)Android SDK36.1.0Gradle8.13Android Gradle Plugin8.1.0Kotlin1.9.10环境配置步骤1. 安装 Flutter# 下载 Flutter SDK# https://docs.flutter.dev/get-started/install/windows# 添加到环境变量# Path H:\flutter\bin2. 安装 Android Studio下载https://developer.android.com/studio安装时选择 Android SDK、Android SDK Platform-Tools安装 Android 13 (API 33) SDK3. 配置 Android SDK 路径# 告诉 Flutter Android SDK 的位置flutter config--android-sdkH:\Android\Sdk4. 接受 Android 许可证flutter doctor--android-licenses# 对每个许可证输入 y 接受5. 验证环境flutter doctor依赖配置pubspec.yaml 关键依赖dependencies:flutter:sdk:flutter# State Managementprovider:^6.1.1# Local Storagesqflite:^2.4.0path_provider:^2.1.4shared_preferences:^2.3.0# Internationalizationintl:^0.20.2flutter_localizations:sdk:flutter# Utilsuuid:^4.3.1Android 配置文件gradle.propertiesorg.gradle.jvmargs-Xmx4G -XX:MaxMetaspaceSize1G -Dfile.encodingUTF-8 android.useAndroidXtrue android.enableJetifiertrue注意默认内存配置-Xmx768M -XX:MaxMetaspaceSize256M会导致内存不足错误。gradle-wrapper.propertiesdistributionUrlhttps\://services.gradle.org/distributions/gradle-8.13-all.zipbuild.gradle.kts (项目级)buildscript{ext.kotlin_version1.9.10repositories{google()mavenCentral()}dependencies{classpath(com.android.tools.build:gradle:8.1.0)classpath(org.jetbrains.kotlin:kotlin-gradle-plugin:$kotlin_version)}}app/build.gradle.ktsandroid{namespacecom.bucketlist.bucketListcompileSdk34compileOptions{sourceCompatibilityJavaVersion.VERSION_17 targetCompatibilityJavaVersion.VERSION_17}kotlinOptions{jvmTargetJavaVersion.VERSION_17.toString()}defaultConfig{applicationIdcom.bucketlist.bucketListminSdk21targetSdk34versionCode1versionName1.0.0}}构建命令# 安装依赖flutter pub get# 清理构建缓存出现问题时使用flutter clean# 构建 Release APKflutter build apk--release# APK 输出位置# build\app\outputs\flutter-apk\app-release.apk常见问题与解决方案1. cmdline-tools 组件缺失错误信息cmdline-tools component is missing解决方案在 Android Studio 中安装Tools → SDK ManagerSDK Tools 选项卡勾选 Android SDK Command-line Tools (latest)点击 Apply 安装2. Android SDK Platform 缺失错误信息Could not determine the dependencies of task :sqflite:compileReleaseJavaWithJavac. Failed to install the following SDK components: platforms;android-33解决方案在 Android Studio 的 SDK Manager 中安装 Android 13.0 (API 33)3. 依赖版本冲突错误信息Because every version of flutter_localizations from sdk depends on intl 0.20.2 and bucket_list depends on intl ^0.18.1, flutter_localizations from sdk is forbidden.解决方案更新pubspec.yaml中的 intl 版本intl:^0.20.2然后运行flutter pub get4. CardTheme 类型错误错误信息The argument type CardTheme cant be assigned to the parameter type CardThemeData?.解决方案修改lib/utils/app_theme.dart// 错误cardTheme:CardTheme(...)// 正确cardTheme:CardThemeData(...)5. path_provider_android 编译错误错误信息error: cannot find symbol PluginRegistry.Registrar registrar解决方案# 升级依赖到最新版本flutter pub upgrade--major-versions6. ic_launcher_foreground 资源缺失错误信息resource mipmap/ic_launcher_foreground not found解决方案删除 adaptive-icon 配置rm-rf android/app/src/main/res/mipmap-anydpi-v267. Kotlin 增量编译缓存损坏错误信息Could not close incremental caches this and base files have different roots解决方案flutter clean flutter build apk--release8. 内存不足 (OutOfMemoryError)错误信息java.lang.OutOfMemoryError: Metaspace解决方案修改android/gradle.properties# 从 org.gradle.jvmargs-Xmx768M -XX:MaxMetaspaceSize256M # 改为 org.gradle.jvmargs-Xmx4G -XX:MaxMetaspaceSize1G9. Gradle 版本过低错误信息Minimum supported Gradle version is 8.13. Current version is 8.3解决方案修改android/gradle/wrapper/gradle-wrapper.propertiesdistributionUrlhttps\://services.gradle.org/distributions/gradle-8.13-all.zipFlutter Doctor 正常输出[√] Flutter (Channel stable, 3.38.9) [√] Windows Version (10 专业版 64 位, 22H2, 2009) [√] Android toolchain - develop for Android devices (Android SDK version 36.1.0) [√] Chrome - develop for the web [√] Connected device [√] Network resources输出信息APK 路径build\app\outputs\flutter-apk\app-release.apk示例输出√ Built build\app\outputs\flutter-apk\app-release.apk (49.4MB)相关文档Android 官方构建文档Flutter Android 构建文档