如何手动将 .xcframework 添加到 Flutter iOS 插件？

Question

我正在尝试创建一个 Flutter 插件以使用本机库。 我尝试使用的这个库存储在一个私有存储库中，可以与 Swift Dependency Manager 一起使用。

这让我很头疼，因为我无法在我的插件中添加私有存储库依赖项（我在 .podspec 文件中找不到这样做的方法），所以我做了什么：

1. 我已使用 Swift 包管理器将插件添加到示例项目中
2. 手动将MyDependency.xcframework文件夹复制到MyPlugin/ios文件夹
3. 在 podspec 文件中引用它，如下所示：

s.preserve_paths = 'MyDependency.xcframework'
s.xcconfig = { 'OTHER_LDFLAGS' => '-framework MyDependency' }
s.vendored_frameworks = 'MyDependency.xcframework'

这样做我可以在插件的源代码中使用 MyDependency。

我目前的问题是：这只适用于模拟器。

在此之前，该项目在真实设备上运行没有任何问题。

这是我每次尝试在真实设备上运行时收到的错误消息：

另外，我已经直接从 Swift Dependency Manager 使用依赖项进行了测试，并且工作正常。我认为问题在于我将框架添加到插件的方式。

Answer 1

我通过在xxx.podspec 中添加以下几行来开始工作：

s.preserve_paths = 'xxxxxx.xcframework/**/*'
s.xcconfig = { 'OTHER_LDFLAGS' => '-framework xxxxxx' }
s.vendored_frameworks = 'xxxxxx.xcframework'

注意s.preserve_paths末尾的/**/*

这是完整的xxx.podspec 文件：

#
# To learn more about a Podspec see http://guides.cocoapods.org/syntax/podspec.html.
# Run `pod lib lint xxx.podspec` to validate before publishing.
#
Pod::Spec.new do |s|
  s.name             = 'xxx'
  s.version          = '1.0.0'
  s.summary          = 'xxx'
  s.description      = <<-DESC
xxx is a flutter plugin
                       DESC
  s.homepage         = 'https://example.com'
  s.license          = { :file => '../LICENSE', :type => 'BSD' }
  s.author           = { 'xxx' => 'email@example.com' }
  s.source           = { :path => '.' }
  s.source_files = 'Classes/**/*'
  s.dependency 'Flutter'
  s.platform = :ios, '10.0'

  # Flutter.framework does not contain a i386 slice.
  s.pod_target_xcconfig = { 'DEFINES_MODULE' => 'YES', 'EXCLUDED_ARCHS[sdk=iphonesimulator*]' => 'i386' }
  s.swift_version = '5.0'

  s.preserve_paths = 'xxxxxx.xcframework/**/*'
  s.xcconfig = { 'OTHER_LDFLAGS' => '-framework xxxxxx' }
  s.vendored_frameworks = 'xxxxxx.xcframework'
end

确保将xxxxxx.xcframework 目录复制到.../xxx/ios/xxxxxx.xcframework（您的插件xxx.podspec 所在的位置）

---

将xxxxxx.xcframework 添加到Pods 方案以便能够导入它

运行flutter命令创建插件ie时，Frameworks目录应该在Pods方案之下。

flutter create --org com.xxx --template=plugin --platforms=android,ios -a java -i swift xxx

来源：Developing packages & plugins

（如果没有，添加它）

1. 导航到Pods方案并右键单击Frameworks
2. 点击Add Files to "Pods"...

1. 导航到ios 目录的根目录，xxxxxx.xcframework 所在的目录
2. 取消选中Copy items if needed
3. 选择Create folder references
4. 检查Pods-Runner
5. 检查您的插件，即。 xxx
6. 点击Add

---

将xxxxxx.xcframework 嵌入到您的项目中

（这应该允许您运行/发布到真实设备）

1. 点击Pods方案
2. 在TARGETS 中选择Pods-Runner
3. 点击General标签
4. 确保xxxxx.xcframework 出现在Frameworks and Libraries 下方（如果没有，请单击+ 添加）
5. 将Embed 更改为Embed & Sign

6. 点击你的插件，即。 xxx
7. 确保xxxxx.xcframework 出现在Frameworks and Libraries 下面
8. 将Embed 更改为Embed & Sign

9. 同样，对于Pods 方案下的两个目标，接下来的步骤应该已经没问题了，但只需检查一下
10. 点击Build Phases
11. 点击Link Binary With Libraries
12. 确保xxxxx.xcframework 存在，如果不存在，请单击+ 并确保Status 设置为Required

现在您应该能够导入框架并在您的代码中引用它，并且应该也可以正常发布。

希望这会有所帮助，祝你好运。我希望这不会很快再次改变

手指交叉

Answer 2

在做了一些研究之后，我发现some links 给了我一个关于真正问题的想法......

为了解决这个问题，我在主项目的构建过程中添加了一个简单的脚本。

此脚本将代码签名添加到内部 .framework 文件中。

cd "${CODESIGNING_FOLDER_PATH}/Frameworks/"

# flatten nested frameworks by copying to APP.app/Frameworks
for framework in *; do
    if [ -d "$framework" ]; then
        if [ -d "${framework}/Frameworks" ]; then
            echo "Moving embedded frameworks from ${framework} to ${PRODUCT_NAME}.app/Frameworks"
            cp -R "${framework}/Frameworks/" .
            rm -rf "${framework}/Frameworks"
        fi
    fi
done

# remove any leftover nested frameworks (i.e. 'PackageName_359AFEED79E48935_PackageProduct.framework')
for framework in *; do
    if [ -d "$framework" ]; then
        if [ -d "${framework}/Frameworks" ]; then
            echo "Removing embedded frameworks from ${framework} to ${PRODUCT_NAME}.app/Frameworks"
            rm -rf "${framework}/Frameworks"
        fi
    fi
done

# codesign for Debugging on device
if [ "${CONFIGURATION}" == "Debug" ] & [ "${SDKROOT}" != *Simulator* ] ; then

    echo "Code signing frameworks..."
    find "${CODESIGNING_FOLDER_PATH}/Frameworks" -maxdepth 1 -name '*.framework' -print0 | while read -d $'\0' framework
    do
        # only sign frameworks without a signature
        if ! codesign -v "${framework}"; then
            codesign --force --sign "${EXPANDED_CODE_SIGN_IDENTITY}" --preserve-metadata=identifier,entitlements --timestamp=none "${framework}"
            echo "Added missing signature to '${framework}'"
        fi
    done
fi