ReactNative进阶（三十四）：ipa Archive 阶段报错error: Multiple commands produce问题修复及思考

文章目录

    • 一、前言
    • 二、问题描述
    • 三、问题解决
    • 四、拓展阅读
    • 五、拓展阅读

一、前言

在应用RN开发跨平台APP阶段，从git中拉取项目，应用Jenkins进行组包时，发现最终生成的ipa安装包版本号始终与项目中设置的版本号不一致。

二、问题描述

经过仔细排查，发现Jenkins在Archive编译、归档阶段失败，但是后续Export阶段生成了ipa包。

error: Multiple commands produce '/Users/xxx/Library/Developer/Xcode/DerivedData/xxx-eomylkmdzkgaughihoblturddotc/Build/Products/Debug-iphonesimulator/PopNews.app':1) Target 'xxx' has create directory command with output '/Users/xxx/Library/Developer/Xcode/DerivedData/xxx-eomylkmdzkgaughihoblturddotc/Build/Products/Debug-iphonesimulator/PopNews.app'2) That command depends on command in Target 'xxx': script phase “[CP] Copy Pods Resources”

三、问题解决

选中项目 target -> Build phase -> Copy Pods Resources -> Output Files -> 移除 ${TARGET_BUILD_DIR}/${UNLOCALIZED_RESOURCES_FOLDER_PATH} -*

四、拓展阅读

android 中 android/app/build.gradle文件中版本设置如下：

