Criando uma Pokedex com Swift Part: 1/3

Instalando o CocoaPods

Vamos entrar na hype que já passou do Pokemon Go e nessa série de posts vamos fazer algo diferente. Vamos criar uma lista (Pokedex) dos 881 pokemons que temos atualmente.

Para realizar esse projeto, vamos usar uma API aberta que vai trazer todas as informações dos nossos queridos monstrinhos.

pokéapi - The Pokemon RESTful API

Antes de tudo precisamos de uma API chamada Alamofire. Ela irá nos ajudar com as requisições HTTP.

Alamofire/Alamofire

Para instalar o Alamofire vamos usar o CocoaPods, um gerenciador de dependências, vou falar mais dele nesse post.

CocoaPods.org

Nessa primeira parte irei mostrar como instalar o CocoaPods em seu projeto.

O que é o CocoaPods?

CocoaPods é um gerenciador de dependências para Swift e Objective-C.

É usado em mais de 1.2 milhões de projetos e contem muitas APIs para te ajudar no seu projeto.

CocoaPods é feito em Ruby e sua instalação será feita pelo terminal.

Instalação do CocoaPods

Certifique-se que seu Ruby está atualizado, se não tiver pode usar o link abaixo como referência para te ajudar nessa tarefa.

Can I upgrade to the current version of Ruby (2.2.3) on OS X v10.6.8?

Com o Ruby em dia vamos instalar o CocoaPods.

Abra o terminal, digite a linha abaixo e dê um enter.

sudo gem install cocoapods

Aguarde até o processo terminar.

A versão instalada no momento de criação desse post é a 1.1.1.

Agora vamos terminar sua configuração. No terminal digite a linha abaixo e de um enter.

pod setup --verbose

Pronto, seu CocoaPods está instalado e configurado, porém ainda temos que adicioná-lo ao nosso projeto.

"Pera aí, que projeto? Ainda não criamos nada."

Bem, vamos criar agora!

Abra o Xcode, acesse o menu File e depois New Project(Shift+Command+N).

Escolha a opção de Single View Application.

Escolha um nome para seu projeto, deixe a linguagem como Swift e o device eu deixei como iPhone.

Agora, com o projeto criado, feche o Xcode. Vamos voltar para o terminal.

No terminal, abra a pasta do projeto, como na linha abaixo.

cd /Caminho da pasta

Dentro da pasta pelo terminal coloque a linha abaixo e aperte o enter.

pod init

Vamos colocar o caminho para CocoaPods possa fazer o download e adicionar a API em nosso projeto.

Adicione a linha abaixo e aperte o enter

open -a Xcode Podfile

Essa linha vai abrir uma tela do Xcode com o arquivo Podfile.

Vamos mudar um pouco o arquivo.

Troque a linha abaixo.

# platform :ios, '9.0' 

pela linha a seguir.

platform :ios, '10.0'

Agora dentro de target vamos adicionar a API que queremos baixar, que será a Alamofire.

Alamofire/Alamofire

É exatamente o que precisamos para construir nossa Pokedex!

Dentro de target adicione a seguinte linha.

pod 'Alamofire', '~> 4.0'

Seu arquivo deve estar parecido com isso.

# Uncomment this line to define a global platform for your project
platform :ios, '10.0'
target 'Pokedex' do
# Comment this line if you're not using Swift and don't want to use dynamic frameworks
use_frameworks!
# Pods for Pokedex
pod 'Alamofire', '~> 4.0'
end

Salve, feche o arquivo e volte para o terminal.

No terminal digite a linha abaixo, aperte enter e veja a mágica acontecer.

pod install

Aguarde a instalação do pod.

Depois abra o projeto pelo .xcworkspace.

Caso você esteja com uma versão anterior à mais atual, que no momento da criação desse post é a 1.1.1, possivelmente irá aparecer uma mensagem pedindo para converter o código para Swift 3.

Para resolver isso você terá que adicionar as linhas abaixo no final do seu arquivo Podfile e dar um pod install novamente.

post_install do |installer|
  installer.pods_project.targets.each do |target|
    target.build_configurations.each do |config|
      config.build_settings['SWIFT_VERSION'] = '3.0'
    end
  end
end

Caso você esteja trabalhando com Swift 2.3, você pode usar essas mesmas linhas, porem mudando o SWIFT_VERSION de 3.0 para 2.3

Faça o build (Command+B) e o projeto já estará sem erros e com o CocoaPods instalado.

Conclusão

Nesse post fizemos uma instalação simples e rápida do CocoaPods, um gerenciador de dependências que tenho certeza que vai te ajudar em vários projetos desse mundão sem porteira.

Existem outros gerenciadores por exemplo o Carthage.

Carthage/Carthage

A escolha de qual você irá usar é pessoal.

NO PRÓXIMO EPISÓDIO

Criando uma Pokedex com Swift Part: 2/3

Obrigado

Caso tenha gostado do texto, recomende-o clicando no coração ali em baixo. Obrigado e até a próxima.

Até a Próxima