网络知识 娱乐 Flutter安装及版本切换

Flutter安装及版本切换

发布: 2023年2月14日 10:17:50

文章目录

    • flutter安装
      • 推荐安装方式（克隆仓库）
      • macOS下通过 brew 安装
      • 官方release包
    • flutter通道及发行版本
      • flutter channel
      • git tag
    • flutter切换版本
      • downgrade
      • upgrade
      • clean
    • Q&A
      • pod install 报错找不到 Flutter.framework
      • pod install 报错找不到 Flutter.podspec
      • 运行报错 Dart Error: Can't load Kernel binary
    • refs

flutter安装

一般有两种安装方式：git clone 和 包管理器。主流平台的包管理器如下：

  • macOS：Homebrew；
  • windows：Chocolatey、Scoop；
  • linux：DPKG - APT、RPM - YUM。

推荐安装方式（克隆仓库）

将 flutter github 仓库克隆到本地目录，例如 macOS 下的 ~/Library/Developer/：

$ git clone https://github.com/flutter/flutter.git ~/Library/Developer/

然后需要配置环境变量，macOS 下在 ~/.zshrc 中添加以下三行：

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

当前终端shell窗口需要执行 . ~/.zshrc 或 source ~/.zshrc 才能生效，或者新建shell窗口立即生效。

macOS下通过 brew 安装

macOS 下还可通过 homebrew 包管理器工具来安装，具体来说执行 brew install --cask flutter 命令即可。

由于brew安装flutter后，会将 flutter 和 dart 二进制可执行文件软链一份到 /usr/local/bin 下，而该目录默认已在 PATH 中，因此无需额外配置 PATH 环境变量。
但是仍需配置 PUB_HOSTED_URL 和 FLUTTER_STORAGE_BASE_URL 这两个环境变量。

brew 安装 flutter 后，执行 which flutter 查看其 binutils 位置：

$ which flutter
/usr/local/bin/flutter

执行 ls -F 可知其为软链（symbol link）

$ ls -F `which flutter`
/usr/local/bin/flutter@

进一步执行 readlink 可读取其原身位置，此即 brew 安装位置：

$ readlink `which flutter`
/usr/local/Caskroom/flutter/1.22.6/flutter/bin/flutter

cd 到安装目录，其实也是 flutter github 仓库：

$ cd /usr/local/Caskroom/flutter/1.22.6/flutter/
$ git remtoe -v
origin	https://github.com/flutter/flutter.git (fetch)
origin	https://github.com/flutter/flutter.git (push)

官方release包

除此之外，可以到 flutter 官方网站 Install 下载安装包，在 Flutter SDK releases 中查找下载指定历史版本。

如果官方被墙或网速很慢，上 flutter.cn 下载更快：https://flutter.cn/docs/development/tools/sdk/releases?tab=macos, 例如 https://storage.flutter-io.cn/flutter_infra/releases/stable/macos/flutter_macos_1.22.6-stable.zip 。

flutter通道及发行版本

flutter channel

执行 flutter channel 查看当前通道：

$ flutter channel
Flutter channels:
  master
  dev
  beta
* stable

下面通过 git checkout 或者 git reset 强切版本，flutter git 仓库将处于 ‘detached HEAD’ 状态（例如 HEAD detached at 1.22.6），将没有星号标记当前 channel。

git tag

flutter release 发版一般都会有对应的tag，cd进入本地 flutter git 仓库，然后执行 git tag 可查看发行版本。

