xcodebuild 命令行解析

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的配置；

    compileBitcode
    
    destination
    export 导出还是上传
    method
    enterprise 内测版
    provisioningProfiles
    
        bundle id这里写
        provision file名字或者uuid
    
    signingCertificate
    iPhone Distribution
    signingStyle 签名方式
    manual
    stripSwiftSymbols
    
    teamID
    账户的id
    thinning app是不是需要
    <none>

还有很多参数，比如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
实现对版本的动态选择