×
广告

关于xcodebuild

96
齐滇大圣
2017.11.01 23:36* 字数 685

介绍

xcodebuild 是苹果发布自动构建的工具。一般持续集成的时候都需要用到它。可以在终端输入man xcodebuild查看用法及介绍。也可以在官方文档中查看,官方文档可能会更新不及时,我用到的就好几个跟终端中输出的解释不一样。

在介绍中可以看到,xcodebuild主要就是用来构建projectsworkspaces的:

xcodebuild -- build Xcode projects and workspaces

相关路径说明

基础路径

xcode设置的基础路径是:

/Users/username/Library/Developer/Xcode/DerivedData/xxxWorkspace-caepeadwrerdcrftijaolkkagbjf

这个路径可以在Xcode->Preferences->Locations里设置。

下面用$()代替上面一长串东东

$(SYMROOT) = $()/Build/Products

$(BUILD_DIR) = $()/Build/Products

$(BUILD_ROOT) =  $()/Build/Products

在此目录下没一个配置或者模拟器真机都会有一个目录,比如

$()/Build/Products/Debug-iphonesimulator
$()/Build/Products/Release-iphonesimulator
$()/Build/Products/Debug-iphoneos
$()/Build/Products/Release-iphoneos

路径介绍

我们能在xcodebuild的相关action说明里看到这些路径:SYMROOTDSTROOTSRCROOT

  • SYMROOT(Build Products Path):

debug版本编译结果路径,默认是在/Users/username/Library/Developer/Xcode/DerivedData/tragetname-******/Build/Products

例子:
xcodebuild -workspace Demo.xcworkspace -scheme DemoTest SYMROOT="/Users/username/Desktop"

运行以上例子之后就会在桌面上生成一个文件夹Debug-iphoneos,里面会有每一个pod对应的编译结果和此工程scheme的DemoTest.app文件和DemoTest.app.dSYM

或者可以指定对应的配置configuration:
xcodebuild -workspace Demo.xcworkspace -scheme DemoTest SYMROOT="/Users/username/Desktop" -configuration ${CONFIGURATION}

基本上默认的配置是为Debug或Release,有时候我们会自己添加一些配置,比如Dev,Publish之类的。那么最后桌面生成的文件夹就是Dev-iphoneos或者Publish-iphoneos

  • DSTROOT

全称distribution root, 表示archive的可安装文件路径。默认路径为/tmp/$(PROJECT_NAME).dst。只有当build setting->$DEPLOYMENT_LOCATION设置为YES的时候才会出现。当为YES时$(DSTROOT)$(SYMROOT)都会有DemoTest.app,而$(SYMROOT)里的即为$(DSTROOT)里的替身版本。

例子:
xcodebuild install -workspace Demo.xcworkspace -scheme DemoTest DSTROOT="/Users/username/Desktop"

xcodebuild -workspace Demo.xcworkspace -scheme DemoTest DSTROOT="/Users/username/Desktop" archive

运行以上例子之后就会在桌面上生成一个文件夹Applications,里面就是对应的可安装文件DemoTest.app

  • SRCROOT

即当前工程所在的目录


相关命令说明

参数 说明
-project name.xcodeproj 在当前目录下有多个项目时需要指定
-target targetname 如果不指定的话默认会构建第一个target
-alltargets 表示同时构建所有的target
-workspace name.xcworkspace 构建workspace, 需要指定scheme
-scheme schemename 指定对应的scheme,当构建workspace时是必选项
-destination destinationspecifier 通过描述使用对应的设备,默认使用当前scheme所匹配的设备
-destination-timeout timeout 搜索对应设备时需要时间,可以设置搜索超时时间,默认为30s
-configuration configurationname 使用对应的配置进行构建,configurationname一般为Debug和Release
-arch architecture 指定构建的包所支持的指令集:arm64 armv7 armv7s
-sdk sdkfullpath sdkname 针对指定的SDK选择适合的构建工具构建。如-sdk iphoneos
-showsdks 列出所有的SDK,一般列出的后面都会跟上版本号,-sdk不写版本号的话默认就是所有版本
-list 列出当前项目所有的Targets、Build Configurations、Schemes
-derivedDataPath path 构建成功时相关的缓存文件路径,默认为/Users/dasheng/Library/Developer/Xcode/DerivedData 执行xcodebuild -scheme schemeName archive build时才会有相关缓存
-archivePath xcarchivepath 设置导出的.xcarchive文件的路径

Action

参数 说明
build 构建target,当没有其他action指定时,这是xcodebuild默认的一个action
build-for-testing 构建target和对应的相关单元测试,需要指定scheme
analyze 构建和分析target或scheme,需要指定scheme
archive 存档对应的构建scheme,需要指定scheme
test 从SYMROOT目录测试scheme,需要指定scheme和可选的destination
install 构建target然后安装到target的安装目录的发布目录(DSTROOT)
clean 从构建目录(SYMROOT)删除构建的products和一些中间文件

-destination

表示给特定的设备进行构建,使用:-destination destinationspecifier,destinationspecifier表示对应设备的描述,例子如下所示:

xcodebuild -destination "platform=iOS Simulator,id=36EB495C-4C6E-4233-A555-EF2B3866D470" 

描述根据key=value的方式并用逗号进行分割,key包括platformidnameOS

相关设置的值可以通过终端执行instruments -s命令得到。

-showBuildSettings

显示当前所有的BuildSettings的配置

xcodebuild -showBuildSettings

参考

apple documentation xcodebuild
iOS 自动构建命令——xcodebuild
环境变量路径相关
buildsettings
Xcode Build Settings - Products Path

iOS理论知识点
Web note ad 1