iOS Xcodebuild

Posted 2020-08-20 SYT在路上

简介

xcodebuild 是苹果发布自动构建的工具。它在一个Xcode项目下能构建一个或者多个targets ，也能在一个workspace或者Xcode项目上构建scheme，总的来说，用它没错就是了。

用法说明

Tips：在终端输入man xcodebuild，可以看到Description里面有介绍用法。

也可以看官方文档

当你想构建一个Xcode项目，在项目目录下运行xcodebuild就可以了（目录下面包含着projectname.xcodeproj文件就行），如果目录下有多个项目，你需要用参数-project指定一个项目。默认xcodebuild命令会构建你第一个target的。当然你也可以用-targetname指定。

如果要构建workspace，你必须指定-workspace和-scheme参数。

当然你可以以用就比如-version、-showsdks、-list等一些命令来获取一些项目相关的参数。

构建

在shell里面 [ ]表示这个参数是可选的，< > 表示参数是必须的

话不多说，先上个命令:

xcodebuild [-project projectname] [-target targetname ...] [-configuration configurationname]
            [-sdk [sdkfullpath | sdkname]] [buildaction ...] [setting=value ...]
            [-userdefault=value ...]

• -project 这个很清楚啦？你的项目名字 
• -target 这个也很清楚了吧？不过可以通过xcodebuild -list获取 
• -configrtion 一些参数，也可以通过xcodebuild -list获取
• -sdk 这个可由 xcodebuild -showsdks得到，我一般都是默认

• buildaction 这个指的是构建的动作，一般有build,analyze,archive,test,install,clean，默认当然是build了

  还有其他的一些参数比较少用到

  来看看xcodebuild -list吧

  Information about project "ThreeDTouchTest":

   Targets:
       ThreeDTouchTest
       ThreeDTouchTestTests
       ThreeDTouchTestUITests
  
   Build Configurations:
       Debug
       Release
  
   If no build configuration is specified and -scheme is not passed then "Release" is used.
  
   Schemes:
       ThreeDTouchTest

你们想要的Target有了，Schemes也有了，Configurations也有了，来看看xcodebuild -showsdks

OS X SDKs:
    OS X 10.11                        -sdk macosx10.11

ios SDKs:
    iOS 9.2                           -sdk iphoneos9.2

iOS Simulator SDKs:
    Simulator - iOS 9.2               -sdk iphonesimulator9.2

tvOS SDKs:
    tvOS 9.1                          -sdk appletvos9.1

tvOS Simulator SDKs:
    Simulator - tvOS 9.1              -sdk appletvsimulator9.1

watchOS SDKs:
    watchOS 2.1                       -sdk watchos2.1

watchOS Simulator SDKs:
    Simulator - watchOS 2.1           -sdk watchsimulator2.1

构建吧，兄台们，还等什么？接着来看看构建workspace命令是怎么样的

xcodebuild -workspace workspacename -scheme schemename [-destination destinationspecifier]
            [-destination-timeout value] [-configuration configurationname]
            [-sdk [sdkfullpath | sdkname]] [buildaction ...] [setting=value ...]
            [-userdefault=value ...]

基本都一样，只不过这里的workspacename跟schemename必须要指定。

命令运行成功后，一般会在你的项目目录下生成build文件夹,你可以在里面看到你的生成的包，还有dSYM文件。（好像对workspace构建后不会在项目目录下生成build文件夹，那你可以在你的命令后面添加SYMROOT=buildDir指定一个build文件夹）。

对了，还有这个命令可以查看项目设置：

xcodebuild -target <target> -configuration <configuration> -showBuildSettings

生成ipa文件

生成文件使用的是xrun命令：

xcrun -sdk iphoneos -v PackageApplication ./build/Release-iphoneos/xxx.app -o ~/Desktop/xxx.ipa

打包成功后，会在桌面找到你的ipa。

是不是很简单呢?

上传到Fir

这个就更简单了，敬请参照：Fir的命令行客户端

总结

作为开发人员，肯定不可能天天跟着测试人员跑。自动化是非常有必要的，所以会点脚本，肯定不会吃亏。

最后推荐一个好东西：自动构建打包，不是我写的，有这么好的轮子怎么会自已再写一个呢？

参考文档

官方文档

iOS自动打包并发布脚本