RealityKit Entity自定义属性在单元测试中触发EXC_BAD_ACCESS崩溃

崩溃原因 #

RealityKit的Entity类及HasModel这类协议依赖完整的RealityKit运行时上下文才能正常初始化。在单元测试的孤立环境中，直接实例化Entity子类时，底层的Objective-C runtime相关结构没有被正确初始化，访问对象属性（或model组件相关的底层内存）时就会触发EXC_BAD_ACCESS野指针错误。

解决方案 #

方案1：拆分初始化逻辑，隔离RealityKit组件代码 #

将模型组件的初始化从init方法中剥离，放到单独的配置方法里。单元测试时可以只初始化实体、测试业务属性，不加载RealityKit相关组件：

修改后的BasicEntity：

class BasicEntity: Entity, HasModel {
    var someProperty: Int?
    
    required init() {
        super.init()
        // 移除init中的RealityKit组件初始化逻辑
    }
    
    /// 单独配置模型组件，在需要渲染的场景中调用
    func configureModel() {
        let mesh = MeshResource.generateBox(size: 0.5)
        let material = SimpleMaterial(color: UIColor.green, isMetallic: false)
        let modelComponent = ModelComponent(mesh: mesh, materials: [material])
        self.model = modelComponent
    }
}

对应的单元测试：

func testPropertyAccess() {
    let basicEntity = BasicEntity()
    basicEntity.someProperty = 1
    XCTAssertNotNil(basicEntity.someProperty)
    XCTAssertEqual(basicEntity.someProperty, 1)
}

如果需要测试模型组件，可在测试中先初始化RealityKit的运行环境（比如创建ARView）：

func testModelComponentConfiguration() {
    // 创建ARView以提供RealityKit运行上下文
    let arView = ARView(frame: CGRect(x: 0, y: 0, width: 100, height: 100))
    let basicEntity = BasicEntity()
    basicEntity.configureModel()
    
    // 将实体添加到场景中确保组件正常生效
    arView.scene.addAnchor(basicEntity)
    
    XCTAssertNotNil(basicEntity.model)
}

方案2：改用UI测试替代单元测试 #

UI测试运行在完整的App进程环境中，RealityKit的运行时上下文会被正常初始化。可以编写UI测试来验证实体的属性和组件逻辑，避免单元测试的环境限制。

内容的提问来源于stack exchange，提问作者Jon Vogel