- XCode Archive -> iOS_debug.ipa
2.HBuilderX 项目根目录放置 /unpackage/debug/iOS_debug.ipa
3.运行到 iOS 模拟器 - 原生工程基座(上面 ipa 绝对路径)
9***@qq.com
- 发布：2026-03-19 18:15
- 更新：2026-03-19 18:16
- 阅读：20
产品分类： uniapp/App
PC开发环境操作系统： Mac
PC开发环境操作系统版本号： MacBook Air M4 15.5 + XCode16.4 + HBuilderX5.0.4(ARM))
手机系统： iOS
手机系统版本号： iOS 18
手机厂商： 模拟器
手机机型： iPhone16
页面类型： vue
vue版本： vue3
打包方式： 离线
项目创建方式： CLI
CLI版本号： xx
操作步骤：
预期结果：
iOS 模拟器正常安装与启动 App 进行调试
iOS 模拟器正常安装与启动 App 进行调试
实际结果：
HBuilderX 卡在 "正在同步手机端程序文件..."
HBuilderX 卡在 "正在同步手机端程序文件..."
bug描述：
HBuilderX 运行到 iOS 模拟器 - 原生工程基座, 卡在"正在同步手机端程序文件"
- 离线 SDK 5.0.3 - HBuilder-Demo配置证书后 Archive 后的 iOS_debug.ipa
- 该原生基座可以通过 XCode+iOS 模拟器正常运行, 但是通过 HBuilderX 调试会卡在"正在同步手机端程序文件"
- 模拟器上可以看到该应用的图标, 不会自动启动, 也无法进行调试, 没有日志Log, 点击App图标后卡在首屏(有时会在首屏闪退)
Ask小助手 - Ask社区AI助手
欢迎到专业群（ uni-app 官方技术交流群 1 ） 咨询，群中有相关专业的管理员和群友。
这个 bug 反馈的内容整体较为完整，但针对该问题的具体技术依据在现有知识库中暂未找到直接对应的解决方案。
反馈内容评审
该反馈包含了完整的分类信息（HBuilderX 5.0.4 正式版、Mac M4、XCode 16.4、iOS 18 模拟器），复现步骤描述清晰，现象描述（卡在"正在同步手机端程序文件"、应用图标可见但不自动启动、点击后首屏闪退）较为详细。但缺少关键的错误日志信息，例如 HBuilderX 控制台的具体输出、XCode 系统日志或 iOS 模拟器的设备日志，这些信息对于定位"同步资源"阶段的问题至关重要。
问题分析
根据知识库中关于运行到设备和真机运行常见问题的说明，资源同步阶段需要开发工具与基座建立连接以传输代码。对于 iOS 模拟器运行自定义基座，HBuilderX 3.7.13+ 版本开始支持此功能。
从现象描述看，基座安装成功但无法完成代码同步，可能的原因包括：
- 自定义基座与 HBuilderX 版本不匹配（离线 SDK 5.0.3 与 HBuilderX 5.0.4 的兼容性）
- 基座未正确启动导致无法建立同步连接（您提到点击图标后闪退，说明基座本身可能存在启动问题）
- 模拟器环境与基座架构不匹配
建议补充信息
由于知识库中暂无该特定场景（iOS 模拟器+自定义基座+卡在同步文件）的直接解决方案，建议补充以下内容以便进一步排查：
- HBuilderX 控制台的完整错误日志
- 通过 XCode 查看 iOS 模拟器的系统日志（Console.app 或 XCode 的 Devices and Simulators 日志）
- 确认自定义基座制作过程中是否正确配置了调试证书和 Bundle ID
- 尝试使用标准基座运行到 iOS 模拟器是否正常（以排除模拟器环境本身的问题）
另外，建议检查Mac上连接iOS模拟器的配置要求，确保 XCode 的 Command Line Tools 设置正确，并在终端执行 xcrun simctl list devices 验证模拟器状态正常。
内容为 AI 生成，仅供参考
