MacOS Flutter环境配置

安装 Flutter SDK

  1. 配置环境变量

    echo 'export PUB_HOSTED_URL="https://pub.flutter-io.cn"' >> ~/.zshrc
echo 'export FLUTTER_STORAGE_BASE_URL="https://storage.flutter-io.cn"' >> ~/.zshrc

  2. 创建一个可以安装 Flutter 的文件夹，然后将文件夹命名为 Flutter

    mkdir -p ~/software; cd ~/software

  3. 下载Flutter压缩包

    curl https://storage.flutter-io.cn/flutter_infra_release/releases/stable/macos/flutter_macos_arm64_3.27.1-stable.zip -o ~/software/flutter_macos_arm64_3.27.1-stable.zip

  4. 解压

    unzip flutter_macos_arm64_3.27.1-stable.zip

  5. 将 Flutter 添加到你的 PATH 环境变量中

    echo 'export PATH=~/software/flutter/bin:$PATH' >> ~/.zshrc
. ~/.zshrc

  6. 运行 Flutter doctor 来验证安装

    $ flutter doctor

安装 Xcode

要为iOS开发Flutter应用程序，您需要Xcode最新版本:

  1. 安装Xcode最新版本。
  2. 配置Xcode命令行工具以使用新安装的Xcode版本 sudo xcode-select --switch /Applications/Xcode.app/Contents/Developer 对于大多数情况，当您想要使用最新版本的Xcode时，这是正确的路径。如果您需要使用不同的版本，请指定相应路径。
  3. 确保Xcode许可协议是通过打开一次Xcode或通过命令sudo xcodebuild -license同意过了.

使用Xcode，您可以在iOS设备或模拟器上运行Flutter应用程序。

初始化

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

升级 Flutter

Flutter SDK分支

Flutter SDK有多个分支，如beta、dev、master、stable，其中stable分支为稳定分支（日后有新的稳定版本发布后可能也会有新的稳定分支，如1.0.0），dev和master为开发分支，安装flutter后，你可以运行flutter channel查看所有分支，如笔者本地运行后，结果如下：

Flutter channels:
  beta
  dev
* master

带"*“号的分支即你本地的Flutter SDK 跟踪的分支，要切换分支，可以使用flutter channel beta 或 flutter channel master，Flutter官方建议跟踪稳定分支，但你也可以跟踪master分支，这样可以查看最新的变化，但这样稳定性要低得多。

升级Flutter SDK和依赖包

要升级flutter sdk，只需一句命令：

flutter upgrade

该命令会同时更新Flutter SDK和你的flutter项目依赖包。如果你只想更新项目依赖包（不包括Flutter SDK），可以使用如下命令：

  • flutter packages get获取项目所有的依赖包。
  • flutter packages upgrade 获取项目所有依赖包的最新版本。

VS Code的配置与使用

VS Code是一个轻量级编辑器，支持Flutter运行和调试。

安装flutter插件

  1. 启动 VS Code。
  2. 调用 View>Command Palette…。
  3. 输入 ‘install’, 然后选择 Extensions: Install Extension action。
  4. 在搜索框输入 flutter ，在搜索结果列表中选择 ‘Flutter’, 然后点击 Install。
  5. 选择 ‘OK’ 重新启动 VS Code。
  6. 验证配置
    • 调用 View>Command Palette…
    • 输入 ‘doctor’, 然后选择 ‘Flutter: Run Flutter Doctor’ action。
    • 查看“OUTPUT”窗口中的输出是否有问题

创建Flutter应用

  1. 启动 VS Code
  2. 调用 View>Command Palette…
  3. 输入 ‘flutter’, 然后选择 ‘Flutter: New Project’ action
  4. 输入 Project 名称 (如myapp), 然后按回车键
  5. 指定放置项目的位置，然后按蓝色的确定按钮
  6. 等待项目创建继续，并显示main.dart文件

体验热重载

  1. 打开lib/main.dart文件。
  2. 将字符串 'You have pushed the button this many times:' 更改为 'You have clicked the button this many times:'。
  3. 不要按“停止”按钮; 让您的应用继续运行。
  4. 要查看您的更改，直接保存（cmd+s / ctrl+s），或者点击 热重载按钮 （绿色圆形箭头按钮）即可。

你会立即在运行的应用程序中看到更新的字符串。

连接iOS模拟器

要准备在iOS模拟器上运行并测试Flutter应用，请按以下步骤操作：

  1. 在你的MAC上，通过 Spotlight 或以下命令找到模拟器：

    open -a Simulator

  2. 通过检查模拟器 Hardware > Device 菜单中的设置，确保模拟器正在使用64位设备（iPhone 5s或更高版本）。

  3. 根据你电脑屏幕大小，模拟高清屏iOS设备可能会溢出屏幕。可以在模拟器的 Window> Scale 菜单下设置设备比例。

  4. 运行 flutter run启动flutter应用程序。

连接iOS真机设备

要将Flutter应用安装到iOS真机设备，需要一些额外的工具和一个 Apple 账户，还需要在 Xcode 中进行一些设置。

  1. 安装 homebrew (opens new window) （如果已经安装了brew,跳过此步骤）。

  2. 打开终端并运行如下这些命令:

    brew update
brew install --HEAD libimobiledevice
brew install ideviceinstaller ios-deploy cocoapods
pod setup

    如果这些命令中的任何一个失败并出现错误，请运行brew doctor并按照说明解决问题.

  3. 遵循Xcode签名流程来配置您的项目:

    • 在你Flutter项目目录中通过 open ios/Runner.xcworkspace 打开默认的Xcode workspace.

    • 在Xcode中，选择导航面板左侧中的Runner项目。

    • 在Runner target设置页面中，确保在 General > Signing > Team 下选择了你的开发团队。当你选择一个团队时，Xcode会创建并下载开发证书，向你的设备注册你的帐户，并创建和下载配置文件（如果需要）。

    • 要开始您的第一个iOS开发项目，您可能需要使用您的Apple ID登录Xcode，如图1-4：

      图1-4

      任何Apple ID都支持开发和测试，但若想将应用分发到App Store，就必须注册Apple开发者计划，有关详情读者可以自行了解。

    1. 当您第一次attach真机设备进行iOS开发时，需要同时信任你的Mac和该设备上的开发证书。首次将iOS设备连接到Mac时，请在对话框中选择 Trust，如图1-5：

      添加信任

      然后，转到iOS设备上的设置菜单，选择 常规>设备管理 并信任您的证书。

    2. 如果Xcode中的自动签名失败，请验证项目的 General > Identity > Bundle Identifier 值是否唯一，如图1-6所示：

      验证bundle id是否唯一

    3. 运行 flutter run启动flutter应用程序。