MapLibreParticleLab/docs/报告/STEP-081_iOS_Metal_Renderer与真机Smoke入口_RDC编译验证报告_v1.md

STEP-081 iOS Metal Renderer 与真机 Smoke 入口 RDC 编译验证报告 v1

日期：2026-09-17
状态：DEVICE_BUILD_PASS / WAITING_DEVICE_SMOKE

结果

• CMake ios-metal 配置成功。
• iPhoneOS 26.2 / arm64 / Debug / app target 最终 BUILD SUCCEEDED。
• 未使用 Simulator；因 provisioning 与当前真机 unavailable，最终构建使用 CODE_SIGNING_ALLOWED=NO。
• particle_gpu_validation.cpp 已进入 mbgl-core arm64 编译并通过。
• MBXViewController.mm private Smoke 入口已通过 Objective-C++ arm64 编译。
• 产物：build-ios/platform/ios/app/Debug-iphoneos/app.app，约 61 MB；主程序为 arm64 Mach-O。
• Bundle 内 ParticleSmokeFixtures/T0.qbin 与 T1.qbin SHA-256 与 RN Test Host Golden fixture 完全一致。

RDC 编译期修正

1. Test App private include root 改用 ${CMAKE_SOURCE_DIR}/src，避免子项目 PROJECT_SOURCE_DIR 指向 platform/ios/app。
2. weakSelf 使用显式 MBXViewController * 类型。
3. fixture path 使用 NSString *，移除错误的 const NSString *。
4. 安装/启用仓库锁定的 Bazel 8.6.0 以完成 Darwin generated code。

尚未完成

当前登记 iPhone/iPad 均为 unavailable。因此尚未执行签名安装、设备启动、Metal runtime shader compile，以及 T0 / midpoint / T1 / Clear-release Smoke。STEP-081 不能关闭，下一状态为 WAITING_DEVICE_SMOKE。