android {compileSdkVersion rootProject.ext.compileSdkVersioncompileOptions {sourceCompatibility JavaVersion.VERSION_1_8targetCompatibility JavaVersion.VERSION_1_8}defaultConfig {applicationId "com.china.shq5785"minSdkVersion rootProject.ext.minSdkVersiontargetSdkVersion rootProject.ext.targetSdkVersionversionCode 18072801versionName "2.2.5"multiDexEnabled truetestBuildType System.getProperty('testBuildType', 'debug')// This will later be used to control the test apk build typetestInstrumentationRunner 'androidx.test.runner.AndroidJUnitRunner'ndk {//设置支持的SO库架构abiFilters "armeabi", "armeabi-v7a", "x86_64" //, "arm64-v8a"}missingDimensionStrategy 'react-native-camera', 'general'}......
}

ios 在配置文件ios/mrcs.xcodeproj/project.pbxproj中，可查看到如下配置信息：

13B07F941A680F5B00A75B9A /* Debug */ = {isa = XCBuildConfiguration;baseConfigurationReference = AA6AA411A14368FB4EEC0CD3 /* Pods-mrcs.debug.xcconfig */;buildSettings = {ASSETCATALOG_COMPILER_APPICON_NAME = AppIcon;CLANG_ENABLE_MODULES = YES;CODE_SIGN_IDENTITY = "iPhone Distribution";CODE_SIGN_STYLE = Manual;CURRENT_PROJECT_VERSION = 1;DEAD_CODE_STRIPPING = NO;DEVELOPMENT_TEAM = U4ALRF5A38;ENABLE_BITCODE = NO;FRAMEWORK_SEARCH_PATHS = ("$(inherited)","$(PROJECT_DIR)/shq5785","$(PROJECT_DIR)",);GCC_PREFIX_HEADER = shq5785/PrefixHeader.pch;GCC_WARN_ABOUT_RETURN_TYPE = NO;HEADER_SEARCH_PATHS = "$(inherited)";INFOPLIST_FILE = shq5785/Info.plist;IPHONEOS_DEPLOYMENT_TARGET = 9.0;LD_RUNPATH_SEARCH_PATHS = "$(inherited) @executable_path/Frameworks";LIBRARY_SEARCH_PATHS = ("$(inherited)","$(PROJECT_DIR)/shq5785",);MARKETING_VERSION = 2.2.5;OTHER_CODE_SIGN_FLAGS = "--deep";OTHER_LDFLAGS = ("$(inherited)","-ObjC","-lc++",);PRODUCT_BUNDLE_IDENTIFIER = com.china.shq5785;PRODUCT_NAME = shq5785;PROVISIONING_PROFILE_SPECIFIER = "1111";SWIFT_OBJC_BRIDGING_HEADER = "$(PRODUCT_MODULE_NAME)/shq5785-Bridging-Header.h";SWIFT_OPTIMIZATION_LEVEL = "-Onone";SWIFT_VERSION = 5.0;VERSIONING_SYSTEM = "apple-generic";};name = Debug;};

五、拓展阅读

iOS 开发的最后一步就是进行 App 的打包和分发，这里分为两个步骤：

  1. Archive：对 Target 进行编译、归档，生成 .xcarchive 文件。

  2. Export：对 .xcarchive 归档文件进一步处理，生成不同渠道的 .ipa 包，进行分发。

当我们在 Xcode 菜单中选择 Product -> Archive 后，编译系统就会对当前的 Xcode 工程进行分析、编译和打包，最终生成目标 Target 的一个 Archive（归档），我们可以在 Window -> Organizer -> Archives 页面查看到所有缓存的历史归档信息：

在这里插入图片描述
所谓的”归档“，就是对源码进行编译后，将此次编译生成的各种文件、资源、记录统一封装到一个地方，方便进行管理和回溯。

右键选择一个归档文件 archive，然后点击 Show in Finder，可以看到它在 Finder 中表示为一个 .xcarchive 后缀的文件。

在这里插入图片描述

这个 .xcarchive 文件包含了应用和它的符号表信息（symbol information）以及其它的相关资源，右键选择显示包内容，可以查看一个 Archive 归档中具体的文件结构：

在这里插入图片描述
其中每个文件夹的含义：

  • BCSymbolMaps
    Xcode 对 BitCode 符号表进行混淆（Symbol Hiding）后生成的对照表，和 dSYM 文件会一一对应。

  • dSYMs
    存储此次编译的符号表（debug symbols），用来符号化解析崩溃堆栈。

  • Products
    存储此次编译生成的的 App 包（.app）。

要注意的是这个包虽然包括了 App 运行需要的可执行文件以及其它资源，但是和最终用户下载的版本会有所不同。后续的 export 操作会对其进行进一步处理。

  • SCMBlueprint
    如果 Xcode 打开了版本管理（Preferences -> Source Control -> Enable Source Control），SCMBlueprint 文件夹会存储此次编译的版本控制信息，包括使用的 git 版本、仓库、分支等。

如果未来想要回溯此次编译的源码版本，可以从这个 SCMBlueprint 中找到必要的信息。

  • SwiftSupport
    如果在 Target 的 Build Settings 中打开了ALWAYS_EMBED_SWIFT_STANDARD_LIBRARIES，此次编译使用的 Swift 版本对应的标准库文件（.dylib）会被放到这个文件夹中。

发布 App 时，这些标准库也会被复制到 ipa bundle 中。

不过现在 Swift 的 ABI 已经稳定了，Xcode 10.2 及以后的版本打出来的包，在 iOS 12.2 及以后的系统的 app bundle 中不用再自带链接库了，节省了一定的体积。

了解 ipa 文件
.ipa(iOS App Store Package) 文件是最终被安装到 iPhone 上的应用格式，包含了运行 App 所必需的的签名、二进制包、资源等内容。

在 Organizer 中无论用什么方式 export 应用的安装包，最终生成的都是一个 .ipa 文件。

.ipa 本身是压缩包文件，如果要查看 ipa 中的内容，可以右键查看包内容，观察解压以后的包，主要包含以下内容：

在这里插入图片描述
App 的签名信息会被放到 _CodeSignature 文件夹中。

  • info.plist
    存储 App 主要信息的 plist 文件也会被一并打包到 ipa 中。

  • entitlements
    entitlement 直译成中文是“权益”、“权限”的意思。

当你在 Capabilities 中开启一些特定的权限时，Xcode 会自动给你生成一个.entitlements 文件，在这个文件中通过 xml 的格式将这些授权记录下来。

App 瘦身
要对 App 安装包体积进行压缩，首先要知道安装包占用的多少空间，这些空间由哪些部分组成，然后再进行针对性的优化。

查看最终用户安装包大小
实际上在 Xcode 本地 archive 出来的 app 包或者 export 出来的 ipa 包和最终用户下载的版本会有所不同（通常体积会大很多）。因为苹果可能会对 App 进行重新编译（如果上传了 BitCode），也会针对不同的设备型号、iOS 版本分发不同的资源（比如 2x、3x 的图片），最后还会对整个 .ipa 进行压缩，以减少从 App Store 下载时耗费的流量。

那么如何估算用户最终下载版本的包体积大小呢？其实在 iTunes Connect 页面可以直接查询到。

打开 iTunes Connect，选择 我的App -> 活动 -> 所有构建版本，然后选择一个要查看的版本：

在这里插入图片描述
找到 App Store 文件大小按钮：

在这里插入图片描述

在弹出的列表中，可以看到在最新版本的 iOS 系统下，不同设备下载的包体积大小：

在这里插入图片描述

列表中的两列：

  • 下载大小：表示通过无线下载的压缩 App 大小；

  • 安装大小：安装后此 App 将在用户设备上占用的磁盘空间大小；

如何分析 App 包 Size？
为了更直观地查看哪些资源占用了 App 安装包的体积，我们可以借助一些文件工具来分析解压后的 ipa 包，比如说 derlien

在这里插入图片描述

可以很直观地看到各种不同类型文件所占的比例。

检查未使用资源
随着 App 的不断迭代，我们往往会无意间引入很多用不到的资源，或者一些资源的引用已经从代码中去除了，但是没有及时从 bundle 中删除，造成 App 包体积的浪费。

为了查找这些不再使用的资源，可以借助开源工具 LSUnusedResources 来检测整个工程。

LSUnusedResources 应用过程如下：

  1. 可以从下面的地址下载 LSUnusedResources
    源码,然后进行编译…

  2. 将源码在Mac上运行,可以看到如下界面:在这里插入图片描述在Project> Path目录中,点击Browse…选择要检测工程的根目录,然后点击Search,开始进行检索…,你可以在下方的日志窗中看到检测结果>

  3. 检测完成后,可以点击Export将此日志导出,然后开始进行清理工作.切勿不管三七二十一直接开删,毕竟是机器检测,不可完全信赖。

针对一些特殊情况，比如代码中使用例如 [UIImage imageNamed:[NSString stringWithFormat:@"icon_tag_%d", index]] 的方式引用资源，LSUnusedResources 也支持使用正则表达式来模糊匹配。

压缩图片
图片文件是安装包中最常见的资源了，常常会占有相当一部分比例，未压缩的图片体积往往相当大，通过一些工具压缩图片资源，节省空间：

  • 无损压缩：ImageOptim

  • 有损压缩：tinypng

使用 Asset Catalogs 存储资源
相比于直接将图片拖入工程目录的方式，使用 Asset Catalogs 会更节省体积。Asset Catalogs 会用一个高度优化的特殊格式来存所有图片，对 png 图片也会进行最大化的压缩。

Xcode 工程模板会自动生成一个 Assets.xcassets 文件，我们也可以按需创建另外的 .xcassets，最终在 ipa 包中，这些 xcassets 都会被压缩到 Assets.car 文件中，一定程度上也保证了安全性。

640?wx_fmt=png

除了图片资源外，Asset Catalogs 也可以存储文本、Data 甚至 AR、apple TV 相关的资源，非常全能，所以比较好的实践就是：

能用 Asset Catalogs 管理的资源，尽量使用 Asset Catalogs 来管理

分析 LinkMap 文件
上面提到，App 包占用空间中很大一部分比例是最终编译生成的可执行文件(MACH-O)，可执行文件的大小不仅和代码体积有关，也受编译器版本、编译选项、链接库、目标架构等影响。

可以通过分析编译时产生的 LinkMap 来了解 MACH-O 文件的组成部分。

要找到对应的 LinkMap，首先在 Xcode Target -> Build Settings -> Write Link Map File 设置为 YES，然后在 Target -> Build Settings -> Path to Link Map File 选项中设置好 LinkMap 的生成地址（一般用 build 文件夹中的默认地址就好了），archive 成功后，我们就可以在对应地址找到该次编译的 LinkMap 了：

640?wx_fmt=png

LinkMap 记录了编译时的链接信息，用来描述可执行文件的构造成分，包括代码段__TEXT 和数据段 __DATA 的分布情况：

640?wx_fmt=png
网上有很多脚本可以对 LinkMap 进行分析统计，比如：

可视化工具

  • js脚本

  • 命令行工具

获取到分析结果后，可以精确了解各个模块、链接库、方法在可执行文件中的位置和占用空间：

640?wx_fmt=png

对于一些占比特别大的模块，常见的优化思路有：

寻找可替代的，小体积的依赖库，或者自己实现

去掉静态库中不需要的指令集，比如 armv7s，x86等，只保留发布需要的 armv7，arm64

提高代码重用性

进一步分析代码中没有被使用的方法、模块，对代码库进行精简。

使用 bitcode
bitcode 是在 LLVM 体系中介于前端语言（OC、Swift、C）和后端语言（X86、ARM的机器码）之间的中间语言。

640?wx_fmt=png

一次完整的编译（从源码到.O目标文件）包含三个主要步骤：

  • 前端(Frontend)：负责把各种类型的源代码编译为 bitcode 中间码表示。

  • 优化(Optimizer)：负责对 bitcode 进行各种类型的优化，将 bitcode 代码进行一些逻辑等价的转换，使得代码的执行效率更高，体积更小。

  • 后端(Backend)：也叫 CodeGenerator，负责把优化后的 bitcode 编译为指定目标架构的机器码，比如 x86、arm64 等等。

可以在 Xcode Target -> Build Settings -> Enable Bitcode 中打开 bitcode 选项，这样在 archive 时，会将中间生成的 bitcode 嵌入到链接后的二进制文件（.o）中，用于提交到 App Store。

上面提到，bitcode 作为 LLVM 的中间语言，是可以从它直接编译出最终程序的，Apple 拿到我们上传的 bitcode 后，会使用最新的技术、编译器针对不同的终端设备重新编译 App，而这些重新编译的版本往往比本地 Xcode 编译的版本体积更小、效率更高。

如果后续需要支持新的平台或者有新的编译技术革新，苹果就不用依赖开发者重新上传了，直接使用现成的 bitcode 编译出新的版本。

值得注意的是：在打包时，如果一些三方的依赖库没有开启 bitcode，或者开启了但是没有在最终引用的链接库中带有 bitcode，那么整个工程就无法用 bitcode 来编译了。

按需加载资源（On-Demand Resources）
iOS9 以后，苹果提供了 On-Demand Resources 功能来减少安装包的体积。可以将一些资源标记为 “按需加载”，在需要使用的时候请求操作系统从 App Store 中下载。这个功能非常适合一些大型游戏、带有付费内容或者大量不常使用的多媒体资源的 App。

在这里插入图片描述

当然，按需加载只是针对 App 使用的资源文件，不包括二进制可执行文件或者源码。

On-Demand Resources 的配置可以很轻松地在 Xcode 中完成。

首先在 Target -> Resource Tags 中创建资源 tag，一个 tag 表示一组可以被独立下载的资源，后面我们就会使用这个 tag 在程序中请求操作系统下载对应的资源包到本地。

640?wx_fmt=png

不同的 tag 包含的资源是可以重复的，App Store 会自己 differ，不会重复下载。

然后找到想要按需加载的资源文件，为它们分配一个或多个之前创建的 tag。

640?wx_fmt=png

最后在代码中，可以使用 NSBundleResourceRequest：

  • 请求下载 on-demand 资源;

  • 将资源标记为已使用状态（这样下载的资源会被清理掉，节省本地空间）;

  • 管理资源下载过程，配置优先级、追踪下载进度等等;

  • 检测磁盘容量警告;

下面的代码是一个简单的资源下载请求：

// 配置要下载的 tags
NSSet *tags = [NSSet setWithObjects: @"birds", @"bridge", @"city"];// 创建 NSBundleResourceRequest 对象
resourceRequest = [[NSBundleResourceRequest alloc] initWithTags:tags];// 请求资源，处理回调
[resourceRequest beginAccessingResourcesWithCompletionHandler: ^(NSError * __nullable error) {if (error) {// 处理错误self.resourcesLoaded = NO;return;}// 下载成功，可以直接使用这些资源了self.resourcesAvailable = YES;}
];

下图总结了一个 on-demand 资源的生命周期：

640?wx_fmt=png

题外话：苹果取消了移动网络下载 150M 的限制，说明随着手机容量的增加和移动网络的普及，大家对 App 安装包体积不再那么敏感了，只要我们遵循一些最佳实践，一般不会在这一块有太大的问题。

本文来自互联网用户投稿，该文观点仅代表作者本人，不代表本站立场。本站仅提供信息存储空间服务，不拥有所有权，不承担相关法律责任。如若转载，请注明出处：http://www.hqwc.cn/news/70039.html

如若内容造成侵权/违法违规/事实不符，请联系编程知识网进行投诉反馈email:809451989@qq.com，一经查实，立即删除！

相关文章

C++11并发与多线程笔记（3）线程传参详解，detach()大坑，成员函数做线程函数

C++11并发与多线程笔记（3）线程传参详解，detach()大坑，成员函数做线程函数

C11并发与多线程笔记（3）线程传参详解，detach 大坑，成员函数做线程函数 1、传递临时对象作为线程参数1.1 要避免的陷阱11.2 要避免的陷阱21.3 总结 2、临时对象作为线程参数2.1 线程id概念2.2 临时对象构造时机抓捕 3、传递类对象…
阅读更多...
Mac OS minicom 无法设置921600问题

Mac OS minicom 无法设置921600问题

MacOS minicom 无法设置921600问题 介绍过程解决方案参考资料 介绍 minicom是Mac上一款非常好用的串口工具。本文假设你已经安装minicom，并且知道minicom的一般配置和使用方法。这是“MacOS minicom 无法设置921600”的解决问题记录。它在以下环境中设置成功&#…
阅读更多...
flutter：webview_flutter的简单使用

flutter：webview_flutter的简单使用

前言 最近在研究如何在应用程序中嵌入Web视图，发现有两个库不错。 一个是官方维护、一个是第三方维护。因为没说特别的需求，就使用了官方库，实现一些简单功能是完全ok的 基本使用 官方文档 https://pub-web.flutter-io.cn/packages/webv…
阅读更多...
ansible 修改远程主机nginx配置文件

ansible 修改远程主机nginx配置文件

安装ansible brew install ansible 或者 pip3 install ansible 添加远程主机 设置秘钥 mac登录远程主机 ssh -p 5700 root192.168.123.211 ssh localhost #设置双机信任 ssh-kyegen -t rsa #设置主机两边的ssh配置文件 vi /etc/ssh/sshd_config/ PermitRootL…
阅读更多...
Python Opencv实践 - 图像金字塔

Python Opencv实践 - 图像金字塔

import cv2 as cv import numpy as np import matplotlib.pyplot as pltimg cv.imread("../SampleImages/pomeranian.png", cv.IMREAD_COLOR) print(img.shape)#图像上采样 #cv.pyrUp(src, dstNone, dstsizeNone, borderTypeNone) #参考资料：https://blo…
阅读更多...
数据库高性能架构模式

数据库高性能架构模式

互联网业务兴起之后，海量用户加上海量数据的特点，单个数据库服务器已经难以满足业务需要，必须考虑数据库集群的方式来提升性能。高性能数据库集群的第一种方式是“读写分离”，第二种方式是“数据库分片”。 1、读写分离架构 **读…
阅读更多...
信息与通信工程面试准备——信号与系统｜10:23

信息与通信工程面试准备——信号与系统｜10:23

8月16日 23:21 目录 ​编辑 1. 调制的作用 2. 放大器与振荡器的作用和区别 工作原理 输出信号 应用 反馈方式 设计复杂度 装置性质 3. 信号与系统：三大变换之间的关系？ 4. 无码间串扰的条件 5. 冲激函数的作用？ 研究的意义&…
阅读更多...
Python系统学习1-9-类(一)

Python系统学习1-9-类(一)

一、类之初印象 1、类就是空表格，将变量（列名）和函数（行为）结合起来 2、创建对象，表达具体行 3、创建类就是创建数据的模板 --操作数据时有提示 --还能再组合数据的行为 --结构更加清晰 4、类的内存分配…
阅读更多...
ChatGPT爆火，会给教育带来什么样的影响或者冲击？

ChatGPT爆火，会给教育带来什么样的影响或者冲击？

近来，人工智能聊天机器人ChatGPT连上热搜，火爆全网。ChatGPT拥有强大的信息整合能力、自然语言处理能力，可谓是“上知天文，下知地理”，而且还能根据要求进行聊天、撰写文章等。 ChatGPT一经推出，便迅速在社…
阅读更多...
c#设计模式-结构型模式 之 桥接模式

c#设计模式-结构型模式 之 桥接模式

前言 桥接模式是一种设计模式，它将抽象与实现分离，使它们可以独立变化。这种模式涉及到一个接口作为桥梁，使实体类的功能独立于接口实现类。这两种类型的类可以结构化改变而互不影响。 桥接模式的主要目的是通过将实现和抽象分离，…
阅读更多...
迅捷视频工具箱：多功能音视频处理软件

迅捷视频工具箱：多功能音视频处理软件

这是一款以视频剪辑、视频转换、屏幕录像等特色功能为主，同时附带有视频压缩、视频分割、视频合并等常用视频处理功能为主的视频编辑软件。该软件操作简单易用，即使没有视频处理经验的用户也可以轻松上手。将视频添加到工具箱对应功能后，简单…
阅读更多...
Ogami Organic Store有机商店WordPress主题

Ogami Organic Store有机商店WordPress主题

Ogami Organic Store有机商店WordPress主题是一个整洁且响应迅速的 WooCommerce WordPress 主题，适用于任何类型的食品、蔬菜店、化妆品或类似网站，这些网站需要功能丰富且美观的在线展示以及优雅灵活的设计。 网址: Ogami Organic Store有机商店WordPr…
阅读更多...
推荐文章
最新文章

Copyright @ 2022~2023