iOS项目中如何消除FooBar框架的隐式导入？

问题背景 #

团队开发中，我们构建了多套框架，某款集成这些框架的App要求必须在指定文件夹内导入FooBar框架，外部导入需触发编译警告。我自定义了一条SwiftLint规则来检测违规导入，但发现规则会误判：即使文件未显式导入FooBar，也能访问该框架（隐式导入），导致规则抛出错误警告。

补充说明：FooBar是同时支持Objective-C和Swift的静态框架，App项目采用混编方式调用其功能。

自定义的SwiftLint规则如下：

oneplayer_import:
    exclude: "somepath"
    regex: "^#?import .*FooBar.*$"
    message: "FooBar frameworks should not be imported outside somepath"
    severity: warning

解决方案 #

1. 从根源消除静态框架的隐式导入 #

静态框架默认会将所有公开符号全局暴露给主项目，导致无需显式导入就能访问。需通过以下方式限制符号暴露范围：

• Objective-C部分：在FooBar框架的伞头文件（FooBar.h）中，仅保留需要对外暴露的头文件，移除不必要的#import；内部类/方法仅用@class声明，具体实现文件中再引入对应头文件。
• Swift部分：仅将需对外暴露的类型/方法标记为public或open，内部类型保持默认internal访问级别；同时检查框架的module.modulemap文件，确保仅声明公开的模块接口。

2. 优化SwiftLint规则避免误报 #

原规则仅检测显式导入语句，需配合隐式导入的修复，同时调整规则配置：

• 确保exclude路径覆盖指定文件夹的所有子目录，改为somepath/**；
• 添加included字段缩小规则作用范围，只检测代码文件：

  oneplayer_import:
      included: ["**/*.swift", "**/*.h", "**/*.m"]
      exclude: "somepath/**"
      regex: "^#?import .*FooBar.*$"
      message: "FooBar框架仅允许在somepath目录内导入"
      severity: warning
  

3. 混编项目的额外配置 #

• Swift调用Objective-C：避免在App全局桥接文件（*-Bridging-Header.h）中导入FooBar头文件，仅在指定文件夹内的局部桥接配置或对应Swift文件关联的桥接文件中导入。
• Objective-C调用Swift：禁止在项目Prefix.pch中全局导入FooBar的Swift生成头文件（FooBar-Swift.h），仅在需要的.m文件中显式导入。

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