Flutter插件：iOS与macOS代码共享方案及构建失败问题解决

这种跨iOS/macOS共享代码的思路完全没问题，但你的配置漏掉了几个关键细节，导致Pod无法正确生成插件模块，才出现了no such module 'plugin_name'的错误。我来一步步帮你解决：

1. 确认目录结构与Podspec核心配置 #

首先检查你的目录结构是否符合预期：

你的插件根目录/
├─ common/
│  └─ Classes/
│     ├─ 你的共享Swift/OC文件
│     └─ ...
├─ ios/
│  └─ your_plugin.podspec
└─ macos/
   └─ your_plugin.podspec

然后针对两个平台的.podspec文件，补充/修正以下配置：

• 路径正确性：你写的s.source_files = '../common/Classes/**/*'是对的（因为ios/macos目录相对common是上一级），但要确认路径拼写无错误（比如Classes的大小写、目录是否真的存在）。
• 明确模块名：在podspec里添加一行，确保模块名和你的插件名完全一致：

  s.module_name = 'plugin_name' # 替换成你的实际插件名
  

• OC代码额外配置：如果共享的是OC代码，必须指定公开头文件，否则Pod无法生成可导入的模块：

  s.public_header_files = '../common/Classes/**/*.h'
  

  （Swift代码不需要这一步，但要确保你的Swift类/方法的访问权限是public）

2. 清理缓存，重新构建 #

缓存是这类问题的高发原因，按以下顺序操作：

• 进入iOS和macOS示例项目目录，删除Pods文件夹和Podfile.lock文件。
• 分别在ios和macos目录下执行pod install。
• 回到插件根目录，执行flutter clean，然后flutter pub get。
• 重启Xcode（非常重要！Xcode经常会缓存旧的模块信息）。

3. 检查模块导入的一致性 #

打开GeneratedPluginRegistrant.swift，确认导入语句是import plugin_name，这里的plugin_name必须和你podspec里的module_name、插件pubspec.yaml里的name完全一致（大小写敏感）。

额外提醒：平台特定代码处理 #

如果共享代码里有iOS/macOS专属的API（比如UIKit vs AppKit），记得用条件编译区分，避免编译错误：

#if os(iOS)
import UIKit
// iOS专属代码
#elseif os(macOS)
import AppKit
// macOS专属代码
#endif

完成以上步骤后，重新构建示例项目，应该就能解决模块找不到的问题了。

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