Instalar o Visual Studio Tools for Apache Cordova

Artigo
09/13/2015

No Visual Studio 2013, as ferramentas do Cordova são lançadas como uma versão de visualização (CTP). As ferramentas do Cordova serão lançadas como parte do Visual Studio 2015 e recomendamos usar o Visual Studio 2015 RTM para desenvolver aplicativos usando o Visual Studio Tools for Apache Cordova. Você pode baixar o Visual Studio no Centro de Download da Microsoft.

Tirar proveito do instalador fácil de usar para criar aplicativos multiplataforma com o Visual Studio e Apache Cordova. Com o instalador, não é necessário que identificar os SDKs, ferramentas e bibliotecas necessárias (ou quais versões).

Nesta seção:

Requisitos
Obtenha as ferramentas
Instalar as ferramentas
Instalar as ferramentas para iOS
Tarefas adicionais

Requisitos

Requisitos do sistema operacional:

O Windows 7, Windows 8, Windows 8.1, Windows 10 ou Windows Server 2012 R2.

Importante

Se estiver usando o Windows 7, poderá desenvolver aplicativos para Android e iOS, mas não para Windows ou Windows Phone.

Para criar aplicativos para as plataformas de dispositivo específicas, há alguns requisitos adicionais:

o simulador do iOS e iOS requer um computador Mac capaz de executarXcode 6(Xcode 6 é recomendado). Para obter informações adicionais e etapas de instalação, consulteinstalar ferramentas para iOS.

Dica

Se você quiser criar iOS em um serviço de nuvem em vez de hardware do Mac, consulteCompilar e simular o iOS na nuvem.
Emuladores Android funcionam melhor em computadores quepode executar o Hyper-Vou o driver HAXM Intel. ConsulteExecutar seu aplicativo Apache Cordova no Android.
Emuladores do Windows Phone exigem um computador que possa executar o Hyper-V.
Criando um aplicativo Windows 10 Universal Platform requer a instalação doWindows 10 Tools for Visual Studio. Observe que aplicativos do Windows 8.1/Phone 8.1 também podem ser implantados para o Windows 10

Obtenha as ferramentas

Obter o Visual Studio Tools para o Apache Cordovaque são incluídos como um componente opcional do Visual Studio de 2015. Siga as etapas na próxima seção para instalar as ferramentas.

Importante

É recomendável 2015 do Visual Studio para desenvolver aplicativos do Apache Cordova.Se você tiver instalado o Visual Studio 2015 Preview, CTP do Visual Studio 2015 ou Visual Studio 2015 RC, primeiro desinstale-o usando o painel de controle, programas e recursos, antes de instalar o Visual Studio de 2015.

Instalar as ferramentas

Quando você optar por instalar o Visual Studio Tools para o Apache Cordova, o instalador do Visual Studio de 2015 seleciona software de terceiros adicional para instalar. A maioria deles são softwares livres necessários para plataformas específicas ou pelo Apache Cordova. Você pode substituir as seleções padrão e desativar um software que você não deseja instalar.

Se ainda não estiver instalado, o seguinte software será selecionado por padrão:

O SDK do Android é necessário para o processo de compilação do Android e do Ripple.
O Apache Ant 1.8.0 ou posterior é necessário para os processos de compilação do Android.
Oracle Java JDK 7 de 32 bits é necessário para o processo de compilação Android.
Node. js joyent permite que o Visual Studio para integrar o simulador Apache Cordova Interface de linha de comando (CLI) e Apache ondulação.

Dica

O instalador não instala o Google Chrome, que é necessário se você quiser executar o simulador Apache se propagam para iOS e Android, e não instala Apple iTunes, que é necessário para implantar um aplicativo em um dispositivo iOS conectado ao seu PC do Windows.
O Git CLI é necessário somente se você precisar adicionar manualmente Git URIs a plug-ins Cordova específicos.

Importante

Ao usar o Cordova 5.0.0+, talvez seja necessário adicionar um_JAVA_OPTIONSvariável de ambiente que contém pelo menos-Xmx512Mpara evitar problemas de memória insuficiente ao criar Android.Para obter mais informações, consulte o problema conhecidoaqui.

Para instalar o Visual Studio Tools para o Apache Cordova

Execute o instalador encontrado noObtenha as ferramentas.
Siga as instruções para instalar o Visual Studio de 2015 e certifique-se de que instalar os seguintes recursos opcionais:
- HTML/JavaScript (Apache Cordova), em desenvolvimento entre plataformas móveis
  
  Dica
  
  Se você estiver instalando o Visual Studio 2013, em vez de 2015 Studio Visual (recomendamos 2015 do Visual Studio), as ferramentas de Cordova são instaladas como umseparar extensão.
