Mac电脑Android Studio和VS Code配置Flutter开发环境（图文超详细）

一、安装Android Studio

官网地址：

https://developer.android.google.cn/

历史版本下载地址：

https://developer.android.com/studio/archive?hl=zh-cn

二、安装Xcode

到App Store下载安装最新版本，如果MacOS更新不到13.0以上就无法安装最新的Xcode，只能去下载以前版本的Xcode。

历史版本下载地址：

https://developer.apple.com/download/all/?q=Xcode

三、安装VS Code

VS Code官网地址：

https://code.visualstudio.com

四、安装Flutter SKD

官网地址：

https://docs.flutter.dev/get-started/install/macos

注意：苹果芯片需要安装rosetta翻译环境
Flutter用于git安装和升级。我们建议安装Xcode，其中包含git，但您也可以单独安装git。

$ sudo softwareupdate --install-rosetta --agree-to-license

1.下载Flutter SDK包

下载解压后，将目录放到/Library/Developer/flutter。

2.打开终端配置环境变量

配置前，先打开 系统偏好设置->安全性与隐私  进入页面等着。因为从不受信任的源下载的SDK，安装时需要用户手动点同意。

1).执行命令 $ vim ~/.bash_profile

2).输入i （进入可编辑状态）

3).复制下面的代码粘入

export PATH=/Library/Developer/flutter/bin:$PATH  
export PUB_HOSTED_URL=https://pub.flutter-io.cn
export FLUTTER_STORAGE_BASE_URL=https://storage.flutter-io.cn

4).按esc输入:wq退出

其它指令：
q 表示退出；
w 表示保存退出；
q! 表示强制退出。

5).执行命令 $ source ~/.bash_profile

6).执行命令 $ flutter -h

安装成功，提示Manage your Flutter app development。

7).执行命令 $ flutter doctor

查看是否需要安装任何依赖项才能完成设置

比如我安装时，有如下提示。

8).按照提示完善环境

报错：
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 Studio进入Preferences，安装Android SDK Command-line Tools (latest)。

报错：
✗ Android license status unknown.      Run `flutter doctor --android-licenses` to accept the SDK licenses.      See https://flutter.dev/docs/get-started/install/macos#android-setup for      more details.
解决：
执行命令 $ flutter doctor --android-licenses
需要去同意Android的一些许可

报错：
CocoaPods not installed.
解决：
安装CocoaPods，内容有点多，提出来放到了下一节。

五、安装CocoaPods

1.了解brew、rvm、ruby、gem、cocaspods之间的关系是什么样的

在 macOS 环境中，Brew、RVM、Ruby、Gem 和 CocoaPods 之间存在以下关系：

Homebrew (Brew)：Homebrew 是 macOS 上的包管理器，用于安装和管理各种开源软件包。它使您能够轻松地从命令行安装、更新和卸载软件包，包括开发工具、库和其他应用程序。

RVM (Ruby Version Manager)：RVM 是一个用于管理和安装多个 Ruby 版本的工具。它允许您在同一台计算机上同时安装和切换不同版本的 Ruby。RVM 还提供了一个独立的环境，以隔离不同版本的 Ruby 和它们的依赖项。

Ruby：Ruby 是一种动态、面向对象的编程语言，经常用于 Web 开发和脚本编写。它由日本开发者松本行弘（Yukihiro Matsumoto）创建，并且具有简洁、优雅的语法。RVM 用于安装和管理不同版本的 Ruby。

Gem：Gem 是 Ruby 的软件包管理系统。它用于安装、管理和分发 Ruby 应用程序和库。Gem 包含可重用的代码库，让开发人员能够轻松地共享和使用 Ruby 的扩展功能。通过 Gem，您可以安装和管理与 Ruby 相关的软件包和依赖项。

CocoaPods：CocoaPods 是一个用于管理 iOS 和 macOS 项目中的第三方库依赖项的工具。它使用 Ruby 编写，并且依赖于 Gem 来安装和管理自己的软件包。CocoaPods 允许您在 Xcode 项目中轻松地集成和更新各种开源库。

综上所述，Brew 是用于管理 macOS 上的软件包的包管理器，RVM 是用于管理和安装多个 Ruby 版本的工具，Ruby 是编程语言本身，Gem 是 Ruby 的软件包管理系统，而 CocoaPods 是用于管理 iOS 和 macOS 项目中的第三方库依赖项的工具，它使用 Gem 来安装和管理自己的软件包。Brew、RVM、Ruby、Gem 和 CocoaPods 提供了一套工具链，使您能够更方便地安装、管理和使用 Ruby 和相关的软件包和依赖项。

2.检查并安装brew

验证 Homebrew 是否安装

$ brew doctor

执行以下指令，下载 Homebrew 的安装脚本并自动执行安装过程。

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

3.检查并安装rvm

检查rvm是否安装

$ rvm -v

检查提示rvm: command not found时，就表示rvm需要安装。

