用途
本技能用于配置 macOS 上的 Flutter 开发环境,使其可用于构建、运行和部署 Flutter 应用。它会校验包括 Xcode 和 CocoaPods 在内的工具依赖,并确保环境通过 Flutter 针对 macOS 桌面开发的诊断检查。该技能假设宿主操作系统为 macOS,且用户拥有管理员权限。
主要能力与执行流程
技能按以下步骤执行:
-
验证 Flutter 安装。运行 flutter --version 检查 Flutter 是否已安装并在当前环境中可访问。如果命令失败,则停止并询问用户:“Flutter is not installed or not in your PATH. Please install Flutter and add it to your PATH before continuing.”如果成功,则进入下一步。
-
验证 Xcode 安装。运行 xcodebuild -version 确认 macOS 系统已安装 Xcode。若未安装,则停止并询问用户从 Mac App Store 安装最新版 Xcode;若已安装,则继续。
-
配置 Xcode 命令行工具。将 Xcode 命令行工具链接到已安装的 Xcode 版本并运行首次启动设置,提示用户手动执行:sudo sh -c 'xcode-select -s /Applications/Xcode.app/Contents/Developer && xcodebuild -runFirstLaunch'。若 Xcode 安装在非标准目录,需将路径替换为用户的自定义路径。
-
接受 Xcode 许可协议。在编译前必须接受许可协议,提示用户执行:sudo xcodebuild -license。
-
安装 CocoaPods。使用原生 macOS 代码的 Flutter 插件需要 CocoaPods。运行 pod --version 检查;若已安装则继续,若未安装则指导用户通过 Homebrew 或 RubyGems 安装,并提供命令:sudo gem install cocoapods,随后验证安装。
-
校验与修复循环。运行 flutter doctor -v 检查剩余的 macOS 工具链问题,重点分析 Xcode 部分。若存在错误或缺失组件,识别具体缺失依赖,向用户提供确切的修复命令,并重新运行 flutter doctor -v。重复此循环,直到 Xcode 部分报告无问题。
-
验证设备可用性。运行 flutter devices 确保 Flutter 能将 macOS 桌面识别为有效部署目标。检查输出中至少有一项以 “macos” 作为平台;若缺失,则指示用户启用 macOS 桌面支持:flutter config --enable-macos-desktop。
适用场景
适用于需要在 macOS 上建立 Flutter 桌面开发环境、构建或部署 Flutter 应用的场景。技能面向具备管理员权限的 macOS 用户。
限制与约束
技能约束包括:输出或提示中不得包含任何外部 URL 或链接;不得自动运行 sudo 命令,必须暂停并提供确切命令由用户执行;不解释基础终端用法或通用 macOS 概念;在认为技能完成前,必须确保 flutter doctor 的 Xcode 部分完全没有错误;必须假设用户运行在 macOS 环境,不提供 Windows 或 Linux 替代方案。