Configurar o Visual Studio Tools for Apache Cordova

  • Artigo

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.

Depois de terinstalado as ferramentasconsulte este tópico para outras maneiras de configurar rapidamente, atualizar ou personalizar as ferramentas para o seu ambiente.

  • 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 instalar, iniciar e configurar o agente de remotebuild (anteriormente chamado remoto do vs-mda) para criar aplicativos do iOS, consulte o seguinte:

    • Instalar o agente remoto e executá-lo(external topic)

    • Gerar um nova PIN de segurança

    • Configurar o agente remoto

    • Gerar um novo certificado de servidor

    • Verifique a configuração do agente remoto

  • Se você encontrar erros inesperados durante a tentativa de criar o modelo de aplicativo em branco, consultereinstalar vs tac.

    Aviso

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

  • Para outros problemas não listados aqui, consulte oproblemas conhecidos.

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.

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.5 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, consulteSubstituir variáveis de ambiente do sistema.

  • Java de 32 bits Oracle 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

    • Para evitar problemas de memória insuficiente, defina uma variável de ambiente _JAVA_OPTIONS com pelo menos - Xmx512M nele.

      Dica

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

  • SDK do androidcom os seguintes pacotes SDK:

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

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

    • SDK do Android-ferramentas de compilação (19,1, 19.0.3 e 21)

    • Android 5.0 (nível de API 21) com os seguintes pacotes:

      • Plataforma SDK

      • Se você quiser usar o emulador Android da Google para emular um dispositivo 5.0:

        • 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)

    • Se você quiser usar Cordova 5.0.0 ou posterior:

      • 5.1 Android (nível de API 22) com os seguintes pacotes:

        • Plataforma SDK

        • Se você quiser usar o emulador Android da Google para emular um dispositivo 5.1:

          • 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 mínimos no Gerenciador de SDK do Android.

    Cordova_SDK_Android_Packages

    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, consulteSubstituir 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)

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

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

    2. Descompacte os binários e, em seguida, desbloquear net45\Release\WebSocket4Net.dll

      Para desbloquear a DLL, abra o arquivo de propriedades para a DLL e escolhaDesbloquearna guia Geral (na parte inferior da caixa de diálogo).

    3. Depois de desbloquear a DLL, copie net45\Release\WebSocket4Net.dll para a pasta % ProgramFiles(x86) %\Microsoft Visual Studio 14.0\Common7\IDE\CommonExtensions\Microsoft\WebClient\Diagnostics\ToolWindows em seu computador.

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. Noopçõescaixa de diálogo caixa, escolhaFerramentas para Apache Cordovae, em seguida, escolhasubstituiçõ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.

Environment variables, warning message

Gerar um nova PIN (iOS agente remoto) de segurança

Quando vocêIniciar o agentethe first time, the generated PIN is valid for a limited amount of time (10 minutes by default). Se você não se conectar ao agente antes de expira o tempo ou se você deseja se conectar a um segundo cliente para o agente, você precisará gerar um novo PIN.

Para gerar um nova PIN de segurança

  1. Pare o agente (ou abra uma segunda janela do Terminal de aplicativo em seu Mac e usá-lo para inserir o comando).

  2. No aplicativo Terminal no seu Mac, digite:

    remotebuild generateClientCert

  3. Siga as instruções paraIniciar o agenteon your Mac and configure the agent in Visual Studio.

Gerar um novo certificado de servidor (iOS agente remoto)

Para fins de segurança, o servidor de certificados que par Visual Studio com o agente remoto estão vinculados a do Mac IP ou nome do host. Se esses valores forem alteradas, você precisará gerar um novo certificado de servidor e, em seguida, reconfigurar o Visual Studio com os novos valores.

