Partilhar via

Instalar as ferramentas de compilação para iOS

  • Artigo

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.

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, remoto do vs-mda, em 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

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, consulte Compilar um aplicativo Cordova para iOS usando o Parallels.Para obter informações sobre como usar os serviços hospedados em nuvem do Mac, em vez de um Mac, consulte Compilar e simular o iOS na nuvem.

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

Instalar e configurar o agente remoto para criar e simular o iOS

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, use xcode-select --install)

  • Node.js

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 cer) 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 (escolha XCode, preferências)

Para baixar e instalar o agente remoto

  • No aplicativo Terminal no seu Mac, digite:

    sudo npm install -g vs-mda-remote --user=$USER

    onde $USER será substituído por seu nome de usuário no Mac. Quando você executa o comando, você deverá digitar sua senha também.

    O comutador da instalação global (-g) é recomendado, mas não é necessário.

    Durante a instalação, remoto do vs-mda será instalado e modo de desenvolvedor será ativado em seu Mac. Homebrew e dois pacotes npm também serão instalados.

    Aviso

    Para instalar o Homebrew, é necessário acesso sudo (administrador).Se você precisar instalar o vs-mda remota 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 o documentação Homebrew.If you need to manually enable developer mode, type the following in the Terminal app: 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:

    vs-mda-remote

    Isso iniciará o agente com um diretório de compilação padrão de ~ / remoto compilações. Opções de configurações adicionais para o agente são descritas neste tópico.

    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.

    Saída quando seu primeiro iniciar o agente remoto

    Importante

    Novo nesta versão, vs e mda-remoto foi projetado para transferir cargas de compilação para e do Visual Studio usando um PIN 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.

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

Para configurar o agente remoto do Visual Studio

  1. Se o agente não estiver sendo executado em seu Mac, inicie o agente remoto.

  2. Em seu Mac, obter o nome do host ou endereço IP do seu Mac.

    Você pode obter o endereço IP usando o ifconfig comando.

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

  4. No opções caixa de diálogo ferramentas para Apache Cordovae, em seguida, escolha configuração do agente remoto.

  5. Defina Habilitar o processamento remoto de iOS para Verdadeiro.

  6. No Host, porta, e segurança PIN campos, 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.

    Configurando o agente remoto no Visual Studio

    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 em OK, Visual Studio se conectará à instância remota agent (o agente deve estar em execução para conectar-se).

    Se você quiser desabilitar o modo seguro e habilitar as conexões baseadas em HTTP simples, digite o seguinte comando no aplicativo de Terminal:

    vs-mda-remote --secure false

    Em seguida, você pode deixar o segurança PIN campo vazio ao configurar o agente no Visual Studio.

Para interromper o agente

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

Quando você iniciar o agente na primeira vez, o PIN gerado é válido por um período limitado de tempo (10 minutos por padrão). Se você não se conectar ao agente antes de expira o tempo, 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:

    vs-mda-remote generateClientCert

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:

    vs-mda-remote resetServerCert

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

  4. No aplicativo Terminal no seu Mac, digite:

    vs-mda-remote generateClientCert

  5. Siga as instruções acima para inserir em novas informações de PIN e IP ou host de segurança.

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

Algumas das opções foram alterados desde a versão 0.2 do vs e mda-remoto.A alteração mais importante é que a opção - buildDir foi renomeada para - serverDir.

Para atualizar o agente remoto

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

    vs-mda-remote --help

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

    vs-mda-remote --secure false

    Quando você usa essa opção, deixe o campo PIN em branco ao configurar o agente no Visual Studio.

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

    vs-mda-remote --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:

    vs-mda-remote > 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:

    vs-mda-remote --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 de exemplo, examine a pasta vs-mda-remote/examples/exampleConfig.json no diretório de instalação do agente remoto. Por exemplo, o caminho pode ser /usr/local/lib/node_modules/vs-mda-remote/examples/exampleConfig.json.

Para verificar a configuração do agente remoto

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

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

    vs-mda-remote test

    Importante

    Este comando falhará se o agente não está sendo executado em uma segunda janela.

    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:

    vs-mda-remote test 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:

    vs-mda-remote test --device

  • Para verificar se sua identidade de assinatura de distribuição está configurada corretamente para compilações de dispositivo (usando a configuração de Distribuição no Visual Studio), digite:

    vs-mda-remote test --device --cfg distribution

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

Em alguns casos, talvez seja necessário obter acesso ao projeto do Xcode gerado para solucionar um problema nativo. Felizmente, você pode obter rapidamente acessem o projeto usado para criar seu aplicativo.

Para acessar um projeto Xcode gerado

  1. Crie seu aplicativo usando um simulador de iOS ou de destino do dispositivo.

  2. Após a compilação, vá para a janela de saída e selecione Mostrar saída de: criar.

    As entradas finais da saída de compilação devem ser semelhantes a esta:

    1>  ** BUILD SUCCEEDED **
1>  
1>  Command finished with error code 0: /Users/<username>/remote-builds/builds/8382/cordovaApp/platforms/ios/cordova/build --debug

  3. Em seu Mac, navegue até a pasta de ios no caminho especificado na saída da compilação. No exemplo acima, isso é Users < username > / remoto compilações/compilações/8382/cordovaApp/plataformas/ios

    Importante

    Quando o agente remoto do vs-mda é interrompido, a compilação (incluindo o projeto xcode gerado) será excluída a menos que você iniciou o vs-mda remota com o seguinte comando: --deleteBuildsOnShutdown false.

  4. Clique duas vezes no arquivo .xcodeproj nessa pasta e o projeto será aberto no Xcode.

Consulte também

Conceitos

Instalar o Visual Studio Tools for Apache Cordova

Executar seu aplicativo Apache Cordova no iOS