React Native CarPlay应用在iPhone App终止时无内容显示求助

问题详情 #

当iPhone端App完全终止时，点击CarPlay模拟器里的应用图标，屏幕显示空白；但iPhone端App处于后台或活跃状态时，所有功能正常。对比Spotify、Tidal这类应用，它们在iPhone端App终止时仍能正常加载CarPlay内容。

当前负责CarPlay的代码片段：

import Foundation
import CarPlay
class SceneDelegateCarPlay: UIResponder, CPTemplateApplicationSceneDelegate {
...
func templateApplicationScene(_ templateApplicationScene: CPTemplateApplicationScene, didConnect interfaceController: CPInterfaceController) {
    print("SceneDelegateCarPlay.templateApplicationScene(), didConnect")
    // 内容渲染逻辑
    ...
}
}

目前只有以下两种情况能触发内容渲染：

• CarPlay应用关闭，且iPhone App处于活跃/后台状态时，点击CarPlay图标
• CarPlay应用已打开（空白），且iPhone App处于终止状态时，启动iPhone App

需要实现的是：iPhone端App终止时，直接点击CarPlay图标就能加载内容

解决步骤 #

1. 修正Info.plist的CarPlay场景配置 #

确保Info.plist中正确配置CarPlay场景的激活条件，允许CarPlay独立唤醒应用：

<key>UIApplicationSceneManifest</key>
<dict>
    <key>UISceneConfigurations</key>
    <dict>
        <key>CPTemplateApplicationSessionSceneRoleApplication</key>
        <array>
            <dict>
                <key>UISceneConfigurationName</key>
                <string>CarPlay Configuration</string>
                <key>UISceneDelegateClassName</key>
                <string>$(PRODUCT_MODULE_NAME).SceneDelegateCarPlay</string>
                <key>UISceneActivationConditions</key>
                <dict>
                    <key>UISceneActivationConditionCanActivateForTargetContentIdentifier</key>
                    <string>*</string>
                    <key>UISceneActivationConditionPrefersToActivateForTargetContentIdentifier</key>
                    <string>*</string>
                </dict>
            </dict>
        </array>
    </dict>
</dict>

2. 在AppDelegate中处理CarPlay场景的启动请求 #

当iPhone App终止时，CarPlay的启动请求会走到AppDelegate的场景配置方法，这里要返回正确的CarPlay场景配置，确保应用能被唤醒并初始化：

@main
class AppDelegate: UIResponder, UIApplicationDelegate {
    func application(_ application: UIApplication, configurationForConnecting connectingSceneSession: UISceneSession, options: UIScene.ConnectionOptions) -> UISceneConfiguration {
        if connectingSceneSession.role == .templateApplicationSession {
            let carPlayConfig = UISceneConfiguration(name: "CarPlay Configuration", sessionRole: connectingSceneSession.role)
            carPlayConfig.delegateClass = SceneDelegateCarPlay.self
            return carPlayConfig
        }
        // 其他场景的默认配置
        return UISceneConfiguration(name: "Default Configuration", sessionRole: connectingSceneSession.role)
    }
}

3. 让CarPlay场景的渲染逻辑独立 #

不要让templateApplicationScene(_:didConnect:)依赖iPhone端React Native的状态。可以先展示一个基础的加载模板或者默认菜单，确保CarPlay界面先有内容，后续再和React Native同步数据。比如：

func templateApplicationScene(_ templateApplicationScene: CPTemplateApplicationScene, didConnect interfaceController: CPInterfaceController) {
    print("SceneDelegateCarPlay.templateApplicationScene(), didConnect")
    // 先展示一个基础菜单
    let menuItem = CPTextButton(title: "首页", handler: { _ in
        // 后续跳转逻辑
    })
    let menuTemplate = CPListTemplate(title: "我的应用", sections: [CPListSection(items: [menuItem])])
    interfaceController.setRootTemplate(menuTemplate, animated: true)
    
    // 再初始化React Native桥接并同步数据
    setupReactNativeBridge()
}

4. 提前初始化React Native桥接（如果需要） #

如果CarPlay内容依赖React Native模块，在SceneDelegateCarPlay的scene(_:willConnectTo:options:)方法中提前初始化桥接，不用等主场景启动：

func scene(_ scene: UIScene, willConnectTo session: UISceneSession, options connectionOptions: UIScene.ConnectionOptions) {
    // 初始化React Native桥接
    let bridge = RCTBridge(delegate: self, launchOptions: nil)
    // 保存桥接实例供后续使用
}

5. 测试独立启动流程 #

终止iPhone端App后，直接在CarPlay模拟器点击应用图标，检查templateApplicationScene(_:didConnect:)是否被调用。如果没触发，检查Info.plist配置和AppDelegate的场景逻辑是否正确。

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