Flutter 环境搭建

MacOS 系统

该文档是基于MacOS系统来记录的一个搭建Android平台运行flutter代码的教程

1. 安装Xcode (如果需要IOS的运行环境)
  • 这个可以直接从App store下载,或者通过命令行安装
bash 复制代码
	xcode-select --install
  • 接受 Xcode 许可协议:
bash 复制代码
sudo xcodebuild -license
2. 安装HomeBrew(这个后续用于安装一下软件或者sdk之类的很好用, 前提要有权限)
bash 复制代码
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
3. 安装Flutter
  • 如果有安装HomeBrew的话,可以通过brew命令安装,方便便捷。
bash 复制代码
brew tap flutter/flutter
brew install flutter
  • 手动下载安装
  1. 访问 Flutter 官网 下载 macOS 版本的 SDK 压缩包。
  2. 解压到指定目录(目录自己定,如 ~/development/flutter)。
  3. 配置环境变量:
bash 复制代码
echo 'export PATH="$PATH: ~/development/flutter/bin"' >> ~/.zshrc  # 或 ~/.bash_profile
source ~/.zshrc

这个Path是环境变量,是flutter解压后的地址。如果配置不正确的话,会导致flutter命令不起作用。

4. 配置平台的开发环境
  • 安装 CocoaPods(用于 iOS 依赖管理):

    bash 复制代码
    sudo gem install cocoapods
  • 安装Android studio(用于Android开发环境),由于我是Android开发,所以我就只搭建Android的开发环境了。

    Android Studio 下载地址

5. 验证flutter环境
复制代码
flutter doctor

如果出现结果:

bash 复制代码
➜  ~ flutter doctor
Doctor summary (to see all details, run flutter doctor -v):
[✓] Flutter (Channel stable, 3.29.2, on macOS 15.3.2 24D81 darwin-arm64, locale en-CN)
[✓] Android toolchain - develop for Android devices (Android SDK version 34.0.0)
[!] Xcode - develop for iOS and macOS (Xcode 16.3)
    ✗ CocoaPods not installed.
        CocoaPods is a package manager for iOS or macOS platform code.
        Without CocoaPods, plugins will not work on iOS or macOS.
        For more info, see https://flutter.dev/to/platform-plugins
      For installation instructions, see
      https://guides.cocoapods.org/using/getting-started.html#installation
[✓] Chrome - develop for the web
[✓] Android Studio (version 2024.3)
[✓] VS Code (version 1.99.0)
[✓] Connected device (3 available)
[✓] Network resources

! Doctor found issues in 1 category.

✓\] 表示已经好了, ✗ 表示不行,如果是IOS开发,想要在电脑上运行IOS平台,则必须保证IOS的相关配置都好了。 如果是Android开发,就得保证Androd的所有配置都好了。上面这个输出结果则说明你的Android平台的环境是没有问题的。 但如果出现结果输出结果是: ```bash ➜ ~ flutter doctor Doctor summary (to see all details, run flutter doctor -v): [✓] Flutter (Channel stable, 3.29.2, on macOS 15.3.2 24D81 darwin-arm64, locale en-CN) [!] Android toolchain - develop for Android devices (Android SDK version 34.0.0) ✗ cmdline-tools component is missing Run `path/to/sdkmanager --install "cmdline-tools;latest"` See https://developer.android.com/studio/command-line for more details. ✗ Android license status unknown. Run `flutter doctor --android-licenses` to accept the SDK licenses. See https://flutter.dev/to/macos-android-setup for more details. [!] Xcode - develop for iOS and macOS (Xcode 16.3) ✗ CocoaPods not installed. CocoaPods is a package manager for iOS or macOS platform code. Without CocoaPods, plugins will not work on iOS or macOS. For more info, see https://flutter.dev/to/platform-plugins For installation instructions, see https://guides.cocoapods.org/using/getting-started.html#installation [✓] Chrome - develop for the web [✓] Android Studio (version 2024.3) [✓] VS Code (version 1.99.0) [✓] Connected device (3 available) [✓] Network resources ``` 则2个环境都有问题。下面是关于如何解决Android 环境的问题。 * 解决**cmdline-tools component is missing**问题 * 打开Android Stuido -\> tool -\> SDK manager ![image-20250421170312488.png](https://oss.xyyzone.com/jishuzhan/article/1914251420485877761/180f5daae75f2fd2ea51bd18d3a4c7c8.webp) ![image-20250421143723128.png](https://oss.xyyzone.com/jishuzhan/article/1914251420485877761/daadb36fb4e2e11faf0b0e6a152b7ab0.webp) 下载安装之后再命令执行 ```bash flutter doctor --android-licenses ``` 执行之后会有一些条款需要同意并输入:y。如: ```bash Accept? (y/N): ``` 你就一直输入y就好了,直到出现。 ```bash All SDK package licenses accepted. ``` * 再次执行 flutter doctor 理论上会出现最开始的那个结果。 至此Android 平台运行flutter的开发环境就没什么问题 。 ##### 6. Android Studio 插件 * 必备插件: * Flutter : 官方插件 * Dart:官方插件 * 可选插件 * GetX: 如果用getx作为状态管理框架的话,推荐安装,省去了创建基础类的麻烦。 安装完以上几个插件,基本的开发就没什么问题了。 ##### 7. 常见问题 * 运行Flutter docutor的时候,未找到flutter命令 说明flutter的环境变量没有配置好,重新检查一下flutter环境变量的路径是否配置好了。最好是通过brew的方式安装fluter,这样命令会自动配置环境变量。 * 第一次创建Flutter项目的时候,可能会出现运行特别慢的问题。 这是因为第一次运行需要下载一些平台的依赖,不确定IOS是怎么样,反正Androd平台需要下载很多的依赖,如果网络不好的话,光gradle就得下载好久。 如果是Android平台,则可以通过打开新项目的方式去打开Flutter目录下android这个平台,然后点击sync的方式去加载。

相关推荐
Mr YiRan43 分钟前
Android Gradle多渠道打包
android
BG2 小时前
使用ffmpeg-kit 自己构建ffmpeg,并在flutter本地引用记录
flutter
程一个大前端2 小时前
【Flutter进阶】分模块开发与独立启动
flutter
IvanCodes2 小时前
MySQL 视图
android·数据库·sql·mysql·oracle
KevinWang_2 小时前
Java 和 Kotlin 混编导致的 bug
android·kotlin
好学人2 小时前
Android动画系统全面解析
android
leverge20092 小时前
android studio 运行java main报错
android·ide·android studio
思想觉悟2 小时前
ubuntu编译android12源码
android·ubuntu·源码
好学人3 小时前
Android自定义控件事件传递机制
android