[Flutter 基础] - Flutter 环境搭建

搬砖的理查德
225 阅读3分钟

MacOS 系统

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

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

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

4. 配置平台的开发环境

  • 安装 CocoaPods（用于 iOS 依赖管理）：

    sudo gem install cocoapods

  • 安装Android studio(用于Android开发环境)，由于我是Android开发，所以我就只搭建Android的开发环境了。

    Android Studio 下载地址

5. 验证flutter环境
flutter doctor

如果出现结果：

➜  ~ 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平台的环境是没有问题的。

但如果出现结果输出结果是：

➜  ~ 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

image-20250421143723128.png

下载安装之后再命令执行

flutter doctor --android-licenses

执行之后会有一些条款需要同意并输入：y。如：

Accept? (y/N):

你就一直输入y就好了，直到出现。

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

avatar
文章
阅读
粉丝