如何在最低兼容iOS12的应用中适配iOS15 CarPlay功能

核心逻辑 #

iOS系统会自动忽略自身不识别的Info.plist配置项，直接添加Scene相关配置不会导致iOS12设备崩溃，仅需要对CarPlay相关实现做版本分支判断即可。

具体操作步骤 #

• 第一步：正常在Info.plist添加Application Scene Manifest配置，完整结构参考如下：

<key>UIApplicationSceneManifest</key>
<dict>
    <key>UIApplicationSupportsMultipleScenes</key>
    <false/>
    <key>UISceneConfigurations</key>
    <dict>
        <key>CPTemplateApplicationSceneSessionRoleApplication</key>
        <array>
            <dict>
                <key>UISceneConfigurationName</key>
                <string>CarPlaySceneConfig</string>
                <key>UISceneDelegateClassName</key>
                <string>$(PRODUCT_MODULE_NAME).CarPlaySceneDelegate</string>
            </dict>
        </array>
    </dict>
</dict>

iOS12系统读取到这个陌生key时会直接跳过，不会产生任何运行时错误。

• 第二步：拆分CarPlay实现逻辑做版本适配

  • iOS12~iOS12.5版本：沿用原有已废弃的CPApplicationDelegate相关实现，所有旧API的调用都包裹在@available(iOS 12.0, *)判断中
  • iOS13及以上版本：使用新的CPTemplateApplicationSceneDelegate实现CarPlay功能，相关代码包裹在@available(iOS 13.0, *)判断中

• 第三步：在AppDelegate中添加Scene生命周期的版本判断

// OC示例
- (UISceneConfiguration *)application:(UIApplication *)application configurationForConnectingSceneSession:(UISceneSession *)connectingSceneSession options:(UISceneConnectionOptions *)options API_AVAILABLE(ios(13.0)) {
    if ([connectingSceneSession.role isEqualToString:CPTemplateApplicationSceneSessionRoleApplication]) {
        return [UISceneConfiguration configurationWithName:@"CarPlaySceneConfig" sessionRole:connectingSceneSession.role];
    }
    // 其他Scene配置返回逻辑
    return nil;
}

// Swift示例
@available(iOS 13.0, *)
func application(_ application: UIApplication, configurationForConnecting connectingSceneSession: UISceneSession, options: UIScene.ConnectionOptions) -> UISceneConfiguration? {
    if connectingSceneSession.role == .carPlayTemplateApplication {
        return UISceneConfiguration(name: "CarPlaySceneConfig", sessionRole: connectingSceneSession.role)
    }
    // 其他Scene配置返回逻辑
    return nil
}

验证注意事项 #

• 分别用iOS12模拟器/真机、iOS15及以上版本的模拟器/真机测试CarPlay功能触发逻辑
• 检查编译时是否有版本相关的警告，确保所有高版本API都做了可用性判断
• 确认打包后的Info.plist中CarPlay相关的权限（NSCarPlayUsageDescription等）配置完整

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