$ cd ~/Library/Developer/flutter # cd /usr/local/Caskroom/flutter/1.22.6/flutter/
$ git tag -l | sort | grep '^1.*|^2.*'
# 此处省略部分低版本输出
1.22.1
1.22.2
1.22.3
1.22.4
1.22.5
1.22.6
1.23.0-13.0.pre
1.23.0-18.0.pre
1.23.0-18.1.pre
1.23.0-3.0.pre
1.23.0-4.0.pre
1.23.0-7.0.pre
1.24.0-1.0.pre
1.24.0-10.1.pre
1.24.0-10.2.pre
1.24.0-3.0.pre
1.24.0-6.0.pre
1.24.0-7.0.pre
1.25.0-4.0.pre
1.25.0-8.0.pre
1.25.0-8.1.pre
1.25.0-8.2.pre
1.25.0-8.3.pre
1.26.0-1.0.pre
1.26.0-12.0.pre
1.26.0-17.0.pre
1.26.0-17.1.pre
1.26.0-17.2.pre
1.26.0-17.3.pre
1.26.0-17.4.pre
1.26.0-17.5.pre
1.26.0-17.6.pre
1.26.0-17.7.pre
1.26.0-17.8.pre
1.26.0-8.0.pre
1.27.0-1.0.pre
1.27.0-4.0.pre
1.27.0-8.0.pre
2.0.0
2.0.1
2.0.2
2.0.3
2.0.4
2.0.5
2.1.0-10.0.pre
2.1.0-12.0.pre
2.1.0-12.1.pre
2.1.0-12.2.pre
2.2.0-10.0.pre
2.2.0-10.1.pre

flutter切换版本

以下讲解通过 git 命令行工具手动切换 Flutter SDK 版本。
强烈建议采用 FVM 管理切换 Flutter SDK，参考 Flutter版本管理器-FVM。

downgrade

目前通过 git clone 或 brew install flutter，其 stable 版本已经到了 2.0.5-2.12.3。

$ flutter --version
Flutter 2.0.5 • channel stable • https://github.com/flutter/flutter.git
Framework • revision adc687823a (7 hours ago) • 2021-04-16 09:40:20 -0700
Engine • revision b09f014e96
Tools • Dart 2.12.3

由于我们的 flutter_module 工程还没有完全适配 flutter 2.0，需要将其回退到 last stable 版本 1.22.6。

一般通过如下三（四）步即可实现版本降级：

# 1. 切换到 stable 频道
flutter channel stable
# 2. 降级到 1.22.6
flutter downgrade v1.22.6 # git checkout 1.22.6 or git reset --hard 1.22.6
# 3. 删除工具链缓存（可选）
rm -rf bin/cache
# 4. 重新拉取工具链
flutter precache # or flutter doctor?

正常执行 flutter downgrade 的版本提示如下：

$ flutter downgrade v1.22.6
Downgrade flutter to version 1.22.6
? [y|n]: y

输入 y 确认即可成功降级。

如果执行 flutter downgrade 的输出报错或确认版本非预期：

$ flutter downgrade v1.22.6
Downgrade flutter to version 1.22.4
? [y|n]: n

则可cd到flutter本地git仓库目录，然后通过 git checkout 或 git reset 来切换版本到指定tag：

$ cd ~/Library/Developer/flutter # cd /usr/local/Caskroom/flutter/1.22.6/flutter/
$ git checkout 1.22.6
Updating files: 100% (3185/3185), done.
Note: switching to '1.22.6'.

以上通过 flutter downgrade 命令或 git checkout 命令切换 flutter 版本后，一般需执行 flutter precache 重新拉取工具链：

$ flutter precache
Downloading Dart SDK from Flutter engine 2f0af3715217a0c2ada72c717d4ed9178d68f6ed...
  % Total    % Received % Xferd  Average Speed   Time    Time     Time  Current
                                 Dload  Upload   Total   Spent    Left  Speed
