Xcode界面,大家build用起来很简单;如果是在编译机器上呢,这时候我们就需要了解下 xcodebuild 这个命令行工具
1. xcodebuild 的用法的概要
用法谁不会啊,其实我们在命令行输入, 用法就打出来了
xcodebuild -help
image.png
usage看着有点乱,其实我们可以总结一个公式:
xcodebuild 参数a 参数b 参数c 参数d 参数others
- 参数a - 得先让xcodebuild知道搞哪个项目?,所以可以是 -workspace 或者 -project 后面跟个project路径或者 workspace路径(cocoapods生成的)
- 参数b - 知道了搞哪个项目,项目可能有好几个target呢? 所以可以得指定 -target 或者 -scheme
- 参数c - 知道了项目,知道了搞哪个target, 那搞什么配置的? debug还是release,还是其它自己加的配置? 所有 -configuration 来指定下
- 参数d - 都配置好了,那让xcodebuild干什么呢? clean, build, archive,test,profile,还是export ipa,所以最后我们告诉xcodebuild去做什么
这么一看,其实也就顺其自然了。
2. xcode编译产出ipa
(假设使用Cocoapods管理)
第一步, archive
xcodebuild -workspace xxx.workspace \
-scheme xxx(target名称) \
-configuration release(假设是release)\
archive
第二步,export ipa
xcodebuild -exportArchive -archivePath (archive生成的产物路径)\
-exportPath (要导出ipa的路径) \
-exportOptionsPlist ExportOptions.plist文件的路径 \
其实还有一种xcrun导出的方式,不过Xcode 9 之后就不推荐了
ExportOptions.plist文件是在哪里呢?其实我们用Xcode界面导出一次ipa,文件夹中就有了
里面都是 key-value的配置;
<?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>
<false/>
<key>destination</key>
<string>export</string> 导出还是上传
<key>method</key>
<string>enterprise</string> 内测版
<key>provisioningProfiles</key>
<dict>
<key>bundle id这里写</key>
<string>provision file名字或者uuid</string>
</dict>
<key>signingCertificate</key>
<string>iPhone Distribution</string>
<key>signingStyle</key> 签名方式
<string>manual</string>
<key>stripSwiftSymbols</key>
<true/>
<key>teamID</key>
<string>账户的id</string>
<key>thinning</key> app是不是需要
<string><none></string>
</dict>
</plist>
还有很多参数,比如bitcode打不打开,具体可以根据用到情况,来决定开关打开与否。
3. 其它有用的参数
我们第一部分没有说 others参数,其实这部分参数有时候还挺有用的
- -quiet 这个可以只输出 waring和error级别的日志;经历过查百万行代码的编译日志,可以说深有感触(编译日志在150 - 200MB大小,压根没法打开,sublime, vscode全跪,然后被催催,有进展了不,有进展了不,只能是去你的;加了之后大小1-3MB,美滋滋)
- -allowProvisioningUpdates 指定了这个,可以自己去下载最新的 Provision Profile文件,当然 前提是在Xcode上登录了; 缺点也比较明显,苹果这个服务器啊,连起来老是很慢,会耗费几十秒
- -derivedDataPath 这个可以指定 deriveddata的路径;编译过程的中间产物,其实就是在 deriveddata 路径下,所以,有了这个,我们直接每次编译开始前删掉这个就行;我们也就不需要xcodebuild clean了,也就是第二步没写的原因
4. 不同版本的xcodebuild
同一台机器如何使用不同版本的xcodebuild命令呢? 大家可能想到是 xcode-select
但如果是并发,其实这会存在一个问题; "A 切换到 xcode 9.4;但B 又切换 Xcode 10"
切换, 使用这两个不是原子操作,所以可能出现使用了错误的版本。
解决的办法其实也简单,我们用过Python2和Python3就很容易明白。
image.png
我们队Xcode版本进行独立命名, 然后使用时候指明就行。比如使用xcodebuild 10版本
可以明确指示
/Applications/Xcode10.1.app/Contents/Developer/usr/bin/xcodebuild
再进一步,设置宏名称 XCODE_VERSION
/Applications/Xcode${XCODE_VERSION}.app/Contents/Developer/usr/bin/xcodebuild
实现对版本的动态选择