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

前言

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

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

必备软件安装

Android Studio

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

Sidekick

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

环境配置

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

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

检查 Homebrew 是否安装

  • 在终端输入 brew doctor ,如果出现 brew: command not found,则说明电脑还没安装 Homebrew

  • 输入 以下命令安装

    bash 复制代码
    /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,在终端输入以下命令更新路径配置

    bash 复制代码
    echo 'export PATH="/usr/local/bin:$PATH"' >> ~/.bash_profile(如果使用 bash shell)
    echo 'export PATH="/usr/local/bin:$PATH"' >> ~/.zshrc(如果使用 zsh shell)
  • 安装完提示如下

    bash 复制代码
    ...
    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
    ...
  • 此时再执行以下命令,按回车即可完成

    bash 复制代码
    (echo; echo 'eval "$(/opt/homebrew/bin/brew shellenv)"') >> /Users/10583/.bash_profile
        eval "$(/opt/homebrew/bin/brew shellenv)"
  • 然后重启终端再次执行 brew doctor

Homebrew 问题一览

  • 升级卡住,果出现以下这种情况,一直卡在 Cloning into......

  • 输入以下命令

    bash 复制代码
    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 文件没有

  • 在环境配置文件中添加 export HOMEBREW_NO_INSTALL_FROM_API=1 即可,具体添加方式见下方更改环境配置

查vim是否安装

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

更改环境配置

  • 输入 vim ~/.bash_profile,打开环境变量文件

  • 按 i 键,即可写入下方的配置

    bash 复制代码
    # 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
  • 然后选择 Platforms,去下载 iOS 相关资源(图为已下载)
  • 然后在 Xcode 打开模拟器
  • 选择其中一个型号启动即可

运行 Flutter 项目至 iOS 模拟器

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

最后

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

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

相关推荐
在下历飞雨几秒前
Kuikly基础之动画实战:让孤寡青蛙“活”过来
前端·ios·harmonyos
勇气要爆发25 分钟前
【第五阶段—高级特性和架构】第七章:CustomPainter—绘图大师
flutter
用户7502734994771 小时前
我用百度文心快码开发了一款积木工坊:用AI让每个孩子都成为小小建筑师
flutter
D***t1311 小时前
Swift在iOS中的多任务处理
开发语言·ios·swift
名字被你们想完了2 小时前
Flutter 实现一个容器内部元素可平移、缩放和旋转等功能(一)
flutter
灰灰勇闯IT2 小时前
Flutter×VS Code:跨端开发的高效协作指南(2025最新配置)
笔记·flutter·harmonyos
●VON3 小时前
Flutter vs React Native vs 原生开发:有何不同?
学习·flutter·react native·react.js·openharmony
白茶三许3 小时前
【OpenHarmony】深入理解 Flutter 异步编程:从基础到实战
flutter·开源·openharmony·gitcode
西西学代码3 小时前
flutter---日历
flutter
kirk_wang3 小时前
Flutter 桌面/Web 开发:用 MouseRegion 打造原生级交互体验
前端·flutter·交互