XcodeProj

<!-- ALL-CONTRIBUTORS-BADGE:START - 请勿删除或修改此部分 -->

<!-- ALL-CONTRIBUTORS-BADGE:END -->

XcodeProj 是一个用 Swift 编写的库，用于解析和处理 Xcode 项目。它深受 CocoaPods XcodeProj 和 xcode 的启发。

---

• XcodeProj
  • 使用 XcodeProj 的项目
  • 安装
    • Swift Package Manager
    • 脚本
  • 文档 📝
  • 参考资料 📚
  • 贡献
  • 许可证
  • 贡献者 ✨

使用 XcodeProj 的项目

项目	仓库
ProjLint	github.com/JamitLabs/ProjLint
rules_xcodeproj	github.com/buildbuddy-io/rules_xcodeproj
Rugby	github.com/swiftyfinch/Rugby
Sourcery	github.com/krzysztofzablocki/Sourcery
Tuist	github.com/tuist/tuist
XcodeGen	github.com/yonaskolb/XcodeGen
xspm	gitlab.com/Pyroh/xspm
Privacy Manifest	github.com/stelabouras/privacy-manifest

如果您的项目也在使用 XcodeProj，欢迎提交 PR 将其添加到上面的列表中。

安装

Swift Package Manager

在 Package.swift 文件中添加依赖：

let package = Package(
    name: "myproject",
    dependencies: [
        .package(url: "https://github.com/tuist/XcodeProj.git", .upToNextMajor(from: "8.12.0")),
    ],
    targets: [
        .target(
            name: "myproject",
            dependencies: ["XcodeProj"]),
        ]
)

脚本

使用 swift-sh 可以通过脚本自动化项目任务，例如，我们可以创建一个脚本，使项目的版本键与当前表示项目版本的 git 标签保持同步：

#!/usr/bin/swift sh
import Foundation
import XcodeProj  // @tuist ~> 8.8.0
import PathKit

guard CommandLine.arguments.count == 3 else {
    let arg0 = Path(CommandLine.arguments[0]).lastComponent
    fputs("用法: \(arg0) <project> <new-version>\n", stderr)
    exit(1)
}

let projectPath = Path(CommandLine.arguments[1])
let newVersion = CommandLine.arguments[2]
let xcodeproj = try XcodeProj(path: projectPath)
let key = "CURRENT_PROJECT_VERSION"

for conf in xcodeproj.pbxproj.buildConfigurations where conf.buildSettings[key] != nil {
    conf.buildSettings[key] = newVersion
}

try xcodeproj.write(path: projectPath)

然后您可以将其存储在仓库中，例如保存为 scripts/set-project-version，然后运行它：

$ scripts/set-project-version ./App.xcodeproj 1.2.3
$ git add App.xcodeproj
$ git commit -m "更新版本"
$ git tag 1.2.3

未来的适配可以轻松包括确定版本并自动升级。如果这样做，我们建议使用提供 Version 对象的库。

文档 📝

想开始使用 XcodeProj 吗？首先深入了解我们的文档，它将帮助你熟悉 API 并更好地了解 Xcode 项目结构。

参考资料 📚

• Xcode 项目文件格式
• Xcode 项目格式简介
• pbexplorer
• pbxproj 标识符
• mob-pbxproj
• Xcodeproj
• Nanaimo
• Facebook Buck
• Swift Package Manager - Xcodeproj

贡献

1. 克隆代码库 git@github.com:tuist/xcodeproj.git。
2. 用 Xcode 打开 Package.swift。

许可证

XcodeProj 基于 MIT 许可证发布。查看 LICENSE 了解详情。

贡献者 ✨

感谢这些优秀的人（表情符号说明）：

