Mac下flutter环境配置以及遇到的问题

本文详细介绍了在MacOS系统上搭建Flutter开发环境的步骤,包括解决git clone报错、配置环境变量、安装AndroidStudio、设置Android SDK路径、安装Xcode及依赖组件、配置CocoaPods等,确保开发环境顺利搭建。

摘要生成于 C知道 ,由 DeepSeek-R1 满血版支持, 前往体验 >

参考

1.在macOS上搭建Flutter开发环境

2.Mac 打开、编辑 .bash_profile 文件

3.Mac系统安装AndroidStudio

1.打开终端

2.clone flutter

命令:

git clone -b beta https://github.com/flutter/flutter.git

到此步终端报错:

error: RPC failed; curl 18 transfer closed with outstanding read data remaining

fatal: The remote end hung up unexpectedly

fatal: early EOF

fatal: index-pack failed

解决办法看这一篇: git clone 报错:error: RPC failed; curl 18 transfer closed with outstanding read data remaining 解决办法

3.打开(或创建) .bash_profile

1.打开

终端输入:

open -e .bash_profile

如果不能成功打开,那就创建

2.创建

1.进入当前用户的home目录(默认就是)

cd ~

cd /Users/用户名

4.更新环境变量

打开bash_profile就是为了可以永久的更新环境变量,一劳永逸。请看解释和注意后根据自己的需要来将代码添加到打开的bash_profile。

export PUB_HOSTED_URL=https://pub.flutter-io.cn
export FLUTTER_STORAGE_BASE_URL=https://storage.flutter-io.cn

解释:由于一些flutter命令需要联网获取数据,如果您是在国内访问,由于众所周知的原因,直接访问很可能不会成功。 上面的PUB_HOSTED_URLFLUTTER_STORAGE_BASE_URL是google为国内开发者搭建的临时镜像。你也可以不设置,如果你能翻墙的话。如果不能的话可以直接复制上面的代码

export PATH= PATH_TO_FLUTTER_GIT_DIRECTORY/flutter/bin:$PATH

注意PATH_TO_FLUTTER_GIT_DIRECTORY为你flutter的路径,比如在当前用户路径里。如果不确定,可以点击mac上面菜单的"前往" --> "个人",然后在此文件夹里找是否有flutter文件夹。如果有的话你的应该这样写:

export PATH= /Users/用户名/flutter/bin:$PATH

然后输入以下命令更新刚刚配置的环境变量:

source .bash_profile

然后输入以下命令,通过运行flutter/bin命令验证目录是否在已经在PATH中:

echo $PATH

如果看到有flutter那就是配置好了

5.运行 flutter doctor

输入下面这个命令,来看还有没有要安装的依赖项:

export PATH="$PWD/flutter/bin:$PATH"
cd ./flutter
flutter doctor

我的话一开始是这个

提示flutter版本太低

让我更新flutter,我不想看到warning所以立马更新了。

flutter upgrade

错误1:

然后就看x了,这是我第一个打叉的地方

