需求

DONE

  • 生成可以在 iOS 上直接安装的 ipa 包。
  • Debug Release 版本选择。
  • 有默认配置，可以通过命令行修改预设参数。

TODO

  • Android 版本的打包。
  • 支持上传到 Fir.im、蒲公英 等等。
  • 记录环境信息，包括：Unity 版本、Xcode 版本、Ruby 版本。
  • 记录所有程序输出的日志，方便查找错误。
  • 可以使用指定版本构建。
  • 计时，记录每一步消耗的时间。

过程

语言

这种打包脚本使用操作系统自带的脚本语言最方便。第一选择是 Python，但是之前写过类似的，这次就想换 Ruby 尝试一下，最终决定使用 Ruby 来编写这个工具。 Ruby 本身用起来非常简单，OS X 自带的 Ruby 版本 2.0.0，已经非常成熟了。

提示：使用 ls 这种语法调用时请不要使用中文路径，中文在路径中会消失，而不管 Ruby 源文件是否是 utf-8 编码。

提示：在使用字符串时需要双引号使用，以方便在其中嵌入变量，同时应对所有命令中变化的值使用 \" 引用，防止为空时出错。此处不应使用 \'，在 shell 中，\' 并不会对字符串中的内容进行转义！

Unity

从命令行调用参考官方文档 Unity - Manual: Command line arguments 即可。 Unity 内部需要辅助静态函数来打包，这里使用到了之前写的一个库：networm/Infinity.BuildInUnity3d

BuildInUnity3d 库的作用就是套一层封装，同时配合 Build 库实现构建 Debug 与 Release 版本。 因为 Unity 不支持传递自定义参数，即使传递了自定义参数，使用 System.Environment.GetCommandLineArgs() 也无法获取，最终变通方法是使用不同的构建函数：BuildPlayerDevelop() 与 BuildPlayerRelease()。

提示：Unity 的日志输出可以重定向到标准输出（即终端中），只要在调用时指定参数 -logFile $stdout。

Xcode

xcode 构建这里麻烦一些，涉及到的步骤较多：

  • 安装 mobileprovision
  • 创建并解锁 keychain
  • 导入 p12 开发者私钥与证书
  • 编译、打包

codesign

有关如何禁止 codesign 签名时弹窗，网上有很多方案，但是只有代码，并没有解释得很清楚。

codesign 在签名时会使用两样东西：keychain 与 private key。其中 private key 存储在 keychain 中。 codesign 在签名时会寻找系统指定的 keychain 搜索列表。不要被 codesign 的 --keychain filename 选项蒙蔽，这个选项要求 filename 必须在 keychain 搜索列表中。 用户有一个默认的 login.keychain，密码是用户自己的密码，如果导入 p12 时导入到 login.keychain 中就必须要求要么用户输入密码，要么将密码写死在脚本中，这样很危险，而且无法做到开包即用。

这里使用的一个变通方法：

  1. 首先创建一个 keychain 并解锁。
  2. 将 p12 导入到新建的 keychain 中并通过 -T /usr/bin/codesign 参数指定 codesign 使用的私钥。
  3. 再通过 security list-keychains -s 命令将创建的 keychain 设置为用户的 keychain 搜索列表。
  4. 直接使用 codesign 或通过 xcodebuild 间接使用 codesign 签名。
  5. 将用户的 keychain 搜索列表设置为默认的 login.keychain。
  6. 删除创建的 keychain。

第 5 步强烈建议做，如果不做的话，用户打开 钥匙链 应用时，只能看到刚创建的“keychain”，而看不到默认的“登录”。

提示：创建 keychain 后建议解锁，否则在 300 秒超时后 codesign 在签名时会要求解锁。

提示：import p12 时一定要指定 -T /usr/bin/codesign 否则 codesign 在执行时会提示对话框询问是否允许使用私钥。

mobileprovision

mobileprovision 安装很简单，将其拷贝到 ~/Library/MobileDevice/Provisioning Profiles 目录中，并将其改名为 $UUID.mobileprovision。

其中的 UUID 可以通过

grep "UUID" ${IOS_PROVISIONING_FILE_PATH} -A 1 --binary-files=text 2>/dev/null |grep string|sed -e 's/^[[:blank:]]<string>//' -e 's/<\/string>//'

命令获取。 但是在 Ruby 中直接调用并不会获取正确的结果，所以此处使用 nokogiri xml 库来读取 UUID。

iOS 布署方式

  • app-store 是发布到 App Store 的方式（注意：TestFlight 使用的是 app-store，而不是 ad-hoc）。
  • ad-hoc 是发布给其他人使用的方式。
  • development 是开发者布署到自己的测试设备上的方式。

提示：提交到 iTunes Connect 中的应用的 Build 版本号每一个都要不一样，否则会提示重复，所以在每次构建前都要设置 –build-version 参数。 因为这个 Build 版本号存放在 Xcode 项目的 Info.plist 中，可以使用 PlistBuddy 修改。

提示：在构建 app-store 与 ad-hoc 时要求的 exportOptionsPlist 中有一个 team ID，可以从导入的 P12 中直接提取。

Source Code

GitHub: networm/Infinity.Build

GitHub: networm/Infinity.BuildInUnity3d

LICENSE

MIT LICENSE

参考资料