先用下面命令安装

$ curl -L https://get.rvm.io | bash -s stable

上一步执行完成后再执行

$ source ~/.rvm/scripts/rvm

再次查询rvm的安装情况

$ rvm -v

4.检查并安装ruby

先检查ruby的信息，安装cocaPods，ruby环境不得低于2.2.2，否则会报错。

$ ruby -v

最好更新到新版本，可以去官网查询ruby最新版本https://www.ruby-lang.org/zh_cn/downloads/

安装最新稳定版本ruby

$ rvm install 3.2.2

然后输入指令查看是否安装成功

$ rvm list

5.检查并更新gem ruby

检查gem ruby版本，需要输入一次密码。

$ sudo gem -v

更新gem ruby

最新版本，可以去网站查询一下https://rubygems.org/pages/download

$ gem update --system

6.检查并更新ruby源

检查ruby源

$ gem sources -l

如果展示https://rubygems.org/，则移除此ruby源。

$ gem sources --add https://gems.ruby-china.com/

7.安装CocoaPods 

cocoapods官网地址:

https://cocoapods.org/

安装cocoapods指令，sudo表示管理员指令，需要输入密码。

$ sudo gem install -n /usr/local/bin cocoapods

或者

$ sudo gem install -n /usr/local/bin cocoapods  --pre

安装后，检查安装情况。

$ pod --version

8.CocoaPods使用

先创建一个iOS测试工程GaminTestDemo

然后打开终端，cd到项目。

$ cd /Users/gamin/Desktop/GaminTestDemo

然后再初始化pod，执行成功后，目录中会多出一个Podfile文件。

$ pod init

打开Podfile文件，添加依赖库AFNetworking。

最后，在终端执行指令安装依赖库。

$ pod install

安装成功后，项目目录中会多出Pods、xxx.xcworkspace、Podfile.lock。之后打开项目，需要用.xcworkspace文件去打开。

9.重新检查flutter环境

$ flutter doctor

提示CocoaPods安装了但不起作用

这是Ruby的版本和CocoaPods的版本不对应产生的问题

终端执行命令查看，果然当前使用了旧版本的ruby。

$ source ~/.rvm/scripts/rvm

$ rvm list

切换ruby版本

$ rvm use ruby-3.2.2

移除Ruby版本

$ rvm uninstall ruby-2.6.6

移除旧版本我这里会报错，就不移除了，因为切换ruby后上面的问题就修复了。

六、创建Flutter工程

1.用VS Code创建

1).安装Dart、Flutter和Code Runner插件

2).创建Flutter工程

Command+Shift+P打开全局搜索，搜索flutter，选择Flutter:New Project回车。

选择Application回车

选择将项目放在什么位置

输入项目名称创建项目，注意规范了项目名称只能输入小写字母和下划线。

2.用Android Studio创建

1).安装Flutter、Dart插件

2).创建Flutter工程

打开Android Studio，选择Flutter语言，确认Flutter SDK 路径后进行下一步。

项目名称规范未小写字母加下划线，这一步比用VS Code创建Flutter应用多了一些配置项。

七、运行Flutter项目

运行Flutter项目，在Android Studio和VS Code没什么区别，下面用VS Code的面板简单介绍一下。

1.运行到macOS

面板右上角，Run -> Start Debugging，直接运行到macOS。

2.运行到Chrome

3.运行到iOS模拟器

终端输入指令打开模拟器，或者在设备管理列表选择启动，当然手动打开模拟器APP都行。

$ open -a Simulator

cd到flutter项目根目录，使用flutter run命令运行项目。也可以Run -> Start Debugging运行项目。

$ flutter run

4.运行到Android模拟器

查看设备列表，其中Nexus和Pixel就是Studio中安装的模拟器。刚打开VS Code时，这两个模拟器状态都是“Offline”，选择后模拟器就开始启动。模拟器状态会变成“Availabel”，就可以直接在设备上运行了。

5.运行到夜神模拟器

1).安装夜神模拟器for mac

应用程序中，右键夜神模拟器，显示包内容。找到Contents中的MacOS目录，然后终端cd到目录，执行如下命令连接模拟器。

$ adb connect 127.0.0.1:62001

发现会提示-bash: adb: command not found，那是因为我们还没有配置过Android环境变量。

2).配置Android环境变量

I.打开终端执行如下命令，创建.bash_profile文件，若已经创建过，则无不会再次创建。

$ touch .bash_profile

II.打开文件进行编辑

$ open -e .bash_profile

将下面的内容粘贴到.bash_profile文件的后面

export ANDROID_HOME=自己sdk路径从Android Studio获取
export PATH=${PATH}:${ANDROID_HOME}/tools
export PATH=${PATH}:${ANDROID_HOME}/platform-tools

III.终端输入如下命令更新

$ source .bash_profile

IV.重新cd /Applications/NoxAppPlayer.app/Contents/MacOS验证adb是否配置完成

