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的方式去加载。

相关推荐
阿斌_bingyu70921 分钟前
uniapp实现android/IOS消息推送
android·ios·uni-app
Android系统攻城狮32 分钟前
Android内核进阶之周期更新PCM状态snd_pcm_period_elapsed:用法实例(九十二)
android·pcm·android内核·音频进阶
达达尼昂39 分钟前
🎯 Flutter 拖拽选择组件:flutter_drag_selector —— 像选文件一样选择列表项
前端·flutter
Cola可洛1 小时前
修复Flyme移植BUG
android·bug
消失的旧时光-19431 小时前
Kotlinx.serialization 使用指南
android·kotlin·json
消失的旧时光-19433 小时前
Kotlinx.serialization 项目集成
android·kotlin·json
QuantumLeap丶3 小时前
《Flutter全栈开发实战指南:从零到高级》- 15 -本地数据存储
flutter·ios·dart
梦里不知身是客113 小时前
datax如何做增量导入
android
我是好小孩4 小时前
【Android】RecyclerView的高度问题、VH复用概念、多子项的实现;
android·java·网络
4Forsee4 小时前
【Android】模板化解决复杂场景的滑动冲突问题
android·java·rpc