Flutter(2) — 安装SDK

关注

转载最新推荐文章于 2026-07-12 12:33:01 发布 4.8k 阅读 AI 写同款· GEO 优化 ›

【Flutter从入门到入坑之一】Flutter 介绍及安装使用当下是移动互联网的时代，也是大前端技术紧密整合的时代。而移动系统与终端设备的碎片化，让我们一直头痛于在不同平台上开发和维护同一个产品的成本问题：使用原生方式来开发 App，不仅要求分别针对 iOS 和 Android 平台，使用不同的语言实现同样的产品功能，还要对不同的终端设备和不同的操作系统进行功能适配，并承担由此带来的测试维护升级工作。为解决这一问题，各类打着“一套代码，多端运行”口号的跨平台开发方案，如雨后春笋般涌现。感兴趣的同学可以看一下 React Native VS Flutter。阅读详情

这一篇主要介绍一下Flutter的SDK环境搭建，网上关于环境搭建的文章很多，但是介绍基本都没有介绍SDK里有些什么。本文以Mac上安装为例，因为主要涉及到SDK内部，所以和其他平台应该是一致的。

官方的安装文档： https://flutterchina.club/get-started/install/

一、获取Flutter SDK

官网下载页： https://flutter.dev/docs/development/tools/sdk/archive
GitHub下载页： https://github.com/flutter/flutter/releases

在国内Flutter官网可能无法访问，一般大家都会去github上下载。下面是github上的release包，最新版是v1.3.13

在这里插入图片描述

从GitHub下载有个问题是大家容易忽略的，就是版本的channel。如果能打开官网的网页，我们可以发现Flutter SDK 有Stable、Beat、Dev、Master 四个渠道。其中Stable版本到目前为止只release了两个版本，通过对比发现，GitHub上release的是Dev版本。

在这里插入图片描述
当然也可以直接通过git命令来下载SDK，下面命令下载的是mster分支。

 git clone -b master https://github.com/flutter/flutter.git
 ./flutter/bin/flutter --version

关于四个Channel：

Master：是最新的代码，官方解释是【latest cutting edge build】，不知道如何解释，但是基本上时可用的，只是不稳定。
Dev：官方解释是【latest fully-tested build】，经过完整的测试，功能可用的，但是可能会有一些问题。会有一个Bad Build来记录这些问题。会持续的从Master分支合并一些代码过来。
Beta：每个月会从Dev获取最好的build合并到Beta分支，Beta的分支是经过codeLab测试的。
Stable：稳定版本，计划3个月左右发布一次。

学习话还是建议选取Stable版本。

二、安装SDK和环境配置

下载好SDK并解压之后，需要添加一下环境变量。具体平台不同方式也不一样，Linux和Mac下，建议使用~/.profile 文件，在~/.bashrc或者~/.zshrc 中加入 source ~/.profile

#for flutter
export FLUTTER_ROOT=/work/flutter
export FLUTTER_HOME=FLUTTER_ROOT/bin  export PATH=PATH:FLUTTER_HOME:FLUTTER_ROOT

按照官方提示，执行下面命令检查和安装flutter需要的依赖项目

flutter doctor

在这里插入图片描述

执行后会下载一些必要的依赖项目，主要是Dart SDK和一想相关的工具Flutter tool、Common tool、Android tool、IOS tool，Gradle。然后会检查本机的开发软件是否安装好了。
在这里插入图片描述
如果执行这个命令很久没有相应，可能是在国内连接不上，所以可以使用官方提供的临时镜像，如果自己有SS可以配合Proxifier进行全局代理，一般对java、dart、curl、git* 进行代理就可以了。

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

如果说是手动下载的zip包，执行这个命令时可能会提示你不是git目录的错误，这个时候只需要在SDK目录下执行一下git init 命令。不过还是建议直接使用git clone命令拉去SDK，然后切换到你要的版本。