Para gerar um novo certificado do servidor

  1. Interrompa o agente.

  2. No aplicativo Terminal no seu Mac, digite:

    remotebuild resetServerCert --hostname=my.hostname.com

  3. Quando solicitado, digite "Y" e, em seguida, digite Enter.

  4. No aplicativo Terminal no seu Mac, digite:

    remotebuild generateClientCert --hostname=my.hostname.com

    nome de host é opcional. Se omitido, o agente tentará determinar o nome do host automaticamente.

  5. Siga as instruções paraIniciar o agenteon your Mac and configure the agent in Visual Studio.

Configurar o agente remoto do iOS

Você pode configurar o agente remoto usando várias opções de linha de comando. Por exemplo, você pode especificar a porta para escutar solicitações de compilação e especificar o número máximo de compilações a serem mantidas no sistema de arquivos. (Por padrão, o limite é 10. O agente irá remover as compilações que excedem o máximo no desligamento.)

Aviso

Várias opções foram alterados entre remoto do vs-mda e remotebuild.

Para atualizar o agente remoto

  • Para ver uma lista completa dos comandos de agente, digite:

    remotebuild --help

  • Para desabilitar o modo seguro e habilitar conexões de baseado em HTTP simples, digite:

    remotebuild –-secure=false

    Quando você usar essa opção, deixe o campo PIN em branco e certifique-se de definirmodo seguroparaFalseao configurar o agente no Visual Studio.

  • Para especificar um local para arquivos de agente remoto, digite:

    remotebuild --serverDir <directory>

    onde< diretório >é um local em seu Mac onde os arquivos de log, compilações e certificados de servidor serão colocados. Por exemplo, o local pode ser Usersnome de usuário/compilações. (Compilações serão organizadas por número de compilação nesse local.)

  • Usar um processo em segundo plano para capturar stdout e stderr para um arquivo (server.log), digite:

    remotebuild > server.log 2>&1 &

    O arquivo server.log pode ajudar na solução de problemas de compilação.

  • Para executar o agente usando um arquivo de configuração em vez de parâmetros de linha de comando, digite:

    remotebuild --config <path-to-config-file>

    O arquivo de configuração deve estar no formato JSON. As opções de inicialização e seus valores não devem incluir traços. Para ver um arquivo de configuração documentada, examine a pasta remotebuild/examples/exampleConfig.json no diretório de instalação do agente remoto, embora você deve remover os comentários no arquivo que você usa para a sua configuração. Um exemplo de um caminho que você pode usar ao executar este comando é/Users/<username>/myConfig.json. O caminho padrão onde o agente procura um arquivo de configuração é ~ /.taco_home/RemoteBuild.config.

Verifique a configuração de agente remoto do iOS

Depois de terinstalou o agenteyou can verify the remote agent configuration.

Para verificar a configuração do agente remoto

  • Com o agente remoto em execução, abra uma segunda janela do aplicativo Terminal (escolhaShellnova janela).

  • Na segunda janela do aplicativo Terminal no seu Mac, digite:

    remotebuild test <same-options-as-first-agent>

    Importante

    Esse comando falhará se o agente não está em execução em uma segunda janela, ou se as duas instâncias não estiver usando as mesmas opções de configuração.

    Este comando inicia uma compilação de teste. A saída do comando deve mostrar o número da versão e outras informações sobre a criação, como seu progresso.

    Depois de iniciar uma compilação de teste,Verifique se a compilação.

  • Se você iniciou o servidor em uma porta diferente da 3000, use o seguinte comando para iniciar uma compilação de teste:

    remotebuild test –-server https://localhost:<portNumber>

  • Para verificar se a identidade de assinatura do desenvolvedor está configurada corretamente para compilações de dispositivo (usando as configurações de Depuração e Versão no Visual Studio), digite:

    remotebuild test --device

  • Para verificar que sua identidade de autenticação está configurada corretamente para o dispositivo de distribuição cria (usando a configuração de depuração no Visual Studio), digite:

    remotebuild test --device

    Para obter mais informações sobre identidades de assinatura de certificado e provisionamento de aplicativo, consulteEmpacotar seu aplicativo compilado com o Visual Studio Tools for Apache Cordova.

