Tutorial Passo por CocoaPods Passo

Octo 31 CocoaPods Tutorial de etapa

Publicado em 09: 00 Cocoapods, intermediário, Swiftporluis R

introdução

cocoapods. Tenho certeza que você ouviu falar sobre esta ferramenta.

Este é o gerente de agência mais conhecido e usado no desenvolvimento iOS.

é uma ferramenta fundamental que tornará sua vida mais fácil Para quando se trabalha com bibliotecas externas em seus projetos com Swift e Objective-c.

Se você nunca trabalhou com Cocoapods, este tutorial é para você.

2. O que você vai aprender neste tutorial?

Estes são os pontos mais importantes nos quais nos concentraremos:

  • O que é cocoapods?
  • Por que deveria Você usa cacaods em seus projetos do iOS?
  • Como configurar um projeto IOS com cocoapods?

Nós começamos!

3. O que é cocoaplods?

Como nós comentamos no começo, Cocoapods é um gerente de dependência para projetos iOS. Mas vamos começar Basic.

O que é um gerente de dependência?

Quando falamos de dependências, nos referimos a bibliotecas externas que queremos integrar em nossos projetos. Se você nunca integrou uma biblioteca externa antes dos projetos do IOS, eu recomendo que você dê uma olhada em um dos nossos últimos tutoriais, onde você pode ver passo a passo este processo:

Integrando livrarias externas no seu Projetos

Agora que você já entende que estamos nos referindo quando falamos de dependências, poderíamos chegar à conclusão de que, se o Cocoapods for um gerente de dependência, sua missão será automatizada parte desse processo de integração e manutenção. de bibliotecas externas em nossos projetos.

Exatamente, essa é a sua função.

4. Por que você deve usar cocoaplods em seus projetos do iOS?

Se você deu uma olhada no tutorial que recomendei na seção anterior, você terá visto passo a passo o processo manual de adicionar uma biblioteca externa a Um projeto do iOS.

Basicamente, o processo consiste nisso:

  • Pesquisar o link de download da versão mais recente da biblioteca.
  • Baixe disse Bookstore .
  • Adicione a pasta com a biblioteca ao nosso projeto no Xcode.
  • Verifique se a nossa biblioteca depende de outras livrarias.
  • Se sim, baixe-os também.
  • Adicioná-los ao nosso projeto no Xcode.

Todo esse processo pode ser feito de forma rápida e fácil usando cocoapodes.

Se isso não parecer vantagem suficiente, vou mostrar um problema muito comum que pode surgir se você não usar cocoaplods.

a maldição das livrarias

imagine que você fez manualmente ( Sem usar cocoapods) a biblioteca AFNetworking Em um dos seus projetos.

AFNetworking está junto com a Alamofire a biblioteca de comunicações mais importante e usada no desenvolvimento do iOS. Vamos usá-lo como um exemplo no tutorial Cocoapods

Seu aplicativo está funcionando perfeitamente com a AFNetworking. Um dia, Matt Thompson, o desenvolvedor principal da livraria, lança uma nova versão que melhora a segurança e corrige alguns bugs importantes detectados em versões anteriores.

O que você faz? É uma nova versão que aumenta a segurança das comunicações da biblioteca.

Ummm … Soa parece que eu tenho que atualizar a livraria se ou se você tem.

Para acessar o repositório AFNetworking, baixe o SDK completo novamente e adicione-o ao seu projeto iOS.

e se um mês após o bem do Matt retorna para liberar outra versão?

Nós teria que repetir o processo novamente.

E se, em vez de em um projeto, você trabalha em 5 projetos? Você deve ter que atualizar todos os seus aplicativos com cada nova versão.

Isso levaria para se tornar um escravo para o seu código.

Cocoapods permite que você automatize a pesquisa, download e integração de novas versões de bibliotecas externas em seus projetos do IOS.

apenas por este motivo, você deve vê-lo seriamente usá-lo.