- Windows 8.1 e Windows Phone 8.0/8.1 ferramentas
- Microsoft Visual Studio emulador Android, se sua máquina de desenvolvimentooferece suporte a Hyper-V.
  
  …
  
  Dica
  
  Você pode adicionar esses recursos a uma instalação existente do Visual Studio de 2015.No Painel de Controle, escolha Programas e Recursos.Selecione 2015 do Visual Studio na lista e escolhaalteração.Na janela de instalação do Visual Studio, escolha Modificar.Na lista de recursos, selecione os recursos opcionais, conforme mostrado na ilustração.
  
  Se você não quiser aceitar as dependências de terceiros selecionadas por padrão, com ferramentas comuns e Kits de desenvolvimento de Software, você pode limpar as seleções de software e instalar manualmente as dependências que necessárias posteriormente.
  
  Importante
  
  Se as dependências de terceiros já estão no seu sistema ou se você optar por instalá-las manualmente, talvez seja necessário atualizar o caminho do sistema.Consulteinstalar manualmente as dependências.
Reinicialize o computador para garantir que tudo seja instalado corretamente.
Abra o Visual Studio, escolha Ferramentas, Extensões e Atualizações e Atualizações. Se houver uma atualização do Visual Studio para Visual Studio Tools for Apache Cordova, instalá-lo.

Dica

Na primeira vez que você criar um aplicativo após instalar as ferramentas, o Visual Studio irá baixar e instalar as ferramentas do Cordova.Como resultado, a primeira compilação leva mais tempo para ser concluída.Verifique a janela de Saída para ver o progresso.Se você vir um erro, comoCannot find module [modulename]talvez seja necessário limpar a solução e reconstruir.Para obter mais informações, consultereinstalação do vs tac.

Se você estiver migrando um projeto de uma versão anterior do Visual Studio, consulte esteinformações de migração.

Instalar as ferramentas para iOS

Para compilar e executar aplicativos do iOS o simulador do iOS ou em um dispositivo iOS usando o Visual Studio, você deve instalar e configurar o agente remoto,remotebuildem um computador Mac que atenda aos requisitos especificados abaixo. (Atualmente, aplicativos iOS não podem ser criados no Windows.) No Visual Studio em seu computador, você também deve configurar o agente remoto conforme descrito neste tópico.

Dica

Para obter informações sobre como usar os serviços hospedados em nuvem do Mac, em vez de um Mac, consulteCompilar e simular o iOS na nuvem.Se você estiver executando o Windows em um Mac usando a tecnologia de virtualização, você poderá criar e executar o iOS localmente.Para obter mais informações, consulteCompilar um aplicativo Cordova para iOS usando o Parallels.

Antes de instalar o agente remoto, verifique se você teminstalado o Visual Studio Tools para o Apache Cordova.

Você pode configurar o agente para tratar das solicitações de criação e executar o aplicativo em um dispositivo iOS ou no iOS Simulator. Para hospedar o agente remoto, o computador Mac deve ter o seguinte instalado:

Mac OS X Mavericks
Xcode 6
Ferramentas de linha de comando do Xcode (do aplicativo de Terminal, usexcode-select --install)
Node.js
Ferramentas de linha de comando Gitse você estiver usando uma CLI de um repositório Git.

Se a versão da CLI é apontada para um local de Git, Git é necessário para compilar o aplicativo para iOS.

Você também deve ter o seguinte:

Um ativo iOS conta do programa de desenvolvedores com Apple
Um perfil configurado no Xcode (download o provisionamento de perfil e execute o arquivo baixado *.mobileprovision) de provisionamento de iOS.

Dica

Para obter informações detalhadas, leia Mantendo suas identidades de assinatura e certificados na Biblioteca de Desenvolvedor do iOS.
Uma identidade de autenticação configurada no Xcode (escolhaXCodePreferências)

Dica

2015 do Visual Studio tem um agente remoto atualizado chamadoremotebuild.VS mda-remoto, o agente anterior, é para uso com o Visual Studio 2015 RC e versões anteriores.

Para baixar e instalar o agente remoto

No aplicativo Terminal no seu Mac, digite:
```
sudo npm install –g npm
sudo npm install -g remotebuild
sudo npm install –g ios-sim@3.1.1
```
O primeiro comando atualiza npm, o segundo comando instala o agente remoto e o terceiro comando só é necessário se você utilizar o iOS simulador do Visual Studio.
Se você tiver uma versão anterior do Node. js e npm, talvez seja necessário digitar os comandos a seguir antes de iniciar o agente remoto, ou você encontrará um erro de permissões durante a criação. No aplicativo Terminal no seu Mac, digite:
```
sudo npm cache clear
sudo chown -R `whoami` ~/.npm
```
Esse comando garante que as permissões do cache do pacote npm em seu diretório base estão configuradas corretamente (versões mais recentes do Node. js e npm fará isso para você automaticamente.)