Reinstale o tac vs

Se você vir erros inesperados quando tentar criar o modelo de aplicativo em branco depois de instalar o Visual Studio Tools para o Apache Cordova, você pode tentar limpar o cache e reinstalar o tac-Cordova CLI pré-processador, vs, no seu PC. Normalmente, isso é necessário apenas se você tentar criar um aplicativo Cordova e consulte o erroCannot find module [modulename].

Para limpar o cache

  1. EscolhaferramentasopçõesFerramentas para Apache Cordovae, em seguida, escolhaFerramentas Cordova.

  2. EscolhaLimpar Cache Cordova.

  3. Feche e reabra o projeto.

  4. EscolhacriarLimpar soluçãoe, em seguida, recrie seu projeto.

    Dica

    Se você tiver sem erros, não preciso reinstalar tac vs.Se você ainda terá o mesmo erro, reinstale o tac vs.

Para reinstalar o tac vs

  1. Feche o Visual Studio.

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

    npm install -g <path-to-vs-tac>

    O caminho padrão para vs tac é C:\Program Files (x86) \Microsoft Visual Studio 14.0\Common7\IDE\Extensions\ApacheCordovaTools\packages\vs-tac

  3. Abra novamente o Visual Studio.

  4. Abra seu projeto, escolhacriarLimpar soluçãoe, em seguida, recrie seu projeto.

    Se isso não resolver o problema, consulte oproblemas conhecidos.

Configurar as ferramentas para trabalhar com um proxy

Se você estiver usando o Visual Studio por trás de um proxy, como um firewall corporativo, talvez seja necessário definir configurações de proxy para o Gerenciador de pacotes npm e git antes de usar o Visual Studio Tools para o Apache Cordova.

Importante

Usar as configurações de proxy npm com versões recentes do Node. js pode causar Cordova falha adquirir plug-ins na linha de comando ou no designer de configuração ou ao adicionar plataformas necessárias para compilação.Se você encontrar problemas inesperados (especialmente um "TypeError: solicitar o caminho contém caracteres de escape" erro), tente fazer downgrade Node. js para 0.10.29.

Para definir configurações de proxy para o Gerenciador de pacotes npm

  1. Feche o Visual Studio

  2. Abra uma janela de comando Visual Studio developer (Ctrl + Alt + A) e digite o comando a seguir.

    npm -g uninstall vs-tac

  3. Abra %AppData%\npm\node_modules e verifique se a pasta tac vs foi removida.

  4. Na janela de comando do desenvolvedor do Visual Studio, digite o comando a seguir.

    npm config set proxy <proxy-port>

    ondeporta proxyé o endereço e porta número proxy, como http://proxy.mycompany.com:80 /

  5. Digite este comando:

    npm config set https-proxy <proxy-port>

    ondeporta proxypode ser um valor como http://proxy.mycompany.com:80 /.

  6. Abra o Visual Studio.

  7. Abra a solução Apache Cordova e recompile seu projeto.

Para definir configurações de proxy para git

  1. Feche o Visual Studio.

  2. Abra uma janela de comando Visual Studio developer (Ctrl + Alt + A) e digite o comando a seguir.

    git config --global http.proxy http://<username>:<password>@<proxy-port>

    ondenome de usuárioesenhasão o nome de usuário do proxy e a senha;porta proxypode ser um valor como proxy.mycompany.com:80

  3. Digite o seguinte comando:

    git config --global https.proxy http://<username>:<password>@<proxy-port>

    ondenome de usuárioesenhasão o nome de usuário do proxy e a senha;porta proxypode ser um valor como proxy.mycompany.com:80

  4. Abra o Visual Studio.

  5. Abra a solução Apache Cordova e recompile seu projeto.

Download the tools Obter o Visual Studio Tools para o Apache Cordovaoumais

Consulte também

Conceitos

Instalar o Visual Studio Tools for Apache Cordova

Executar seu aplicativo Apache Cordova no iOS