Eu ainda não tenho convencido de você?

Bem, como a última medida desesperada, direi-lhe que há uma empresa bem conhecida que usa intensivamente em seus desenvolvimentos: Google

Se o Google usa cocoapodes, isso significa que é uma ótima ferramenta. Se nós, como desenvolvedores, ter uma ótima ferramenta e também é gratuita, não consigo pensar em qualquer motivo para não usá-lo.

5. Instalando CocoApods no seu computador

Instalar Cocoapods é um processo muito simples.Você simplesmente tem que abrir o terminal do seu sistema e escrever o seguinte comando:

sudo gem install CocoaPods

CocoaPods é distribuído através de ruby e como no OS X, ruby está disponível por padrão no nosso sistema, podemos usar este comando para instalá-lo facilmente.

Depois de digitar esta instrução, que serão convidados para o nosso senha de administrador para continuar. Depois de te apresentar, você terá que esperar alguns momentos até que o processo de instalação terminar. No final, algo semelhante a isto irá aparecer no seu terminal:

CocoaPods Terminal Instalar

Se um erro ocorreu durante a instalação I Recomende atualizar com a versão mais recente das gemas Ruby com o seguinte comando e, em seguida, tente novamente instalar cocoapods:

sudo GEM Atualização –system

6. Usando CocoaPods em um de nossos projetos

CocoaPods Uma vez que tenhamos instaladas, vamos ver como usá-lo.

Nós vamos criar um projeto de teste no Xcode para mostrar como podemos instalar biblioteca AFnetworking a Através CocoaPods.

Se você está interessado na instalação de qualquer outra biblioteca em um de seus projetos, os passos que você deve seguir são exatamente o mesmo que vamos ver com AFnetworking

cria um novo projeto no Xcode. Escolha o modelo “Single View Application”. Você pode nomear TestingCocOpods. Deixe o resto de opções de como você vê na imagem:

CocoaPods NOVO PROJETO

Ao salvar o projeto, certifique-se de salvar -lo no desktop do seu Mac. é importante ser capaz de seguir passo a passo deste tutorial.

a próxima coisa que você vai fazer, uma vez que criou e salvou o projeto no ambiente de trabalho será para perto isto. Sim, como você ouve, feche seu projeto e feche Xcode. A primeira coisa que vamos fazer é configurar cocoaplods em nosso projeto e para isso agora não precisamos xcode.

Abra o terminal novamente e digite o seguinte comando:

1

CD ~ / desktop / testingCocoapods

Isto irá permitir-nos para navegar através do terminal para a rota exata onde o nosso projeto é salvo.

para poder CocoaPods configure em qualquer projeto que você deve colocar-se utilizar o terminal na rota exata onde este projeto é salvo

criando um podfile

a próxima coisa vamos fazer é criar um podfile.

a podfile é um arquivo que é armazenado no diretório raiz do nosso projeto e é responsável por gerenciar as vagens que deseja instalar no nosso projeto.

Sim, eu sei qual é o seu seguidor Inte perguntar: e o que é um pod?

Um pod é simplesmente uma referência a uma biblioteca externa que queremos adicionar ao nosso projeto.

Como um resumo, os cacaposes funcionam a partir do formulário seguinte:

  1. Criamos uma podfile na raiz do nosso projeto
  2. Este podfile terá um pod para cada uma das bibliotecas que vamos adicionar ao nosso. aplicação.
  3. CocoaPods Antes de fazer qualquer alteração, use o arquivo Podfile para saber o que ele tem que fazer.

Vamos então vá para o passo 1.

Para criar a podfile em nosso projeto, digite o seguinte comando no terminal:

pod init

CocoaPods irá gerar uma podfile assim:

2
3
4
6
7
8
9
10

11

