xcodebuild 使用手册

最新推荐文章于 2024-01-27 16:28:37 发布
转载 最新推荐文章于 2024-01-27 16:28:37 发布 · 920 阅读 · 0
文章标签：

#mac #xcode

本文详细介绍了 xcodebuild 的使用方法，包括基本命令、参数选项、常见操作如编译、清理项目等，并提供了通过 SSH 连接进行远程构建的解决方案。

摘要生成于 C知道 ，由 DeepSeek-R1 满血版支持， 前往体验 >

xcodebuild 使用手册

 

   

    localhost:bin han
    $
     xcodebuild 
    -
    h
xcodebuild: error: invalid option '
    -
    h'

Usage: xcodebuild [
    -
    project <projectname
    >
    ] [[
    -
    target <targetname
    >
    ]...
    |-
    alltargets] [
    -
    configuration <configurationname
    >
    ] [
    -
    arch <architecture
    >
    ]... [
    -
    sdk [<sdkname
    >|
    <sdkpath
    >
    ]] [<buildsetting
    >=
    <value
    >
    ]... [<buildaction
    >
    ]...
       xcodebuild 
    -
    workspace <workspacename
    >
     
    -
    scheme <schemeName
    >
     [
    -
    configuration <configurationname
    >
    ] [
    -
    arch <architecture
    >
    ]... [
    -
    sdk [<sdkname
    >|
    <sdkpath
    >
    ]] [<buildsetting
    >=
    <value
    >
    ]... [<buildaction
    >
    ]...
       xcodebuild 
    -
    version [
    -
    sdk [<sdkfullpath
    >|
    <sdkname
    >
    ] [<infoitem
    >
    ] ]
       xcodebuild 
    -
    list [[
    -
    project <projectname
    >
    ]
    |
    [
    -
    workspace <workspacename
    >
    ]]
       xcodebuild 
    -
    showsdks
Options:
    
    -
    usage                print full usage
    
    -
    verbose              provide additional status output
    
    -
    project NAME         build the project NAME
    
    -
    target NAME          build the target NAME
    
    -
    alltargets           build all targets
    
    -
    workspace NAME       build the workspace NAME
    
    -
    scheme NAME          build the scheme NAME
    
    -
    configuration NAME   use the build configuration NAME 
    for
     building each target
    
    -
    xcconfig PATH        apply the build settings defined 
    in
     the file at PATH as overrides
    
    -
    arch ARCH            build each target 
    for
     the architecture ARCH; this will override architectures defined 
    in
     the project
    
    -
    sdk SDK              use SDK as the name or path of the base SDK when building the project
    
    -
    parallelizeTargets   build independent targets 
    in
     parallel
    
    -
    jobs NUMBER          specify the maximum number of concurrent build operations
    
    -
    showsdks             display a compact list of the installed SDKs
    
    -
    list                 lists the targets and configurations 
    in
     a project, or the schemes 
    in
     a workspace
    
    -
    find BINARY          display the full path to BINARY 
    in
     the provided SDK
    
    -
    version              display the version of Xcode; with 
    -
    sdk will display info about one or all installed SDKs

显示xcodebuild version

[yarshure@MacPro]%xcodebuild -version

Xcode 3.1.1

Component versions: DevToolsCore-1114.0; DevToolsSupport-1102.0

BuildVersion: 9M2517

 

显示当前系统安装SDK

[yarshure@MacPro]%xcodebuild -showsdks

iPhone OS Simulator SDKs:

        Simulator - iPhone OS 2.0       -sdk iphonesimulator2.0

        Simulator - iPhone OS 2.1       -sdk iphonesimulator2.1

 

iPhone OS Device SDKs:

        Device - iPhone OS 2.0          -sdk iphoneos2.0

        Device - iPhone OS 2.1          -sdk iphoneos2.1

 

Mac OS X SDKs:

        Mac OS X 10.4                   -sdk macosx10.4

        Mac OS X 10.5                   -sdk macosx10.5

显示当前目录下project Information

[yarshure@MacPro]%xcodebuild -list

Information about project "BookOO":

    Targets:

        BookOO (Active)

 

    Build Configurations:

        Debug (Active)

        Release

 

    If no build configuration is specified "Release" is used.