[✗] Android toolchain - develop for Android devices
    ✗ Unable to locate Android SDK.
      Install Android Studio from: https://developer.android.com/studio/index.html
      On first launch it will assist you in installing the Android SDK components.
      (or visit https://flutter.io/setup/#android-setup for detailed instructions).
      If Android SDK has been installed to a custom location, set $ANDROID_HOME to that location.

这是让我安装android studio并且设置好$ANDROID_HOME这个环境变量。

于是我便按照提示打开https://developer.android.com/studio/index.html,并且下载安装了android studio。

安装后最好运行一下android studio,好安装andriod sdk。运行好根据界面提示点下一步,如果没有sdk会提示安装,只要点就行了。记得查看下安装路径,一般路径都是在当前用户的Library文件夹里。

安装好sdk后,可以把android studio关了。

然后打开bash_profile

open -e .bash_profile

在bash_profile里加上

export ANDROID_HOME="/Users/用户名/Library/Android/sdk" //android sdk目录,替换为你自己的
export PATH=${PATH}:${ANDROID_HOME}/tools
export PATH=${PATH}:${ANDROID_HOME}/platform-tools

更新配置

source .bash_profile

然后运行

flutter doctor

看这一项还报错不。ok还是有报错,报错如下:

[!] Android toolchain - develop for Android devices (Android SDK 28.0.2)
    ✗ Android licenses not accepted.  To resolve this, run: flutter doctor --android-licenses

根据提示运行:

flutter doctor --android-licenses

然后根据提示一直y,y到结束为止。

错误2:

这是我第二个打叉的地方

[!] iOS toolchain - develop for iOS devices
    ✗ Xcode installation is incomplete; a full installation is necessary for iOS development.
      Download at: https://developer.apple.com/xcode/download/
      Or install Xcode via the App Store.
      Once installed, run:
        sudo xcode-select --switch /Applications/Xcode.app/Contents/Developer
    ✗ libimobiledevice and ideviceinstaller are not installed. To install, run:
        brew install --HEAD libimobiledevice
        brew install ideviceinstaller
    ✗ ios-deploy not installed. To install:
        brew install ios-deploy
    ✗ CocoaPods not installed.
        CocoaPods is used to retrieve the iOS platform side's plugin code that responds to your plugin usage on the Dart side.
        Without resolving iOS dependencies with CocoaPods, plugins will not work on iOS.
        For more info, see https://flutter.io/platform-plugins
      To install:
        brew install cocoapods
        pod setup

依旧是根据提示,我去App Store安装了xcode。

安装好后根据之前的错误信息运行:

sudo xcode-select --switch /Applications/Xcode.app/Contents/Developer

然后:

brew install --HEAD libimobiledevice

再然后:

brew install ideviceinstaller

又然后:

brew install ios-deploy

还然后:

brew install cocoapods

最后然后:

pod setup

进行到这我报错了:

[!] /usr/bin/git clone https://github.com/CocoaPods/Specs.git master --progress

Cloning into 'master'...
remote: Counting objects: 2353094, done.        
remote: Compressing objects: 100% (450/450), done.        
error: RPC failed; curl 18 transfer closed with outstanding read data remaining
fatal: The remote end hung up unexpectedly
fatal: early EOF
fatal: index-pack failed

弄个加速器就可以了。我用的云墙netfits,有试用,试用够下载了。如果有更好的加速器欢迎留言。

再运行doctor

flutter doctor

ios还有报错:

[!] iOS toolchain - develop for iOS devices (Xcode 9.4.1)
    ✗ Missing Xcode dependency: Python module "six".
      Install via 'pip install six' or 'sudo easy_install six'.

按照提示输入'pip install six' 或 'sudo easy_install six'。然后再运行doctor,我这里ios没有报错了。就剩错误3里的报错。

错误3:

[✓] Android Studio (version 3.1)
    ✗ Flutter plugin not installed; this adds Flutter specific functionality.
    ✗ Dart plugin not installed; this adds Dart specific functionality.

android studio里还少了两个插件。我们打开andriod studio。

1.点击preferences

 

2.搜索plugins

3.搜索flutter

4.点击安装

有弹框提示要安装dart,同意。等安装好后重启andriod studio。

原文链接



 

### 在 Mac 操作系统上配置 Flutter 开发环境 要在 Mac 操作系统上配置 Flutter 开发环境,需要满足一定的系统要求并完成一系列的安装和配置步骤。以下是详细的说明: #### 1. 系统要求 - **操作系统**: macOS (64-bit) 或更高版本[^1]。 - **磁盘空间**: 至少需要 2.8 GB 的可用磁盘空间(不包括 IDE 和其他工具的磁盘空间)[^2]。 - **命令行工具**: 需要确保以下命令行工具已正确安装:`.bash`, `mkdir`, `rm`, `git`, `curl`, `unzip`, `which`[^1]。 #### 2. 安装 Xcode Xcode 是苹果官方提供的集成开发环境,Flutter 的开发依赖于 Xcode 提供的工具链。可以通过 Mac App Store 安装 Xcode[^2]。安装完成后,还需要通过命令行安装 Xcode 命令行工具: ```bash xcode-select --install ``` #### 3. 安装 Git Git 是用于管理 Flutter SDK 的版本控制系统。如果 Xcode 已经安装,通常 Git 也会随之安装。可以通过以下命令验证 Git 是否已安装: ```bash git --version ``` 如果没有安装,可以从 [Git 官方网站](https://git-scm.com/) 下载并安装,或者使用 Homebrew 安装: ```bash brew install git ``` #### 4. 获取 Flutter SDK 通过 Git 克隆 Flutter SDK 到本地: ```bash git clone https://github.com/flutter/flutter.git -b stable ``` 将克隆后的路径添加到系统的环境变量中。假设 Flutter 被克隆到 `/Users/YourMacUserName/flutter`,可以编辑 `.bash_profile` 文件以添加环境变量: ```bash echo 'export PATH="$PATH:/Users/YourMacUserName/flutter/bin"' >> ~/.bash_profile source ~/.bash_profile ``` #### 5. 配置环境变量 在 Mac 上配置环境变量时,通常需要编辑 `.bash_profile` 文件。如果该文件不存在,可以手动创建: ```bash touch ~/.bash_profile open -e ~/.bash_profile ``` 在文件中添加以下内容: ```bash export PATH="$PATH:/Users/YourMacUserName/flutter/bin" ``` 保存文件后,重新加载 `.bash_profile`: ```bash source ~/.bash_profile ``` #### 6. 安装依赖项 运行以下命令以检查并安装 Flutter 所需的依赖项: ```bash flutter doctor ``` 根据输出结果,安装任何缺失的依赖项。例如,可能需要安装 Android Studio、Android SDK 或 iOS 开发工具。 #### 7. 处理 Apple 芯片兼容性问题 如果使用的是搭载 Apple M1 芯片的 Mac,可能会遇到某些 Flutter 组件或依赖项不兼容的问题。在这种情况下,可以安装并启用 Rosetta 2 来解决兼容性问题[^3]。通过以下命令安装 Rosetta 2: ```bash /softwareupdate --install-rosetta --agree-to-license ``` #### 8. 测试 Flutter 安装 完成所有配置后,可以通过以下命令测试 Flutter 是否正常工作: ```bash flutter --version ``` 还可以运行以下命令来验证开发环境是否完全准备好: ```bash flutter doctor -v ``` ### 示例代码 以下是一个简单的 Dart 代码示例,用于验证 Flutter 是否正常工作: ```dart import 'package:flutter/material.dart'; void main() { runApp(MyApp()); } class MyApp extends StatelessWidget { @override Widget build(BuildContext context) { return MaterialApp( home: Scaffold( appBar: AppBar(title: Text('Hello Flutter')), body: Center(child: Text('Hello, World!')), ), ); } } ```
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值