React Native iOS Release编译后导出带provision profile的IPA及Xcode编译问题

问题1：现有.app文件转换为带provision profile的ipa文件 #

• 先校验.app的架构合规性，执行命令查看架构：lipo -info <你的App名>.app/<你的App名>，如果输出包含x86_64模拟器架构，先执行剥离命令：lipo -remove x86_64 <你的App名>.app/<你的App名> -o <你的App名>.app/<你的App名>
• 新建空文件夹命名为Payload，将编译好的.app文件整体移入该文件夹
• 确认对应的provision profile文件路径，默认存储路径为~/Library/MobileDevice/Provisioning Profiles/，也可以直接从Xcode的Signing & Capabilities界面右键导出对应profile
• 执行签名命令重签.app，替换对应参数即可：

  codesign -f -s "Apple Distribution: <你的团队名> (<团队ID>)" --entitlements <你的权限配置文件>.entitlements --provisioning-profile <你的profile文件路径> Payload/<你的App名>.app
  

• 签名完成后将Payload文件夹压缩为zip包，将后缀名改为.ipa，得到的文件即可正常上传Transporter

*补充说明：你之前执行的npx react-native run-ios --configuration Release默认不会读取Xcode中为Archive配置的正式发布provision profile，所以生成的.app本身不带发布所需的签名信息，才会出现上传报错的问题。如果不想手动处理签名，可以直接用CLI自带的打包命令生成xcarchive再导出ipa，不会触发Xcode界面的链接报错：

1. 生成xcarchive：npx react-native build-ios --configuration Release --scheme <你的AppScheme> --archive-path ./build/Release-ios/YourApp.xcarchive
2. 准备exportOptions.plist配置文件，指定provision profile对应关系后执行导出：xcodebuild -exportArchive -archivePath ./build/Release-ios/YourApp.xcarchive -exportPath ./build/ipa -exportOptionsPlist ./exportOptions.plist

问题2：React CLI编译正常、Xcode直接编译失败的原因 #

核心差异是两者调用xcodebuild时的参数和读取的配置上下文不一致：

• React Native CLI调用xcodebuild时会自动读取node_modules下所有原生依赖的pod配置，自动注入依赖库的搜索路径参数，不会出现找不到链接库的问题
• 你直接用Xcode编译报错Library not found for -lBVLinearGradient，大概率是两种情况：
  • 你打开的是.xcodeproj文件而非.xcworkspace文件，CocoaPods管理的依赖库只有在xcworkspace下才会正常加载
  • 你的App Target的Build Settings中Library Search Paths配置缺少react-native-linear-gradient对应的路径，CLI执行时会临时注入该路径，而Xcode界面编译时没有读取到该配置
• 修复Xcode编译问题的方法：打开项目的.xcworkspace文件，在App Target的Build Settings的Library Search Paths中添加一行$(SRCROOT)/../node_modules/react-native-linear-gradient/ios，设置为recursive即可，修复后可直接用Xcode执行Archive打包，流程更规范。

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