使用 iphonesimulator2.1build project

    

     [yarshure
     @
     MacPro]
     %
     xcodebuild 
     -
     sdk iphonesimulator2.
     1
     

     ===
      BUILDING NATIVE TARGET BookOO OF PROJECT BookOO WITH THE 
     DEFAULT
      CONFIGURATION (Release) 
     ===
     Checking Dependencies...
......
......
Touch 
     /
     Users
     /
     yarshure
     /
     Desktop
     /
     BookOO
     /
     build
     /
     Release
     -
     iphonesimulator
     /
     BookOO.app
    cd 
     /
     Users
     /
     yarshure
     /
     Desktop
     /
     BookOO
    
     /
     usr
     /
     bin
     /
     touch 
     -
     c 
     /
     Users
     /
     yarshure
     /
     Desktop
     /
     BookOO
     /
     build
     /
     Release
     -
     iphonesimulator
     /
     BookOO.app

     **
      BUILD SUCCEEDED 
     **
     
clean Target
[yarshure
     @
     MacPro]
     %
     xcodebuild clean 
     -
     sdk iphonesimulator2.
     1
      
     -
     configuration
     =
     Debug

     ===
      CLEANING NATIVE TARGET BookOO OF PROJECT BookOO WITH THE 
     DEFAULT
      CONFIGURATION (Release) 
     ===
     
 
Checking Dependencies...
 
Clean.Remove clean 
     /
     Users
     /
     yarshure
     /
     Desktop
     /
     BookOO
     /
     build
     /
     Release
     -
     iphonesimulator
     /
     BookOO.app
    
     /
     bin
     /
     rm 
     -
     rf 
     /
     Users
     /
     yarshure
     /
     Desktop
     /
     BookOO
     /
     build
     /
     Release
     -
     iphonesimulator
     /
     BookOO.app
 
Clean.Remove clean 
     /
     var
     /
     folders
     /
     9j
     /
     9jS16
     -
     DSHs07FniFobQ7Bk
     +++
     TI
     /-
     Caches
     -/
     com.apple.Xcode.
     501
     /
     SharedPrecompiledHeaders
     /
     BookOO_Prefix
     -
     eizrpbwsixzcdogzigrqutwuvbzo
     /
     BookOO_Prefix.pch.gch
     
     /
     bin
     /
     rm 
     -
     rf 
     /
     var
     /
     folders
     /
     9j
     /
     9jS16
     -
     DSHs07FniFobQ7Bk
     +++
     TI
     /-
     Caches
     -/
     com.apple.Xcode.
     501
     /
     SharedPrecompiledHeaders
     /
     BookOO_Prefix
     -
     eizrpbwsixzcdogzigrqutwuvbzo
     /
     BookOO_Prefix.pch.gch
  
Clean.Remove clean 
     /
     Users
     /
     yarshure
     /
     Desktop
     /
     BookOO
     /
     build
     /
     Release
     -
     iphonesimulator
     /
     BookOO.app.dSYM
    
     /
     bin
     /
     rm 
     -
     rf 
     /
     Users
     /
     yarshure
     /
     Desktop
     /
     BookOO
     /
     build
     /
     Release
     -
     iphonesimulator
     /
     BookOO.app.dSYM
 
Clean.Remove clean 
     /
     Users
     /
     yarshure
     /
     Desktop
     /
     BookOO
     /
     build
     /
     BookOO.build
     /
     Release
     -
     iphonesimulator
     /
     BookOO.build
    
     /
     bin
     /
     rm 
     -
     rf 
     /
     Users
     /
     yarshure
     /
     Desktop
     /
     BookOO
     /
     build
     /
     BookOO.build
     /
     Release
     -
     iphonesimulator
     /
     BookOO.build

     **
      CLEAN SUCCEEDED 
     **

 From SSH Connection Build Xcode iPhone Project

1 使用ssh client login Develope Machine

2 $cd iPhone App directory

3 $xcodebuild

