[Feature]:
Personne n'a encore pris cette issue.
Évaluation
- Difficulté
- 5/5
- Temps estimé
- Plus d'une semaine
- Accessibilité débutants
- 20/100
Piste de recherche
The issue describes the project’s overall purpose and capabilities, but does not specify a feature to implement or name files, tests, or an entry point. Read CONTRIBUTING.md to learn the project’s accepted scope, then clarify which Xcode project format capability is missing and how it should be verified before starting work.
Rédigé par le modèle d'indexation à partir du texte de l'issue.
Description
Describe the feature
xcode-project-format
xcode-project-format is a Swift library for reading, writing, and manipulating Xcode's JSON-based project.xcproj format. It models the format as a rich set of value types nested under a single namespace, XCSchema, so consumers get precise, typed access to a project's structure instead of hand-parsing JSON.
The goal is to give the ecosystem a shared, accurate model of the Xcode project format — so tools like generators, linters, verifiers, and validators don't each have to reverse-engineer the format from scratch.
The package also ships xcprojformatter, a small CLI tool built on the library.
Getting started
Requirements
Swift 6.1 or later
macOS 14 or later (the library also builds on non-Darwin platforms; see Package.swift)
Installation
Add the package as a dependency in your Package.swift:
dependencies: [
.package(url: "https://github.com/apple/xcode-project-format/", from: "0.1.0")
]
Usage
import XcodeProjectFormat
func listTargets(in projectURL: URL) throws {
let projectData = try Data(contentsOf: projectURL)
let project = try XCSchema.Project(jsonRepresentation: projectData)
for target in project.targets {
print(target.name)
}
}
You'll find types for folders, file references, groups, targets, build phases, build rules, and the rest of the Xcode project model within this package.
Documentation
The project documentation is available at Swift Package Index.
To preview it locally:
swift package add-dependency https://github.com/swiftlang/swift-docc-plugin --from 1.5.0
swift package --disable-sandbox preview-documentation
Contributing
We welcome contributions within a defined scope. See CONTRIBUTING.md for what we accept, what's out of scope for now, and how to get started.
Support
GitHub Issues — bug reports, feature requests, and questions
License
Licensed under the Apache License 2.0 with Runtime Library Exception.
Use case
xcode-project-format
xcode-project-format is a Swift library for reading, writing, and manipulating Xcode's JSON-based project.xcproj format. It models the format as a rich set of value types nested under a single namespace, XCSchema, so consumers get precise, typed access to a project's structure instead of hand-parsing JSON.
The goal is to give the ecosystem a shared, accurate model of the Xcode project format — so tools like generators, linters, verifiers, and validators don't each have to reverse-engineer the format from scratch.
The package also ships xcprojformatter, a small CLI tool built on the library.
Getting started
Requirements
Swift 6.1 or later
macOS 14 or later (the library also builds on non-Darwin platforms; see Package.swift)
Installation
Add the package as a dependency in your Package.swift:
dependencies: [
.package(url: "https://github.com/apple/xcode-project-format/", from: "0.1.0")
]
Usage
import XcodeProjectFormat
func listTargets(in projectURL: URL) throws {
let projectData = try Data(contentsOf: projectURL)
let project = try XCSchema.Project(jsonRepresentation: projectData)
for target in project.targets {
print(target.name)
}
}
You'll find types for folders, file references, groups, targets, build phases, build rules, and the rest of the Xcode project model within this package.
Documentation
The project documentation is available at Swift Package Index.
To preview it locally:
swift package add-dependency https://github.com/swiftlang/swift-docc-plugin --from 1.5.0
swift package --disable-sandbox preview-documentation
Contributing
We welcome contributions within a defined scope. See CONTRIBUTING.md for what we accept, what's out of scope for now, and how to get started.
Support
GitHub Issues — bug reports, feature requests, and questions
License
Licensed under the Apache License 2.0 with Runtime Library Exception.
Alternatives considered
No response
Additional context
xcode-project-format
xcode-project-format is a Swift library for reading, writing, and manipulating Xcode's JSON-based project.xcproj format. It models the format as a rich set of value types nested under a single namespace, XCSchema, so consumers get precise, typed access to a project's structure instead of hand-parsing JSON.
The goal is to give the ecosystem a shared, accurate model of the Xcode project format — so tools like generators, linters, verifiers, and validators don't each have to reverse-engineer the format from scratch.
The package also ships xcprojformatter, a small CLI tool built on the library.
Getting started
Requirements
Swift 6.1 or later
macOS 14 or later (the library also builds on non-Darwin platforms; see Package.swift)
Installation
Add the package as a dependency in your Package.swift:
dependencies: [
.package(url: "https://github.com/apple/xcode-project-format/", from: "0.1.0")
]
Usage
import XcodeProjectFormat
func listTargets(in projectURL: URL) throws {
let projectData = try Data(contentsOf: projectURL)
let project = try XCSchema.Project(jsonRepresentation: projectData)
for target in project.targets {
print(target.name)
}
}
You'll find types for folders, file references, groups, targets, build phases, build rules, and the rest of the Xcode project model within this package.
Documentation
The project documentation is available at Swift Package Index.
To preview it locally:
swift package add-dependency https://github.com/swiftlang/swift-docc-plugin --from 1.5.0
swift package --disable-sandbox preview-documentation
Contributing
We welcome contributions within a defined scope. See CONTRIBUTING.md for what we accept, what's out of scope for now, and how to get started.
Support
GitHub Issues — bug reports, feature requests, and questions
License
Licensed under the Apache License 2.0 with Runtime Library Exception.
- Langage dominant
- Swift
- Étoiles
- 544
- Forks
- 36
- Métriques de merge des PR
- Aucune PR mergée en 30 j
Préparer son environnement
- Aucun Dockerfile ni fichier Docker Compose
- Propose un modèle de pull request
- Lire le guide de contribution
Par où commencer
- Lisez l'issue en entier, puis le guide de contribution du projet.
- Signalez en commentaire que vous la prenez — cela évite que deux personnes fassent le même travail.
- Forkez le dépôt et travaillez sur une branche.
- Ouvrez une pull request qui référence le numéro de l'issue.
Autres issues de apple/xcode-project-format
-
bug
Difficulté 2/5 1-3 heures Accessibilité débutants 70/100
-
Negative encoding value crashes the decoderPeut-être pris @nassersala l’a pris il y a 58 jours. Ouverte
Difficulté 2/5 1-3 heures Accessibilité débutants 84/100
-
[Bug]: Decoder does not restore the parent value after decoding a childPeut-être pris @hippi345 l’a pris il y a 31 jours. Ouvertebug
Difficulté 2/5 1-3 heures Accessibilité débutants 88/100
-
XcodeOuverteenhancement
Difficulté 5/5 Plus d'une semaine Accessibilité débutants 25/100
-
[Feature]:Ouverteenhancement
Difficulté 1/5 Moins d'une heure Accessibilité débutants 15/100
Toutes les issues de apple/xcode-project-format
Issues similaires
-
Difficulté 2/5 1-3 heures Accessibilité débutants 72/100
OneBusAway/onebusaway-ios#1749 ·
Les mainteneurs répondent en général sous 1 jour
-
Difficulté 2/5 1-3 heures Accessibilité débutants 78/100
Les mainteneurs répondent en général sous 1 jour
-
[低] 更新配置里的 mirror_base_url 无人读取Ouverte
Difficulté 2/5 Moins d'une heure Accessibilité débutants 62/100