基于CarPlay框架开发的音频应用在iOS13及更早版本运行崩溃

你遇到的崩溃是因为CPNowPlayingAddToLibraryButton、CPNowPlayingRepeatButton等相关类是iOS 14才首次加入CarPlay框架的API，iOS 13及更低版本的系统中不存在这些类的实现。默认强链接框架的情况下，App启动时dyld会尝试加载所有依赖的符号，找不到就会直接触发崩溃，哪怕你逻辑上不会在低版本执行这些代码。

1. 把CarPlay框架设置为弱链接 #

打开Xcode项目配置，进入Build Phases → Link Binary With Libraries，找到CarPlay.framework，将右侧的Status从默认的Required改为Optional。
弱链接后，系统启动时如果发现缺失对应类的符号，会自动将类指针置为nil，不会直接触发崩溃。

2. 代码层面加版本校验 #

所有调用iOS 14+专属CarPlay类的代码，必须包裹在系统版本判断分支中，低版本分支走Media Player框架的原有逻辑，示例代码如下：

if (@available(iOS 14.0, *)) {
    // iOS 14及以上版本才执行CarPlay框架逻辑
    CPNowPlayingAddToLibraryButton* addToButton = [[CPNowPlayingAddToLibraryButton alloc] initWithHandler:^(CPNowPlayingAddToLibraryButton* button) {
        // 你的业务逻辑
    }];
    // 其他使用该类的逻辑都要放在该分支内
} else {
    // iOS 13及以下版本走Media Player框架实现
}

• 两个步骤缺一不可，只加版本判断不做弱链接，App在低版本启动时依然会因为找不到符号崩溃
• 如果上述iOS 14+专属类被用作属性、成员变量，建议用API_AVAILABLE(ios(14.0))标记，避免编译警告和误调用
• 所有涉及低版本不支持的CarPlay API的调用，都要记得做版本和类存在性校验

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