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

下载安装之后再命令执行

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

相关推荐
booboosui2 小时前
编号没变,消息还是来了:Mac 端通知读取漏第二条的原因
android
雨白18 小时前
单例设计模式:从 Java/Kotlin 实现到 Android 实战
android
hai_android1 天前
一行 asLiveData,背后是一座生命周期的桥
android·java·kotlin
阿杰m1 天前
Android源码第二十三章:Telephony、RIL 与 IMS——来电怎么到应用?
android
booboosui1 天前
没人认领 .md:安卓把报告交给了音乐播放器打开
android
用户60709759149061 天前
AOSP 14 OTA 升级指导(四):update_engine 内部机制——Action 流水线与写盘
android
恋猫de小郭1 天前
Jetpack Compose 1.13 发布,憋了这么久终有交代了
android·前端·flutter
JMchen1231 天前
【Android 性能优化实战 60 讲】12 异步 Inflate 实战与痛击:源码拆解原生瓶颈,手写增强版布局预加载框架
android·性能优化·实战·启动优化·异步inflate·x2c
好的佩奇2 天前
蓝牙之设备角色与连接
android·flutter·蓝牙
雨白2 天前
Android 消息机制剖析:从 Handler 投递到 Looper 循环的全链路
android