Como EU instalo o Xamarin

Um dos maiores desafios do Xamarin é instalar e configurar seu ambiente. E o problema já começa aí, não é um ambiente, são três: Android, iOS e UWP.

Cada um deles tem as suas peculiaridades e restrições e abaixo vou mostrando como instalo cada um.

É importante destacar que as ferramentas evoluem muito rápido e pode ser que, dependendo de quando você ler esse post, ele não seja tão útil. Prometo tentar atualizar sempre :)

Esse é meu ambiente:

Windows

  • Windows 10 Pro versão 1703
  • Core i7, 16 GB de Ram e 256 de SSD
  • Visual Studio 2017 (Nesse caso é indiferente se a versão é a Enterprise ou Community)

Mac

  • Mac OS Sierra 10.12
  • Core i7, 16 GB de Ram e 256 de SSD
  • Visual Studio for Mac
  • XCode 8.3.3

Importante:

SSD é vida. Quando eu for ditador desse país eu exigirei que todo e qualquer computador vendido venha com SSD.

Para desenvolver apps para iOS é necessário ter um Mac.

VM de Mac OS é pirataria. Ponto Final.

Sendo assim, vamos ao que viemos.

UWP

Só funciona no Windows e sua instalação é muito simples, resumindo-se a seleção da opção “Desenvolvimento com a Plataforma Universal do Windows” e a escolha dos SDKs:

Opção para instalação do ambiente para desenvolvimento UWP
SDKs

E os emuladores?

Bom, eu não os instalo emuladores por alguns motivos:

  • Acho mais simples testar na própria máquina, e isso é uma coisa fantástica do UWP: o mesmo app pode ser executado em qualquer lugar que rode Windows 10. É claro que não é a mesma coisa, mas como raramente preciso fazer alguma coisa para Windows 10 Mobile, rodar localmente já me ajuda muito.
  • Os emuladores do Windows 10 Mobile utilizam o O Hyper-v. Eu curto utilizar o Genymotion como emulador do Android e este utiliza o Virtual Box. Hyper-v e Virtual Box não funcionam na mesma máquina. Pode até ser que exista alguma maneira de fazer eles funcionarem juntos, mas nunca me preocupei em procurar.

#protip

Se você está fazendo um app utilizando Xamarin Forms, recomendo fazer os testes no UWP instalado na máquina. Roda muito mais rápido do que qualquer emulador/dispositivo. É claro que, você vai precisar testar no Android e iOS, mas ai é para fazer ajustes finos nas UI.

Link:

https://www.visualstudio.com/pt-br/vs/universal-windows-platform/

iOS

Só funciona no Mac OS e sua instalação talvez seja a mais tranquila de todos os ambientes.

A primeira coisa que eu faço é ir na loja da Apple, procurar por XCode e instalar. Depois disso vou dormir. Sério, a instalação do XCode consegue demorar mais que o Visual Studio Full :/

Site Itunes — Não estou no Mac nesse momento, mas acredito, é isso ai :)

A instalação do Visual Studio for Mac é bem parecida com a do Visual Studio for Windows. Você pode escolher os componentes e nesse momento você pode preferir não instalar o SDK do Android, já que você já vai ter instalado no Windows. Agora se você não usa o Windows vai ter que instalar o SDK do Android e o processo que eu vou descrever abaixo pode ser aplicado do Mac sem problema nenhum.

Instalador do belíssimo Visual Studio for Mac

#protip

O VS for Mac está cada dia melhor. Eu tenho curtido muito ele. Experimente brincar com o .net Core. É sensacional!

Emulador não. Simulador.

O simulador do iOS não é emulador. Isso tem uma grande diferença. Tem coisas que só funcionam no dispositivo físico. É um saco. Recomendo pesquisar no Google para saber mais sobre isso.

A instalação dos simuladores é feita no XCode. Por padrão, ao instalar a IDE, já vem alguns instalados, porém, caso queira adicionar mais algum, clique em XCode, em seguida vá em Preferences, Downloads, Components e selecione os Simuladores que você quiser.

Simuladores. Instale apenas aqueles que você vai usar.

#protip

Sempre que instalar/atualizar o XCode execute-o. Geralmente uma janela para você aceitar os termos de uso pode aparecer. Se você não aceitar os termos o Visual Studio for Mac pode não identificar os simuladores.

Links:

https://www.visualstudio.com/pt-br/vs/visual-studio-mac/

Android

O Android precisa basicamente dos seguintes componentes:

  • Java SDK 64 bits (JDK)
  • Android SDK

O Android NDK é opcional, mas mesmo assim eu instalo.

Quando você instala o Xamarin via Visual Studio ele já instala todos esses componentes. Porém, até a última versão, o instalador baixa o JDK 32 bits, que é incompatível :/

