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

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

相关推荐
疯狂的程序猴1 小时前
iOS 多技术栈混淆实现,跨平台 App 混淆拆解与组合
后端·ios
左手厨刀右手茼蒿3 小时前
Flutter 三方库 firebase_admin 跨云边管线企业级鸿蒙管控底座适配风云:无障碍贯穿服务器授权防火墙打通底层生态授权域并构建海量设备推送集结-适配鸿蒙 HarmonyOS ohos
服务器·flutter·harmonyos
钛态3 小时前
Flutter for OpenHarmony:shelf_web_socket 快速构建 WebSocket 服务端,实现端到端实时通信(WebSocket 服务器) 深度解析与鸿蒙适配指南
服务器·前端·websocket·flutter·华为·性能优化·harmonyos
亚历克斯神3 小时前
Flutter 三方库 at_server_status 的鸿蒙化适配指南 - 在鸿蒙系统上构建极致、透明、实时的 @protocol 去中心化身份服务器状态感知与鉴权监控引擎
flutter·华为·harmonyos
左手厨刀右手茼蒿5 小时前
Flutter 三方库 k_m_logic 的鸿蒙化适配指南 - 构建声明式的业务逻辑状态机、助力鸿蒙端复杂交互流程的解耦与重构
flutter·harmonyos·鸿蒙·openharmony·k_m_logic
钛态5 小时前
Flutter 三方库 result_type 深入鸿蒙强类型返回栈跨界交互适配:肃清空指针回调与运行时崩溃、大幅增注接口安全壁垒且提升多隔离桥接数据抛出健壮性-适配鸿蒙 HarmonyOS ohos
flutter·交互·harmonyos
左手厨刀右手茼蒿5 小时前
Flutter 三方库 invertible 的鸿蒙化适配指南 - 实现极致的撤销与重做流、助力鸿蒙端高交互编辑类应用开发
flutter·harmonyos·鸿蒙·openharmony
恋猫de小郭5 小时前
2026 AI 时代下,Flutter 和 Dart 的机遇和未来发展,AI 一体化
android·前端·flutter
2501_916008895 小时前
iOS开发者工具有哪些?Xcode、Fastlane 与 kxapp 的组合使用
ide·vscode·macos·ios·个人开发·xcode·敏捷流程
加农炮手Jinx5 小时前
Flutter 三方库 fast_i18n 的鸿蒙化适配指南 - 掌握类型安全的国际化编译技术、助力鸿蒙应用构建全球化且极速响应的多语言交互体系
flutter·harmonyos·鸿蒙·openharmony·fast_i18n