Instalar o Visual Studio Tools for Apache Cordova

Este artigo se refere ao Visual Studio Tools for Apache Cordova, que é um software de pré-lançamento. Os recursos descritos estão em pré-lançamento e sujeitos a alterações. Você pode baixar a visualização do Microsoft Download Center.

Este artigo descreve como instalar as ferramentas e as dependências de terceiros necessárias para criar aplicativos de Cordova de plataforma cruzada usando o Visual Studio Tools para o Apache Cordova:

Requisitos
Obtendo as ferramentas
Instalando as ferramentas
Instalar as dependências manualmente
Instalando ferramentas para iOS
Substituir variáveis de ambiente do sistema

Requisitos

• Um dos seguintes sistemas operacionais: Windows 7, Windows 8, Windows 8.1 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.

• Visual Studio 2013 atualização 4 (Professional, Ultimate, Premium ou Community Edition) com os seguintes recursos instalados:

  • Ferramentas para a Manutenção de Aplicativos da Store para o Windows 8

  • SDK do Windows Phone 8.0

    Você pode adicionar esses recursos a uma instalação existente do Visual Studio 2013 Atualização 4. No Painel de Controle, escolha Programas e Recursos. Selecione Visual Studio 2013 na lista e escolha Alterar. Na janela de instalação do Visual Studio, escolha Modificar. Na lista de recursos, selecione as duas opções, conforme mostrado na ilustração.

    

• Se você estiver usando o Visual Studio 2015 Preview em vez do Visual Studio 2013, consulte o procedimento de instalação em neste tópico.

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

• O emulador do Android funciona melhor em computadores que executam o driver Intel HAXM. Consulte Executar seu aplicativo Apache Cordova no Android.

• Emuladores do Windows Phone exigem um computador que possa executar o Hyper-V. Para obter mais informações, consulte os requisitos de sistema do emulador.

• o simulador do iOS e iOS requer um computador Mac capaz de executar Xcode 6 (Xcode 6 é recomendado). Para ver etapas adicionais, consulte: Instalar as ferramentas de compilação para iOS.

  Dica

  Se você quiser criar iOS em um serviço de nuvem em vez de hardware do Mac, consulte Compilar e simular o iOS na nuvem.

Obtenha as ferramentas

Para obter o Visual Studio Tools para extensão Apache Cordova, vá para o Microsoft Download Center. Siga as etapas na próxima seção para instalar a extensão.

Importante

Se você instalou anteriormente um CTP do Visual Studio Tools para o Apache Cordova (aplicativos híbridos de múltiplos dispositivos), primeiro você deve desinstalar o CTP usando o painel de controle, programas e recursos antes de instalar o Visual Studio 2013 atualização 4 e o CTP atual.

No Visual Studio 2015 Preview, o Visual Studio Tools for Apache Cordova pode ser instalado como um recurso opcional durante a instalação. Para o procedimento de instalação, consulte se familiarizar com o Visual Studio Tools for Apache Cordova.

Instalar as ferramentas

Primeiro, o instalador instala um patch para o Visual Studio para dar suporte ao desenvolvimento de aplicativo Cordova. Em seguida, ele oferece a opção de instalar o seguinte software de terceiros. A maioria deles são softwares livres necessários para plataformas específicas ou pelo Apache Cordova.

• O Joyent Node.js permite que o Visual Studio integre a Interface de Linha de Comando (CLI) do Apache Cordova e o Apache Ripple Emulator.

• O Git CLI é necessário somente se você precisar adicionar manualmente Git URIs a plug-ins Cordova específicos.

• O Google Chrome é necessário para executar o emulador Apache Ripple para iOS e Android.

• O Apache Ant 1.8.0 ou posterior é necessário para os processos de compilação do Android.

• O Oracle Java JDK 7 é necessário para o processo de compilação do Android.

• O SDK do Android é necessário para o processo de compilação do Android e do Ripple.

• O SQLite para Tempo de Execução do Windows é necessário para adicionar conectividade SQL aos aplicativos do Windows (para o plug-in WebSQL Polyfill).

• O Apple iTunes é necessário para implantar um aplicativo em um dispositivo iOS conectado ao seu computador Windows.

Para instalar a extensão do Visual Studio e dependências

1. Execute o instalador encontrado no Obtenha as ferramentas.

2. Siga as instruções para instalar a extensão do Visual Studio.

3. Quando solicitado, permita que o instalador instale as dependências de software de terceiros, ou você pode limpar as seleções de software e instalar manualmente as dependências que serão 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.Consulte instalando dependências manualmente.

   

4. Reinicie o computador.

   Importante

   Você deve reinicializar para certificar-se de que tudo está instalado corretamente.

