iOS Jenkins 自动化打包构建

时间：2022-09-10 18:45:14

 

前言

在测试app项目过程中，通常都是需要开发打测试包给到测试，但是无论是iOS还是Android的打包过程都是相当漫长的，频繁的回归测试需要频繁的打包，对于开发同学影响还是蛮大的。因此在这种情况下，开发通常都会搭建一个简单的自动化打包平台（Jenkins），自动化构建打包或者上传到蒲公英，firm等分发平台。作为测试也需要了解相关的知识，因为这些工作也有可能测试来做或推动开发去做相关的工作，用以优化提高开发测试效率。

 

涉及技术点：

  1. Jenkins的搭建配置，任务构建
  2. iOS开发环境配置
  3. iOS打包（证书配置）
  4. iOS命令行打包xcodebuild的使用

xcode打包介绍

准备工作

如果不打包，直接在测试机上跑app是不需要证书和描述文件的。只要有Apple ID就是可以的，它可以自动生成描述文件，然后让app运行到测试机上。

如果是需要打包分发的话，就是必须要有证书和描述文件。

 

证书有两种，一种是开发证书，一种是上线证书，当然测试只需要拿到开发证书就可以了，大部分情况下上线工作是不需要测试来做的（涉及到一些开发者账号等东西）。

如果我们需要本地打包的话那么就需要跟开发要两样东西：

  1. 开发证书
  2. 描述文件

 

开发证书拿到之后双击打开就好，可以在钥匙串中看到安装好的证书。

描述文件需要单独保存一下，一些配置可能用到，Xcode配置中需要导入。

代码权限，跟开发拿到代码权限，git clone到本地。

Xcode使用

Xcode是iOS开发IDE，使用的时候需要跟开发同步使用的版本，有些开发是一直用最新版的，有的可能用的是老版本，会有问题。

检查本地环境及代码

使用Xcode打开clone到本地的代码，如果版本什么都对应的话，build应该是没有问题的。

command b  build项目，查看是否有错误。

或者导航栏：product → Build

iOS Jenkins 自动化打包构建

 

如果没什么问题，可以编译build成功就OK了。

模拟器运行

如果只是模拟器运行是不需要配置证书描述文件的，选择模拟器类型，直接运行就好了。

iOS Jenkins 自动化打包构建

 

真机运行

真机运行有两种方式：

  1. 一种是不需要证书描述文件但是需要一个appleID账号密码
  2. 一种是需要证书描述文件导出.ipa包

 

第一种方式的话只能手机通过USB链接到电脑上，然后运行项目在手机上安装app

第二种方式的话是可以导出ipa文件传输到手机上安装

 

第一种方式：

可以通过导航栏Xcode → Preferences → Accounts 添加apple账号

iOS Jenkins 自动化打包构建

在项目中配置（target→  sanjieke），有个Automatically manage signing，勾选了后选择apple账号就会自动生成配置描述文件

iOS Jenkins 自动化打包构建

 

如果有错误看下错误说明，然后调整下配置，一般的错误就是

buddle id的问题

iOS版本的问题

调整下就没什么问题了。

 

第二种方式，真机打包

如果是导出包安装测试的话，还需要在开发者中心把测试机的udid加入到里面，这个给到开发就好了

安装好了证书，拿到了描述文件，在项目中配置

还是上图红框的内容，不要点击Automatically manage signing了，点击provisioning profile，选择import profile，将描述文件导入就可以了。

 

然后在模拟器那个位置选择Generic iOS Device

导航栏 Product → Archive 

按照提示一步步选择就好了，最后会在你选择的路径下生成需要的ipa 包。

xcodebuild命令介绍

 

如果不想手动操作打包，还可以使用命令打包

 

xcodebuild基础命令

  1. xcodebuild -usage          查看xcodebuild用法
  2. xcodebuild -showsdks   查看安装的sdk
  3. xcodebuild -list               查看项目中的target（目标项目），configuration（打包环境debug,release）和schemes(项目名）, 这三个参数也是后续打包需要用到的
  4. xcodebuild        构建生成archive文件 archive -archivePath <archivePath> -project <projectName> -scheme <schemeName> #从-list命令中获取 -configuration < Debug|Release> -sdk <sdkName> #sdkName可从showsdks命令中获取
  5. xcodebuild       将archive文件导出为ipa文件 -exportArchive -archivePath <xcarchivepath> -exportPath <destinationpath> -exportOptionsPlist <plistpath>#这个plist文件可以通过打一次ipa包里面去获取，然后根据需求修改

 

xcodebuild命令实际应用

从基础命令来看用的最多的就是4和5，实际上命令行导出ipa文件有两种方式

  1. 一种方式是先将项目构建成.app文件，通过xcodebuild build, 然后使用xcun 将app文件导出生成ipa，但是目前新版本的不支持这种方式了，一般用2
  2. 另外一种方式就是先构建生成.xcarchive文件, 然后导出生成.ipa文件

 

注意一点的是，plist文件我们可以通过用Xcode打包一次获得，然后根据需要修改，也可以参数化，内容如下：

<?xml version="1.0" encoding="UTF-8"?> <!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd"> <plist version="1.0"> <dict>          <key>compileBitcode</key>          <true/>          <key>destination</key>          <string>export</string>          <key>method</key>          <string>development</string>          <key>provisioningProfiles</key>          <dict>                   <key>com.sanjieke.app</key>                   <string>com.sanjieke.appDevelop</string>         </dict>         <key>signingCertificate</key>         <string>iPhone Developer</string>         <key>signingStyle</key>         <string>manual</string>         <key>stripSwiftSymbols</key>         <true/>         <key>teamID</key>         <string>V5LUS4979S</string>         <key>thinning</key>         <string>&lt;none&gt;</string> </dict> </plist>

xcodebuild打包脚本

知道了如何用命令行进行打包后，我们可以自己写个简单的脚本来进行打包，然后集成到Jenkins的话直接执行脚本，不使用Jenkins提供的Xcode插件，更加方便。

 

 

 

相关文章