如何对供iOS App与扩展共用的Swift库配置条件编译以解决dylib安全警告?
问题背景
- 开发的供主App和App Extension共用的Swift库,编译时出现警告:
linking against a dylib which is not safe for use in application extensions - 已知警告来源是库未开启
Allow app extension API only选项,但开启该选项后,代码中所有调用UIApplication.shared的位置都会触发编译错误 - 实际业务场景中,App Extension环境根本不需要调用
UIApplication.shared,仅主App环境会执行这部分逻辑 - 已尝试的配置未生效:
- 用条件编译包裹相关代码:
#if !IS_EXTENSION // 结束后台任务 UIApplication.shared.endBackgroundTask(bgTask) #endif - 已在扩展Target的
Active Compilation Conditions中添加IS_EXTENSION标识,同时在App扩展的Preprocessor Macros中设置IS_EXTENSION=1,但库的编译警告依旧存在
- 用条件编译包裹相关代码:
原因定位
- Swift的条件编译判断完全不识别Objective-C风格的
Preprocessor Macros,这类宏仅对OC代码生效,无法触发Swift的#if判断逻辑 - 编译标识的配置位置错误:将
IS_EXTENSION配置在了App Extension业务Target上,但Swift库的编译过程独立于业务Target,自身编译时读取不到业务Target的配置,自然无法识别IS_EXTENSION标识,导致UIApplication.shared的代码块没有被排除在库的编译产物外 Allow app extension API only的检测逻辑是静态扫描库二进制中是否链接了扩展不允许的API,只要编译产物中残留了UIApplication.shared这类禁用API的符号,编译时就会报出不安全的链接警告
解决步骤
- 清理无效配置
- 移除App Extension Target中添加的
IS_EXTENSION=1Preprocessor Macros配置,这类配置对Swift代码无任何作用
- 移除App Extension Target中添加的
- 替换为系统内置的条件编译标识
- 放弃手动自定义
IS_EXTENSION宏,使用苹果内置的EXTENSION编译条件,系统会自动根据当前编译的Target类型设置标识,无需手动同步各Target的配置:#if !EXTENSION // 仅主App环境编译、执行的逻辑 UIApplication.shared.endBackgroundTask(bgTask) #endif
- 放弃手动自定义
- 开启库的扩展安全编译配置
- 选中Swift库的Target,在Build Settings中将
Allow app Extension API Only设置为YES,编译器会自动校验库的二进制是否包含扩展禁用的API
- 选中Swift库的Target,在Build Settings中将
- 编译验证
- 分别编译主App、App Extension两个Target,确认主App下的
UIApplication相关逻辑可正常执行,App Extension环境下无禁用API的编译报错、库的链接警告消失
- 分别编译主App、App Extension两个Target,确认主App下的
内容的提问来源于stack exchange,提问作者Darren
相关产品推荐
相关产品推荐

