入门: 在macOS上搭建Flutter开发环境
更新环境变量
编辑器设置
平台设置
使用镜像
由于在国内访问Flutter有时可能会受到限制,Flutter官方为中国开发者搭建了临时镜像,大家可以将如下环境变量加入到用户环境变量中:
export PUB_HOSTED_URL=https://pub.flutter-io.cn
export FLUTTER_STORAGE_BASE_URL=https://storage.flutter-io.cn
注意: 此镜像为临时镜像,并不能保证一直可用,读者可以参考详情请参考 Using Flutter in China 以获得有关镜像服务器的最新动态。
系统要求
要安装并运行Flutter,您的开发环境必须满足以下最低要求:
操作系统: macOS (64-bit)
磁盘空间: 700 MB (不包括Xcode或Android Studio的磁盘空间).
工具: Flutter 依赖下面这些命令行工具.
bash, mkdir, rm, git, curl, unzip, which
获取Flutter SDK
去flutter官网下载其最新可用的安装包,转到下载页 。
注意,Flutter的渠道版本会不停变动,请以Flutter官网为准。另外,在中国大陆地区,要想正常获取安装包列表或下载安装包,可能需要翻墙,读者也可以去Flutter github项目下去下载安装包,转到下载页 。
解压安装包到你想安装的目录,如:
cd ~/development
unzip ~/Downloads/flutter_macos_v0.5.1-beta.zip
添加flutter相关工具到path中:
export PATH=pwd
/flutter/bin:$PATH
此代码只能暂时针对当前命令行窗口设置PATH环境变量,要想永久将Flutter添加到PATH中请参考下面更新环境变量 部分。
注意: 由于一些flutter命令需要联网获取数据,如果您是在国内访问,由于众所周知的原因,直接访问很可能不会成功。 上面的PUB_HOSTED_URL和FLUTTER_STORAGE_BASE_URL是google为国内开发者搭建的临时镜像。详情请参考 Using Flutter in China
要更新现有版本的Flutter,请参阅升级Flutter。
运行 flutter doctor

