Mac 版#

flutter create xxxx(项目名称)

Android sdkmanager not found. Update to the latest Android SDK and ensure that the cmdline-tools are

cmdline-tools

Windows#

D:\flutter\bin

用法: java [-options] class [args...]
           (执行类)
   或  java [-options] -jar jarfile [args...]
           (执行 jar 文件)
其中选项包括:
    -d32          使用 32 位数据模型 (如果可用)
    -d64          使用 64 位数据模型 (如果可用)
    -server       选择 "server" VM
                  默认 VM 是 server.

    -cp <目录和 zip/jar 文件的类搜索路径>
    -classpath <目录和 zip/jar 文件的类搜索路径>
                  用 ; 分隔的目录, JAR 档案
                  和 ZIP 档案列表, 用于搜索类文件。
    -D<名称>=<值>
                  设置系统属性
    -verbose:[class|gc|jni]
                  启用详细输出
    -version      输出产品版本并退出
    -version:<值>
                  警告: 此功能已过时, 将在
                  未来发行版中删除。
                  需要指定的版本才能运行
    -showversion  输出产品版本并继续
    -jre-restrict-search | -no-jre-restrict-search
                  警告: 此功能已过时, 将在
                  未来发行版中删除。
                  在版本搜索中包括/排除用户专用 JRE
    -? -help      输出此帮助消息
    -X            输出非标准选项的帮助
    -ea[:<packagename>...|:<classname>]
    -enableassertions[:<packagename>...|:<classname>]
                  按指定的粒度启用断言
    -da[:<packagename>...|:<classname>]
    -disableassertions[:<packagename>...|:<classname>]
                  禁用具有指定粒度的断言
    -esa | -enablesystemassertions
                  启用系统断言
    -dsa | -disablesystemassertions
                  禁用系统断言
    -agentlib:<libname>[=<选项>]
                  加载本机代理库 <libname>, 例如 -agentlib:hprof
                  另请参阅 -agentlib:jdwp=help 和 -agentlib:hprof=help
    -agentpath:<pathname>[=<选项>]
                  按完整路径名加载本机代理库
    -javaagent:<jarpath>[=<选项>]
                  加载 Java 编程语言代理, 请参阅 java.lang.instrument
    -splash:<imagepath>
                  使用指定的图像显示启动屏幕
有关详细信息, 请参阅 http://www.oracle.com/technetwork/java/javase/documentation/index.html。

Windows 开发#

下载 C++环境

下载地址#

• 安装 SDK，安装前关闭所有杀毒软件，360 和管家

  必装几个 sdk：

  1. Android14,安装后核对是否为 x64：Google APls Intel x86 Atom_64 System lmage

  2. Android SDK Build-Tools 35

     需要安装 35.0.0、35.0.0-rc4、30.0.3 才可以

  3. Android Emulator、Android Emulator hypervisor driver

  4. lntel x86 Emulator Accelerator (HAXM installer)

  5. Android SDK Platform-Tools

  6. Google USB Driver

  7. Android SDK Command-line Tools 13.0 安装最新的即可

  8. Sources for Android 35

  9. Intel x86 Emulator Accelerator(HAXM installer)

• 安装 flutter 插件

  

安装 Android 证书#

在使用 Flutter 之前，按照指南安装所有必要的条件之后，再同意 Android SDK 平台的许可证。

flutter doctor --android-licenses #全部算则Y

进行 Flutter doctor 检测环境#

• 按 windows 键+R，打开运行，输入: cmd 回车 输入 flutter doctor

  注意:

  Dart SDK已经在捆绑在Flutter里了，没有必要单独安装Dart。找到flutter存放路径flutter- > bin-> cache- > lockfile删除lockfile文件

C:\Users\Administrator>flutter doctor
Doctor summary (to see all details, run flutter doctor -v):
[√] Flutter (Channel stable, 2.2.3, on Microsoft Windows [Version 10.0.19042.1110],
    locale zh-CN)
[√] Android toolchain - develop for Android devices (Android SDK version 31.0.0)
[√] Chrome - develop for the web
[!] Android Studio (not installed)
[√] VS Code (version 1.59.0)
[√] Connected device (3 available)

! Doctor found issues in 1 category.

Vscode 运行 Flutter#

1. 新建 bat 文件输入：

   C:\Android\AndroidSDK\emulator\emulator.exe -netdelay none -netspeed full -avd Pixel4XLAPI30 Pixel4XLAPI30为Andorid Studio的AVD名称

