Git ignora arquivo para projetos Xcode

Quais arquivos devo include no .gitignore ao usar o Git em conjunto com o Xcode ?

Mods: Por favor, não aprove as edições para esta resposta. Até agora, todas as edições foram INCORRECTAS e causaram perda de dados. Por favor, deixe esta resposta em paz!


Se você quiser editar esta resposta … não. Leia a coisa toda primeiro – há uma maneira fácil de você fazer seu próprio garfo, e se isso não for suficiente, então comente.


Eu estava usando anteriormente a resposta mais votada, mas ela precisa de um pouco de limpeza, então aqui está uma nova versão do Xcode 4, com algumas melhorias.

Eu pesquisei todos os arquivos nesta lista, mas vários deles não existem nos documentos oficiais do xcode da Apple, então eu tive que ir nas listas de discussão da Apple.

A Apple continua adicionando arquivos não documentados, potencialmente corrompendo nossos projetos ao vivo. Esta IMHO é inaceitável, e agora eu comecei a registrar erros contra ela toda vez que eles fazem isso. Eu sei que eles não se importam, mas talvez seja uma vergonha para um deles tratar os desenvolvedores de forma mais justa.


Se você precisa personalizar, aqui está uma essência que você pode bifurcar: https://gist.github.com/3786883


 ######################### # .gitignore file for Xcode4 and Xcode5 Source projects # # Apple bugs, waiting for Apple to fix/respond: # # 15564624 - what does the xccheckout file in Xcode5 do? Where's the documentation? # # Version 2.6 # For latest version, see: http://stackoverflow.com/questions/49478/git-ignore-file-for-xcode-projects # # 2015 updates: # - Fixed typo in "xccheckout" line - thanks to @lyck for pointing it out! # - Fixed the .idea optional ignore. Thanks to @hashier for pointing this out # - Finally added "xccheckout" to the ignore. Apple still refuses to answer support requests about this, but in practice it seems you should ignore it. # - minor tweaks from Jona and Coeur (slightly more precise xc* filtering/names) # 2014 updates: # - appended non-standard items DISABLED by default (uncomment if you use those tools) # - removed the edit that an SO.com moderator made without bothering to ask me # - researched CocoaPods .lock more carefully, thanks to Gokhan Celiker # 2013 updates: # - fixed the broken "save personal Schemes" # - added line-by-line explanations for EVERYTHING (some were missing) # # NB: if you are storing "built" products, this WILL NOT WORK, # and you should use a different .gitignore (or none at all) # This file is for SOURCE projects, where there are many extra # files that we want to exclude # ######################### ##### # OS X temporary files that should never be committed # # cf http://www.westwind.com/reference/os-x/invisibles.html .DS_Store # cf http://www.westwind.com/reference/os-x/invisibles.html .Trashes # cf http://www.westwind.com/reference/os-x/invisibles.html *.swp # # *.lock - this is used and abused by many editors for many different things. # For the main ones I use (eg Eclipse), it should be excluded # from source-control, but YMMV. # (lock files are usually local-only file-synchronization on the local FS that should NOT go in git) # cf the "OPTIONAL" section at bottom though, for tool-specific variations! # # In particular, if you're using CocoaPods, you'll want to comment-out this line: *.lock # # profile - REMOVED temporarily (on double-checking, I can't find it in OS X docs?) #profile #### # Xcode temporary files that should never be committed # # NB: NIB/XIB files still exist even on Storyboard projects, so we want this... *~.nib #### # Xcode build files - # # NB: slash on the end, so we only remove the FOLDER, not any files that were badly named "DerivedData" DerivedData/ # NB: slash on the end, so we only remove the FOLDER, not any files that were badly named "build" build/ ##### # Xcode private settings (window sizes, bookmarks, breakpoints, custom executables, smart groups) # # This is complicated: # # SOMETIMES you need to put this file in version control. # Apple designed it poorly - if you use "custom executables", they are # saved in this file. # 99% of projects do NOT use those, so they do NOT want to version control this file. # ..but if you're in the 1%, comment out the line "*.pbxuser" # .pbxuser: http://lists.apple.com/archives/xcode-users/2004/Jan/msg00193.html *.pbxuser # .mode1v3: http://lists.apple.com/archives/xcode-users/2007/Oct/msg00465.html *.mode1v3 # .mode2v3: http://lists.apple.com/archives/xcode-users/2007/Oct/msg00465.html *.mode2v3 # .perspectivev3: http://stackoverflow.com/questions/5223297/xcode-projects-what-is-a-perspectivev3-file *.perspectivev3 # NB: also, whitelist the default ones, some projects need to use these !default.pbxuser !default.mode1v3 !default.mode2v3 !default.perspectivev3 #### # Xcode 4 - semi-personal settings # # Apple Shared data that Apple put in the wrong folder # cf http://stackoverflow.com/a/19260712/153422 # FROM ANSWER: Apple says "don't ignore it" # FROM COMMENTS: Apple is wrong; Apple code is too buggy to trust; there are no known negative side-effects to ignoring Apple's unofficial advice and instead doing the thing that actively fixes bugs in Xcode # Up to you, but ... current advice: ignore it. *.xccheckout # # # OPTION 1: --------------------------------- # throw away ALL personal settings (including custom schemes! # - unless they are "shared") # As per build/ and DerivedData/, this ought to have a trailing slash # # NB: this is exclusive with OPTION 2 below xcuserdata/ # OPTION 2: --------------------------------- # get rid of ALL personal settings, but KEEP SOME OF THEM # - NB: you must manually uncomment the bits you want to keep # # NB: this *requires* git v1.8.2 or above; you may need to upgrade to latest OS X, # or manually install git over the top of the OS X version # NB: this is exclusive with OPTION 1 above # #xcuserdata/**/* # (requires option 2 above): Personal Schemes # #!xcuserdata/**/xcschemes/* #### # Xcode 4 workspaces - more detailed # # Workspaces are important! They are a core feature of Xcode - don't exclude them :) # # Workspace layout is quite spammy. For reference: # # /(root)/ # /(project-name).xcodeproj/ # project.pbxproj # /project.xcworkspace/ # contents.xcworkspacedata # /xcuserdata/ # /(your name)/xcuserdatad/ # UserInterfaceState.xcuserstate # /xcshareddata/ # /xcschemes/ # (shared scheme name).xcscheme # /xcuserdata/ # /(your name)/xcuserdatad/ # (private scheme).xcscheme # xcschememanagement.plist # # #### # Xcode 4 - Deprecated classs # # Allegedly, if you manually "deprecate" your classs, they get moved here. # # We're using source-control, so this is a "feature" that we do not want! *.moved-aside #### # OPTIONAL: Some well-known tools that people use side-by-side with Xcode / iOS development # # NB: I'd rather not include these here, but gitignore's design is weak and doesn't allow # modular gitignore: you have to put EVERYTHING in one file. # # COCOAPODS: # # cf http://guides.cocoapods.org/using/using-cocoapods.html#what-is-a-podfilelock # cf http://guides.cocoapods.org/using/using-cocoapods.html#should-i-ignore-the-pods-directory-in-source-control # #!Podfile.lock # # RUBY: # # cf http://yehudakatz.com/2010/12/16/clarifying-the-roles-of-the-gemspec-and-gemfile/ # #!Gemfile.lock # # IDEA: # # cf https://www.jetbrains.com/objc/help/managing-projects-under-version-control.html?search=workspace.xml # #.idea/workspace.xml # # TEXTMATE: # # -- UNVERIFIED: cf http://stackoverflow.com/a/50283/153422 # #tm_build_errors #### # UNKNOWN: recommended by others, but I can't discover what these files are # 

