拿到一台新MAC,如何快速配置并运行Flutter项目

3,363 阅读3分钟

前言

大家好,我是未央歌,一个默默无闻的移动开发搬砖者~

最近我的电脑因为升级要求需要格式化,悲催,一切要重新开始,本文就记录了我的配置之路,可谓保姆级讲解记录,方便后面有需要回顾查看,如果你也有需要,不妨收藏看看是否用得上。

必备软件安装

Android Studio

  • 无需多言,下载 AS 或者 VSCode,全凭个人喜好习惯

Sidekick

  • Flutter SDK 管理工具
  • 安装完成后,选择一个你需要的版本下载,并设置为全局。 image.png

环境配置

查看电脑使用的shell是Bash还是Zsh

  • 在终端输入 echo $SHELL ,该命令将显示当前默认 shell 的路径
  • 如果是 Bash,你将看到 /bin/bash,如果是 Zsh,你将看到 /bin/zsh。
  • 以我的 MAC 为例,是 /bin/bash

检查 Homebrew 是否安装

  • 在终端输入 brew doctor ,如果出现 brew: command not found,则说明电脑还没安装 Homebrew
  • 输入 以下命令安装
    /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
    
  • 安装完成后,再次执行 brew doctor ,如果出现 your system is ready to brew,则表示 Homebrew 已经安装成功
  • 如若仍然出现 brew: command not found,在终端输入以下命令更新路径配置
    echo 'export PATH="/usr/local/bin:$PATH"' >> ~/.bash_profile(如果使用 bash shell)
    echo 'export PATH="/usr/local/bin:$PATH"' >> ~/.zshrc(如果使用 zsh shell)
    
  • 安装完提示如下
    ...
    Installation successful!
    
    ==> Homebrew has enabled anonymous aggregate formulae and cask analytics.
    Read the analytics documentation (and how to opt-out) here:
      https://docs.brew.sh/Analytics
    No analytics data has been sent yet (nor will any be during this install run).
    
    ==> Homebrew is run entirely by unpaid volunteers. Please consider donating:
      https://github.com/Homebrew/brew#donations
    
    ==> Next steps:
    - Run these two commands in your terminal to add Homebrew to your PATH:
        (echo; echo 'eval "$(/opt/homebrew/bin/brew shellenv)"') >> /Users/10583/.bash_profile
        eval "$(/opt/homebrew/bin/brew shellenv)"
    - Run brew help to get started
    - Further documentation:
        https://docs.brew.sh
    ...
    
  • 此时再执行以下命令,按回车即可完成
    (echo; echo 'eval "$(/opt/homebrew/bin/brew shellenv)"') >> /Users/10583/.bash_profile
        eval "$(/opt/homebrew/bin/brew shellenv)"
    
  • 然后重启终端再次执行 brew doctor

Homebrew 问题一览

  • 升级卡住,果出现以下这种情况,一直卡在 Cloning into…… image.png
  • 输入以下命令
    cd /usr/local/Homebrew/Library/Taps/
    mkdir homebrew
    cd homebrew
    git clone https://mirrors.ustc.edu.cn/homebrew-core.git
    或 git clone https://mirrors.ustc.edu.cn/homebrew-cask.git (哪个卡住 Clone 哪个)
    brew update
    
  • 如果brew提示 formula.jws.json 文件没有 image.png
  • 在环境配置文件中添加 export HOMEBREW_NO_INSTALL_FROM_API=1 即可,具体添加方式见下方更改环境配置

查vim是否安装

  • 输入 vim ~/.bash_profile,如果出现 vim: command not found ,说明没安装 vim
  • 输入 brew install vim 进行安装

更改环境配置

  • 输入 vim ~/.bash_profile,打开环境变量文件
  • 按 i 键,即可写入下方的配置
    # Flutter
    # Flutter SDK位置
    export PATH=$HOME/fvm/default/bin:$PATH
    # Flutter 网络代理
    export PUB_HOSTED_URL=https://pub.flutter-io.cn
    export FLUTTER_STORAGE_BASE_URL=https://storage.flutter-io.cn
    
  • 写入完成后,按 esc 退出编辑
  • 输入 :wq 保存并关闭。(若此时遇到 readonly option is set (add!to override),执行 :wq! 强制保存退出)
  • 执行 source ~/.bash_profile 让前面编辑的 vim ~/.bash_profile 文件生效
  • 运行 flutter --version,看是否生效

安装cocoapods

  • 执行 brew install cocoapods
  • 验证 cocoapods 是否已成功安装,执行 pod --version

运行至模拟器

创建 iOS 模拟器

  • 在 App Store 上搜索 Xcode 并安装。
  • 安装完打开 Xcode,选择菜单栏的 window,选择 Devices and Simulators image.png
  • 然后选择 Platforms,去下载 iOS 相关资源(图为已下载) image.png
  • 然后在 Xcode 打开模拟器 image.png
  • 选择其中一个型号启动即可 image.png

运行 Flutter 项目至 iOS 模拟器

  • 如果运行起来报错 increase your application's deployment target to at least 13.0 as described at docs.flutter.dev/deployment/… image.png
  • 去到项目中双击打开 Runner.xcworkspace image.png
  • 在如下路径中将 iOS Deployment Target 改为 13.0 image.png
  • 然后打开项目中 Podfile 文件,将 platform 也改成13.0
  • 最后 cd 进入到这个 iOS 目录下,执行 pod install 命令
  • 最后如何其他问题,一般都可以运行啦,如果遇到其他问题,欢迎评论区提出,一起解决~

最后

如果你对 Android 和 Flutter 感兴趣,可以订阅我的专栏:

感谢大家的支持,码字实在不易,其中如若有错误,望指出,记得点赞关注加收藏哦 ~