2. Vscode 安装 Flutter 插件

3. 打开项目运行 Flutter run 即可在模拟器打开

4. 按 F5 实现热更新

设置模拟器#

flutter emulators
flutter emulators --launch <emulator_id>
flutter devices
flutter run

完全卸载Android Studio#

要完全删除 Android Studio，包括所有相关文件和设置，可以按照以下步骤操作：

首先，通过系统的控制面板卸载 Android Studio

Windows：

1. 打开 控制面板。
2. 点击 程序 > 程序和功能。
3. 找到 Android Studio，右键点击并选择 卸载。
4. 按照提示完成卸载过程。

macOS：

1. 打开 Finder。
2. 找到 应用程序 文件夹，找到 Android Studio。
3. 将 Android Studio 拖到 废纸篓。

gradle 报错处理#

Could not locate aapt. Please ensure you have the Android buildtools install

此问题需要安装

Android SDK Build-Tools 35、35.0.0-rc4、30.0.3 三个才可以

查看 android 下的 gradle/wrapper 中的gradle-wrapper.properties

distributionBase=GRADLE_USER_HOME
distributionPath=wrapper/dists
zipStoreBase=GRADLE_USER_HOME
zipStorePath=wrapper/dists
distributionUrl=https\://services.gradle.org/distributions/gradle-7.6.3-all.zip

设置代理#

运行 gradle 时会报错，需要配置代理,路径 android/gradle.properties 配置增加代理

org.gradle.jvmargs=-Xmx4G -XX:MaxMetaspaceSize=2G -XX:+HeapDumpOnOutOfMemoryError
android.useAndroidX=true
android.enableJetifier=true

systemProp.http.proxyHost=127.0.0.1
systemProp.http.proxyPort=7890
systemProp.https.proxyHost=127.0.0.1
systemProp.https.proxyPort=7890

mavenRepositoryUrl=https://maven.aliyun.com/nexus/content/groups/public/

settings.gradle配置代理

  repositories {
        // google()
        // mavenCentral()
        // gradlePluginPortal()
        maven { url 'https://maven.aliyun.com/repository/google' }
        maven { url 'https://maven.aliyun.com/repository/public' }
        maven { url 'https://maven.aliyun.com/nexus/content/groups/public' }
        maven { url 'https://maven.aliyun.com/nexus/content/repositories/jcenter' }
        maven { url 'https://maven.aliyun.com/repository/gradle-plugin' }
    }

build.gradle配置代理

allprojects {
    repositories {
        // google()
        // mavenCentral()
               maven { url 'https://maven.aliyun.com/repository/public' }
        maven { url 'https://maven.aliyun.com/repository/google' }
        maven { url 'https://maven.aliyun.com/nexus/content/repositories/jcenter' }
        maven { url 'https://maven.aliyun.com/repository/gradle-plugin' }
    }
}

清除用户名下的C:\Users\ronhai\.gradle\caches和C:\Users\ronhai\.gradle\wrapper文件夹重新打包

更改gradle包#

更改android下的gradle-wrapper.properties

distributionBase=GRADLE_USER_HOME
distributionPath=wrapper/dists
zipStoreBase=GRADLE_USER_HOME
zipStorePath=wrapper/dists
# distributionUrl=https\://services.gradle.org/distributions/gradle-7.6.3-all.zip
distributionUrl=https\://services.gradle.org/distributions/gradle-8.3-all.zip

gradlew清除缓存#

在android目录下执行以下命令，清除缓存，会重新下载gradle的包

./gradlew clean build --refresh-dependencies

报java版本错误#

官方文档 ：https://docs.flutter.dev/release/breaking-changes/android-java-gradle-migration-guide

出现此错误的原因是 Android Studio Flamingo 将其捆绑的 Java SDK 从 11 更新到 17。Flutter 使用与 Android Studio 捆绑的 Java 版本来构建 Android 应用。使用 Java 17 时， 7.3 之前的Gradle 版本无法运行。

错误类似于Unsupported class file major version 65，这表明您的 Java 版本比您正在运行的 Gradle 版本要新。AGP、Java 和 Gradle 之间存在一组不明显的依赖关系。

flutter运行跟自己电脑装的java版本没有关系，调用的是Android Studio的java来打包，版本是在Android Studio中控制，简单的方式是下载相对应的Android Studio版本，下载地址：https://developer.android.google.cn/studio/archive切换为英文下载

