---
title: "De pbxproj a xcproj: a configuração de projeto do Xcode ganha formato JSON"
description: "O Xcode 27.2 introduz o project.xcproj, que substitui o project.pbxproj como descrição de build do projeto: árvore legível, diffs menores, merges menos conflituosos e um caminho direto para coding agents. Com o xcode-project-format open source da Apple e o impacto para Tuist e XcodeGen."
canonical: "https://ronanrodrigo.dev/notes/xcproj-json-project-format"
markdown: "https://ronanrodrigo.dev/notes/xcproj-json-project-format.md"
last-updated: "2026-09-21"
---
## From pbxproj to xcproj: Xcode Project Configuration Gets a JSON Format

Xu Yang (fatbobman) analisa o novo `project.xcproj` do Xcode 27.2, que substitui o `project.pbxproj` como arquivo de configuração de build dentro do bundle `.xcodeproj`. O formato troca a tabela plana de IDs da era NeXT por uma árvore que espelha a UI (`files` / `targets` / `build-settings`), inverte a direção das relações via `target-membership` e reduz referências cruzadas a nomes e caminhos — diffs mais legíveis, merges menos conflituosos e modificações diretas por tools e coding agents, sem alterar o modelo de projeto subjacente. Projetos novos já usam `xcproj` por padrão; existentes podem converter via File inspector ou `xcodebuild -convert-project`. O texto também examina o que muda para Tuist, XcodeGen, Bazel e xcconfig — nada desloca esses manifests, e times que mantêm `.xcodeproj` à mão são os que mais ganham — e observa que o formato foi arquivado pela Apple sob "Coding Intelligence": menos uma revolução, mais o pistão antigo reasfaltado para agents rodarem nele.

[Acesse a fonte original](https://fatbobman.com/en/posts/from-pbxproj-to-xcproj/)

## Updating your Xcode project configuration file format

Documentação oficial da Apple que introduz o novo formato `project.xcproj` no Xcode 27.2: o que o JSON-based format cobre, como migrar projetos existentes e como ferramentas automatizadas e assistivas passam a ler e editar a configuração do projeto.

[Acesse a fonte original](https://developer.apple.com/documentation/xcode/updating-your-xcode-project-configuration-file-format)

## apple/xcode-project-format

Biblioteca Swift open source da Apple para ler, escrever e manipular o formato `project.xcproj`, modelando o schema como tipos de valor sob o namespace `XCSchema` — geradores, linters e validadores não precisam mais fazer engenharia reversa do formato. O pacote inclui o `xcprojformatter`, CLI que valida e reformata arquivos já no novo formato (não é um conversor de `pbxproj`).

[Acesse a fonte original](https://github.com/apple/xcode-project-format)