# remova o comentário da linha seguinte PARA DEFINIR GLOBAL PLATAFORMA PARA SEU PROJETO
# Plataforma: iOS, ’10 .0 ‘
-alvo TestingCoCoapods’ fazer
# comentário a próxima linha Se você não está usando SWIFT e não quer usar o Dynamic Frameworks
use_frameworks!
# pods para testingcocopodes
end

Na verdade, se você acessar o diretório raiz do seu projeto, poderá ver como o arquivo podfile aparece ali.

cocoapods podfile criado Esta seria a estrutura básica do podfile. O que temos que fazer agora é editar este arquivo para adicionar nossas vagens.

Editando o podfile com o VIM

para fazer a edição deste arquivo, usaremos um editor chamado VIM. Vim é um programado incorporado dentro de cada Mac que permite editar arquivos de texto diretamente do terminal.

Para editar o podfile Escreva o seguinte comando no seu terminal:

1

vim podfile

através deste comando acessa o vim. Uma tela como esta será exibida no seu terminal:

Cacau Pods Editando Arquivo POD com VIM Levando em conta que a biblioteca que queremos integrar em nosso projeto A AFNetworking, você terá que editar o podfile e adicionar a próxima linha logo antes do arquivo final:

o aspecto que seu podfile deve ter depois de adicionar esta linha é o seguinte:

pod ‘affetworking’, ‘~ > 3.0’

1
3
4
6
7
8
9

# Descomemment a próxima linha para definir a plataforma global para o seu projeto
# plataforma: ios, ’10 .0 ‘
‘ testingcoapods ‘de’ Div>
# comentário A próxima linha se você não estiver usando Swift e não quer usar estruturas dinâmicas
use_frameworks!
# pods para testingcocopodes
pod ‘affetworking’, ‘~ > 3.0’
final

Uma vez que adicionamos a vagem AFNetworking, teremos que salvar as alterações e sair.

Para fazer isso no VIM, pressione a tecla ESC e digite isto:

1

: wq

Isso significa, escreva e desista. Isto é, salvar alterações e fechar vim.

resumo do podfile

antes de continuar, vamos ver um pequeno resumo do podfile:

  • as linhas que Eles aparecem para trás # são comentários, então eles realmente não influenciam nosso arquivo
  • a primeira linha que vemos é o “testingcocoapods” do alvo. O que especifica esta linha é o nome do projeto onde estamos adicionando cocoapodes. Adote o nome do nosso projeto em Xcode.
  • A linha a seguir é use_frameworks! Esta linha indica cacapos que vamos usar estruturas em vez de bibliotecas estáticas. Simplesmente fique com que esta linha é obrigatória quando você trabalha com projetos em swift.
  • a última linha é pod ‘afnetworking’, ‘~ > 3.0’ e defina Que vamos usar uma força que corresponda à biblioteca AFNetworking, com uma determinada versão. Você pode especificar diferentes versões usando alguns operadores. Você pode verificar exatamente o que o operador ~ > e o restante dos operadores de cocoapods, nesta página.

neste momento em que você Pergunte como eu conheço o nome da vagem que tenho que usar para adicionar a biblioteca AFNetworking.

Você tem duas opções para este nome:

opção 1: através do oficial de página : cocoapods.org

cocoapods cocoapods.org web

No site oficial de cocoapods você pode fazer uma pesquisa por qualquer biblioteca que você quer adicionar ao seu projeto. Por exemplo, se procurarmos por AFNetworking, você verá que recebe uma série de resultados na parte inferior.Se você clicar na primeira opção que você oferecer (o que corresponde à biblioteca sem qualquer outra estrutura adicionada) será exibida na Web uma seção chamada podfile onde a linha está chegando que teríamos que adicionar nosso arquivo podfile:

opção 2: diretamente na documentação da biblioteca

Se, por exemplo, acesso ao AFNetworking Repositório Você pode ver como há uma seção chamada Instalação com Cocoapods onde aparece perfeitamente explicou o aspecto que seu arquivo podfile deve ter que adicionar esta biblioteca. As bibliotecas mais conhecidas têm esta seção em sua documentação.

