Repolode
Enviar
yonaskolb

yonaskolb/XcodeGen

Ferramenta de linha de comando em Swift que gera projetos Xcode a partir de uma especificação YAML ou JSON e da estrutura de pastas.

Ver no GitHub
Estrelas
8,930
Forks
918
Issues abertas
404
Último commit
há 26 dias

O que é?

O XcodeGen cria um projeto Xcode a partir de um arquivo de especificação legível por humanos, que define targets, configurações, schemes, build settings e dependências. Os diretórios de código-fonte são analisados automaticamente e espelhados como grupos no Xcode, então adicionar ou mover arquivos no disco também atualiza o projeto, sem edições manuais no Xcode.

Como o arquivo .xcodeproj pode ser gerado novamente sob demanda, as equipes podem removê-lo do git e evitar os conflitos de merge que arquivos de projeto costumam causar. A especificação pode ser dividida em vários arquivos, e grupos compartilhados de build settings permitem que vários targets reutilizem a mesma configuração. A geração pode ser feita pela linha de comando, inclusive no CI.

A ferramenta oferece suporte a pacotes do Swift Package Manager, frameworks do Carthage, SDKs do sistema e frameworks multiplataforma como dependências. Também pode exportar a especificação resolvida em vários formatos e oferece uma opção de cache para ignorar a geração quando nada mudou.

Recursos principais

  • 01Gera projetos Xcode a partir de uma especificação YAML ou JSON, mantendo os grupos sincronizados com a estrutura de pastas.
  • 02Remove o .xcodeproj do git para evitar conflitos de merge nos arquivos do projeto.
  • 03Compartilha build settings entre targets por meio de grupos de build settings.
  • 04Cria schemes automaticamente para diferentes ambientes.
  • 05Divide a especificação em vários arquivos para compartilhamento e sobrescrita.
  • 06Oferece suporte a pacotes Swift, frameworks do Carthage e dependências de SDKs.

Casos de uso

  • Manter arquivos .xcodeproj fora do controle de versão para evitar conflitos de merge em equipes de iOS ou macOS.
  • Gerar projetos Xcode em máquinas de CI a partir de uma única especificação.
  • Manter projetos grandes com muitos targets e build settings compartilhados.
  • Criar novos projetos com configurações consistentes a partir de uma especificação modelo.

Início rápido

  1. 1

    Verifique se a versão estável mais recente do Xcode está instalada

  2. 2

    Instale o XcodeGen com o Homebrew

    brew install xcodegen
  3. 3

    Gere o projeto do Xcode a partir da especificação do seu projeto no diretório atual

    xcodegen generate

Antes de usar

  • Requer o Xcode, por isso funciona apenas para o desenvolvimento de plataformas Apple no macOS.

Em coleções

Ferramentas de CLI e terminalApps open source para Mac

Tópicos

#xcode#swift#ios#macos#cli#project-generator#yaml#ci#generator#specification

Perguntas frequentes

O que é XcodeGen?
Ferramenta de linha de comando em Swift que gera projetos Xcode a partir de uma especificação YAML ou JSON e da estrutura de pastas. O XcodeGen cria um projeto Xcode a partir de um arquivo de especificação legível por humanos, que define targets, configurações, schemes, build settings e dependências. Os diretórios de código-fonte são analisados automaticamente e espelhados como grupos no Xcode, então adicionar ou mover arquivos no disco também atualiza o projeto, sem edições manuais no Xcode.
XcodeGen é gratuito? Qual é a licença?
XcodeGen é open source sob a licença MIT. Confira os termos da licença antes de usá-lo em produtos comerciais.
XcodeGen ainda é mantido?
Manutenção ativa. O último commit de XcodeGen foi em 13 de out. de 2026.
Para que posso usar XcodeGen?
Manter arquivos .xcodeproj fora do controle de versão para evitar conflitos de merge em equipes de iOS ou macOS. Gerar projetos Xcode em máquinas de CI a partir de uma única especificação. Manter projetos grandes com muitos targets e build settings compartilhados. Criar novos projetos com configurações consistentes a partir de uma especificação modelo.
Como instalar XcodeGen?
Verifique se a versão estável mais recente do Xcode está instalada Instale o XcodeGen com o Homebrew: brew install xcodegen Gere o projeto do Xcode a partir da especificação do seu projeto no diretório atual: xcodegen generate
Onde consigo XcodeGen?
O código-fonte e as instruções de instalação estão no GitHub: https://github.com/yonaskolb/XcodeGen

Resumo gerado por IA a partir do README do projeto. As estatísticas do GitHub são atualizadas diariamente.

Projetos relacionados