在SwiftUI生命周期App中集成CarPlay及CPTemplateApplicationSceneDelegate的方法

SwiftUI生命周期下不需要切回UIKit AppDelegate架构，直接通过系统的Scene路由机制就能对接CarPlay，CarPlay的界面渲染和主App的SwiftUI视图层级完全隔离，走系统的CPTemplate体系。

第一步：前置权限与配置 #

• 先在Xcode的Signing & Capabilities页面对应添加你的App所属类别的CarPlay权限：音频类选CarPlay Audio，导航类选CarPlay Navigation，即时通讯/点餐等其他类别选对应模板权限，权限不匹配会直接导致审核被拒、运行时CarPlay场景不加载。
• 打开Info.plist，配置多场景支持和CarPlay场景映射，核心配置如下：

<key>UIApplicationSceneManifest</key>
<dict>
    <!-- 开启多场景支持 -->
    <key>UIApplicationSupportsMultipleScenes</key>
    <true/>
    <key>UISceneConfigurations</key>
    <dict>
        <!-- 保留主App默认的WindowScene配置，不需要额外修改 -->
        <key>UIWindowSceneSessionRoleApplication</key>
        <array>
            <dict>
                <key>UISceneConfigurationName</key>
                <string>Default Configuration</string>
            </dict>
        </array>
        <!-- 新增CarPlay模板场景配置 -->
        <key>CPTemplateApplicationSceneSessionRoleApplication</key>
        <array>
            <dict>
                <key>UISceneConfigurationName</key>
                <string>CarPlay</string>
                <!-- 绑定你自己实现的CarPlay场景代理类，注意要加模块名前缀 -->
                <key>UISceneDelegateClassName</key>
                <string>$(PRODUCT_MODULE_NAME).CarPlaySceneDelegate</string>
            </dict>
        </array>
    </dict>
</dict>

你现有的@main入口的MyApp结构体不需要做任何修改，原有WindowGroup { ContentView() }的逻辑会自动匹配主App场景，不会影响CarPlay场景加载。

第二步：实现CPTemplateApplicationSceneDelegate #

新建一个继承自UIResponder、遵守CPTemplateApplicationSceneDelegate协议的类，处理CarPlay连接、断开、界面渲染逻辑，示例代码：

import CarPlay

class CarPlaySceneDelegate: UIResponder, CPTemplateApplicationSceneDelegate {
    // 持有CarPlay界面控制器，用来后续跳转、更新模板
    private var interfaceController: CPInterfaceController?
    
    func templateApplicationScene(_ templateApplicationScene: CPTemplateApplicationScene, didConnect interfaceController: CPInterfaceController) {
        self.interfaceController = interfaceController
        
        // 构建CarPlay根界面，根据你的业务选择对应的模板类型
        // 常用模板：CPListTemplate列表、CPGridTemplate宫格、CPNowPlayingTemplate播放页
        let listItems = [
            CPListItem(text: "最近播放", detailText: "查看最近收听内容", handler: { _, completion in
                // 处理点击逻辑，比如跳转到对应二级模板
                completion()
            }),
            CPListItem(text: "我的收藏", detailText: "打开收藏列表", handler: { _, completion in
                completion()
            })
        ]
        let section = CPListSection(items: listItems)
        let rootTemplate = CPListTemplate(title: "首页", sections: [section])
        
        // 设置根模板
        interfaceController.setRootTemplate(rootTemplate, animated: true)
    }
    
    func templateApplicationScene(_ templateApplicationScene: CPTemplateApplicationScene, didDisconnectInterfaceController interfaceController: CPInterfaceController) {
        // 断开连接时清理引用，避免内存泄漏
        self.interfaceController = nil
    }
}

常见注意事项 #

• CarPlay界面强制要求使用系统提供的CPTemplate系列类构建，不能直接把SwiftUI View、UIKit UIView插入CarPlay界面，违反规则会直接触发运行时crash，同时审核会被拒。
• 如果需要和主SwiftUI应用共享状态，可以把状态封装成ObservableObject单例，或者挂在App层级的环境对象中，CarPlaySceneDelegate直接访问单例即可同步状态、响应交互。
• 测试必须使用真机或者Xcode内置的CarPlay模拟器，普通iPhone模拟器无法触发CarPlay场景加载。
• 不同类别的CarPlay App允许使用的模板范围有苹果官方限制，不要尝试使用权限范围外的模板，否则会运行失败。

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