NythyCleaner
← Blog

Como Limpar Caches do Xcode no Mac (DerivedData, Archives, Simuladores)

10 min de leitura
#xcode#macos#desenvolvedor#derived-data#limpeza

Como Limpar Caches do Xcode no Mac (DerivedData, Archives, Simuladores)

Se você desenvolve aplicativos iOS ou macOS, o Xcode é uma das maneiras mais rápidas de consumir espaço em disco. Os caches de DerivedData, Archives, simuladores e SwiftPM podem crescer para dezenas de gigabytes sem qualquer aviso na visão geral de Armazenamento.

Este guia explica o que cada pasta faz, o que você pode excluir com segurança e como automatizar a limpeza. Para uma estratégia de armazenamento mais ampla, consulte como liberar espaço em disco no Mac.

Por Que o Xcode Usa Tanto Espaço

O Xcode armazena várias categorias independentes de dados:

  • DerivedData — produtos de compilação intermediários, índices e caches de módulos. Seguro para excluir; o Xcode irá reconstruí-los na próxima compilação.
  • Archives — compilações de lançamento para App Store Connect e distribuição ad-hoc. Arquivos antigos são frequentemente esquecidos.
  • Simuladores — imagens completas de tempo de execução de dispositivos. A remoção de runtimes não utilizados recupera grandes quantidades de espaço.
  • SwiftPM — checkouts e artefatos de compilação em .build e caches do SwiftPM.
  • Suporte a dispositivos — símbolos para dispositivos iOS conectados; versões mais antigas podem ser removidas se você não testar mais essas versões do SO.

Nenhum destes é “seu código-fonte”. São artefatos reproduzíveis, e é por isso que excluí-los geralmente apresenta baixo risco.

Limpar DerivedData Manualmente

  1. Saia do Xcode.
  2. Abra o Finder e pressione Shift + Command + G.
  3. Cole: ~/Library/Developer/Xcode/DerivedData
  4. Exclua o conteúdo (ou a pasta inteira). O Xcode irá recriá-lo.

Alternativamente, no Xcode: Ajustes → Locais → Derived Data e clique na seta para abrir a pasta no Finder.

Remover Arquivos Antigos

Os arquivos estão em:

~/Library/Developer/Xcode/Archives

Cada pasta datada é um arquivo do Xcode. Exclua arquivos de versões antigas que você não precisa mais enviar ou depurar. Mantenha os recentes se você ainda simbolizar logs de falhas dessas compilações.

Aparar Runtimes de Simuladores

  1. Abra Xcode → Ajustes → Plataformas (ou Componentes em versões mais antigas do Xcode).
  2. Remova os runtimes de iOS/watchOS/tvOS que você não usa mais.

Você também pode excluir dados em ~/Library/Developer/CoreSimulator — mas prefira remover plataformas via Xcode primeiro para evitar quebrar projetos ativos.

SwiftPM e CocoaPods

  • SwiftPM: Checkouts em ~/Library/Caches/org.swift.swiftpm e pastas de projeto .build.
  • CocoaPods: A pasta Pods pode ser regenerada com pod install.

Se você estiver em dúvida, mantenha um backup ou use controle de versão antes de excluir pastas grandes dentro de um projeto.

Automatizar a Limpeza do Xcode com NythyCleaner

NythyCleaner inclui uma seção Desenvolvedor / Xcode que verifica caminhos comuns de desenvolvedor, resume quanto espaço cada categoria usa e permite limpá-los em um único fluxo de trabalho. Você pode combiná-lo com:

Lista de Verificação de Segurança

  • Feche o Xcode antes de excluir DerivedData ou grandes dados de simulador.
  • Não exclua suas pastas ~/Developer ou de projeto, a menos que você pretenda fazê-lo.
  • Mantenha os arquivos recentes da App Store se você ainda precisar fazer upload ou depurar compilações correspondentes.

Resumo

LocalizaçãoConteúdo TípicoSeguro para excluir?
DerivedDataSaídas de compilação, índicesSim (reconstrói)
ArchivesArquivos IPA/relacionados ao IPASim, se obsoleto
SimuladoresImagens de runtimeSim, runtimes não utilizados
Caches do SwiftPMDependências, compilaçõesGeralmente sim

Limpar os caches do Xcode regularmente mantém os SSDs rápidos e evita erros inesperados de “disco cheio” durante as compilações.