Carthage é uma ferramenta de gerenciamento de dependências para projetos iOS, macOS, watchOS e tvOS. Ao contrário de outras ferramentas como CocoaPods, Carthage é descentralizado e não altera o projeto Xcode automaticamente. Ele busca e constrói as dependências, mas deixa a integração com o projeto a cargo do desenvolvedor. Este artigo irá guiá-lo através do processo de configuração e uso do Carthage em um projeto iOS.

Instalando o Carthage

Para começar a usar o Carthage, você precisa instalá-lo. A maneira mais comum de instalação é via Homebrew, um gerenciador de pacotes para macOS. Abra o Terminal e execute o seguinte comando:

brew install carthage

Criando um Cartfile

O Cartfile é onde você especifica as dependências do seu projeto. Crie um arquivo chamado Cartfile na raiz do seu projeto e adicione as bibliotecas que deseja utilizar. Por exemplo, para adicionar o Alamofire, uma popular biblioteca de rede, adicione a seguinte linha ao seu Cartfile:

github "Alamofire/Alamofire" ~> 5.4

Construindo as Dependências

Depois de configurar o Cartfile, você precisa construir as dependências. No Terminal, navegue até o diretório do seu projeto e execute:

carthage update --platform iOS

Este comando irá clonar os repositórios das dependências e construir os frameworks necessários.

Integrando ao Xcode

Após construir as dependências, você precisa integrá-las ao seu projeto Xcode:

1. No Finder, navegue até o diretório Carthage/Build/iOS.
2. Arraste os arquivos .framework das bibliotecas que você deseja usar para a seção "Frameworks, Libraries, and Embedded Content" nas configurações do seu projeto no Xcode.
3. Certifique-se de que os frameworks estão marcados como "Embed & Sign".

Atualizando Dependências

Para atualizar as dependências, basta modificar o Cartfile e executar novamente o comando carthage update --platform iOS.

Exemplo Completo

Vamos ver um exemplo completo de como usar o Carthage para integrar o Alamofire em um projeto iOS:

1. Instale o Carthage:

   brew install carthage

2. Crie um Cartfile:

   Crie um arquivo chamado Cartfile e adicione:

   github "Alamofire/Alamofire" ~> 5.4

3. Atualize as dependências:

   Navegue até o diretório do projeto e execute:

   carthage update --platform iOS

4. Integre ao Xcode:

   • Arraste Alamofire.framework do diretório Carthage/Build/iOS para o Xcode.
   • Certifique-se de que está em "Embed & Sign".

5. Use Alamofire no seu código:

   import Alamofire
   
   AF.request("https://api.example.com").response { response in
      debugPrint(response)
   }