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 <path>
 
常见命令
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

 

文章参考:
相关文章
相关标签/搜索