Quando você inicia o agente remoto (remotebuild), o modo de desenvolvedor será ativado em seu Mac. Homebrewtambém será instalado, juntamente com ideviceinstaller e ios-webkit-debug-proxy para permitir a execução automática de aplicativos em dispositivos e para permitir a depuração de aplicativos em dispositivos e no simulador.

Aviso

Para instalar o Homebrew, é necessário acesso sudo (administrador).Se você precisar instalar remotebuild sem sudo, você pode instalar Homebrew manualmente em um local usr/local e adicione sua pasta bin em seu caminho.Para obter mais informações, consulte oHomebrew documentação.Se você precisar habilitar manualmente o modo de desenvolvedor, digite o seguinte no aplicativo de Terminal:DevToolsSecurity –enable

Se você atualizou o computador para uma nova versão do Visual Studio, também deverá atualizar o agente remoto para a versão atual.

Para atualizar o agente remoto

Repita a etapa de instalação da seção anterior.

Para iniciar o agente remoto

No aplicativo Terminal no seu Mac, digite:
```
remotebuild
```
Dica

No Visual Studio 2013, o comando anterior évs-mda-remote.

Isso irá iniciar o agente com um diretório de compilação padrão de ~/.taco_home/remote-builds/taco-remote/compilações. Opções de configurações adicionais para o agente são descritas emConfigurar o agente remoto.

Na primeira vez que você iniciar o agente, você receberá as informações necessárias para configurar o agente no Visual Studio, incluindo o host, a porta e a segurança do PIN.

Importante

O agente remoto foi projetado para transferir cargas de compilação para e do Visual Studio usando certificados SSL com segurança.
Se você pretende configurar o agente remoto no Visual Studio usando o nome do host, execute ping Mac usando o nome de host para verificar se ele está acessível. Caso contrário, talvez seja necessário usar o endereço IP em vez disso.
Se o mac é visível externamente em um nome de host, mas internamente atribui a próprio outro nome de host, você pode especificar o nome do host usando o seguinte comando no aplicativo de Terminal:
```
remotebuild resetServerCerts --hostname=my.external.hostname.com
remotebuild generateClientCert --hostname=my.external.hostname.com
```
para gerar novamente os certificados que funcionarão com o nome de host específico. Se você pretende configurar o agente remoto no Visual Studio usando o nome do host, execute ping Mac usando o nome de host para verificar se ele está acessível. Caso contrário, talvez seja necessário usar o endereço IP em vez disso.

Antes de poder usar o agente remoto, você deverá especificar a configuração remota no Visual Studio.

Para configurar o agente remoto para uso com o Visual Studio

Se o agente não estiver sendo executado em seu Mac, inicie o agente remoto.
Em seu Mac, obter o nome do host ou endereço IP do seu Mac.

Você pode obter o endereço IP usando oifconfigcomando.
Na barra de menus do Visual Studio, escolha Ferramentas, Opções.
Noopçõescaixa de diálogoFerramentas para Apache Cordovae, em seguida, escolhaconfiguração do agente remoto.
Defina Habilitar o processamento remoto de iOS para Verdadeiro.
Definirmodo seguroparaTrue.
NoHostportaesegurança PINcampos, digite os valores especificados pelo agente remoto quando é iniciado pela primeira vez. O host pode ser o nome ou endereço IP do seu Mac. A porta padrão é 3000.

Dica

Se você não puder executar ping do Mac usando o nome de host, talvez seja necessário usar o endereço IP.

Quando você clica emOKVisual Studio se conectará à instância remota agent (o agente deve estar em execução para conectar-se).

Se você quiser desabilitar o modo e habilitar simples baseado em HTTP conexões seguras, escolhaFalsecomo omodo seguroconfiguração e iniciar remotebuild com modo seguro desabilitado:
```
remotebuild --secure false
```
Se o modo seguro é desabilitado, você pode deixar osegurança PINcampo vazio ao configurar o agente no Visual Studio.

A segurança é PIN para serem utilizados. Se você precisar colocar um novo cliente com o servidor remotebuild, consultegerar um nova PIN de segurança.

Para interromper o agente

No aplicativo Terminal no seu Mac, pressione Ctrl+C.

Tarefas adicionais

Em algumas circunstâncias, etapas adicionais podem ser necessárias para atualizar e configurar as ferramentas.

Se você optar por não instalar uma ou mais dependências com o Visual Studio Tools para o Apache Cordova, talvez seja necessárioinstalar manualmente as dependências
Se você precisa verificar se o caminho para uma dependência de terceiros ou se você tiver várias versões de uma dependência instalado, consulteSubstituir variáveis de ambiente do sistema
Se você estiver executando o Visual Studio por trás de um proxy, consulteConfigurar ferramentas para trabalhar com um proxy.
Para usar e configurar o agente remotebuild para criar aplicativos do iOS, consulte o seguinte:
Se você encontrar erros inesperados durante a tentativa de criar o modelo de aplicativo em branco, consultereinstalação do vs tac.