升级 Xcode12 和 macOS BigSur 后使用框架时 iOS/macOS 应用程序分发失败

Question

我们无法分发使用我们框架的示例应用程序，而我们的用户也不能。在归档并分发到 AppStore 时，应用程序被拒绝并显示以下消息：

Invalid Bundle - One or more dynamic libraries that are referenced by your app are not present in the dylib search path. If your app contains bitcode, bitcode processing may have failed. Because of these errors, this build of your app will not be able to be submitted for review or placed on the App Store.

该框架包含位代码，或者至少BITCODE_GENERATION_MODE = bitcode在我们的 中有一个构建设置.xcconfig，这基本上意味着 Xcode 将向-fembed-bitcode任何 clang 调用添加构建标志。

从这里开始，我们开始使用Ad-Hoc构建进行测试，以加快我们的试错尝试，这在Rebuild from bitcode选择选项时也会失败。管理器显示包含以下内容的弹出窗口：

ipatool failed with an exception: #<CmdSpec::NonZeroExitException: $ /Applications/Xcode.app/Contents/Developer/usr/bin/python3 /Applications/Xcode.app/Contents/Developer/usr/bin/bitcode-build-tool -v -t /Applications/Xcode.app/Contents/Developer/Toolchains/XcodeDefault.xctoolchain/usr/bin --sdk /Applications/Xcode.app/Contents/Developer/Platforms/iPhoneOS.platform/Developer/SDKs/iPhoneOS14.2.sdk -o /var/folders/vz/b0jj0dms4014y5htfv93svfc0000gn/T/ipatool20201130-52097-13rj9hy/thinned-out/arm64/Payload/iosTest.app/Frameworks/SciChart.framework/SciChart --generate-dsym /var/folders/vz/b0jj0dms4014y5htfv93svfc0000gn/T/ipatool20201130-52097-13rj9hy/thinned-out/arm64/Payload/iosTest.app/Frameworks/SciChart.framework/SciChart.dSYM --strip-swift-symbols /var/folders/vz/b0jj0dms4014y5htfv93svfc0000gn/T/ipatool20201130-52097-13rj9hy/thinned-in/arm64/Payload/iosTest.app/Frameworks/SciChart.framework/SciChart
Status: pid 52150 exit 1
Stdout:
    SDK path: /Applications/Xcode.app/Contents/Developer/Platforms/iPhoneOS.platform/Developer/SDKs/

提供的日志信息量不大，这里是摘录 IDEDistributionPipeline.log

    -= Output =-
    ld: warning: -sdk_version and -platform_version are not compatible, ignoring -sdk_version
    Undefined symbols for architecture arm64:
      "___llvm_profile_runtime", referenced from:
          __hidden#25821_ in 0832.o
          __hidden#25821_ in 0833.o
          __hidden#25821_ in 0834.o
          __hidden#25821_ in 0835.o
          __hid
2020-11-30 16:19:17 +0000  den#25821_ in 0836.o
          __hidden#25821_ in 0837.o
          __hidden#25821_ in 0838.o
          ...
    ld: symbol(s) not found for architecture arm64
    Exited with 1z
    
    Failed to compile bundle: /var/folders/vz/b0jj0dms4014y5htfv93svfc0000gn/T/SciChart6aun_sfs/SciChart.arm64.xar

Stderr:

    from /Applications/Xcode.app/Contents/Developer/usr/bin/ipatool:2808:in `block in CompileOrStripBitcodeInBundle'
    from /Applications/Xcode.app/Contents/Developer/usr/bin/ipatool:2747:in `each'
    from /Applications/Xcode.app/Contents/Developer/usr/bin/ipatool:2747:in `CompileOrStripBitcodeInBundle'
    from /Applications/Xcode.app/Contents/Developer/usr/bin/ipatool:3016:in `block in ProcessIPA'
    from /Applications/Xcode.app/Contents/Developer/usr/bin/ipatool:2978:in `each'
    from /Applications/Xcode.app/Contents/Developer/usr/bin/ipatool:2978:in `ProcessIPA'
    from /Applications/Xcode.app/Contents/Developer/usr/bin/ipatool:3928:in `<main>'
2020-11-30 16:19:17 +0000  /Applications/Xcode.app/Contents/Developer/usr/bin/ipatool exited with 1

在一堆警告之后显示文件末尾的实际错误（我不能包含完整的日志，因为它是太多的原始文本）：

            code = 1061;
            description = "ipatool failed with an exception: #<CmdSpec::NonZeroExitException: ...
            info =             {
            };
            level = ERROR;
            type = exception;

不知道该怎么办，我尝试了不同的构建设置选项，没有任何帮助......已经联系了苹果，但还没有反馈，而且知道他们，我们可以等太久......

这里奇怪的部分是，如果我们直接将 .framework 作为源代码包含在内，然后将应用程序存档 - 一切都按预期工作。如果我们将它包含为XCFramework或仅包含预构建的 .framework - 它会如上所述失败。

我可能会在这里遗漏一些简单或明显的内容，所以如果有人对此有一些见解，请告诉我。

Some system info:
macOS BigSur 11.0.1
XCode Version 12.2 (12B45b)

我们尝试了 macOS 和 Xcode 的不同组合，例如：

Catalina with Xcode 12
BigSur with Xcode 11
etc.

任何帮助是极大的赞赏。谢谢。

Answer 1

长话短说，其中包含 LLVM 工具，这会阻止 AppStore 处理。我在这里写了一篇关于它的完整博客文章 - https://blog.scichart.com/xcframework-xcode-12-and-bigsur-issues/

总而言之，在创建XCFramework分发时需要确保以下几个必要步骤：

• 使用归档版本是必须的，发布版本是不够的
• BUILD_LIBRARY_FOR_DISTRIBUTION必须设置为YES
• SKIP_INSTALL 必须设置为NO
• GCC_INSTRUMENT_PROGRAM_FLOW_ARCS = NO关闭 GCC 检测并将其从二进制文件中删除
• CLANG_ENABLE_CODE_COVERAGE = NO关闭二进制文件中的代码覆盖工具

以上所有内容都有助于解决我们的准备和分发问题，如果您碰巧遇到与我们相同的问题，希望可以为您节省一些时间。