master
* stable
  remotes/origin/HEAD -> origin/master
  remotes/origin/beta
  remotes/origin/dev
  remotes/origin/filiph-animated-widget-sample
  remotes/origin/gallery
  remotes/origin/master
  remotes/origin/revert-28919-composite_elevations
  remotes/origin/revert-29010-re_enable_dart2js
  remotes/origin/revert-29323-roll_branch
  remotes/origin/stable

更具体的环境安装过程就没必要写出来了，具体参考官网就可以了： https://flutterchina.club/setup-macos/

环境搭建好之后，就可以按照官方文档尝试新建并运行一个 Flutter程序了。 https://flutterchina.club/get-started/test-drive/

三、SDK初探

每次下载一个东西的SDK，我都喜欢看一看SDK里面有什么东西。Flutter SDK 提供了Framework的功能，所以我们先看一下SDK的目录结构，也能帮助我们理解flutter的架构。
在这里插入图片描述

➜  flutter git:(stable) ll
total 96
-rw-r--r--   1 chengchao  staff   1.4K  3 19 12:53 AUTHORS
-rw-r--r--@  1 chengchao  staff   2.6K  3 13 01:23 CODE_OF_CONDUCT.md
-rw-r--r--   1 chengchao  staff   3.4K  3 13 01:23 CONTRIBUTING.md
-rw-r--r--   1 chengchao  staff   1.5K  3 13 01:23 LICENSE
-rw-r--r--   1 chengchao  staff   1.1K  3 13 01:23 PATENTS
-rw-r--r--   1 chengchao  staff   6.1K  3 19 12:53 README.md
-rw-r--r--@  1 chengchao  staff   7.9K  3 13 01:23 analysis_options.yaml
drwxr-xr-x   7 chengchao  staff   224B  3 19 12:53 bin
-rw-r--r--   1 chengchao  staff   607B  3 13 01:23 dartdoc_options.yaml
drwxr-xr-x  15 chengchao  staff   480B  3 16 01:09 dev
drwxr-xr-x  12 chengchao  staff   384B  3 13 01:23 examples
-rw-r--r--   1 chengchao  staff   1.7K  3 13 01:23 flutter_console.bat
drwxr-xr-x  13 chengchao  staff   416B  3 19 12:53 packages
-rw-r--r--   1 chengchao  staff     5B  3 23 00:07 version

其中有bin、dev、examples、package四个目录。我们先看看bin目录，一般这个都是最有用的。

➜  bin git:(stable) ls -l
total 32
drwxr-xr-x  16 chengchao  staff   512  3 23 00:07 cache
-rwxr-xr-x@  1 chengchao  staff  6932  3 13 01:23 flutter
-rw-r--r--   1 chengchao  staff  7288  3 19 12:53 flutter.bat
drwxr-xr-x  11 chengchao  staff   352  3 23 00:26 internal

flutter命令

我们第一个执行的就是这个命令，用来下载依赖项目。其实只是一个sh脚本文件，执行一下会列举出命令参数（篇幅原因只选取了重要的）。可以分为options 和 command两种。

➜  bin git:(stable) flutter
Manage your Flutter app development.

Global options:
-h, --help                  Print this usage information.
-v, --verbose               Noisy logging, including all shell commands executed.
                            If used with --help, shows hidden options.

-d, --device-id             Target device id or name (prefixes allowed).
    --version               Reports the version of this tool.
    --suppress-analytics    Suppress analytics reporting when this command runs.
    --bug-report            Captures a bug report file to submit to the Flutter team.
                            Contains local paths, device identifiers, and log snippets.

    --packages              Path to your ".packages" file.
                            (required, since the current directory does not contain a ".packages" file)