Outro ponto é que ele os instala no C:/Program Files/Bla Bla Bla. Isso me irrita. Não gosto de instalar nessas pastas por dois motivos: Pode-se estourar o tamanho do path (256 caracteres) e o outro é que nesse path contém espaço e isso pode causar muitos problemas… mas muitos mesmo…

Sendo assim, eu instalo cada um manualmente no C:/ e em seguida adiciono seus paths nas variáveis de ambiente do Windows.

  • C:/java
  • C:/android-sdk
  • C:/android-ndk

Colocar esses componentes nas variáveis de ambiente garante que, caso eu precise utilizar alguma outra plataforma de desenvolvimento, que também necessite desses componentes, eles já estarão lá, prontos para uso. Caso do Cordova, Reactive Native, etc.

Para facilitar o entendimento, segue abaixo os passos para acessar a tela de variáveis de ambiente:

  • Clique com o botão direito em Este Computador
  • Clique em Propriedades
  • Do lado esquerdo, clique em Propriedades Avançadas do Sistema
  • Clique no botão Variáveis de Ambiente

Começando as instalações

JDK

A instalação do JDK é Next, Next, Finish. Muito simples. Baixe seu instalador aqui. Verifique se essa é a versão mais atual.

Depois de instalado adicione as seguintes variáveis de sistema:

JAVA_HOME com o valor C:/java/jdk{versão instalada}

CLASSPATH com o valor .;%JAVA_HOME%\lib;%JAVA_HOME%\jre\lib

Edite a variável path adicionando o seguinte valor: %JAVA_HOME%\bin

Agora abra a linha de comando e digite java -version. Se tudo der certo e nada der errado, a versão do java será mostrada.

Android NDK

Baixe o zip aqui e descompacte-o em C:/android-ndk. Adicione a variável ANDROID_NDK_HOME com o valor C:/android-ndk. Descompacte o conteúdo, certificando-se de que não tem uma pasta dentro da outra.

Android SDK

No site do Android, o SDK é oferecido junto com o Android Studio (puta ferramenta show de bola). Você pode querer instalar essa IDE também, porém, eu não instalo pelo fato de ter um SSD de 256. Sendo assim, no fim da página você tem a opção de baixar apenas as ferramentas de linha de comando.

Baixe o pacote e descompacte-o em c:/android-sdk. Em seguida adicione a variável ANDROID_HOME com o valor c:/android-sdk.

Edite a variável path adicionando os seguinte valores: %ANDROID_HOME%\tools e %ANDROID_HOME%\platform-tools.

Pronto? Ainda não. Só instalamos as ferramentas de linha de comando do Android. Precisamos baixar os SDKs e outras ferramentas.

Vá na linha de comando e digite android. O Android SDK Manager vai abrir e você deverá selecionar algumas opções. Abaixo eu vou listar aquelas que eu tenho instalado, mas recomendo que você entenda para que cada uma serve.

Tools
Android SDK Tools (25.2.5)
Android SDK Platform-tools (25.0.3)
Android SDK Build-tools (23.0.3)

APIs
Android 7.1 (API 25) — Apenas o SDK Platform
Android 6.0 (API 23) — Apenas o SDK Platform
Android 5.0.1 (API 21) — Apenas o SDK Platform

As APIs vão variar conforme sua necessidade. Você pode baixar apenas as 7.1, que é a mais atual, por exemplo.

Extras
Android Support Repository
Google Play Services (opcional, mas é importante ter caso você precise utilizar Push Notification por exemplo)
Intel Hardware Accelerated Execution Manager

Instale essas opções, escolha um CD do Pink Floyd, ouça até o fim. Quando terminar de ouvir, pode ser que você já tenha o SDK do Android configurado :)

Terminamos!! Só que não.

Precisamos instalar o Xamarin, certo? Até então, instalamos e configuramos o ambiente Android.

Para instalar o Xamarin, atente-se para as opções que vamos desmarcar no instalador.

Instalação do Xamarinm
Opções que devemos desmarcar, afinal, já temos esses componentes instalados

Agora falta pouco. Depois do Xamarin Instalado, abra o Visual Studio. Vá em Tools, Options, Xamarin. Clique em Android Settings. Verifique se os caminhos Java Development Kit Location, Android SDK Location e Android NDK Location estão apontando para os seus respectivos locais. Se não estiverem, aponte!

Pronto!!

João das Neves. Ele morre. Mas depois ressucita…

Mas… e os Emuladores?

Eu curto o Genymotion. Gosto é gosto.

Para instalar o Genymotion Free acesse https://www.genymotion.com/fun-zone/. Baixe a versão que vem com o Virtual Box.

Depois de instalado, adicione um emulador do Android. Escolha um cuja a API você tenha instalado no Android SDK Manager.

Quando terminar de baixar, abra-o.

Agora sim, terminamos.

Links que o ajudarão na batalha:

Show your support

Clapping shows how much you appreciated angelobelchior’s story.