拿到一台新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 感兴趣,可以订阅我的专栏:

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

相关推荐
恋猫de小郭21 分钟前
2025 年终醒悟,AI 让我误以为自己很强,未来程序员的转型之路
android·前端·flutter
2501_9159184135 分钟前
iOS 开发中证书创建与管理中的常见问题
android·ios·小程序·https·uni-app·iphone·webview
00后程序员张1 小时前
IOScer 开发环境证书包括哪些,证书、描述文件与 App ID 的协同管理实践
android·ios·小程序·https·uni-app·iphone·webview
江东小bug王1 小时前
深入理解 UITabBarController:代理方法与 ViewController 生命周期的执行顺序(含 UINavigationController 场景)
ios
_大学牲1 小时前
Flutter 勇闯2D像素游戏之路(五):像元气骑士一样的设计随机地牢
flutter·游戏·游戏开发
阿里云云原生1 小时前
RUM 赋能 iOS App 稳定:从异常体系到监控方案的全方位解析!
ios·云原生
Zfox_2 小时前
无缝穿越系统边界:节点小宝4.0如何让我的Mac/iOS像访问本地盘一样操控Windows
windows·macos·ios·节点小宝
音浪豆豆_Rachel4 小时前
Flutter鸿蒙化之深入解析Pigeon非空字段设计:non_null_fields.dart全解
flutter·harmonyos
Zender Han4 小时前
Flutter 图片裁剪插件 image_cropper 最新版介绍与使用教程
android·flutter·ios
子榆.5 小时前
Flutter 与开源鸿蒙(OpenHarmony)实时音视频通话实战:基于 AVSession 与 Native 音视频栈构建安全通信应用
flutter·开源·harmonyos