iOS CI(持续集成)之Xcodebuild命令

前言:

今天认真研究了一下Jenkins持续集成iOS项目(我会再找时间单独总结这部分内容),那就不得不提一下Xcodebuild命令,当然今天的重点就是这个啦。

正文:

平时我们打包ipa文件,一般都是通过GUI操作进行,大家觉得很简单,但作为会偷懒的程序猿,我们当然采用更加简单的方式了。就是通过执行简单的命令,静静的等待整个过程完成。那xcodebuild 这个命令就是来完成这个事情的。
目前已经有不少封装得很不错的第三方打包服务可以用,比如最出名的有 AFNetworking 的作者 mattt 大大的 shenzhen (没错,就是深圳),还有一个名叫 gym 也很不错。这些库都是对 xcodebuild 这个命令做了一些封装,更方便使用而已。

什么是xcodebuild?

xcodebuild 命令是 Xcode Command Line Tools 的一部分。通过调用这个命令,可以完成 iOS 工程的编译,打包和签名过程。这个命令随着 Xcode 的版本不同使用方法上也会有所不同。打开命令行,调用以下命令查看使用方法:

xcodebuild --help
xcodebuild-help.png

上面截图中显示了命令执行结果。

语法:

在shell里面 [ ]表示这个参数是可选的,< > 表示参数是必须的。
如:

xcodebuild [-project name.xcodeproj] -scheme schemename [[-destination destinationspecifier] …] [-destination-timeout value] [-configuration configurationname] [-sdk [sdkfullpath | sdkname]] [action …] [buildsetting=value …] [-userdefault=value …]
  • -project 你的项目名字,该项目会负责管理生成一个或者多个软件产品的全部文件和配置,一个Project可以包含多个Target。
  • Workspace:简单来说,Workspace就是一个容器,在该容器中可以存放多个你创建的Xcode Project, 以及其他的项目中需要使用到的文件。使用Workspace的好处有:
  1. 扩展项目的可视域,即可以在多个项目之间跳转,重构,一个项目可以使用另一个项目的输出。Workspace会负责各个Project之间提供各种相互依赖的关系;
  2. 多个项目之间共享Build目录。
  • -target 不过可以通过xcodebuild -list获取
  • -configrtion 默认就是Debug和Release这两个版本,没有指定默认为Release版本,也可以通过xcodebuild -list获取
  • -sdk 这个可由 xcodebuild -showsdks得到,一般都是默认
  • Scheme:一个定义好构建过程的Target成为一个Scheme。可在Scheme中定义的Target的构建过程buildaction 有:Build/Run/Test/Profile/Analyze/Archive
  • BuildSetting:配置产品的Build设置,比方说,使用哪个Architectures?使用哪个版本的SDK?。在Xcode Project中,有Project级别的Build Setting,也有Target级别的Build Setting。Build一个产品时一定是针对某个Target的,因此,XCode中总是优先选择Target的Build Setting,如果Target没有配置,则会使用Project的Build Setting。

let's see see xcodebuild -list:

xcodebuild -list.png

这样我们想要的Target有了,Schemes也有了,Configurations也有了。

再来看看xcodebuild -showsdks:

xcodebuild -showsdks.png

用下面这个命令查看项目配置:

xcodebuild -target <target> -configuration <configuration> -showBuildSettings
showBuildSettings.png

那参数咱们也了解了,下面开始构建吧。

打包签名:

首先进入工程目录,执行以下命令:

xcodebuild [-project name.xcodeproj] [[-target targetname] … | -alltargets] [-configuration configurationname] [-sdk [sdkfullpath | sdkname]] [action …] [buildsetting=value …] [-userdefault=value …]

xcodebuild [-project name.xcodeproj] -scheme schemename [[-destination destinationspecifier] …] [-destination-timeout value] [-configuration configurationname] [-sdk [sdkfullpath | sdkname]] [action …] [buildsetting=value …] [-userdefault=value …]

