dotnet-maui-doctor 实战macOS 上 .NET MAUI 的 Xcode 与 iOS 模拟器安装命令全解析【免费下载链接】skillsRepository for skills to assist AI coding agents with .NET and C#项目地址: https://gitcode.com/GitHub_Trending/skills17/skills本文是围绕 dotnet-maui-doctor 技能中 macOS 安装命令参考文档 的深度展开系统讲解在 macOS 上为 .NET MAUI 开发环境安装、配置与验证 Xcode 及 iOS 模拟器的全部命令与决策要点。读完本文你将掌握一套可复制、可脚本化的 macOS 环境安装流程从下载指定版本 Xcode、安装 Command Line Tools、切换活动 Xcode、接受许可证到按需创建 iOS 模拟器并能将其无缝接入 dotnet-maui-doctor 的「诊断 → 修复 → 复验」工作流。背景macOS 安装命令在 dotnet-maui-doctor 中的定位dotnet-maui-doctor 是当前仓库中用于诊断和修复 .NET MAUI 开发环境问题的技能其核心设计原则是「所有版本要求均从 NuGet 的 WorkloadDependencies.json 动态发现绝不硬编码」。在 SKILL.md 定义的十步工作流中Xcode 相关的校验与修复集中在Task 7Validate XcodemacOS Only与Task 9RemediationTask 7 先执行xcodebuild -version获取当前 Xcode 版本再与 Task 4 从 NuGet 发现的xcode.version范围比对Task 9 进入修复阶段时加载的就是 installation-commands-macos.md 这份 macOS 专属命令清单修复完成后Task 10 要求重新执行相关校验任务直到全部通过。也就是说本文讲解的每一条命令都是该技能在 macOS 上「发现问题 → 执行修复 → 复验」闭环中的实际弹药。技能在 Task 1 检测到平台为 macOS 后会同时加载三份平台参考platform-requirements-macos.md、installation-commands-macos.md 和 troubleshooting-macos.md本文即聚焦其中「安装命令」这一环。Xcode版本匹配优先于「最新版」macOS 上构建 .NET MAUI 的 iOS/Mac Catalyst 目标时Xcode 是绕不开的核心组件。平台要求参考文档 platform-requirements-macos.md 将 Xcode 列为必需项并明确其版本来源为「WorkloadDependencies 中的xcode.version」即由 iOS workload manifest 决定。为什么不能从 App Store 安装 Xcode安装命令文档的第一条硬性警告是不要从 App Store 安装 Xcode—— 它可能自动更新到比 .NET MAUI 支持的版本更新的版本。App Store 的自动更新机制会破坏环境一致性某个 iOS workload manifest 只声明支持某个xcode.version范围而 App Store 静默升级后可能超出该范围导致 MAUI 构建出现与 Xcode 相关的编译或签名错误。这与 dotnet-maui-doctor 一贯的「版本必须钉死pin」原则完全一致——在 eval.yaml 的评测用例中第一条 rubric 就要求技能「警告 Xcode 版本不受控更新的风险并推荐特定的下载来源」。从 Apple Developer Downloads 下载指定版本正确的做法是前往Apple Developer Downloads下载特定版本打开 Apple Developer Downloads根据当前 .NET SDK 对应的 iOS workload manifest 中xcode.version范围选择范围内最好取recommendedVersion的 Xcode 版本下载完成安装将 .app 拖入/Applications或使用安装器。下载环节有三个必须向用户说清的现实约束文档明确标注「Agent 无法自动化此步骤」下载需要登录 Apple ID开启双重认证Xcode 体积约为12 GB可能耗时30 分钟以上因此需要让用户手动下载提前说明体积与等待时间预期Agent 则先继续后续可自动化的步骤等 Xcode 就位后再回来校验。如何发现 xcode.version 范围不硬编码xcode.version来自 iOS workload manifest 包内的WorkloadDependencies.json完整的发现流程见 workload-dependencies-discovery.md。核心链路是Step 1查询releases-index.json获取当前 active 的 SDK 版本并推导 SDK band如10.0.102→ band10.0.100Step 2用dotnet workload search version --format json --take 1获取 workload set 版本如10.0.102→ NuGet 版本10.102.0Step 3下载Microsoft.NET.Workloads.{band}包解出workloadset.json得到各 workload 的manifestVersion/sdkBand映射Step 4按{WorkloadId}.Manifest-{sdkBand}构造包 ID如Microsoft.NET.Sdk.iOS.Manifest-10.0.100下载并解出data/WorkloadDependencies.jsonStep 5解析 iOS workload 的xcode字段。iOS workload manifest 的典型结构{ microsoft.net.sdk.ios: { xcode: { version: [26.2,), recommendedVersion: 26.2 }, sdk: { version: 26.2 } } }其中版本范围的记号约定为[表示包含、(表示不包含。[26.2,)意为「 26.2 且无上限」而[17.0,22.0)意为「 17.0 且 22.0」。安装时应优先选择recommendedVersion并确保其落在version范围内。这正是 installation-commands-macos.md 中「匹配 WorkloadDependencies.json 的 xcode.version 范围」这句话背后的完整实现。Command Line Toolsxcode-select --installXcode 安装完成后或作为独立组件需要确保 Command Line Tools 可用。最简单的方式xcode-select --install该命令会弹出系统安装引导安装clang、git、make等命令行开发工具。在 troubleshooting-macos.md 中当出现xcode-select: error: no developer tools found时修复命令正是它。平台要求文档同时提示 Command Line Tools 应与 Xcode 版本匹配。列出并检查现有 Xcode 安装在决定安装或切换之前先摸清机器上已有哪些 Xcode 版本# 列出 /Applications 下所有 Xcode.app ls -d /Applications/Xcode*.app 2/dev/null # 当前 xcodebuild 工具的版本 xcodebuild -version # 当前选中的 Developer 目录 xcode-select -p三个命令各有用途ls -d /Applications/Xcode*.app用于发现机器上是否存在多份 Xcode常见于下载了新版本但未清理旧版本xcodebuild -version给出实际生效的 Xcode 版本号用于与xcode.version范围比对对应 SKILL.md 的 Task 7xcode-select -p则显示当前 Developer 目录路径判断xcodebuild到底指向哪一份 Xcode。这也是 troubleshooting-macos.md 中 Xcode not found at expected location 的诊断第一步。设置活动 Xcode 版本当机器上存在多个 Xcode或xcodebuild指向了错误版本时需要显式切换sudo xcode-select -s /Applications/Xcode.app/Contents/Developer要点说明-s将指定路径设为活动的 Developer 目录路径必须指向.app内部的Contents/Developer需要sudo提升权限如果你下载的 Xcode 版本号不同如Xcode_26.2.app请把路径中的Xcode.app替换为实际名称。判断实际名称可先用ls -d /Applications/Xcode*.app列出。接受 Xcode 许可证首次使用 Xcode 时系统会要求接受许可协议否则xcodebuild等命令会直接报许可证未接受错误。静默接受适合自动化与 CI 场景sudo xcodebuild -license accept同样需要sudo。若希望交互式阅读协议内容可省略accept直接运行sudo xcodebuild -license。验证 Xcode 安装是否就绪安装、切换、接受许可之后用两条命令完成验证# 确认版本号已落入 WorkloadDependencies.json 的 xcode.version 范围 xcodebuild -version # 确认模拟器运行时可用且存在可用设备 xcrun simctl list devices available第一条对应 dotnet-maui-doctor 的 Task 7 校验逻辑将输出版本与xcode.version范围比对第二条则验证 CoreSimulator 服务与已安装运行时状态是后续创建/使用 iOS 模拟器前的健康检查。若这里失败通常说明模拟器运行时缺失或损坏详见下文常见问题。iOS 模拟器仅在必要时创建iOS 模拟器是 macOS 上运行 iOS 应用如dotnet build -t:Run -f net10.0-ios的载体。安装命令文档给出了一条重要原则只有不存在任何模拟器时才创建且优先选择较新的 iPhone 设备类型搭配最新的可用运行时。第一步检查是否已有模拟器xcrun simctl list devices available如果输出中已有可用设备直接跳过创建步骤——不必要的创建只会堆积冗余设备。第二步查找最新的设备类型与运行时# 列出所有可用设备类型过滤 iPhone xcrun simctl list devicetypes | grep iPhone # 列出所有已安装的 iOS 运行时 xcrun simctl list runtimes | grep iOS从输出中分别记录一个设备类型 ID 与一个运行时 ID例如com.apple.CoreSimulator.SimDeviceType.iPhone-16和com.apple.CoreSimulator.SimRuntime.iOS-26-2实际值以你机器上的输出为准。第三步创建模拟器# 将 DEVICE_TYPE_ID 与 RUNTIME_ID 替换为上一步查到的标识符 xcrun simctl create My iPhone Simulator DEVICE_TYPE_ID RUNTIME_IDsimctl create的三个参数依次为设备名称自定义、设备类型 ID、运行时 ID。创建成功后可用xcrun simctl list devices available再次确认。运行时缺失时的补充处理如果xcrun simctl list runtimes | grep iOS为空说明 iOS 运行时尚未安装。troubleshooting-macos.md 提供了两条途径命令行下载xcodebuild -downloadPlatform iOS图形界面Xcode → Settings → Platforms 中下载 iOS 平台。与 dotnet-maui-doctor 工作流的完整衔接单条命令之外更重要的是把它们放进技能的整体流程中。参照 SKILL.md 的十步工作流macOS 上 Xcode 部分的典型执行顺序是Task 1检测环境sw_vers uname -m确认 macOS 与 CPU 架构加载 macOS 专属参考文档Task 4发现需求按 workload-dependencies-discovery.md 从 NuGet 得到xcode.version/recommendedVersionTask 7校验 Xcodexcodebuild -version比对版本范围xcrun simctl list devices available检查模拟器Task 9修复执行本文的安装命令——让用户手动下载 Xcode →xcode-select --install→sudo xcode-select -s→sudo xcodebuild -license accept→ 必要时xcrun simctl create创建模拟器Task 10复验重跑 Task 7 的命令直到版本入范围且模拟器可用。值得注意的是macOS 平台的 workload 选择也与 Xcode 目标直接相关platform-requirements-macos.md 要求maui、android、ios三个 workload 为必需、maccatalyst为推荐。与 Linux 上必须用maui-android不同macOS 上应安装maui元 workload它会带来全部平台 workload并在安装时使用dotnet workload install maui --version $WORKLOAD_VERSION钉死版本——这也是 eval.yaml 中针对 macOS 场景的硬性评测点之一。端到端验证推荐全部检查通过后建议用「创建并构建一个临时 MAUI 项目」做端到端验证SKILL.md 的 Build VerificationTEMP_DIR$(mktemp -d) dotnet new maui -o $TEMP_DIR/MauiTest dotnet build $TEMP_DIR/MauiTest rm -rf $TEMP_DIR构建成功即证明环境真实可用。若要在 iOS 模拟器上做端到端运行验证可选需先征得用户同意因为会启动模拟器并部署应用# 将 net10.0 替换为当前 .NET 主版本 dotnet build -t:Run -f net10.0-ios dotnet build -t:Run -f net10.0-maccatalystmacOS 常见 Xcode 问题速查结合 troubleshooting-macos.md安装配置 Xcode 时最常遇到的四类问题与处置命令如下报错/症状原因修复命令xcode-select: error: no developer tools foundCommand Line Tools 未安装xcode-select --installXcode not found at expected location活动 Xcode 路径错误或未安装ls -d /Applications/Xcode*.app 2/dev/null后执行sudo xcode-select -s /Applications/Xcode.app/Contents/DeveloperUnable to boot simulator无模拟器 / 运行时缺失 / 模拟器损坏依次尝试xcrun simctl create、xcodebuild -downloadPlatform iOS、xcrun simctl erase allCode signing error配置文件缺失或过期Xcode → Settings → Accounts 添加/刷新 Apple Developer 账号并重新下载 provisioning profiles另外两条 macOS 专属诊断命令也值得常备/usr/libexec/java_home -V用于检测 JDK 安装配合 microsoft-openjdk.md 确认 Microsoft 发行版echo $ANDROID_SDK_ROOT用于确认 Android SDK 位置macOS 默认~/Library/Android/sdk。Xamarin/.NET MAUI 相关日志位于~/Library/Logs/Xamarin/。小结与参考路径macOS 上 .NET MAUI 的 Xcode 与模拟器环境核心纪律只有三条版本来自 NuGet 动态发现而非硬编码、从 Apple Developer Downloads 而非 App Store 获取 Xcode、安装后用xcodebuild -version与simctl完成复验。这套命令既可由开发者手动执行也是 dotnet-maui-doctor 技能在 macOS 上自动修复环境的依据配合 installation-commands.md 中的 workload 与 Android SDK 命令即可覆盖 macOS 上的完整 MAUI 工具链安装。文中涉及的仓库文件均可直接查阅安装命令参考macOS本文核心来源SKILL.md 工作流定义Task 7 / Task 9 / Task 10 与验证流程macOS 平台要求必需组件与 workload 清单Workload 依赖发现xcode.version的 NuGet 发现流程macOS 疑难排查Xcode 常见错误与诊断命令跨平台安装命令workload 与 Android SDK 安装评测用例Xcode 版本钉死与 workload 选择的验收标准【免费下载链接】skillsRepository for skills to assist AI coding agents with .NET and C#项目地址: https://gitcode.com/GitHub_Trending/skills17/skills创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 dotnet-maui-doctor 实战：macOS 上 .NET MAUI 的 Xcode 与 iOS 模拟器安装命令全解析
dotnet-maui-doctor 实战macOS 上 .NET MAUI 的 Xcode 与 iOS 模拟器安装命令全解析【免费下载链接】skillsRepository for skills to assist AI coding agents with .NET and C#项目地址: https://gitcode.com/GitHub_Trending/skills17/skills本文是围绕 dotnet-maui-doctor 技能中 macOS 安装命令参考文档 的深度展开系统讲解在 macOS 上为 .NET MAUI 开发环境安装、配置与验证 Xcode 及 iOS 模拟器的全部命令与决策要点。读完本文你将掌握一套可复制、可脚本化的 macOS 环境安装流程从下载指定版本 Xcode、安装 Command Line Tools、切换活动 Xcode、接受许可证到按需创建 iOS 模拟器并能将其无缝接入 dotnet-maui-doctor 的「诊断 → 修复 → 复验」工作流。背景macOS 安装命令在 dotnet-maui-doctor 中的定位dotnet-maui-doctor 是当前仓库中用于诊断和修复 .NET MAUI 开发环境问题的技能其核心设计原则是「所有版本要求均从 NuGet 的 WorkloadDependencies.json 动态发现绝不硬编码」。在 SKILL.md 定义的十步工作流中Xcode 相关的校验与修复集中在Task 7Validate XcodemacOS Only与Task 9RemediationTask 7 先执行xcodebuild -version获取当前 Xcode 版本再与 Task 4 从 NuGet 发现的xcode.version范围比对Task 9 进入修复阶段时加载的就是 installation-commands-macos.md 这份 macOS 专属命令清单修复完成后Task 10 要求重新执行相关校验任务直到全部通过。也就是说本文讲解的每一条命令都是该技能在 macOS 上「发现问题 → 执行修复 → 复验」闭环中的实际弹药。技能在 Task 1 检测到平台为 macOS 后会同时加载三份平台参考platform-requirements-macos.md、installation-commands-macos.md 和 troubleshooting-macos.md本文即聚焦其中「安装命令」这一环。Xcode版本匹配优先于「最新版」macOS 上构建 .NET MAUI 的 iOS/Mac Catalyst 目标时Xcode 是绕不开的核心组件。平台要求参考文档 platform-requirements-macos.md 将 Xcode 列为必需项并明确其版本来源为「WorkloadDependencies 中的xcode.version」即由 iOS workload manifest 决定。为什么不能从 App Store 安装 Xcode安装命令文档的第一条硬性警告是不要从 App Store 安装 Xcode—— 它可能自动更新到比 .NET MAUI 支持的版本更新的版本。App Store 的自动更新机制会破坏环境一致性某个 iOS workload manifest 只声明支持某个xcode.version范围而 App Store 静默升级后可能超出该范围导致 MAUI 构建出现与 Xcode 相关的编译或签名错误。这与 dotnet-maui-doctor 一贯的「版本必须钉死pin」原则完全一致——在 eval.yaml 的评测用例中第一条 rubric 就要求技能「警告 Xcode 版本不受控更新的风险并推荐特定的下载来源」。从 Apple Developer Downloads 下载指定版本正确的做法是前往Apple Developer Downloads下载特定版本打开 Apple Developer Downloads根据当前 .NET SDK 对应的 iOS workload manifest 中xcode.version范围选择范围内最好取recommendedVersion的 Xcode 版本下载完成安装将 .app 拖入/Applications或使用安装器。下载环节有三个必须向用户说清的现实约束文档明确标注「Agent 无法自动化此步骤」下载需要登录 Apple ID开启双重认证Xcode 体积约为12 GB可能耗时30 分钟以上因此需要让用户手动下载提前说明体积与等待时间预期Agent 则先继续后续可自动化的步骤等 Xcode 就位后再回来校验。如何发现 xcode.version 范围不硬编码xcode.version来自 iOS workload manifest 包内的WorkloadDependencies.json完整的发现流程见 workload-dependencies-discovery.md。核心链路是Step 1查询releases-index.json获取当前 active 的 SDK 版本并推导 SDK band如10.0.102→ band10.0.100Step 2用dotnet workload search version --format json --take 1获取 workload set 版本如10.0.102→ NuGet 版本10.102.0Step 3下载Microsoft.NET.Workloads.{band}包解出workloadset.json得到各 workload 的manifestVersion/sdkBand映射Step 4按{WorkloadId}.Manifest-{sdkBand}构造包 ID如Microsoft.NET.Sdk.iOS.Manifest-10.0.100下载并解出data/WorkloadDependencies.jsonStep 5解析 iOS workload 的xcode字段。iOS workload manifest 的典型结构{ microsoft.net.sdk.ios: { xcode: { version: [26.2,), recommendedVersion: 26.2 }, sdk: { version: 26.2 } } }其中版本范围的记号约定为[表示包含、(表示不包含。[26.2,)意为「 26.2 且无上限」而[17.0,22.0)意为「 17.0 且 22.0」。安装时应优先选择recommendedVersion并确保其落在version范围内。这正是 installation-commands-macos.md 中「匹配 WorkloadDependencies.json 的 xcode.version 范围」这句话背后的完整实现。Command Line Toolsxcode-select --installXcode 安装完成后或作为独立组件需要确保 Command Line Tools 可用。最简单的方式xcode-select --install该命令会弹出系统安装引导安装clang、git、make等命令行开发工具。在 troubleshooting-macos.md 中当出现xcode-select: error: no developer tools found时修复命令正是它。平台要求文档同时提示 Command Line Tools 应与 Xcode 版本匹配。列出并检查现有 Xcode 安装在决定安装或切换之前先摸清机器上已有哪些 Xcode 版本# 列出 /Applications 下所有 Xcode.app ls -d /Applications/Xcode*.app 2/dev/null # 当前 xcodebuild 工具的版本 xcodebuild -version # 当前选中的 Developer 目录 xcode-select -p三个命令各有用途ls -d /Applications/Xcode*.app用于发现机器上是否存在多份 Xcode常见于下载了新版本但未清理旧版本xcodebuild -version给出实际生效的 Xcode 版本号用于与xcode.version范围比对对应 SKILL.md 的 Task 7xcode-select -p则显示当前 Developer 目录路径判断xcodebuild到底指向哪一份 Xcode。这也是 troubleshooting-macos.md 中 Xcode not found at expected location 的诊断第一步。设置活动 Xcode 版本当机器上存在多个 Xcode或xcodebuild指向了错误版本时需要显式切换sudo xcode-select -s /Applications/Xcode.app/Contents/Developer要点说明-s将指定路径设为活动的 Developer 目录路径必须指向.app内部的Contents/Developer需要sudo提升权限如果你下载的 Xcode 版本号不同如Xcode_26.2.app请把路径中的Xcode.app替换为实际名称。判断实际名称可先用ls -d /Applications/Xcode*.app列出。接受 Xcode 许可证首次使用 Xcode 时系统会要求接受许可协议否则xcodebuild等命令会直接报许可证未接受错误。静默接受适合自动化与 CI 场景sudo xcodebuild -license accept同样需要sudo。若希望交互式阅读协议内容可省略accept直接运行sudo xcodebuild -license。验证 Xcode 安装是否就绪安装、切换、接受许可之后用两条命令完成验证# 确认版本号已落入 WorkloadDependencies.json 的 xcode.version 范围 xcodebuild -version # 确认模拟器运行时可用且存在可用设备 xcrun simctl list devices available第一条对应 dotnet-maui-doctor 的 Task 7 校验逻辑将输出版本与xcode.version范围比对第二条则验证 CoreSimulator 服务与已安装运行时状态是后续创建/使用 iOS 模拟器前的健康检查。若这里失败通常说明模拟器运行时缺失或损坏详见下文常见问题。iOS 模拟器仅在必要时创建iOS 模拟器是 macOS 上运行 iOS 应用如dotnet build -t:Run -f net10.0-ios的载体。安装命令文档给出了一条重要原则只有不存在任何模拟器时才创建且优先选择较新的 iPhone 设备类型搭配最新的可用运行时。第一步检查是否已有模拟器xcrun simctl list devices available如果输出中已有可用设备直接跳过创建步骤——不必要的创建只会堆积冗余设备。第二步查找最新的设备类型与运行时# 列出所有可用设备类型过滤 iPhone xcrun simctl list devicetypes | grep iPhone # 列出所有已安装的 iOS 运行时 xcrun simctl list runtimes | grep iOS从输出中分别记录一个设备类型 ID 与一个运行时 ID例如com.apple.CoreSimulator.SimDeviceType.iPhone-16和com.apple.CoreSimulator.SimRuntime.iOS-26-2实际值以你机器上的输出为准。第三步创建模拟器# 将 DEVICE_TYPE_ID 与 RUNTIME_ID 替换为上一步查到的标识符 xcrun simctl create My iPhone Simulator DEVICE_TYPE_ID RUNTIME_IDsimctl create的三个参数依次为设备名称自定义、设备类型 ID、运行时 ID。创建成功后可用xcrun simctl list devices available再次确认。运行时缺失时的补充处理如果xcrun simctl list runtimes | grep iOS为空说明 iOS 运行时尚未安装。troubleshooting-macos.md 提供了两条途径命令行下载xcodebuild -downloadPlatform iOS图形界面Xcode → Settings → Platforms 中下载 iOS 平台。与 dotnet-maui-doctor 工作流的完整衔接单条命令之外更重要的是把它们放进技能的整体流程中。参照 SKILL.md 的十步工作流macOS 上 Xcode 部分的典型执行顺序是Task 1检测环境sw_vers uname -m确认 macOS 与 CPU 架构加载 macOS 专属参考文档Task 4发现需求按 workload-dependencies-discovery.md 从 NuGet 得到xcode.version/recommendedVersionTask 7校验 Xcodexcodebuild -version比对版本范围xcrun simctl list devices available检查模拟器Task 9修复执行本文的安装命令——让用户手动下载 Xcode →xcode-select --install→sudo xcode-select -s→sudo xcodebuild -license accept→ 必要时xcrun simctl create创建模拟器Task 10复验重跑 Task 7 的命令直到版本入范围且模拟器可用。值得注意的是macOS 平台的 workload 选择也与 Xcode 目标直接相关platform-requirements-macos.md 要求maui、android、ios三个 workload 为必需、maccatalyst为推荐。与 Linux 上必须用maui-android不同macOS 上应安装maui元 workload它会带来全部平台 workload并在安装时使用dotnet workload install maui --version $WORKLOAD_VERSION钉死版本——这也是 eval.yaml 中针对 macOS 场景的硬性评测点之一。端到端验证推荐全部检查通过后建议用「创建并构建一个临时 MAUI 项目」做端到端验证SKILL.md 的 Build VerificationTEMP_DIR$(mktemp -d) dotnet new maui -o $TEMP_DIR/MauiTest dotnet build $TEMP_DIR/MauiTest rm -rf $TEMP_DIR构建成功即证明环境真实可用。若要在 iOS 模拟器上做端到端运行验证可选需先征得用户同意因为会启动模拟器并部署应用# 将 net10.0 替换为当前 .NET 主版本 dotnet build -t:Run -f net10.0-ios dotnet build -t:Run -f net10.0-maccatalystmacOS 常见 Xcode 问题速查结合 troubleshooting-macos.md安装配置 Xcode 时最常遇到的四类问题与处置命令如下报错/症状原因修复命令xcode-select: error: no developer tools foundCommand Line Tools 未安装xcode-select --installXcode not found at expected location活动 Xcode 路径错误或未安装ls -d /Applications/Xcode*.app 2/dev/null后执行sudo xcode-select -s /Applications/Xcode.app/Contents/DeveloperUnable to boot simulator无模拟器 / 运行时缺失 / 模拟器损坏依次尝试xcrun simctl create、xcodebuild -downloadPlatform iOS、xcrun simctl erase allCode signing error配置文件缺失或过期Xcode → Settings → Accounts 添加/刷新 Apple Developer 账号并重新下载 provisioning profiles另外两条 macOS 专属诊断命令也值得常备/usr/libexec/java_home -V用于检测 JDK 安装配合 microsoft-openjdk.md 确认 Microsoft 发行版echo $ANDROID_SDK_ROOT用于确认 Android SDK 位置macOS 默认~/Library/Android/sdk。Xamarin/.NET MAUI 相关日志位于~/Library/Logs/Xamarin/。小结与参考路径macOS 上 .NET MAUI 的 Xcode 与模拟器环境核心纪律只有三条版本来自 NuGet 动态发现而非硬编码、从 Apple Developer Downloads 而非 App Store 获取 Xcode、安装后用xcodebuild -version与simctl完成复验。这套命令既可由开发者手动执行也是 dotnet-maui-doctor 技能在 macOS 上自动修复环境的依据配合 installation-commands.md 中的 workload 与 Android SDK 命令即可覆盖 macOS 上的完整 MAUI 工具链安装。文中涉及的仓库文件均可直接查阅安装命令参考macOS本文核心来源SKILL.md 工作流定义Task 7 / Task 9 / Task 10 与验证流程macOS 平台要求必需组件与 workload 清单Workload 依赖发现xcode.version的 NuGet 发现流程macOS 疑难排查Xcode 常见错误与诊断命令跨平台安装命令workload 与 Android SDK 安装评测用例Xcode 版本钉死与 workload 选择的验收标准【免费下载链接】skillsRepository for skills to assist AI coding agents with .NET and C#项目地址: https://gitcode.com/GitHub_Trending/skills17/skills创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考