<!-- ALL-CONTRIBUTORS-LIST:START - 请勿删除或修改此部分 --> <!-- prettier-ignore-start --> <!-- markdownlint-disable --> <table> <tbody> <tr> <td align="center" valign="top" width="14.28%"><a href="https://joecolicch.io"><img src="https://avatars3.githubusercontent.com/u/2837288?v=4?s=100" width="100px;" alt="Joseph Colicchio"/><br />_{<b>Joseph Colicchio</b>}</a><br /><a href="#ideas-jcolicchio" title="想法、规划与反馈">🤔</a></td> <td align="center" valign="top" width="14.28%"><a href="https://github.com/deatondg"><img src="https://avatars0.githubusercontent.com/u/3221590?v=4?s=100" width="100px;" alt="deatondg"/><br />_{<b>deatondg</b>}</a><br /><a href="#ideas-deatondg" title="想法、规划与反馈">🤔</a></td> <td align="center" valign="top" width="14.28%"><a href="https://github.com/dflems"><img src="https://avatars3.githubusercontent.com/u/925850?v=4?s=100" width="100px;" alt="Dan Fleming"/><br />_{<b>Dan Fleming</b>}</a><br /><a href="https://github.com/tuist/XcodeProj/commits?author=dflems" title="代码">💻</a></td> <td align="center" valign="top" width="14.28%"><a href="https://twitter.com/_SaschaS"><img src="https://avatars3.githubusercontent.com/u/895505?v=4?s=100" width="100px;" alt="Sascha Schwabbauer"/><br />_{<b>Sascha Schwabbauer</b>}</a><br /><a href="#ideas-sascha" title="想法、规划与反馈">🤔</a></td> <td align="center" valign="top" width="14.28%"><a href="https://github.com/marciniwanicki"><img src="https://avatars3.githubusercontent.com/u/946649?v=4?s=100" width="100px;" alt="Marcin Iwanicki"/><br />_{<b>Marcin Iwanicki</b>}</a><br /><a href="#maintenance-marciniwanicki" title="维护">🚧</a></td> <td align="center" valign="top" width="14.28%"><a href="https://github.com/adamkhazi"><img src="https://avatars2.githubusercontent.com/u/9820670?v=4?s=100" width="100px;" alt="Adam Khazi"/><br />_{<b>Adam Khazi</b>}</a><br /><a href="#maintenance-adamkhazi" title="维护">🚧</a></td> <td align="center" valign="top" width="14.28%"><a href="https://github.com/elliottwilliams"><img src="https://avatars3.githubusercontent.com/u/910198?v=4?s=100" width="100px;" alt="Elliott Williams"/><br />_{<b>Elliott Williams</b>}</a><br /><a href="https://github.com/tuist/XcodeProj/commits?author=elliottwilliams" title="代码">💻</a></td> </tr> <tr> <td align="center" valign="top" width="14.28%"><a href="http://muukii.app"><img src="https://avatars.githubusercontent.com/u/1888355?v=4?s=100" width="100px;" alt="Muukii"/><br />_{<b>Muukii</b>}</a><br /><a href="#content-muukii" title="内容">🖋</a></td> <td align="center" valign="top" width="14.28%"><a href="https://nnsnodnb.github.io"><img src="https://avatars.githubusercontent.com/u/9856514?v=4?s=100" width="100px;" alt="Yuya Oka"/><br />_{<b>Yuya Oka</b>}</a><br /><a href="https://github.com/tuist/XcodeProj/commits?author=nnsnodnb" title="代码">💻</a></td> <td align="center" valign="top" width="14.28%"><a href="https://smileykeith.com"><img src="https://avatars.githubusercontent.com/u/283886?v=4?s=100" width="100px;" alt="Keith Smiley"/><br />_{<b>Keith Smiley</b>}</a><br /><a href="#content-keith" title="内容">🖋</a></td> <td align="center" valign="top" width="14.28%"><a href="https://github.com/ileitch"><img src="https://avatars.githubusercontent.com/u/48235?v=4?s=100" width="100px;" alt="Ian Leitch"/><br />_{<b>Ian Leitch</b>}</a><br /><a href="https://github.com/tuist/XcodeProj/commits?author=ileitch" title="代码">💻</a></td> <td align="center" valign="top" width="14.28%"><a href="https://github.com/subdan"><img src="https://avatars.githubusercontent.com/u/410293?v=4?s=100" width="100px;" alt="Daniil Subbotin"/><br />_{<b>Daniil Subbotin</b>}</a><br /><a href="https://github.com/tuist/XcodeProj/commits?author=subdan" title="代码">💻</a></td> <td align="center" valign="top" width="14.28%"><a href="https://www.florentin.tech"><img src="https://avatars.githubusercontent.com/u/8288625?v=4?s=100" width="100px;" alt="Florentin Bekier"/><br />_{<b>Florentin Bekier</b>}</a><br /><a href="https://github.com/tuist/XcodeProj/commits?author=flowbe" title="代码">💻</a></td> <td align="center" valign="top" width="14.28%"><a href="https://github.com/CognitiveDisson"><img src="https://avatars.githubusercontent.com/u/10621118?v=4?s=100" width="100px;" alt="Vadim Smal"/><br />_{<b>Vadim Smal</b>}</a><br /><a href="https://github.com/tuist/XcodeProj/issues?q=author%3ACognitiveDisson" title="错误报告">🐛</a></td> </tr> <tr> <td align="center" valign="top" width="14.28%"><a href="http://freddi.dev"><img src="https://avatars.githubusercontent.com/u/13707872?v=4?s=100" width="100px;" alt="freddi(Yuki Aki)"/><br />_{<b>freddi(Yuki Aki)</b>}</a><br /><a href="https://github.com/tuist/XcodeProj/commits?author=freddi-kit" title="代码">💻</a></td> <td align="center" valign="top" width="14.28%"><a href="http://KrisRJack.com"><img src="https://avatars.githubusercontent.com/u/35638500?v=4?s=100" width="100px;" alt="Kristopher Jackson"/><br />_{<b>Kristopher Jackson</b>}</a><br /><a href="https://github.com/tuist/XcodeProj/commits?author=KrisRJack" title="代码">💻</a></td> <td align="center" valign="top" width="14.28%"><a href="https://github.com/Jake-Prickett"><img src="https://avatars.githubusercontent.com/u/26095410?v=4?s=100" width="100px;" alt="Jake Prickett"/><br />_{<b>Jake Prickett</b>}</a><br /><a href="https://github.com/tuist/XcodeProj/commits?author=Jake-Prickett" title="代码">💻</a></td> <td align="center" valign="top" width="14.28%"><a href="http://www.jakeadams.co"><img src="https://avatars.githubusercontent.com/u/3605966?v=4?s=100" width="100px;" alt="Jake Adams"/><br />_{<b>Jake Adams</b>}</a><br /><a href="https://github.com/tuist/XcodeProj/commits?author=jakeatoms" title="代码">💻</a></td> <td align="center" valign="top" width="14.28%"><a href="https://github.com/mtj0928"><img src="https://avatars.githubusercontent.com/u/12427733?v=4?s=100" width="100px;" alt="matsuji"/><br />_{<b>matsuji</b>}</a><br /><a href="https://github.com/tuist/XcodeProj/commits?author=mtj0928" title="代码">💻</a></td> <td align="center" valign="top" width="14.28%"><a href="https://github.com/Bogdan-Belogurov"><img src="https://avatars.githubusercontent.com/u/39379705?v=4?s=100" width="100px;" alt="Bogdan Belogurov"/><br />_{<b>Bogdan Belogurov</b>}</a><br /><a href="https://github.com/tuist/XcodeProj/commits?author=Bogdan-Belogurov" title="代码">💻</a></td> <td align="center" valign="top" width="14.28%"><a href="https://chuckgrindel.com/"><img src="https://avatars.githubusercontent.com/u/159968?v=4?s=100" width="100px;" alt="Chuck Grindel"/><br />_{<b>Chuck Grindel</b>}</a><br /><a href="https://github.com/tuist/XcodeProj/commits?author=cgrindel" title="代码">💻</a></td> </tr> <tr> <td align="center" valign="top" width="14.28%"><a href="https://twitter.com/MonocularVision"><img src="https://avatars.githubusercontent.com/u/429790?v=4?s=100" width="100px;" alt="Michael McGuire"/><br />_{<b>Michael McGuire</b>}</a><br /><a href="https://github.com/tuist/XcodeProj/commits?author=michaelmcguire" title="代码">💻</a></td> <td align="center" valign="top" width="14.28%"><a href="https://github.com/CrazyFanFan"><img src="https://avatars.githubusercontent.com/u/15794964?v=4?s=100" width="100px;" alt="C-凡"/><br />_<b>C-凡</b></a><br /><a href="https://github.com/tuist/XcodeProj/commits?author=CrazyFanFan" title="代码">💻</a></td> <td align="center" valign="top" width="14.28%"><a href="http://www.tinder.com"><img src="https://avatars.githubusercontent.com/u/566328?v=4?s=100" width="100px;" alt="Maxwell Elliott"/><br />_{<b>Maxwell Elliott</b>}</a><br /><a href="https://github.com/tuist/XcodeProj/commits?author=maxwellE" title="代码">💻</a></td> <td align="center" valign="top" width="14.28%"><a href="https://brentleyjones.com"><img src="https://avatars.githubusercontent.com/u/158658?v=4?s=100" width="100px;" alt="Brentley Jones"/><br />_{<b>Brentley Jones</b>}</a><br /><a href="https://github.com/tuist/XcodeProj/commits?author=brentleyjones" title="代码">💻</a></td> <td align="center" valign="top" width="14.28%"><a href="https://www.linkedin.com/in/tiemevanveen"><img src="https://avatars.githubusercontent.com/u/1330668?v=4?s=100" width="100px;" alt="Teameh"/><br />_{<b>Teameh</b>}</a><br /><a href="https://github.com/tuist/XcodeProj/commits?author=teameh" title="代码">💻</a></td> <td align="center" valign="top" width="14.28%"><a href="https://technocidal.com"><img src="https://avatars.githubusercontent.com/u/14994778?v=4?s=100" width="100px;" alt="Johannes Ebeling"/><br />_{<b>Johannes Ebeling</b>}</a><br /><a href="https://github.com/tuist/XcodeProj/commits?author=technocidal" title="代码">💻</a></td> <td align="center" valign="top" width="14.28%"><a href="https://baegteun.com"><img src="https://avatars.githubusercontent.com/u/74440939?v=4?s=100" width="100px;" alt="baegteun"/><br />_{<b>baegteun</b>}</a><br /><a href="https://github.com/tuist/XcodeProj/commits?author=baekteun" title="文档">📖</a></td> </tr> <tr> <td align="center" valign="top" width="14.28%"><a href="https://kobachi.jp"><img src="https://avatars.githubusercontent.com/u/103150233?v=4?s=100" width="100px;" alt="Alex Kovács"/><br />_{<b>Alex Kovács</b>}</a><br /><a href="https://github.com/tuist/XcodeProj/commits?author=AlexKobachiJP" title="文档">📖</a></td> <td align="center" valign="top" width="14.28%"><a href="http://zenangst.com"><img src="https://avatars.githubusercontent.com/u/57446?v=4?s=100" width="100px;" alt="Christoffer Winterkvist"/><br />_{<b>Christoffer Winterkvist</b>}</a><br /><a href="https://github.com/tuist/XcodeProj/commits?author=zenangst" title="代码">💻</a></td> <td align="center" valign="top" width="14.28%"><a href="http://www.timothycosta.com"><img src="https://avatars.githubusercontent.com/u/948806?v=4?s=100" width="100px;" alt="Timothy Costa"/><br />_{<b>Timothy Costa</b>}</a><br /><a href="https://github.com/tuist/XcodeProj/commits?author=timothycosta" title="代码">💻</a></td> <td align="center" valign="top" width="14.28%"><a href="https://coolmathgames.tech"><img src="https://avatars.githubusercontent.com/u/6877780?v=4?s=100" width="100px;" alt="Mary "/><br />_{<b>Mary </b>}</a><br /><a href="https://github.com/tuist/XcodeProj/commits?author=Mstrodl" title="代码">💻</a></td> <td align="center" valign="top" width="14.28%"><a href="https://github.com/Ibrahimhass"><img src="https://avatars.githubusercontent.com/u/16992520?v=4?s=100" width="100px;" alt="Md. Ibrahim Hassan"/><br />_{<b>Md. Ibrahim Hassan</b>}</a><br /><a href="https://github.com/tuist/XcodeProj/commits?author=Ibrahimhass" title="代码">💻</a></td> <td align="center" valign="top" width="14.28%"><a href="https://github.com/tatagrigory"><img src="https://avatars.githubusercontent.com/u/5187973?v=4?s=100" width="100px;" alt="tatagrigory"/><br />_{<b>tatagrigory</b>}</a><br /><a href="https://github.com/tuist/XcodeProj/commits?author=tatagrigory" title="代码">💻</a></td> <td align="center" valign="top" width="14.28%"><a href="https://github.com/art-divin"><img src="https://avatars.githubusercontent.com/u/1614869?v=4?s=100" width="100px;" alt="Ruslan Alikhamov"/><br />_{<b>Ruslan Alikhamov</b>}</a><br /><a href="https://github.com/tuist/XcodeProj/commits?author=art-divin" title="代码">💻</a></td> </tr> <tr> <td align="center" valign="top" width="14.28%"><a href="https://ladislas.detoldi.me"><img src="https://avatars.githubusercontent.com/u/2206544?v=4?s=100" width="100px;" alt="Ladislas de Toldi"/><br />_{<b>Ladislas de Toldi</b>}</a><br /><a href="https://github.com/tuist/XcodeProj/commits?author=ladislas" title="代码">💻</a></td> <td align="center" valign="top" width="14.28%"><a href="https://www.massicotte.org"><img src="https://avatars.githubusercontent.com/u/85322?v=4?s=100" width="100px;" alt="Matt Massicotte"/><br />_{<b>Matt Massicotte</b>}</a><br /><a href="https://github.com/tuist/XcodeProj/commits?author=mattmassicotte" title="代码">💻</a></td> <td align="center" valign="top" width="14.28%"><a href="https://github.com/VorkhlikArtem"><img src="https://avatars.githubusercontent.com/u/115653999?v=4?s=100" width="100px;" alt="Артем Ворхлик"/><br />_{<b>Артем Ворхлик</b>}</a><br /><a href="https://github.com/tuist/XcodeProj/commits?author=VorkhlikArtem" title="代码">💻</a></td> <td align="center" valign="top" width="14.28%"><a href="https://github.com/woin2ee"><img src="https://avatars.githubusercontent.com/u/81426024?v=4?s=100" width="100px;" alt="Jaewon-Yun"/><br />_{<b>Jaewon-Yun</b>}</a><br /><a href="https://github.com/tuist/XcodeProj/commits?author=woin2ee" title="代码">💻</a></td> <td align="center" valign="top" width="14.28%"><a href="https://gera.cx"><img src="https://avatars.githubusercontent.com/u/715129?v=4?s=100" width="100px;" alt="Mike Gerasymenko"/><br />_{<b>Mike Gerasymenko</b>}</a><br /><a href="https://github.com/tuist/XcodeProj/commits?author=mikeger" title="代码">💻</a></td> <td align="center" valign="top" width="14.28%"><a href="https://github.com/filipracki"><img src="https://avatars.githubusercontent.com/u/27164368?v=4?s=100" width="100px;" alt="Filip Racki"/><br />_{<b>Filip Racki</b>}</a><br /><a href="https://github.com/tuist/XcodeProj/commits?author=filipracki" title="代码">💻</a></td> </tr> </tbody> </table> <!-- markdownlint-restore --> <!-- prettier-ignore-end --> <!-- ALL-CONTRIBUTORS-LIST:END -->

本项目遵循all-contributors规范。欢迎各种形式的贡献！