5. 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.

6. Antes de executar o aplicativo no iOS Simulator ou em um dispositivo iOS, você deve instalar o agente remoto em um computador Mac. Consulte Instalar as ferramentas de compilação para iOS.

Instalar as dependências manualmente

Se você optar por não instalar uma ou mais dependências com a extensão, você pode instalá-las manualmente mais tarde.

Aviso

Você pode instalar as dependências em qualquer ordem, exceto o Java.Você deve instalar e configurar o Java antes de instalar o SDK do Android.

Leia as informações a seguir e use estes links para instalar as dependências manualmente.

• Joyent Node.js

  É recomendável instalar a versão x86 do Node. js.

• Google Chrome

• Ferramentas de Linha de Comando do Git

  Ao instalar as Ferramentas de Linha de Comando do Git, selecione a opção que adiciona o Git ao seu caminho de prompt de comando.

  Aviso

  Ferramentas de linha de comando Git 1.9.3 são instaladas por padrão.Falhas inesperadas podem ocorrer se você instalar uma versão anterior à 1.9.0.

• Apache Ant

  • Baixe e extraia o Ant para um local como C:/ant-1.x.x

  • Defina a variável de ambiente ANT_HOME para apontar para o local anterior.

  • Adicione %ANT_HOME%\bin ao caminho do sistema.

    Dica

    Se você precisar definir essa variável de ambiente manualmente, consulte substituir variáveis de ambiente do sistema.

• Oracle Java 7

  • Defina a variável de ambiente JAVA_HOME para C:/Arquivos de Programa/Java/jdk1.7.0_55

  • Adicione isso ao caminho do sistema: %JAVA_HOME%\bin

    Dica

    Se você precisar definir essa variável de ambiente manualmente, consulte substituir variáveis de ambiente do sistema.

• SDK do Android com os seguintes pacotes SDK:

  • Ferramentas do SDK do Android (versão mais recente)

  • Ferramentas de plataforma Android para o SDK (versão mais recente)

  • Ferramentas de compilação Android para o SDK (versão mais recente)

  • 4.4 Android (API de nível 19) com os seguintes pacotes:

    • Plataforma SDK

    • Imagem de sistema do ARM EABI v7a

    • Imagem do sistema Atom Intel x86

    • APIs do Google (x da imagem do sistema x86)

    • APIs do Google (imagem de sistema do ARM)

  A ilustração a seguir mostra os pacotes necessários no Gerenciador de SDK do Android.

  

  Defina a variável de ambiente ADT_HOME para o local de instalação do SDK.

  Adicione isso ao caminho do sistema: %ADT_HOME%\tools;%ADT_HOME%\platform-tools

  Se você precisar definir essa variável de ambiente manualmente, consulte substituir variáveis de ambiente do sistema.

  Dica

  Se você instalar o SDK do Android para seu local padrão no Windows, ele é instalado para C:\Program Files (x86) \Android\android-sdk.

• Apple iTunes (x86, x64)

• SQLite

• WebSocket4Net (necessário se você estiver desenvolvendo seu aplicativo no Windows 7)

  1. Baixe o WebSocket4Net(0.9).Binaries.zip do CodePlex.

  2. No arquivo zip baixado, copie o net45\Release\WebSocket4Net.dll para a pasta %ProgramFiles(x86) %\Microsoft Visual Studio 12.0\Common7\IDE\CommonExtensions\Microsoft\WebClient\Diagnostics\ToolWindows no seu computador.

Instalar as ferramentas para iOS

Algumas etapas adicionais são necessárias para criar e executar aplicativos para iOS do Visual Studio. Consulte Instalar as ferramentas de compilação para iOS.

Substituir variáveis de ambiente do sistema

O Visual Studio detecta as configurações para o software de terceiros que você instalou e mantém os caminhos de instalação nas variáveis de ambiente a seguir:

• ADT_HOME aponta para o caminho de instalação do Android.

• ANT_HOME aponta para a pasta Ant no seu computador.

• GIT_HOME aponta para o caminho de instalação do Git.

• JAVA_HOME aponta para o caminho de instalação do Java.

O Visual Studio usa essas variáveis de ambiente ao criar e executar o aplicativo. Você pode exibir as variáveis de ambiente e revisar seus valores por meio da caixa de diálogo Opções do Visual Studio. Você pode desejar substituir as configurações padrão por um dos seguintes motivos:

• O Visual Studio não conseguiu verificar o caminho. Nesse caso, um aviso será exibido ao lado da variável de ambiente.

• Você tem várias versões do software instalado e gostaria de usar uma versão específica.