一般CodeSign 会抱错，消息如下

    

     CodeSign 
     /
     Users
     /
     yarshure
     /
     proj
     /
     BookOO090215
     /
     build
     /
     Release
     -
     iphoneos
     /
     BookOO.app
    cd 
     /
     Users
     /
     yarshure
     /
     proj
     /
     BookOO090215
    
     /
     usr
     /
     bin
     /
     codesign 
     -f
      
     -
     s 
     "
     iPhone Developer: xiangbo kong
     "
      
     --
     resource
     -
     rules
     =/
     Users
     /
     yarshure
     /
     proj
     /
     BookOO090215
     /
     build
     /
     Release
     -
     iphoneos
     /
     BookOO.app
     /
     ResourceRules.plist 
     --
     entitlements 
     /
     Users
     /
     yarshure
     /
     proj
     /
     BookOO090215
     /
     build
     /
     BookOO.build
     /
     Release
     -
     iphoneos
     /
     BookOO.build
     /
     BookOO.xcent 
     /
     Users
     /
     yarshure
     /
     proj
     /
     BookOO090215
     /
     build
     /
     Release
     -
     iphoneos
     /
     BookOO.app

     /
     Users
     /
     yarshure
     /
     proj
     /
     BookOO090215
     /
     build
     /
     Release
     -
     iphoneos
     /
     BookOO.app: User interaction is not allowed.

     **
      BUILD FAILED 
     **

4 解决办法

  使用security 命令行工具

$security unlock-keychain

5 重新执行

$xcodebuild

CodeSign 输出

    

     CodeSign 
     /
     Users
     /
     yarshure
     /
     proj
     /
     BookOO090215
     /
     build
     /
     Release
     -
     iphoneos
     /
     BookOO.app
    cd 
     /
     Users
     /
     yarshure
     /
     proj
     /
     BookOO090215
    
     /
     usr
     /
     bin
     /
     codesign 
     -f
      
     -
     s 
     "
     iPhone Developer: xiangbo kong
     "
      
     --
     resource
     -
     rules
     =/
     Users
     /
     yarshure
     /
     proj
     /
     BookOO090215
     /
     build
     /
     Release
     -
     iphoneos
     /
     BookOO.app
     /
     ResourceRules.plist 
     --
     entitlements 
     /
     Users
     /
     yarshure
     /
     proj
     /
     BookOO090215
     /
     build
     /
     BookOO.build
     /
     Release
     -
     iphoneos
     /
     BookOO.build
     /
     BookOO.xcent 
     /
     Users
     /
     yarshure
     /
     proj
     /
     BookOO090215
     /
     build
     /
     Release
     -
     iphoneos
     /
     BookOO.app

     **
      BUILD SUCCEEDED 
     **

6 ** BUILD SUCCEEDED ** 收工

