Flutter踩坑记录

最新推荐文章于 2025-02-27 11:26:04 发布

原创最新推荐文章于 2025-02-27 11:26:04 发布 · 758 阅读

1 ·

CC 4.0 BY-SA版权

Flutter 专栏收录该内容

1 篇文章

订阅专栏

本文详细介绍了Flutter开发环境的搭建过程，包括解决Android SDK许可状态未知、更新SDK Manager、处理异常错误、配置Java版本及解决Gradle依赖问题等步骤，确保开发者能够顺利进行跨平台应用开发。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

问题1：使用命令 flutter doctor后出现如下提示

[!] Android toolchain - develop for Android devices (Android SDK 29)
    ✗ Android license status unknown.

解决1：

flutter doctor --android-licenses

问题2：运行解决1后，出现如下提示

A newer version of the Android SDK is required. To update, run:
android-sdk/tools/bin/sdkmanager --update

解决2：需要更新sdkmanager

android-sdk/tools/bin/sdkmanager --update

问题3：由问题2引发

Exception in thread "main" java.lang.NoSuchFieldError: FN_AAPT2

解决3：

删除文件 android-sdk/tools/lib/common.jar

问题4：由问题2引发

Exception in thread "main" java.lang.NoClassDefFoundError: javax/xml/bind/annotation/XmlSchema
        at com.android.repository.api.SchemaModule$SchemaModuleVersion.<init>(SchemaModule.java:156)
        at com.android.repository.api.SchemaModule.<init>(SchemaModule.java:75)
        at com.android.sdklib.repository.AndroidSdkHandler.<clinit>(AndroidSdkHandler.java:81)
        at com.android.sdklib.tool.sdkmanager.SdkManagerCli.main(SdkManagerCli.java:73)
        at com.android.sdklib.tool.sdkmanager.SdkManagerCli.main(SdkManagerCli.java:48)
Caused by: java.lang.ClassNotFoundException: javax.xml.bind.annotation.XmlSchema
        at java.base/jdk.internal.loader.BuiltinClassLoader.loadClass(BuiltinClassLoader.java:583)
        at java.base/jdk.internal.loader.ClassLoaders$AppClassLoader.loadClass(ClassLoaders.java:178)
        at java.base/java.lang.ClassLoader.loadClass(ClassLoader.java:521)
        ... 5 more

解决4：

安装低版本Java，并修改JAVA_HOME指向为低版本Java。实测jdk-8u221-windows-x64.exe没问题

问题5：

若使用VsCode，Ctrl+Shift+P，输入doctor，进行验证，依旧出现上述问题。

解决5：

需要在VsCode终端中，依次在按照解决方案实行一次。在其他终端哪怕进行过flutter doctor并验证通过也需要再次来一遍。原因不明，有大佬知道的望告知。

问题6：运行时报错

Launching lib/main.dart on Android SDK built for x86 in debug mode...
Initializing gradle...
Resolving dependencies...
* Error running Gradle:
ProcessException: Process "/Users/rabbit/develop/android/flutter_app/android/gradlew" exited abnormally:
Project evaluation failed including an error in afterEvaluate {}. Run with --stacktrace for details of the afterEvaluate {} error.

FAILURE: Build failed with an exception.

* Where:
Build file '/Users/rabbit/develop/android/flutter_app/android/app/build.gradle' line: 25

* What went wrong:
A problem occurred evaluating project ':app'.
> Could not resolve all files for configuration 'classpath'.
   > Could not find lint-gradle-api.jar (com.android.tools.lint:lint-gradle-api:26.1.2).
     Searched in the following locations:
         https://jcenter.bintray.com/com/android/tools/lint/lint-gradle-api/26.1.2/lint-gradle-api-26.1.2.jar

* Try:
Run with --stacktrace option to get the stack trace. Run with --info or --debug option to get more log output. Run with --scan to get full insights.

* Get more help at https://help.gradle.org

BUILD FAILED in 0s
  Command: /Users/rabbit/develop/android/flutter_app/android/gradlew app:properties

Finished with error: Please review your Gradle project setup in the android/ folder.

解决6：

编辑项目下android\buid.gradle文件，注释jcenter()，google()，修改为如下

buildscript {
    repositories {
        //google()
        //jcenter()
        maven { url 'https://maven.aliyun.com/repository/google' }
        maven { url 'https://maven.aliyun.com/repository/jcenter' }
        maven { url 'http://maven.aliyun.com/nexus/content/groups/public' }
    }

    dependencies {
        classpath 'com.android.tools.build:gradle:3.1.2'
    }
}

allprojects {
    repositories {
        //google()
        //jcenter()
        maven { url 'https://maven.aliyun.com/repository/google' }
        maven { url 'https://maven.aliyun.com/repository/jcenter' }
        maven { url 'http://maven.aliyun.com/nexus/content/groups/public' }
    }
}

全局配置：修改fluttersdk\⁨⁨packages\flutter_tools⁩\⁨gradle⁩\flutter.gradle

buildscript {
    repositories {
        //jcenter()
        maven{ url 'https://maven.aliyun.com/repository/google' }
        maven{ url 'https://maven.aliyun.com/repository/jcenter' }
        maven{ url 'http://maven.aliyun.com/nexus/content/groups/public' }
    }
    dependencies {
        classpath 'com.android.tools.build:gradle:3.1.2'
    }
}