• Você quer que seu caminho de ambiente global seja diferente do ambiente do Visual Studio local.

Para substituir as variáveis

1. Na barra de menus do Visual Studio, escolha Ferramentas, Opções.

2. No opções caixa de diálogo caixa, escolha ferramentas para Apache Cordovae, em seguida, escolha substituições de variável de ambiente.

3. Faça as alterações:

   • Para substituir um valor, marque a caixa de seleção e, em seguida, altere o valor.

     Se as informações de caminho forem inválidas ou ausentes, o Visual Studio exibirá um aviso ao lado da variável.

   • Para redefinir uma variável de ambiente para o valor padrão, desmarque a respectiva caixa de seleção ou escolha Restaurar padrões.

4. Escolha OK para salvar suas alterações e fechar a caixa de diálogo.

Atualizar manualmente a versão Cordova

O Visual Studio tem sido o teste em relação a uma versão específica do Apache Cordova. Pretendemos oferece suporte a seleção de uma versão de Cordova em um nível por projeto, mas até agora, é possível aplicar um patch para usar uma versão diferente do Cordova em todos os projetos em seu sistema.

Aviso

Visual Studio de aplicação de patch não é oficialmente suportada.Você pode executar em comportamentos inesperados e recomendamos que apenas usuários avançados execute estas etapas.O patch faz alterações em todo o sistema para o seu computador.

Para atualizar o Visual Studio para usar uma versão diferente do Cordova

1. Depois de instalar o Visual Studio Tools para Cordova, criar e compilar um projeto em branco para instalar o Cordova.

2. Abra uma linha de comando e digite o seguinte comando:

   cd %appdata%\npm\node_modules\vs-mda\
   

   Se você mesmo instalou Node. js, vs mda pode ser instalado em um local diferente. O comando anterior mostra o local de instalação padrão.

3. Na linha de comando, digite este comando:

   npm install cordova@version --save
   

   onde versão é a versão da CLI Cordova que você deseja usar. Por exemplo, você pode usar a versão 4.1.0.

   Se você tiver instalado o Cordova em outro lugar, você pode digitar cordova --version para descobrir a versão Cordova.

   Importante

   Certifique-se de omitir o -g opção global quando você executa o precede o comando de instalação.

4. Executar uma operação de "limpeza" como limpar solução no projeto que você está editando no Visual Studio para fazer a alteração da versão em vigor.

Para reverter para a versão suportada do Cordova

• Abra um prompt de comando e digite:

  npm uninstall -g vs-mda
  

  O Visual Studio automaticamente reinstalará vs mda na próxima vez que você criar.

  Como alternativa, você pode procurar o arquivo vs mda em C:\Program Files (x86) \Microsoft Visual Studio 12.0\Common7\IDE\Extensions e modificar Package para referir-se a versão que você deseja usar. Quando tiver terminado de modificar Package, execute o seguinte comando na mesma pasta:

  npm install -g vs-mda
  

Para iOS apoio em seu Mac, a versão do Cordova que usa remoto do vs-mda deve corresponder à versão que você instalou o Visual Studio. As etapas a seguir descrevem como atualizar vs mda-remoto para usar uma versão específica de Cordova. Para obter informações completas sobre a instalação do iOS ferramentas de compilação, consulte Instalar as ferramentas de compilação para iOS.

Para atualizar uma versão diferente do Cordova vs-mda remota em seu Mac

1. Abra o aplicativo de Terminal em seu Mac e digite o seguinte comando:

   cd /usr/local/lib/node_modules/vs-mda-remote
   

   Se você não instalou remoto do vs-mda globalmente (-g) o local do vs e mda-remoto pode ser diferente em seu Mac.

2. Digite o seguinte comando:

   sudo npm install cordova@version --save
   

   onde versão é a mesma versão da CLI Cordova instalado anteriormente. Por exemplo, isso pode ser a versão 4.1.0.

   Importante

   Certifique-se de omitir o -g opção global quando você executa o precede o comando de instalação.

   Se você instalou Cordova em outro lugar, você pode digitar cordova --version para descobrir a versão Cordova.

   Executar uma operação de "limpeza" como limpar solução no projeto que você está editando no Visual Studio para fazer a alteração da versão em vigor.

Para reverter o vs-mda remota em seu Mac para a versão com suporte

1. Abra o aplicativo de Terminal em seu Mac e digite:

   sudo npm uninstall -g vs-mda-remote
   

2. Digite o seguinte comando:

   sudo npm install -g vs-mda-remote --save
   

    

Consulte também

Conceitos

Instalar as ferramentas de compilação para iOS

Outros recursos

Baixe as ferramentas

FAQ

problemas conhecidos