Baseado neste guia para o Mercurial, o meu .gitignore inclui:

 .DS_Store *.swp *~.nib build/ *.pbxuser *.perspective *.perspectivev3 

Eu também escolhi include:

 *.mode1v3 *.mode2v3 

que, de acordo com este post da lista de correspondência da Apple , são “configurações de projeto específicas do usuário”.

E para o Xcode 4:

 xcuserdata 

Em relação à exclusão do diretório ‘build’ –

Se você colocar seus arquivos de compilation em um diretório diferente da sua fonte, como eu faço, você não tem a pasta na tree para se preocupar.

Isso também torna a vida mais simples para compartilhar seu código, evitando backups inchados e até mesmo quando você tem dependencies para outros projetos do Xcode (embora exija que as compilações estejam no mesmo diretório que o outro)

Você pode pegar uma cópia atualizada do site do Github https://gist.github.com/708713

Meu arquivo atual .gitignore é

 # Mac OS X *.DS_Store # Xcode *.pbxuser *.mode1v3 *.mode2v3 *.perspectivev3 *.xcuserstate project.xcworkspace/ xcuserdata/ # Generated files *.o *.pyc #Python modules MANIFEST dist/ build/ # Backup files *~.nib 

Para o Xcode 4, também adiciono:

 YourProjectName.xcodeproj/xcuserdata/* YourProjectName.xcodeproj/project.xcworkspace/xcuserdata/* 

Eu incluí estas sugestões em uma essência que criei no Github: http://gist.github.com/137348

Sinta-se à vontade para bifurcá-lo e torná-lo melhor.

As pessoas do GitHub possuem arquivos .gitignore exaustivos e documentados para projetos do Xcode:

Swift: https://github.com/github/gitignore/blob/master/Swift.gitignore

Objetivo-C: https://github.com/github/gitignore/blob/master/Objective-C.gitignore

Estou usando o AppCode e o XCode. Então .idea/ deve ser ignorado.

acrescente isto ao .gitignore

 #### # AppCode .idea/ 

O meu é um .bzrignore, mas a mesma ideia 🙂

 .DS_Store *.mode1v3 *.pbxuser *.perspectivev3 *.tm_build_errors 

o tm_build_errors é para quando eu uso o TextMate para construir meu projeto. Não tão abrangente quanto Hagelin, mas achei que valeria a pena postar para a linha tm_build_errors.

Heres um script que eu fiz para auto criar seus arquivos .gitignore e .gitattributes usando o Xcode … Eu o cortei junto com algumas coisas de outras pessoas. Diverta-se!

Xcode-Git-User-Script

Sem garantias … eu chupo a maior parte disso – então use a seu próprio risco

Você deve verificar gitignore.io para Objective C e Swift

Aqui está o arquivo .gitignore que estou usando

 # Xcode .DS_Store */build/* *.pbxuser !default.pbxuser *.mode1v3 !default.mode1v3 *.mode2v3 !default.mode2v3 *.perspectivev3 !default.perspectivev3 xcuserdata profile *.moved-aside DerivedData .idea/ *.hmap *.xccheckout *.xcworkspace !default.xcworkspace #CocoaPods Pods 

adicionando o arquivo .gitignore para

MAC OS X + XCode + Swift

Foi assim que adicionei o arquivo .gitignore ao meu projeto Swift

  1. Selecione seu projeto no XCode e clique com o botão direito -> Novo Grupo -> Nomeie-o ” Git
  2. Selecione a pasta Git e clique com o botão direito -> Adicionar novo arquivo
  3. Na aba iOS -> selecione Outro -> arquivo vazio

insira a descrição da imagem aqui

  1. dê o nome do arquivo aqui ” .gitignore

insira a descrição da imagem aqui

  1. Confirme o nome e o tipo do arquivo

insira a descrição da imagem aqui

Aqui está a estrutura do resultado

insira a descrição da imagem aqui

  1. abrir arquivo e passado abaixo do código

 # file ######################################################################### # # # Title - .gitignore file # # For - MAC OSX , Xcode7 and Swift Source projects # # Updated by - Ramdhan Choudhary # # Updated on - 13 - November - 2015 # # # ######################################################################### ########### Xcode ########### # Xcode temporary files that should never be committed ## Build generated build/ DerivedData # NB: NIB/XIB files still exist even on Storyboard projects, so we want this *~.nib *.swp ## Various settings *.pbxuser !default.pbxuser *.mode1v3 !default.mode1v3 *.mode2v3 !default.mode2v3 *.perspectivev3 !default.perspectivev3 xcuserdata ## Other *.xccheckout *.moved-aside *.xcuserstate *.xcscmblueprint *.xcscheme ########### OSX ########### # OS X temporary files that should never be committed .DS_Store .AppleDouble .LSOverride # Icon must end with two \r Icon # Thumbnails ._* # Files that might appear in the root of a volume .DocumentRevisions-V100 .fseventsd .Spotlight-V100 .TemporaryItems .Trashes .VolumeIcon.icns # Directories potentially created on remote AFP share .AppleDB .AppleDesktop Network Trash Folder Temporary Items .apdisk ########## Obj-C/Swift specific ########## *.hmap *.ipa # CocoaPods # # We recommend against adding the Pods directory to your .gitignore. However # you should judge for yourself, the pros and cons are mentioned at: # https://guides.cocoapods.org/using/using-cocoapods.html#should-i-check-the-pods-directory-into-source-control # # Pods/ # Carthage # # Add this line if you want to avoid checking in source code from Carthage dependencies. # Carthage/Checkouts Carthage/Build # fastlane # # It is recommended to not store the screenshots in the git repo. Instead, use fastlane to re-generate the fastlane/report.xml fastlane/screenshots 

Bem, graças a Adam , sua resposta me ajudou muito, mas eu ainda tive que adicionar mais algumas inputs como eu queria.

MAC OS X + XCode + Swift

Referências: isto e isto

Para o XCode 5, adiciono:

 #### # Xcode 5 - VCS metadata # *.xccheckout 

Da resposta de Berik

Eu uso o seguinte arquivo .gitignore gerado em gitignore.io:

 ### Xcode ### build/ *.pbxuser !default.pbxuser *.mode1v3 !default.mode1v3 *.mode2v3 !default.mode2v3 *.perspectivev3 !default.perspectivev3 xcuserdata *.xccheckout *.moved-aside DerivedData *.xcuserstate ### Objective-C ### # Xcode # build/ *.pbxuser !default.pbxuser *.mode1v3 !default.mode1v3 *.mode2v3 !default.mode2v3 *.perspectivev3 !default.perspectivev3 xcuserdata *.xccheckout *.moved-aside DerivedData *.hmap *.ipa *.xcuserstate # CocoaPods # # We recommend against adding the Pods directory to your .gitignore. However # you should judge for yourself, the pros and cons are mentioned at: # http://guides.cocoapods.org/using/using-cocoapods.html#should-i-ignore-the-pods-directory-in-source-control # Pods/ 

Eu já adicionei:

 xcuserstate xcsettings 

e coloquei meu arquivo .gitignore na raiz do meu projeto.

Depois de cometer e empurrar. Eu então corri:

 git rm --cached UserInterfaceState.xcuserstate WorkspaceSettings.xcsettings 

enterrado com a pasta abaixo:

 /.xcodeproj/project.xcworkspace/xcuserdata/.xcuserdatad/ 

Então eu corri git commit e empurrei novamente

Aqui está o .gitignore que o GitHub usa por padrão para novos repositorys do Xcode:

https://github.com/github/gitignore/blob/master/Objective-C.gitignore

É provável que seja razoavelmente correto a qualquer momento.

melhor de todos,

gitignore.io

Vá e escolha o seu idioma, então ele te dará o arquivo.

Nós descobrimos que, mesmo se você adicionar o .gitignore e o .gitattribte, o arquivo * .pbxproj pode ser corrompido. Então nós temos um plano simples.

Toda pessoa que codifica no escritório simplesmente descarta as alterações feitas nesse arquivo. No commit nós simplesmente mencionamos os arquivos que são adicionados na fonte. E, em seguida, empurre para o servidor. Nosso gerenciador de integração do que puxa e vê os detalhes de consolidação e adiciona os arquivos aos resources.

Depois que ele atualizar o controle remoto, todos terão sempre uma cópia de trabalho. Caso algo esteja faltando, então o informamos para adicioná-lo e puxá-lo novamente.

Isso funcionou para nós sem quaisquer problemas.

Eu recomendo usar joe para gerar um arquivo .gitignore .

Para um projeto iOS, execute o seguinte comando:

$ joe g osx,xcode > .gitignore

Ele irá gerar este .gitignore :

 .DS_Store .AppleDouble .LSOverride Icon ._* .DocumentRevisions-V100 .fseventsd .Spotlight-V100 .TemporaryItems .Trashes .VolumeIcon.icns .AppleDB .AppleDesktop Network Trash Folder Temporary Items .apdisk build/ DerivedData *.pbxuser !default.pbxuser *.mode1v3 !default.mode1v3 *.mode2v3 !default.mode2v3 *.perspectivev3 !default.perspectivev3 xcuserdata *.xccheckout *.moved-aside *.xcuserstate 

Use https://www.gitignore.io/ para gerar e adicionar os arquivos mac, cocoaPods como abaixo:

 ## Mac .DS_Store ## cocoaPods Pod ## Build generated build/ DerivedData/ ## Various settings *.pbxuser !default.pbxuser *.mode1v3 !default.mode1v3 *.mode2v3 !default.mode2v3 *.perspectivev3 !default.perspectivev3 xcuserdata/ ## Other *.moved-aside *.xccheckout *.xcscmblueprint ### Xcode Patch ### *.xcodeproj/* !*.xcodeproj/project.pbxproj !*.xcodeproj/xcshareddata/ !*.xcworkspace/contents.xcworkspacedata /*.gcno 

Uma estrutura de um arquivo .gitignore standerd para o projeto Xcode>

 .DS_Store .DS_Store? ._* .Spotlight-V100 .Trashes Icon? ehthumbs.db Thumbs.db build/ *.pbxuser !default.pbxuser *.mode1v3 !default.mode1v3 *.mode2v3 !default.mode2v3 *.perspectivev3 !default.perspectivev3 !default.xcworkspace xcuserdata profile *.moved-aside DerivedData .idea/