iOS SwiftUI项目添加CarPlay功能：实现Hello World求助

第一步：确认权限与Entitlements配置 #

• 打开项目Signing & Capabilities面板，添加CarPlay权限，需根据App类型选择对应权限（如媒体类选Audio，导航类选Maps，信息展示类选择符合苹果规范的对应权限）。
• 确保UIBackgroundModes包含对应权限（如音频类需添加audio），可在info.plist中补充配置：

  <key>UIBackgroundModes</key>
  <array>
      <string>audio</string>
  </array>
  

第二步：完善info.plist配置 #

现有配置缺少主应用场景的基础配置，需保留原UIWindowSceneSessionRoleApplication配置，同时保留CarPlay场景配置，完整的UIApplicationSceneManifest如下：

<key>UIApplicationSceneManifest</key>
<dict>
    <key>UIApplicationSupportsMultipleScenes</key>
    <true/>
    <key>UISceneConfigurations</key>
    <dict>
        <!-- 主应用场景 -->
        <key>UIWindowSceneSessionRoleApplication</key>
        <array>
            <dict>
                <key>UISceneDelegateClassName</key>
                <string>$(PRODUCT_MODULE_NAME).SceneDelegate</string>
                <key>UISceneConfigurationName</key>
                <string>Default Configuration</string>
            </dict>
        </array>
        <!-- CarPlay场景 -->
        <key>CPTemplateApplicationSceneSessionRoleApplication</key>
        <array>
            <dict>
                <key>UISceneDelegateClassName</key>
                <string>$(PRODUCT_MODULE_NAME).CarPlaySceneDelegate</string>
                <key>UISceneConfigurationName</key>
                <string>CarPlay Configuration</string>
            </dict>
        </array>
    </dict>
</dict>

若你的SwiftUI项目无主应用SceneDelegate，可直接使用SwiftUI默认场景配置，或参考第三步的App结构体声明方式。

第三步：适配SwiftUI生命周期（两种方式二选一） #

方式一：App结构体声明CarPlay场景（推荐） #

若项目使用SwiftUI的@main App结构体，无需在info.plist中指定CarPlay的SceneDelegate，直接在App中声明场景：

@main
struct YourAppName: App {
    var body: some Scene {
        // 主应用窗口
        WindowGroup {
            ContentView()
        }
        
        // CarPlay场景
        CPTemplateApplicationScene(role: .application) { scene in
            CarPlaySceneDelegate()
        }
    }
}

方式二：使用SceneDelegate（兼容UIKit生命周期） #

修正后的CarPlaySceneDelegate代码，补充必要导入与错误排查逻辑：

import UIKit
import CarPlay

class CarPlaySceneDelegate: UIResponder, CPTemplateApplicationSceneDelegate {
    var interfaceController: CPInterfaceController?

    func templateApplicationScene(_ templateApplicationScene: CPTemplateApplicationScene, didConnect interfaceController: CPInterfaceController) {
        self.interfaceController = interfaceController
        
        // 创建Hello World信息模板
        let infoItem = CPInformationItem(title: "Hello", detail: "CarPlay")
        let infoTemplate = CPInformationTemplate(
            title: "欢迎",
            layout: .leading,
            items: [infoItem],
            actions: []
        )
        
        // 设置根模板并添加错误打印
        interfaceController.setRootTemplate(infoTemplate, animated: true) { success, error in
            if let error = error {
                print("CarPlay根模板设置失败：\(error.localizedDescription)")
            }
        }
    }
    
    func templateApplicationScene(_ templateApplicationScene: CPTemplateApplicationScene, didDisconnect interfaceController: CPInterfaceController) {
        self.interfaceController = nil
    }
}

第四步：崩溃排查方向 #

若仍出现崩溃，可从以下维度排查：

• 模块名验证：确认$(PRODUCT_MODULE_NAME)与项目实际模块名一致，可直接替换为项目名称（如YourApp）。
• 权限匹配度：CarPlay权限必须与App功能类型匹配，部分权限需苹果审核通过后方可使用。
• 模拟器状态：检查CarPlay模拟器是否与iOS模拟器正常连接，可通过Xcode的Window > Devices and Simulators面板确认。
• 日志定位：查看Xcode崩溃日志，定位具体崩溃原因（如类找不到、权限不足、模板初始化错误等）。

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