100  172M  100  172M    0     0  5454k      0  0:00:32  0:00:32 --:--:-- 5855k
Building flutter tool...
Failed to download the Android dependencies
Downloading Android Maven dependencies...                           1.0s
Flutter assets will be downloaded from https://storage.flutter-io.cn. Make sure you trust this source!
Downloading android-arm-profile/darwin-x64 tools...                 1.0s
Downloading android-arm-release/darwin-x64 tools...                 1.0s
Downloading android-arm64-profile/darwin-x64 tools...               0.8s
Downloading android-arm64-release/darwin-x64 tools...               0.9s
Downloading android-x64-profile/darwin-x64 tools...                 0.9s
Downloading android-x64-release/darwin-x64 tools...                 0.9s
Downloading android-x86 tools...                                    5.0s
Downloading android-x64 tools...                                    4.9s
Downloading android-arm tools...                                    2.7s
Downloading android-arm-profile tools...                            1.2s
Downloading android-arm-release tools...                            1.0s
Downloading android-arm64 tools...                                  2.1s
Downloading android-arm64-profile tools...                          1.5s
Downloading android-arm64-release tools...                          1.3s
Downloading android-x64-profile tools...                            1.4s
Downloading android-x64-release tools...                            1.1s
Downloading android-x86-jit-release tools...                        1.9s
Downloading ios tools...                                            8.7s
Downloading ios-profile tools...                                    5.9s
Downloading ios-release tools...                                   37.1s
Downloading package sky_engine...                                   0.3s
Downloading flutter_patched_sdk tools...                            3.3s
Downloading flutter_patched_sdk_product tools...                    3.1s
Downloading darwin-x64 tools...                                     7.8s
Downloading darwin-x64/font-subset tools...                         0.7s

可执行 flutter doctor -v 检查还有哪些工具链或配置缺失，按照提示指引进行补齐。

正常情况下，执行 flutter --version 将显示已经降级到 1.22.6-2.10.5：

$ flutter --version
Flutter 1.22.6 • channel unknown • unknown source
Framework • revision 9b2d32b605 (3 months ago) • 2021-01-22 14:36:39 -0800
Engine • revision 2f0af37152
Tools • Dart 2.10.5

upgrade

首先，切换channel为stable，然后执行 flutter upgrade 即可升级到当前stable channel的最新版本。

$ flutter channel stable
$ flutter upgrade

upgrade 貌似不能像 downgrade 命令那样指定版本？

如果要升级到中间某个版本，还是可以采用 git checkout 或 git reset 方式，切换后执行 flutter precache 重新拉取工具链。

clean

切换flutter版本后，需进入 flutter_module 执行一次 flutter clean，然后再执行 flutter pub get 重新拉取依赖 packages。

有时遇到某些缓存问题，也可手工清理 flutter/.pub-cache 目录，重新 flutter pub get 全量更新。

Q&A

pod install 报错找不到 Flutter.framework

iOS 壳工程执行 pod install 报错找不到 Flutter.framework。

出现工具链或引擎缺失问题，请先检查工具链 flutter/bin/cache/ 下的 artifacts/engine 等是否完整。

一般可通过移除工具链缓存 flutter/bin/cache/，执行 flutter precache 重拉工具链解决。

pod install 报错找不到 Flutter.podspec

参考 No podspec found，执行 pod install 报错找不到 flutter_module/.ios/Flutter/engine/Flutter.podspec：

    Fetching external sources
    -> Fetching podspec for `Flutter` from `../flutter_module/.ios/Flutter/engine`
    [!] No podspec found for `Flutter` in `../flutter_module/.ios/Flutter/engine`

此时，可移除 flutter_module 下的 .ios 目录，然后重新执行 flutter pub get；再回到 iOS 壳工程目录重新执行 pod install。

运行报错 Dart Error: Can’t load Kernel binary

upgrade到2.0.4，再downgrade回1.22.6，编译没问题，但是启动运行一直报错：
DartError

参考 Flutter iOS 混合开发：

  • 问题: Dart Error: Can’t load Kernel binary: Invalid kernel binary format version。
  • 原因: flutter 和 engine 版本不一致，需要更新到一致状态。

可尝试以下方式解决：

  1. 依次尝试重启终端、vscode、IDE（Xcode/AndroidStudio）、电脑；
  2. 尝试清除HOME目录下的所有 .flutter、.dart、.pub-cache，然后重新 flutter clean、flutter pub get；
  3. 尝试卸载flutter（删除git仓库或 brew uninstall flutter），重新安装后再downgrade切换。

refs

How to downgrade Flutter SDK (Dart 1.x)
Flutter cannot downgrade SDK version from 1.22.x to 1.20.0 #65175
Flutter-常见问题

Flutter环境配置遇到的坑：一、二
flutter提示AndroidStudio4.1没有安装flutter插件

相关文章