Available commands:
  analyze                  Analyze the project's Dart code.
  build                    Flutter build commands.
  channel                  List or switch flutter channels.
  clean                    Delete the build/ and .dart_tool/ directories.
  config                   Configure Flutter settings.
  create                   Create a new Flutter project.
  doctor                   Show information about the installed tooling.
  help                     Display help information for flutter.
  install                  Install a Flutter app on an attached device.
  packages                 Commands for managing Flutter packages.
  run                      Run your Flutter app on an attached device.
  screenshot               Take a screenshot from a connected device.
  upgrade                  Upgrade your copy of Flutter.
  version                  List or switch flutter versions.

Run "flutter help <command>" for more information about a command.
Run "flutter help -v" for verbose help output, including less commonly used options.

用vscode打开flutter脚本看看，发现只有不到180行代码，那么是如何拥有这么多功能？

PROG_NAME="(path_uri "(follow_links "BASH_SOURCE")")"  BIN_DIR="(cd "{PROG_NAME%/*}" ; pwd -P)"  export FLUTTER_ROOT="(cd "{BIN_DIR}/.." ; pwd -P)"    FLUTTER_TOOLS_DIR="FLUTTER_ROOT/packages/flutter_tools"
SNAPSHOT_PATH="FLUTTER_ROOT/bin/cache/flutter_tools.snapshot"  STAMP_PATH="FLUTTER_ROOT/bin/cache/flutter_tools.stamp"
SCRIPT_PATH="FLUTTER_TOOLS_DIR/bin/flutter_tools.dart"  DART_SDK_PATH="FLUTTER_ROOT/bin/cache/dart-sdk"

DART="DART_SDK_PATH/bin/dart"  PUB="DART_SDK_PATH/bin/pub"

从中截取一段代码，看看，原来flutter脚本只是一个壳子，具体都是调用了SDK里的功能。这些命令基本包含了SDK升级、Flutter程序创建、编译、打包、安装、调试、测试分析等各项功能。使用几个常用的非开发命令：

channel

在这里插入图片描述

可以查看和切换SDK的渠道

➜  bin git:(stable) flutter channel
Flutter channels:
  beta
  dev
  master
* stable

version

可以查看和切换版本

➜  bin git:(stable) flutter version -h
List or switch flutter versions.

Usage: flutter version [arguments]

这个命令容易和–version混淆

➜  bin git:(stable) flutter --version
Flutter 1.2.1 • channel stable • https://github.com/flutter/flutter.git
Framework • revision 8661d8aecd (5 weeks ago) • 2019-02-14 19:19:53 -0800
Engine • revision 3757390fa4
Tools • Dart 2.1.2 (build 2.1.2-dev.0.0 0a7dcf17eb)

这个会列举出Flutter版本。如果还记得Flutter的架构图，这里列举出了Framework 和 Engine的版本号。使用git log查看一下提交记录，最后一次提交的commit和上面Framework版本是一致的。上面使用的是revision 是 short commit，你可以直接用short commit切换到对应版本。

commit 8661d8aecd626f7f57ccbcb735553edc05a2e713 (HEAD -> stable, tag: v1.2.1, origin/stable)
Author: xster <xiao@xster.net>
Date:   Thu Feb 14 19:19:53 2019 -0800

    Test text paint orders by color (#27983)

commit 22f888090970c0c99df87d57b8177685112e2c53
Author: xster <xiao@xster.net>
Date:   Thu Feb 14 16:50:06 2019 -0800

    Make sure the selection is still painted under the text (#27970)

➜  packages git:(stable) ls -l
total 8
-rw-r--r--@  1 chengchao  staff  232  3 13 01:23 analysis_options.yaml
drwxr-xr-x   8 chengchao  staff  256  3 19 12:53 flutter
drwxr-xr-x   7 chengchao  staff  224  3 23 00:46 flutter_build
drwxr-xr-x   8 chengchao  staff  256  3 19 12:53 flutter_driver
drwxr-xr-x   7 chengchao  staff  224  3 23 00:44 flutter_goldens
drwxr-xr-x   6 chengchao  staff  192  3 23 00:44 flutter_goldens_client
drwxr-xr-x   7 chengchao  staff  224  3 23 00:44 flutter_localizations
drwxr-xr-x   6 chengchao  staff  192  3 19 12:53 flutter_test
drwxr-xr-x  19 chengchao  staff  608  3 19 12:53 flutter_tools
drwxr-xr-x   7 chengchao  staff  224  3 19 12:53 fuchsia_remote_debug_protocol

结构很简单，看几个主要的目录

flutter：这个目录非常重要，提供了Flutter Framework的功能。比如widget.dart、rendering.dart等flutter的功能。
flutter_build：是和flutter程序编译相关
flutter_tools: 上面的那些命令的实现都在flutter_tools/lib/src/commands 目录下。这个下面提供了比如测试、IDE支持、Android/IOS 编译、调试等等工具

总的来说Package目录下都是提供给flutter开发的一些类工具类和Framework类，目前只是简单了解一下基本内容，有很多也不清楚具体用途，后面深入学习的话应该会接触到比较多内容。

dev目录

在这里插入图片描述

This directory contains tools and resources that the Flutter team uses during development of the framework. The tools 
in this directory should not be necessary for developing Flutter applications, though of course they may be interesting if 
you are curious.

 该目录包含Flutter团队在框架开发期间使用的工具和资源。 该目录中的工具对于开发Flutter应用程序不是必需的，尽管
 如果您好奇的话，它们当然很有趣。

bin目录

在这里插入图片描述

bin目录一般是一个SDK比较重要的目录，一般会包含重要的执行程序，比如Java SDK下就有javac，同样这里有前面看到的flutter脚本文件。相比刚解压或总git下拉下来，多了一个cache目录。

➜  bin git:(stable) ll
total 32
drwxr-xr-x  16 chengchao  staff   512B  3 24 01:42 cache
-rwxr-xr-x@  1 chengchao  staff   6.8K  3 13 01:23 flutter
-rw-r--r--   1 chengchao  staff   7.1K  3 19 12:53 flutter.bat
drwxr-xr-x  11 chengchao  staff   352B  3 23 00:26 internal

cache目录

打开cache目录，发现里面有dart-sdk、flutter_tool、material_fonts。这些都是前面下载的依赖项目。所以这个目录下的文件应该都是Flutter所需要的。
在这里插入图片描述

total 49264
drwxr-xr-x   6 chengchao  staff   192B  3 19 13:06 artifacts
drwxr-xr-x  11 chengchao  staff   352B  3 19 14:12 dart-sdk
drwxr-xr-x   2 chengchao  staff    64B  3 19 13:13 downloads
-rw-r--r--   1 chengchao  staff    41B  3 19 12:57 engine-dart-sdk.stamp
-rw-r--r--   1 chengchao  staff    40B  3 19 13:13 engine.stamp
-rw-r--r--   1 chengchao  staff    24M  3 19 12:58 flutter_tools.snapshot
-rw-r--r--   1 chengchao  staff    41B  3 19 12:58 flutter_tools.stamp
-rw-r--r--   1 chengchao  staff   180B  3 23 00:03 flutter_version_check.stamp
-rw-r--r--   1 chengchao  staff    88B  3 13 01:36 gradle_wrapper.stamp
-rw-r--r--   1 chengchao  staff     0B  3 23 01:28 lockfile
-rw-r--r--   1 chengchao  staff    78B  3 13 01:30 material_fonts.stamp
drwxr-xr-x   3 chengchao  staff    96B  3 19 13:06 pkg

有5个*.stamp文件，其中flutter_version_check.stamp 内容如下，记录了服务器最新当前channel最新的版本时间和本地检查时间。

{
  "lastTimeVersionWasChecked": "2019-03-24 01:38:16.300412",
  "lastKnownRemoteVersion": "2019-02-15 03:19:53.000Z"
}

所以这些stamp文件是用来检查本地和服务器版本是否有差别的，其他几个记录的是revision（对应的就是源码git commit ID），所以Flutter SDK主要依赖下面4个：

Dart SDK
Flutter engine
Flutter tool
Gradle
Material fonts

dart-sdk目录

在这里插入图片描述

因为dart 可以支持命令行，Server、Web以及flutter使用，SDK直接可能会有一些差别。所以flutter默认使用自己下载的dart sdk。从flutter脚本中就可以看到，所以如果你机器上已经安装了dart sdk，可以在这里手动指定。不过建议使用flutter自己下载的，因为他会使用对应版本的SDK。当然，正常来说用新版本也不会有比较大的差异。

DART_SDK_PATH="FLUTTER_ROOT/bin/cache/dart-sdk"    DART="DART_SDK_PATH/bin/dart"
PUB="$DART_SDK_PATH/bin/pub"

bin目录

bin目录是dart的一些工具，这些工具其实也都是脚本文件，实际是调用snapshots目录下的dart程序。这些dart程序都是以snapshot的形式发布的， snapshot意思是快照，使用的目的是为了加快程序加载的速度。一般来说VM加载可执行文件时，要解析出相关class结构放在内存，而snapshot文件中是已经序列化之后的结构，可以直接反序列化到内存中。这方面更具体内容后面学dart在研究。Snapshot意思可以参见：https://github.com/dart-lang/sdk/wiki/Snapshots

在这里插入图片描述

➜  bin git:(stable) tree
.
├── dart
├── dartanalyzer
├── dartdoc
├── dartfmt
├── pub
└── snapshots
    ├── analysis_server.dart.snapshot
    ├── dartanalyzer.dart.snapshot
    ├── dartdoc.dart.snapshot
    ├── dartfmt.dart.snapshot
    ├── flutter_dart2js.dart.snapshot
    ├── flutter_kernel_worker.dart.snapshot
    ├── kernel-service.dart.snapshot
    ├── pub.dart.snapshot
    └── resources

在这里插入图片描述
lib目录下是dart提供的语言库，都是源码形式。

pkg目录

在这里插入图片描述

pkg目录下目前只有sky_engine, 里面README介绍。

Flutter Engine

==============

This package describes the dart:ui library, which is the interface between Dart and the Flutter Engine. This 
package also contains a number of Flutter shell binaries that let you run code that uses the dart:ui library on 
various platforms.

该软件包描述了dart：ui库，它是Dart与Flutter Engine之间的接口。 该软件包还包含许多Flutter Shell二进制文件，
使您可以在各种平台上运行使用dart：ui库的代码。

主要作用是Framework和Engine之间的一个桥梁。

artifacts

这个目录下有Flutter依赖的Gradle和Material Font。

在这里插入图片描述

total 0
drwxr-xr-x  20 chengchao  staff  640  3 19 14:11 engine
drwxr-xr-x   6 chengchao  staff  192  3 19 14:14 gradle_wrapper
drwxr-xr-x  25 chengchao  staff  800  3 13 01:30 material_fonts

还有一个engine目录，看起来和Android以及IOS编译相关。
在这里插入图片描述

➜  engine git:(stable) ls -l
total 0
drwxr-xr-x  4 chengchao  staff  128  3 19 14:12 android-arm
drwxr-xr-x  5 chengchao  staff  160  3 19 14:14 android-arm-dynamic-profile
drwxr-xr-x  4 chengchao  staff  128  3 19 13:10 android-arm-dynamic-release
drwxr-xr-x  4 chengchao  staff  128  3 19 13:09 android-arm-profile
drwxr-xr-x  4 chengchao  staff  128  3 19 13:09 android-arm-release
drwxr-xr-x  3 chengchao  staff   96  3 19 13:10 android-arm64
drwxr-xr-x  4 chengchao  staff  128  3 19 13:10 android-arm64-dynamic-profile
drwxr-xr-x  4 chengchao  staff  128  3 19 13:11 android-arm64-dynamic-release
drwxr-xr-x  4 chengchao  staff  128  3 19 13:10 android-arm64-profile
drwxr-xr-x  4 chengchao  staff  128  3 19 13:10 android-arm64-release
drwxr-xr-x  4 chengchao  staff  128  3 19 13:09 android-x64
drwxr-xr-x  4 chengchao  staff  128  3 19 13:09 android-x86
drwxr-xr-x  4 chengchao  staff  128  3 19 14:12 common
drwxr-xr-x  9 chengchao  staff  288  3 19 13:08 darwin-x64
drwxr-xr-x  7 chengchao  staff  224  3 19 13:13 ios
drwxr-xr-x  7 chengchao  staff  224  3 19 13:13 ios-profile
drwxr-xr-x  7 chengchao  staff  224  3 19 13:13 ios-release

随便看2个目录
在这里插入图片描述

➜  engine git:(stable) ls -l android-arm
total 10816
-rw-r--r--@ 1 chengchao  staff  5536743  2 13 14:36 flutter.jar
➜  engine git:(stable) ls -l ios
total 76144
drwxr-xr-x  7 chengchao  staff       224  3 19 13:11 Flutter.framework
-rw-r--r--  1 chengchao  staff  25786499  2 13 15:13 Flutter.framework.zip
-rw-r--r--  1 chengchao  staff       758  2 13 14:02 Flutter.podspec
-rw-r--r--  1 chengchao  staff      1520  3 13 01:23 LICENSE
-rwxr-xr-x  1 chengchao  staff  13188856  2 13 15:13 gen_snapshot

打开个jar包看看，原来里面包含了Android开发需要的一些flutter的类。这个库相当于是Flutter和原生应用直接的一个沟通容器。通过使用这些类，可以在原生代码中嵌入和使用flutter程序。libFlutter.so应该就是flutter的Engine。
在这里插入图片描述

其中还有一个common目录，下面有一些和.dill文件（这些文件是drat源文件进行kernal编译后的文件。简单说就是源码经过了语法分析变成了AST(抽象语法树)，主要是因为dart2.0后VM无法直接执行源码，代码必须经过kernel编译。关于Dart相关内容后面会学习到）。这些dill应该也是会在编译flutter文件时使用到的。
在这里插入图片描述

-rw-r--r--   1 chengchao  staff   1.4M  2 14 06:19 dart2js_outline.dill
-rw-r--r--   1 chengchao  staff   7.0M  2 14 06:19 dart2js_platform.dill
-rw-r--r--@  1 chengchao  staff   4.6K  2 14 06:09 libraries.json
-rw-r--r--   1 chengchao  staff   5.9M  2 14 06:19 platform.dill
-rw-r--r--   1 chengchao  staff    42K  2 14 06:19 platform.dill.d
-rw-r--r--   1 chengchao  staff   5.9M  2 14 06:19 platform_strong.dill
-rw-r--r--   1 chengchao  staff    42K  2 14 06:19 platform_strong.dill.d
drwxr-xr-x  17 chengchao  staff   544B  2 14 06:18 stub_ui
-rw-r--r--   1 chengchao  staff   843K  2 14 06:19 vm_outline.dill
-rw-r--r--   1 chengchao  staff   843K  2 14 06:19 vm_outline_strong.dill

downloads目录

在我们执行flutter doctor命令后下载相关文件的零时存放的地方
在这里插入图片描述

四、总结

这一篇文章主要通过安装Flutter SDK，对SDK内部结构有了一定了解。我们大概知道了：

Flutter SDK 有四个不同的Channel
Flutter SDK依赖的Dart SDK是内部自动下载的（也可以手动指定）
Flutter命令
Flutter SDK提供的功能主要都在package目录下，其中的flutter目录下包含了Framework的类库功能
Flutter SDK提供了一个flutter.jar和flutter.framework来和flutter打交道，以便Android 和 IOS能将flutter程序集成到原生应用中。

补充
windows系统如何快速搭建环境可以参考我的博客 Windows环境下搭建Flutter开发环境

收录于