查看运行的版本

flutter doctor -v

android/app/build.gradle#

   defaultConfig {
        // TODO: Specify your own unique Application ID (https://developer.android.com/studio/build/application-id.html).
        applicationId = "com.example.oilie"
        // You can update the following values to match your application needs.
        // For more information, see: https://flutter.dev/to/review-gradle-config.
        minSdk = flutter.minSdkVersion
        targetSdk = flutter.targetSdkVersion
        versionCode = flutter.versionCode
        versionName = flutter.versionName
    }

改为

    defaultConfig {
        // TODO: Specify your own unique Application ID (https://developer.android.com/studio/build/application-id.html).
        applicationId = "com.rh.oilie"
        // You can update the following values to match your application needs.
        // For more information, see: https://flutter.dev/to/review-gradle-config.
        minSdk = flutter.minSdkVersion
        targetSdk = flutter.targetSdkVersion
        versionCode = flutter.versionCode
        versionName = flutter.versionName
    }

因为 Flutter 和较新版本的 Gradle 不再支持在 AndroidManifest.xml 中通过 package 属性设置命名空间，而是需要将命名空间配置移动到 build.gradle 文件中

android {
    namespace = "com.example.oilie"
    compileSdk = flutter.compileSdkVersion
    ndkVersion = flutter.ndkVersion

改为

android {
    namespace = "com.rh.oilie"
    compileSdk = flutter.compileSdkVersion
    ndkVersion = flutter.ndkVersion

设置了不设置 android/app/src/main/AndroidManifest.xml

android/app/src/main/AndroidManifest.xml#

老版本的设置此方式，新版本按以上的 android 设置即可，此方法不设置

<manifest xmlns:android="http://schemas.android.com/apk/res/android">
    <application
        android:label="oilie"
        android:name="${applicationName}"
        android:icon="@mipmap/ic_launcher">

改为

 <manifest xmlns:android="http://schemas.android.com/apk/res/android" package="com.rh.oilie">
    <application
        android:label="oilie"
        android:name="${applicationName}"
        android:icon="@mipmap/ic_launcher">

android/app/src/debug/AndroidManifest.xml#

<manifest xmlns:android="http://schemas.android.com/apk/res/android">
    <uses-permission android:name="android.permission.INTERNET"/>
</manifest>

改为

<manifest xmlns:android="http://schemas.android.com/apk/res/android" package="com.rh.oilie">
    <uses-permission android:name="android.permission.INTERNET"/>
</manifest>

android/app/src/main/kotlin/com/example/oilie/MainActivity.kt#

package com.example.oilie

import io.flutter.embedding.android.FlutterActivity

class MainActivity: FlutterActivity()

改为

package com.rh.oilie

import io.flutter.embedding.android.FlutterActivity

class MainActivity: FlutterActivity()

kotlin/com 下的包名#

改为

重新生成ios和安卓#

更换了flutter的版本需要重新生成目录

# 进入工程目录，删除android目录
rm -rf android
 
# 重新创建java语言的android目录
flutter create -a java .
 
# 重新创建kotlin语言的android目录
flutter create -a kotlin .

# 进入工程目录，删除ios
rm -rf ios 
 
# 重新创建指定swift语言的ios目录
flutter create -i swift .
 
# 重新创建指定objective-c 语言的ios目录
flutter create -i objc .  

flutter pub cache clean#

这个命令用于清理 Flutter 的包缓存。在使用 Flutter 进行开发时，会下载和缓存一些第三方依赖包，这些包会被保存在 Flutter 的包缓存中。flutter pub cache clean 命令可以清除这些缓存，当你需要清理缓存并重新下载依赖包时，可以使用这个命令

flutter clean#

这个命令用于清理 Flutter 项目的构建文件。当你在 Flutter 项目中进行构建时，会生成一些构建文件和输出目录，例如生成的 APK 文件、构建缓存等。flutter clean 命令可以清除这些构建文件，当你需要清理构建文件并重新构建项目时，可以使用这个命令

总结来说，flutter pub cache clean 主要用于清理 Flutter 包缓存，而 flutter clean 主要用于清理项目的构建文件。它们的使用场景和目的不同，根据具体的需求选择使用适当的命令。

使用flutter clean打开pubspec.yaml保存会自动下载依赖，

flutter pub get#

下载依赖