V.电脑重启或者退出终端后，可能会再次出现adb: command not found，重新执行$ source .bash_profile命令，adb又能使用。

$ source .bash_profile

3).运行效果

Android环境变量配置完成后，重启夜神模拟器，我们能在设备列表中看到它。选择模拟器，运行效果如下。

6.运行到Android真机

手机打开USB调试连接计算机

• 打开“设置”找到“关于手机”进入，连续点击版本号，直到提示“您已经进入开发者模式”。

• 回到“设置”找到“系统与更新”进入，再进入“开发者选项”，打开USB调试。

• 用数据线连接手机和电脑，在弹出框中选择“文件传输”，再允许这台计算机进行调试。

然后在VS Code设备管理中选择对应手机直接运行就可以了。

注意：不同厂商流程会有区别，介绍这个流程打不开时，可以去网上查询一下。强调一下，不要使用三无数据线，这样是不会再手机上弹窗的。

7.运行到iPhone真机

1).手机打开开发者模式

• 进入 设置 -> 通用 -> 关于本机 页面，连续点击版本号。会弹窗，要求输入锁屏密码。

• 上面完成验证后，设置中会出现开发者选项。

• 进入开发者选项，开启开发者模式。

如果您的 iPhone 版本号无法多次点击以启用开发者模式，这可能是因为您的 iPhone 型号或 iOS 版本不支持通过多次点击版本号来激活开发者选项。在某些情况下，特定的 iPhone 型号可能需要使用不同的方法来启用开发者模式。以下是一些备选方法：

使用搜索功能：在设置应用程序中使用搜索功能来查找开发者选项。在主屏幕上向下滑动以展开搜索栏，然后输入 "开发者选项" 或类似的关键词进行搜索。这可能会直接显示开发者选项菜单或相关设置。

使用配置文件：有时，您可以通过安装特定的配置文件来启用开发者模式。这些配置文件可以通过开发者网站或第三方开发者工具提供。在安装配置文件后，您可以在设置中找到开发者选项。

使用 Xcode：如果您具有 Mac 计算机和 Xcode 开发环境，您可以通过连接 iPhone 到 Mac，并在 Xcode 中进行相应设置来启用开发者模式。在 Xcode 中，选择您的 iPhone 设备，然后在设置中进行所需的配置。

2).此时直接运行会报错

数据线连接iPhone手机，VS Code设备管理中会出现iPhone设备，现在直接运行项目到iPhone会报错，因为当前使用的包名“com.example.flutterDemo”还没配置。

3).到开发者网站注册App ID（Bundle ID/包名）

到苹果开发者网站，登录开发者账号。然后进入“标识符（identifiers）”页面，点击添加，注册一个包名（Bundle ID）。 上一步提示的“com.example.flutterDemo”包名已经被其他开发者占用了，这里我就随便创建一个“com.example.gaminFlutterDemo”，用来演示。

没有开开发者账号，就需要去申请，注册个人类型开发者账号，注册公司类型开发者账号。

注意：包名创建后是可以删除的，但有一个前提，就是不能手贱提前将IPA上传到appstoreconnect。

比如，为其它公司开发APP时，若对方开发者账号迟迟不下来，而很多功能又是基于包名，那么可以先将包名注册在自己公司的开发者账号上，不至于卡住开发和测试。等对方的开发账号下来，我们再将包名删掉，重新添加到对方的账号上面去，就可以顺利完成过度。如果，用某个Bundle ID将IPA上传到了appstoreconnect，那么这个Bundle ID就无法从这个账号上删除了。

确定包名后，我们在项目中全局将com.example.flutterDemo替换为com.example.gaminFlutterDemo。这里不修改也没事，这里不改的话就下一步去Xcode中修改，都一样。

开发者网站，还可处理一些其他配置。比如添加测试手机、配置签名等，这里就不详细说在网站上如何操作了，推荐到时打开Xcode时自动注册设备和自动管理签名。

4).使用Xcode打开Flutter工程iOS目录下的Runner.xcworkspace文件

打开项目后，按步骤进入Signing，我们会发现红色的报错。

解决上面的问题，我们先要进入Xcode -> Preferences -> Accounts 添加开发者账号。

然后回到Siging，先将“Automatically manage signing”开关打开，然后将Team对应的开发者账号切换为和com.example.gaminFlutterDemo对应的账号。这样，问题就解决了，可以运行项目了。

新iPhone第一次做真机调试，最好先在Xcode运行一次，以便设备信任和自动注册设备到开发者账号上。不然的话，就去开发者网站的devices目录，添加设备ID。

先在Xcode选择真机，然后点击运行，真机运行效果如下。

5).真机运行效果

关闭Xcode，我们回到VS Code。iPhone用数据线连接Mac后，我们在VS Code选择iPhone直接运行。

运行时，会有个关于“iproxy”的弹窗，会导致运行卡主。我们需要进入 系统偏好设置 -> 安全性与隐私 选择允许。