Cocoapods Instalação do repositório AFNetworking

Agora que você já entendeu 100% Operação do arquivo de podfile, vamos com o último comando que você deve entrar em seu terminal para que cocoapodes execute a instalação da AFNetworking:

Cocoapods começará a baixar a biblioteca e instalar o pod do AFNetworking em nosso projeto.

dez paciência porque é provável que no seu terminal apareça “Configurando o REPO MASTER CROCOAPODS” Por alguns minutos.

O problema que existe neste ponto é que o terminal não nos mostra a qualquer momento se o processo de instalação for advanz E corretamente. Mesmo que Cocoapods seja uma ferramenta muito confiável, como qualquer outro programa, não é perfeito, por isso pode acontecer que o processo de download / instalação da nossa biblioteca seja congelado por algum erro e não sabemos.

Aproveitando o monitor de atividades

Há um pequeno truque para saber se o processo está executando o download corretamente.

Você só precisa ir ao monitor de atividade do seu Mac, acessar a rede seção e procure o processo git-remote-https. Este processo é aquele que está fazendo o trabalho de instalação da nossa biblioteca. Se você vir que, além de alguns segundos, os bytes recebidos não avançam, eu recomendo que você cancele o processo usando as chaves Ctrl + C do terminal e repita o comando de instalação novamente.

Cocoapods processo de download Após o download e instalação, um espaço de trabalho será criado em seu projeto chamado TestingCocoApods.xcworkspace. Este espaço de trabalho irá abranger seu projeto original no Xcode e na livraria AFNetworking.

A partir de agora, para abrir o projeto, você terá que abri-lo no arquivo TestingCocoApods.xcworkspace em vez de usar como sempre testingcoapods.xcodeproj .

7. Tendo um olho no aspecto final do nosso projeto

Como acabamos de dizer, abra seu projeto clicando duas vezes no arquivo TestingCocoApods.xcworkspace.

Você pode ver que dentro do nosso espaço de trabalho temos dois projetos:

  • testingcocopodes (nosso projeto original)
  • pods (o projeto que contém nossa AFNetworking Biblioteca)

cocoapods Xcode com affetworking adicionado desta maneira, adicionamos a biblioteca AFNetworking e podemos usá-lo em qualquer lugar em nosso projeto.

Se você quiser verificar se tudo funciona corretamente, você pode adicionar a seguinte linha de código ao seu arquivo viewController.swift apenas após a importação Uikit:

pod

Como você vê, o Xcode não dá erros e nosso projeto compila perfeitamente.

Projeto Cocoapods compilando O mais coisa importante sobre Todo esse processo é que a partir de agora, CocoaPods gerenciará automaticamente a biblioteca AFNetworking do nosso projeto, então não teremos que nos preocupar em fazer esse trabalho.

8. Resumo final e download do projeto

Estes são os pontos mais importantes que vimos no tutorial desta semana:

  • o que é cocoapods?
  • o que é cocoapods para?
  • vantagens de usar cocoapods
  • como configurar cocoapods em seus projetos ios passo a passo
  • como adicionar uma biblioteca externa ao seu projeto iOS Usando cocoaplos

Você pode baixar o projeto completo que desenvolvemos seguindo este tutorial daqui.

9. Você terminou o tutorial

Espero que tenha gostado deste tutorial e, acima de tudo, atende que você seja capaz de integrar cacapodes em seus projetos do IOS.

Como sempre, aqui está o vídeo-chorra esta semana (ativa o som do seu computador porque se não for engraçado).

nunca prejudicar uma boa risada 😉

Para onde ir agora?

Você pode acessar mais tutoriais disponíveis no Efineple daqui.

Se este artigo tiver uma semelhança útil, Você me faria um grande favor compartilhando-o em suas redes sociais.

1

Affitwork de importação