Xcode 使用手册之 02 创建项目（Xcode中文文档手册）
iCloudEnd的博客
08-16 894
创建项目 创建Xcode项目时，首先要为通用样式的应用程序或框架选择模板，然后根据需要修改项目。 Xcode模板包括必要的项目配置和文件，可帮助您快速开始开发应用程序。 启动Xcode，然后在“欢迎使用Xcode”窗口中，单击“创建新的Xcode项目”。或者，选择“文件”>“新建”>“项目”。 在出现的工作表中，选择目标操作系统或平台。 在“应用程序”下，选择一个模板，然后单击“下一步”。 例如，要创建一个具有单个空白视图的iOS应用，请选择“单个视图应用”。对于macOS应用程
基于xcodebuild和xcrun的自动化打包
小海的博客
10-28 4260
由于本人公司要进行自动化测试，需要客户端人员进行协助。我作为iOS客户端的开发，负责研究使用命令行进行打包，之后上传到指定服务器地址，以供测试人员及时获取。下面是我的研究结果，之间碰到了一个当时很棘手的问题，解决之后还是蛮有成就感的，在次特别感谢倩神的协助。 在xcode5以后，自动打包可以绕过选择证书，通过xcodebuild命令编译为.app文件，xcrun命令将.app文件打包为.
XCode4自学手册
10-08
Xcode自学手册，英文。支持最新版的XCode4.3.2.
Xcode 使用手册
weixin_30727835的博客
02-25 175
一、快捷键 运行：Command + r 清除编译文件：Shift + Command + k 检查内存泄漏：Shift + Command + b 代码格式化（自动排版）：1. Command + a (全选) 2. Ctrl + i (排版) 二、功能点 添加虚拟机：xcode -> Window -> Devices -> add 代码格式化...
Xcode使用手册
尚方杵
07-20 1495
TextFiled：            Clear Button :  Appears while editing                                                                                         说明：在TextFiled输入内容后，输入框后面有“X” 号，删除所有输入的内容
TN2339: 使用 Xcode 命令行构建的常见问题
工匠日记
10-20 1374
Apple Developer Documentation Archive 是 Apple 已归档的开发者文档，具有很大的参考价值。adat 项目选取了一些典型文章进行翻译，摒弃了部分过时的内容，并在 Xcode 13.0 上进行实践。这是该项目的第一篇文章，后续文章将会逐步深入，探究使用命令行工具进行企业级构建的最佳实践。 内容概览 命令行工具包是什么？ macOS 10.9 及以后的版本上的 Xcode 不再提供命令行工具下载入口，应该如何安装？ 如何卸载命令行工具？ 多个 Xcode 并存的..
iOS开发手册（精华篇）
D_猿员的博客
11-24 1391
1.项目基础 1.1 项目新建信息 Product Name：工程名。 Team：开发者账号信息，没有选择None，个人开发者账号（含Personal Team），公司/企业账号（如：XXX Co.,LTD），也可以暂时选择None，后续再配置调试。 Organization Name：个人开发者账号（自定义名字），公司/企业账号（如：XXX Co.,LTD），此处内容明显体现在代码文件头部注释...
探究 Xcode 命令行用法一：Xcode 构建必备认知
工匠日记
10-29 3966
本篇是 adat 项目的延伸文章，也是后续 Xcode 构建实操文章的铺垫，目的是让本系列的读者都有一个共同的认知，当读到某个章节时，不至于对某些概念产生疑惑。这些基础共识，如果你感觉有点模糊，请一定认真读完，如果已经具备，不妨再扫一眼，也许有惊喜哦。 内容概览 命令行用法文档 命令行使用手册 如何利用文档写一条命令 Target、Configuration 和 Scheme 到底是什么东西？ Project、Workspace 又是什么东西？ xcodebuild 基础命令 精彩预告 命令行用.
【Xcode安全加固手册】：最新安全补丁的应对与安装指南
[【Xcode安全加固手册】：最新安全补丁的应对与安装指南](https://opengraph.githubassets.com/bf113c899bc25c33d9ffeeb6c2b7753046df8b1de17ba78e3fb6ac4474cefc2f/zhangao0086/DKImagePickerController/issues/712...
Appium使用笔记整理及IOS的WDA工具的使用简介
weixin_41709624的博客
05-22 2736
概述 1、本人进入IT行业第一份工作是测试自动化方向的，所以针对这一段工作，对自动化测试工具Appium的学习、使用作出整理和总结。 2、对于appium工具的基础使用，注意以下几个关键字： （1）appium只是针对android、ios等的自动化工具进行了集成；还有就是appium这个集成工具是使用nodejs开发的。 （2）Appium clients list。 （3）Appium Ser...
xcodebuild命令
bafa4957的博客
03-22 403
一、xcodebuild命令介绍 　1.基本命令 查看xcodebuild简洁用法 xcodebuild -usage 查看已安装的SDK xcodebuild -showsdks 查看安装的版本号 xcodebuild -version [-sdk [<sdkfullpath>|<sdkname>]...
Xcodebuild命令使用
weixin_30275415的博客
08-17 400
Xcodebuild简介 Xcodebuild是命令行工具包的其中一项。 命令行工具包（Command Line Tools）是一个轻量的、可以与XCode分开的、在Mac上单独下载的命令行工具包。 它有两部分组成：Mac OS SDK和用户系统库目录/usr/bin下的诸多命令工具。例如：gcc/g++编译器，make、git、nase、xcodebuild、xcrun等等。 ...
jenkins+gitlab实现iOS自动打包的坎坷之路（本文包含CI\CD过程中的一些坑点以及一些理解及建议）
weixin_54401017的博客
01-27 2789
本文须知：本文成功案例是配置jekins所在服务器配置打包环境，并非在jenkins中配置打包环境。关于为何不采用在jenkins中配置打包环境将会在文中具体讲解。最后因为是基于jekins所在服务器配置的打包环境，按照本文所诉，实现ios自动打包将更易成功。
iOS 使用xcodebuild自动打包问题记录
减肥ing的博客
04-15 2478
近期我在使用 xcodebuild 自动打包脚本遇到一个问题： ** ARCHIVE FAILED ** The following build commands failed: PhaseScriptExecution [CP]\ Embed\ Pods\ Frameworks /Users/*****/Library/Developer/Xcode/DerivedData/*****-g...
使用 xcodebuild 命令导出 ipa 文件
星辰与海洋
09-04 4640
一、打开一个 terminal 窗口，进入到 xcode 工程文件所在目录，对于 cocos 工程需要进入到 proj.ios_mac 目录 二、执行 xcodebuild clean 进行清除 三、执行 xcodebuild archive -scheme "NewCocosProject1-mobile" -configuration "Release" -archiveP
利用xcodebuild和xcrun给iOS程序自动打包
萱的house
11-30 1957
今天在查阅自动化打包的相关资料，自动化打包，归根到底主要用到了xcodebuild和xcrun命令，及一些shell脚本实现自动化。 了解自动化打包之前，首先了解下传统的打包方式： 1) appstore 二进制程序包 打开你的项目，进入“Edit Project Settings”，进入Configuration页面，选中Release点击下面的Duplicate，复制一个新的配置项出
与 xcodebuild 命令有关的目录
acalism的专栏
05-10 1311
1. 默认设置 build 过程中生成的中间文件、日志和可执行文件，默认都存放在： ```shell ~/Library/Developer/Xcode/DerivedData/ProjName-hash ~/Library/Developer/Xcode/Archives/aa.xcarchive ``` 如何得到这个目录， ```shell # 显示项目设置，可以得到 xcodebuild -showBuildSettings | grep -i derivedData # 日志里会
ubuntu xcodebuild
最新发布
04-01
在 Ubuntu 系统中，`xcodebuild` 是 macOS 平台特有的工具，无法直接运行于 Linux 或其他非 Apple 的操作系统之上。这是因为 `xcodebuild` 高度依赖 macOS 和 Xcode 提供的特定环境以及库支持[^1]。 然而，可以通过一些替代方案来实现类似的构建功能： ### 替代方法一：使用 Docker 模拟 macOS 环境 Docker 可以通过容器化技术模拟一个接近真实的 macOS 开发环境。虽然官方不提供 macOS 的镜像，但社区中有许多开源项目可以帮助创建这样的环境。以下是具体操作方式： #### 步骤说明 1. **安装 Docker**：如果尚未安装 Docker，请先完成安装。 ```bash sudo apt update && sudo apt install docker.io ``` 2. **拉取 macOS Docker 镜像**：可以从 GitHub 上找到由开发者维护的相关镜像。 ```bash docker pull tonistiigi/osx-cross:latest ``` 3. **启动容器并执行 xcodebuild 命令**： ```bash docker run -it --rm tonistiigi/osx-cross bash xcodebuild -version ``` 此过程允许你在类 macOS 环境下测试和运行 `xcodebuild`[^2]。 --- ### 替代方法二：跨平台 CMake 构建系统 对于希望兼容多平台的应用程序开发而言，CMake 是一种更通用的选择。它能够生成适用于不同系统的 Makefile 文件或其他构建脚本。 #### 使用案例 假设有一个简单的 Swift 项目，则可通过如下方式进行设置： ```cmake # CMakeLists.txt 示例 cmake_minimum_required(VERSION 3.18) project(MySwiftProject LANGUAGES Swift) add_executable(${PROJECT_NAME} main.swift) ``` 接着利用以下命令完成整个流程： ```bash mkdir build && cd build cmake .. make ./MySwiftProject ``` 这种方法摆脱了对单一平台工具链（如 `xcodebuild`）的绑定需求。 --- ### 替代方法三：借助虚拟机或远程服务 另一种可行的办法是搭建一台专门用于 iOS/macOS 应用开发的 Mac 虚拟主机或者租赁云服务器资源。例如 AWS EC2 实例提供了预装好 Xcode 的 AMI 映像；又或者是采用第三方 CI/CD 解决方案比如 Bitrise、AppCenter 来处理这些复杂场景下的自动化部署工作流。 --- 尽管如此，在纯 Linux 下原生调用真正的 `xcodebuild` 几乎是不可能的任务，除非完全重构它的底层逻辑使之适应新架构——而这显然超出了大多数用户的实际能力范围之外[^3]。 ---
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值