例如:
[-] Android toolchain - develop for Android devices
• Android SDK at /Users/obiwan/Library/Android/sdk
✗ Android SDK is missing command line tools; download from https://goo.gl/XxQghQ
• Try re-installing or updating your Android SDK,
visit https://flutter.io/setup/#android-setup for detailed instructions.
一般的错误会是xcode或Android Studio版本太低、或者没有ANDROID_HOME环境变量等,请按照提示解决。下面贴一个笔者本机(mac)的环境变量配置,您可以对比修正:
export PATH=/Users/用户名/Documents/flutter/flutter/bin:
P
A
T
H
e
x
p
o
r
t
A
N
D
R
O
I
D
H
O
M
E
=
"
/
U
s
e
r
s
/
用
户
名
/
D
o
c
u
m
e
n
t
s
/
a
n
d
r
o
i
d
s
d
k
"
/
/
a
n
d
r
o
i
d
s
d
k
目
录
,
替
换
为
你
自
己
的
即
可
e
x
p
o
r
t
P
A
T
H
=
PATH export ANDROID_HOME="/Users/用户名/Documents/android_sdk" //android sdk目录,替换为你自己的即可 export PATH=
PATHexportANDROIDHOME="/Users/用户名/Documents/androidsdk"//androidsdk目录,替换为你自己的即可exportPATH={PATH}:
A
N
D
R
O
I
D
H
O
M
E
/
t
o
o
l
s
e
x
p
o
r
t
P
A
T
H
=
{ANDROID_HOME}/tools export PATH=
ANDROIDHOME/toolsexportPATH={PATH}😒{ANDROID_HOME}/platform-tools
export PUB_HOSTED_URL=https://pub.flutter-io.cn
export FLUTTER_STORAGE_BASE_URL=https://storage.flutter-io.cn
第一次运行一个flutter命令(如flutter doctor)时,它会下载它自己的依赖项并自行编译。以后再运行就会快得多。
以下各部分介绍如何执行这些任务并完成设置过程。你会看到在flutter doctor输出中, 如果你选择使用IDE,我们提供了,IntelliJ IDEA,Android Studio和VS Code的插件, 请参阅编辑器设置 以了解安装Flutter和Dart插件的步骤。
一旦你安装了任何缺失的依赖,再次运行flutter doctor命令来验证你是否已经正确地设置了。
flutter doctor 后遇到的问题
- 没有安装AndroidStudio,话不多说,直接从提示中复制地址下载安装就好
- 一直提示XCode没有安装完成,假设你没有安装,就安装一下,如果安装了还提示,按照我下面的方法
一般安装了android studio之后需要启动一下该sdk,然后安装一下模拟器之类的就不会有问题了,但安装了xcode 依然出现:Xcode installation is incomplete; a full installation is necessary for iOS development.
针对非iOS专业的同学,可能就有点懵逼了,没关系,本人亲测执行以下几条命令后不在出问题
brew update
brew install --HEAD usbmuxd
brew link usbmuxd
brew install --HEAD libimobiledevice
brew install ideviceinstaller
brew install ios-deploy
brew install cocoapods
执行完上面的问题后这个要看下面具体的提示,
如红框内的命令,可以执行一下,之后就可以了
最后装上这两个插件(注意:可能第一次打开androidstudio不显示插件,不要慌,关闭重新打开,搜索就行了)
见到如下界面,基本就大功告成啦!!
更新环境变量
您在命令行只能更新当前会话的PATH变量,如Clone Flutter repo所示。 但是,您可能需要的是永久更新此变量,以便您可以运行flutter命令在任何终端会话中。
对于所有终端会话永久修改此变量的步骤是和特定计算机系统相关的。通常,您会在打开新窗口时将设置环境变量的命令添加到执行的文件中。例如
确定您Flutter SDK的目录,您将在步骤3中用到。
打开(或创建)
H
O
M
E
/
.
b
a
s
h
p
r
o
f
i
l
e
.
文
件
路
径
和
文
件
名
可
能
在
您
的
机
器
上
不
同
.
添
加
以
下
行
并
更
改
[
P
A
T
H
T
O
F
L
U
T
T
E
R
G
I
T
D
I
R
E
C
T
O
R
Y
]
为
克
隆
F
l
u
t
t
e
r
的
g
i
t
r
e
p
o
的
路
径
:
e
x
p
o
r
t
P
U
B
H
O
S
T
E
D
U
R
L
=
h
t
t
p
s
:
/
/
p
u
b
.
f
l
u
t
t
e
r
−
i
o
.
c
n
/
/
国
内
用
户
需
要
设
置
e
x
p
o
r
t
F
L
U
T
T
E
R
S
T
O
R
A
G
E
B
A
S
E
U
R
L
=
h
t
t
p
s
:
/
/
s
t
o
r
a
g
e
.
f
l
u
t
t
e
r
−
i
o
.
c
n
/
/
国
内
用
户
需
要
设
置
e
x
p
o
r
t
P
A
T
H
=
P
A
T
H
T
O
F
L
U
T
T
E
R
G
I
T
D
I
R
E
C
T
O
R
Y
/
f
l
u
t
t
e
r
/
b
i
n
:
HOME/.bash_profile. 文件路径和文件名可能在您的机器上不同. 添加以下行并更改[PATH_TO_FLUTTER_GIT_DIRECTORY]为克隆Flutter的git repo的路径: export PUB_HOSTED_URL=https://pub.flutter-io.cn //国内用户需要设置 export FLUTTER_STORAGE_BASE_URL=https://storage.flutter-io.cn //国内用户需要设置 export PATH=PATH_TO_FLUTTER_GIT_DIRECTORY/flutter/bin:
HOME/.bashprofile.文件路径和文件名可能在您的机器上不同.添加以下行并更改[PATHTOFLUTTERGITDIRECTORY]为克隆Flutter的gitrepo的路径:exportPUBHOSTEDURL=https://pub.flutter−io.cn//国内用户需要设置exportFLUTTERSTORAGEBASEURL=https://storage.flutter−io.cn//国内用户需要设置exportPATH=PATHTOFLUTTERGITDIRECTORY/flutter/bin:PATH
注意:PATH_TO_FLUTTER_GIT_DIRECTORY 为你flutter的路径,比如“~/document/code”
export PATH=~/document/code/flutter/bin:$PATH
运行 source $HOME/.bash_profile 刷新当前终端窗口.
注意: 如果你使用的是zsh,终端启动时 ~/.bash_profile 将不会被加载,解决办法就是修改 ~/.zshrc ,在其中添加:source ~/.bash_profile
5.通过运行flutter/bin命令验证目录是否在已经在PATH中:
echo $PATH
更多详细信息,请参阅this StackExchange question.
编辑器设置
使用 flutter 命令行工具,您可以使用任何编辑器来开发Flutter应用程序。输入flutter help在提示符下查看可用的工具。
我们建议使用我们的插件来获得丰富的IDE体验,支持编辑,运行和调试Flutter应用程序。请参阅编辑器设置了解详细步骤
平台设置
macOS支持为iOS和Android开发Flutter应用程序。现在完成两个平台设置步骤中的至少一个,以便能够构建并运行您的第一个Flutter应用程序