教你实现一个 iOS 重签名工具-六虎

作者：crazyball

一. 前语

对于 iOS 开发者来说，重签名技术应该说是比较熟悉的，而且重签名的完结脚本网上已经有很多，完结逻辑上根本也差不多，其间不乏像 iOS App Signer 这样优异的重签名东西。

可是，由于不同的业务场景下，不同证书和不同包体的重签名意图都不相同，很难一个东西满意一切开发者的需求。目前团队的测验流程是对游戏包重签名后，再装置到测验设备上进行测验，在日常的重签打包工作下，发现部分游戏包在重签名后存在一些问题（装置不上，某些权限功用不能用等），而用 Xcode 进行 Archive 操作后在 Xcode Organizer 中导出的包体不会出现异常。所以选用 Xcode 的 xcodebuild 指令的 -exportArchive 指令来进行重签名，发现重签名的成功率和包体稳定性提高了很多。

二. iOS 签名机制

在了解重签名之前，咱们先来了解一下 ipa 包的签名机制

开发者 Mac 系统中生成一对非对称加密算法的公私钥 M，将公钥和开发者信息生成 CSR 文件给到苹果服务器

苹果有自己的公私钥 K，其间公钥 K 存在每一台的 iPhone 设备上，私钥 K 则保存在苹果服务器。依据 CSR 内容运用私钥 K 进行签名并生成证书，一起也依据在开发者后台填写的信息（Bundle ID，权限等）和证书生成描绘文件（mobileprovision）

在开发者设备上打包时，会把描绘文件一并打包到 ipa 中，并运用私钥 M 对包的内容进行签名

在装置到设备上时，会进行两次验证：

运用设备上的公钥 K 校验 ipa 包内的证书文件（证书是经过苹果私钥 K 签名），校验证书是否有用

上一步证书校验经过后，会拿出证书内的公钥 M 来校验 ipa 包（ipa 包是经过开发者私钥 M签名），校验 ipa 包是否可装置

苹果经过以上的双重验证机制，来确保在开发阶段 App 的装置行为的合法性。当将 App 提交到 App Store 后，苹果会对 App 从头加密签名，装置时就只需验证苹果的签名。

三. 重签名脚本

重签名的流程大致能够分红以下 5 个过程，下面列出其间的要害指令：

#!/bin/sh
set -e

# 这儿只列出重签名脚本的大致流程
# 根本能够分为以下 5 个过程

# 1. 解压游戏包，删去包内无用内容（.DS_Store，__MACOSX等），如需求，修正Info.plist参数和图标等资源
unzip "ipa途径" -d "方针途径"
find -d "解压后的途径" -name .DS_Store -o -name __MACOSX | xargs rm -rf

# 2. 对需求重签的内容并重签名
find -d "包体途径" \
-name "*.app" -o \
-name "*.appex" -o \
-name "*.framework" \
-o -name "*.dylib" \
| xargs -I {} /usr/bin/codesign --continue -f -s "证书称号" {}

# 3. 找出 appex 里边的 bundle id
find -d "包体途径" -name "*.appex" \
| xargs -I {} /usr/libexec/PlistBuddy -c "Print :'CFBundleIdentifier'" {}/Info.plist

# 4. 修正 xcarchive 模板信息
#    仿制 .app 文件到 xcarchive 的 Products/Applications 目录下
#    修正 xcarchive 内的 Info.plist 和 ExportOptions.plist 包名，证书称号，描绘文件称号等信息

# 5. 导出ipa包
xcodebuild -exportArchive \
-archivePath "xcarchive途径" \
-exportOptionsPlist "ExportOptions.plist途径" \
-exportPath "导出途径"

1. 解压 ipa 并修正包内容

删去包体内无用文件（.DS_Store，__MACOSX 等系统文件）
读取并修正 Info.plist 参数（Bundle ID，版别号，运用称号等信息）
如需求，可修正包内 icon 等资源文件

2. codesign 指令重签名

这一步与其他的重签脚本有点不相同，以 iOS App Signer 的逻辑为例，需求先将 mobileprovision 仿制到包内改名为 embedded.mobileprovision，并从中提取 Entitlements 相关参数作为 codesign 的参数来重签的。

现在的流程是：不需求手动去替换包内的 embedded.mobileprovision 文件，由于后续的 xcodebuild -exportArchive 指令履行时会主动完结替换，所以 codesign 指令也是不需求 --entitlements 参数的。

3. 读取 appex 的 Bundle ID

appex 是什么？appex 其实便是 Plugins 目录下的内容，是 App 的插件（Extension），像 VPN、告诉等功用的包就需求插件来完结。一个 appex 其实能够理解为一个小型 App（仅仅需求依赖 App 才干运行），所以假如有开发过 Extension 功用的同学就会知道，Appex 也是会有独立的证书、描绘文件和 Info.plist。所以这一步需求读取一切 Appex 的 Bundle ID，由于后续的签名需求用到。

4. 修正 xcarchive 内容

依据最终一步的 xcodebuild -exportArchive 指令，咱们需求传一个 xcarchive 途径和 ExportOptions.plist 途径。（ xcarchive 便是咱们在 Xcode -> Product -> Archive 的产品。）

xcarchive 途径下的内容：

BCSymbolMaps：符号文件，Xcode 对 BitCode 符号表进行混淆（Symbol Hiding）后生成的对照表，和 dSYM 文件会一一对应。
dSYMs：存储此次编译的符号表（debug symbols），用来符号化解析崩溃库房。
Info.plist：xcarchive 的信息
Products：存储此次编译生成的的 App 包（.app）。
SCMBlueprint：假如 Xcode 打开了版别管理（Preferences -> Source Control -> Enable Source Control），SCMBlueprint 文件夹会存储此次编译的版别操控信息，包含运用的 git 版别、库房、分支等。
SwiftSupport：假如你在 Target 的 Build Settings 中打开了 ALWAYS_EMBED_SWIFT_STANDARD_LIBRARIES，此次编译运用的 Swift 版别对应的规范库文件（.dylib）会被放到这个文件夹中。

首要，咱们需求替修正目录下 Info.plist 的参数，并且把 Products/Applications 下的 app 文件替换为需求重签名的 App。

另一个 ExportOptions.plist 文件是咱们导出 ipa 包的所需求参数，也是运用 Xcode 导出 ipa 包时的产品之一。

ExportOptions.plist 文件内容需求修正以下字段：

5. 重签名并导出 ipa

最终，只需求把 xcarchive 目录和 ExportOptions.plis 的内容修正成需求重签名包的内容，就能够运用 xcodebuild -exportArchive 指令来重签名和导出包体。

四、总结

其完结在网上已经有非常多优异 iOS 重签名脚本，根本能满意大多数开发者运用。可是假如期望确保重试的成功率，与 Xcode 打包相同精确的话，运用 xcodebuild -exportArchive 构建 ipa 包显然是目前最优的解决方案。

以上便是咱们内部现在运用的重签脚本的完结思路，为了方便大家了解具体的完结思路，小编也依据这个逻辑写了一个 Mac 版的重签东西，方便学习一起也能直接运用。最终，欢迎大家来运用和提出主张~~

37iOS/Easy-Signer: iOS App 的 Mac 重签名东西

五、参考

DanTheMan827/ios-app-signer
iOS运用安全3 — APP重签名 –
iOS主动化打包之重签名导出不同证书ipa探究 – 简书

教你实现一个 iOS 重签名工具

一. 前语

二. iOS 签名机制