参数说明:SchemeName 就是工程的 scheme 的名字。
命令中可以添加一些参数实现在命令执行时配置不同的环境。比如,如果想 archive 出 Debug 环境的包,那么就可以在命令中添加 -configuration Debug 参数。对于非 workspace 的工程,还可以通过添加 PROVISIONING_PROFILE=的参数来指定签名所用的 Profile 文件,参数的值为 profile 文件的 UUID。

如果工程使用了 Cocoapods 来管理第三方库或使用workspace,那么命令的执行方式上有所不同,因为 Cocoapods 会把工程变成一个 workspace。将 workspace 工程 archive 的命令如下。

xcodebuild -workspace name.xcworkspace -scheme schemename [[-destination destinationspecifier] …] [-destination-timeout value] [-configuration configurationname] [-sdk [sdkfullpath | sdkname]] [action …] [buildsetting=value …] [-userdefault=value …]

workspacename跟schemename必须要指定。
例如我的项目:

xcodebuild -workspace RRTuiGuang.xcworkspace -scheme RRTuiGuang -configuration Release

如果 build 成功,会看到 ** BUILD SUCCEEDED ** 字样,且在终端会打印出这次 build 的签名信息,如下:

Signing Identity: “iPhone Developer: xxx(xxxxxx)”
Provisioning Profile: “iOS Team Provisioning Profile: xxx"

该目录下会多出一个 build 文件夹,该目录下有 Release-iphoneos 和 工程名.build 文件,根据我们 build -configuration 配置的参数不同,Release-iphoneos 的文件名会不同。在 Release-iphoneos 文件夹下,有我们需要的xxx.app文件,这样第一步就完成了,但是要安装到真机上,我们需要将该文件导出为ipa文件,使用 xcrun 命令。
PackageApplication新版Xcode不兼容被废弃

xcrun -sdk iphoneos -v PackageApplication ./build/Release-iphoneos/xxx.app -o ~/Desktop/xxx.ipa
xcodebuild archive工程

上面的方法被弃用,相当恶心啊。所以我们还有从头来过,(不要打我)不过下面会介绍最新的打包方式,两句话:

1.生成archive包

// 使用pod管理第三方  
xcodebuild archive -workspace 项目名称.xcworkspace -scheme 项目名称 -configuration Release -archivePath archive包存储路径 CODE_SIGN_IDENTITY=证书 PROVISIONING_PROFILE=描述文件UUID  
// 未使用pod管理第三方  
xcodebuild archive -project 项目名称.xcodeproj -scheme 项目名称 -configuration Release -archivePath archive包存储路径 CODE_SIGN_IDENTITY=证书 PROVISIONING_PROFILE=描述文件UUID 

如果项目工程里已经设置CODE_SIGN_IDENTITY证书和PROVISIONING_PROFILE描述文件,在这里就不需要添加了。
2.生成ipa包

xcodebuild -exportArchive -exportFormat ipa文件格式 -archivePath archive包存储路径 -exportPath ipa包存储路径  -exportProvisioningProfile 描述文件名称,同上,在这里就不需要添加了。

如果exportProvisioningProfile描述文件已经设置,

  • -archivePath:archive包保存目录;
  • CODE_SIGN_IDENTITY:证书(证书名称)
  • PROVISIONING_PROFILE:描述文件UUID
  • -exportProvisioningProfile:描述文件(描述文件名称)
    大功告成!之后我会总结一下,jekens+svn和xctool
最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 203,324评论 5 476
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 85,303评论 2 381
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 150,192评论 0 337
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 54,555评论 1 273
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 63,569评论 5 365
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 48,566评论 1 281
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 37,927评论 3 395
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 36,583评论 0 257
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 40,827评论 1 297
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 35,590评论 2 320
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 37,669评论 1 329
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 33,365评论 4 318
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 38,941评论 3 307
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 29,928评论 0 19
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 31,159评论 1 259
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 42,880评论 2 349
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 42,399评论 2 342

推荐阅读更多精彩内容