Xcodebuild命令使用

Xcodebuild简介

Xcodebuild是命令行工具包的其中一项。

命令行工具包（Command Line Tools）是一个轻量的、可以与XCode分开的、在Mac上单独下载的命令行工具包。

它有两部分组成：Mac OS SDK和用户系统库目录/usr/bin下的诸多命令工具。例如：gcc/g++编译器，make、git、nase、xcodebuild、xcrun等等。

 

命令行工具包（Command Line Tools）的安装

Xcode-select命令

xcode-select是Mac系统自带的命令行工具，属于用户系统内/usr/bin。当电脑上安装多个Xcode时，xcode-select用来选择命令行工具为哪一个版本的Xcode服务。

命令行工具安装指令：xcode-select --install

选择指定的Xcode路径：xcode-select --switch

 

常见命令

man命令

man可以进行命令用法的在线文档查询,包括使用例子。比如：man xcodebuild。

 

xcpretty命令

命令行输出美化小工具，可以对错误，警告给予高亮显示。使用方式：xcodebuild | xcpretty

 

xcrun命令

xcrun用于调用其他命令执行，如：xcrun xcodebuild。

xcrun的调用是基于xcode-select选择的工具链，当电脑中存在多个版本的xcode时，使用xcrun调用可以保证命令的环境一致性。

 

xcodebuild命令

下面重点介绍xcodebuild如何使用。

在使用xcodebuild时，从终端进入到projectname .xcodeproj 目录下。

有workspace时，参数中要带-workspace和-scheme。

只有project时，则参数中要带 -project和-scheme选项。

xcodebuild在Xcode中存在的默认配置在路径project/info页面中

xcodebuild的常见使用场景

简单命令行build

xcodebuild

单写一个xcodebuild，工程编译使用默认的scheme和编译配置。
scheme、targets、配置、目标设备、SDK和导出数据位置可以在后面自定义配置

 archive打包操作

xcodebuild archive  -workspace PROJECT_NAME.xcworkspace   
-scheme SCHEME_NAME -configuration release -archivePath  
EXPORT_ARCHIVE_PATH 

-archivePath：设置项目的归档路径

 导出ipa文件

xcodebuild -exportArchive -archivePath EXPORT_ARCHIVE_PATH    
-exportPath EXPORT_IPA_PATH -exportOptionsPlist ExportOptionsPlistPath
-allowProvisioningUpdates

-exportArchive：导出ipa
-exportPath：导出ipa文件的路径
-exportOptionsPlist：文件导出时的配置信息
-allowProvisioningUpdates：允许xcodebuild与苹果网站通讯，进行自动签名，证书自动更新，生成。

 单元测试

xcodebuild test -project PROJECT_NAME.xcodeproj -scheme SCHEME_NAME 
-destination 'platform=iOS Simulator,name=iPhone 6s,OS=11.2' -
configuration Debug -derivedDataPath output

-derivedDataPath：产生的缓存文件放在./output目录下
 configuration：编译环境，选择Debug/Release
 -destination :选择test时的目标设备和系统版本号

  UI测试/单元测试，针对某个方法进行测试

xcodebuild test -project PROJECT_NAME.xcodeproj -scheme SCHEME_NAME 
-destination 'platform=iOS Simulator,name=iPhone 6s,OS=11.2' 
-only-testing:TARGET_NAME/CLASS_NAME/FUNC_NAME -quiet

-only-testing: 只测试某一个方法，target名/类名/方法名
-quiet : 除了错误和警告不打印任何信息

使用上次编译成功的测试用例进行测试

注意：app创建时需要指定app的bundle名

self.app = [[XCUIApplication alloc] initWithBundleIdentifier:@"com.xxx.id"];
[self.app launch];

1.UI测试/单元测试，不进行代码编译，利用上次编译的缓存（包括工程编译+测试用例编译），进行重新跑测试。

xcodebuild test-without-building -workspace PROJECT_NAME.xcworkspace 
-scheme doctor -destination 'platform=iOS Simulator,name=iPhone 6s,OS=12.0' 
-only-testing:TARGET_NAME/CLASS_NAME/FUNC_NAME

2.UI测试,使用选项-xctestrun生产测试文件，进行测试调试

//1.产生xctestrun文件
xcodebuild build-for-testing -project PROJECT_NAME.xcodeproj -scheme SCHEME_NAME 
-destination 'platform=iOS Simulator,name=iPhone 6s,OS=11.2' -
configuration Debug -derivedDataPath output

-derivedDataPath: derivedDataPath/Build/Products目录下生成一个.xctestrun文件,包含测试信息


//2.使用xctestrun文件（不带-workspace/-project/-scheme参数）
xcodebuild test-without-building -destination 'platform=iOS Simulator,name=iPhone 6s,OS=12.0' 
-xctestrun DerivedDataPath.xctestrun -only-testing:TARGET_NAME/CLASS_NAME/FUNC_NAME

-xctestrun：有这个选项就从指定的路径下寻找bundle，没有这个选项在derivedDataPath下寻找bundle
-only-testing:TARGET_NAME/CLASS_NAME/FUNC_NAME

 xcodebuild常见action

 

另外一些常见的命令

 

genstrings 命令

本地化命令，根据指定的C/Object-C源文件生成.strings文件。

genstrings -a /path/to/source/files/*.m

ibtool 命令

本地化命令，作用于xib文件。

ibtool --generate-strings-file Localizable.strings en.lpoj/Interface.xib

 

文章参考：

https://www.hualong.me/2018/03/14/Xcodebuild/

https://www.jianshu.com/p/2a351587f0ef