Instalar e configurar ferramentas para criar usando iOS

Você pode usar o Visual Studio com o desenvolvimento móvel multiplataforma com ferramentas C++ para editar, depurar e implantar código iOS no simulador iOS ou em um dispositivo iOS. Mas, devido a restrições de licenciamento, o código deve ser construído e executado remotamente em um Mac. Para criar e executar aplicativos iOS usando o Visual Studio, você precisa instalar e configurar o agente remoto, vcremote, no seu Mac. O agente remoto vcremote lida com solicitações de compilação do Visual Studio e executa o aplicativo em um dispositivo iOS conectado ao Mac ou no simulador iOS no Mac.

Depois de instalar as ferramentas para criar usando o iOS, consulte este artigo novamente. Ele descreve maneiras de configurar e atualizar rapidamente o vcremote para desenvolvimento iOS no Visual Studio e no seu Mac.

Pré-requisitos

Para instalar e usar o agente remoto vcremote para desenvolver código para iOS, você deve primeiro ter estes pré-requisitos:

• Um computador Mac com macOS Mojave versão 10.14 ou posterior

• Um Apple ID

• Uma conta ativa do Apple Developer Program

  Você pode obter uma conta gratuita que permite instalar aplicativos fora da App Store em um dispositivo iOS apenas para testes, mas não para distribuição.

• Xcode versão 10.2.1 ou posterior

  O Xcode pode ser descarregado a partir da App Store.

• Ferramentas de linha de comando Xcode

  Para instalar as ferramentas de linha de comando Xcode, abra o aplicativo Terminal no Mac e digite o seguinte comando:

  xcode-select --install

• Uma conta de ID Apple configurada no Xcode como uma identidade de assinatura para assinar aplicativos

  Para ver ou definir sua identidade de assinatura no Xcode, abra o menu Xcode e escolha Preferências. Selecione Contas e escolha o seu ID Apple e, em seguida, escolha o botão Ver detalhes . Consulte Adicionar a sua conta ID Apple para obter instruções detalhadas.

  Para obter informações detalhadas sobre os requisitos de assinatura, consulte O que é assinatura de aplicativo.

• Se você estiver usando um dispositivo iOS para desenvolvimento, um perfil de provisionamento configurado no Xcode para seu dispositivo

  O Xcode fornece assinatura automática, onde cria certificados de assinatura para você, conforme necessário. Para obter informações detalhadas sobre a assinatura automática do Xcode, consulte Assinatura automática.

  Se quiser fazer assinatura manual, você precisa criar um perfil de provisionamento para seu aplicativo. Para obter informações detalhadas sobre como criar perfis de provisionamento, consulte Criar um perfil de provisionamento de desenvolvimento.

• Node.js versão 18.12.1 e npm versão 8.19.2

  Instale a versão 18.12.1 do Node.js no seu Mac. Se você instalar o pacote Node.js, ele deve vir com npm versão 8.19.2. Outras versões do Node.js e npm podem não suportar alguns módulos usados no vcremote, o que pode causar falha na instalação do vcremote. Recomendamos que você instale Node.js usando um gerenciador de pacotes, como o Node Version Manager. Evite usar o comando sudo para instalar Node.js, pois alguns módulos podem falhar na instalação ao usar sudo.

Instalar vcremote para iOS

Quando você instala o desenvolvimento móvel com carga de trabalho C++, o Visual Studio pode se comunicar com o agente remoto vcremote em execução no Mac para transferir arquivos, criar e executar seu aplicativo iOS e enviar comandos de depuração.

Antes de instalar o vcremote, certifique-se de que satisfez os pré-requisitos e concluiu as etapas de instalação em Instalar desenvolvimento móvel multiplataforma com C++.

Para baixar e instalar o vcremote

• A partir da aplicação Terminal no Mac, verifique se a versão Node.js atualmente em uso é a versão 18.12.1 necessária. Para verificar a versão, execute o comando:

  node -v

  Se não for a versão correta, talvez seja necessário seguir as instruções de instalação Node.js nos pré-requisitos. Em seguida, reinicie Node.js.

• Depois de verificar se o Node.js necessário está em uso, execute este comando para instalar o vcremote nessa versão Node.js:

  npm install -g --unsafe-perm vcremote

  A opção de instalação global (-g) é recomendada, mas não necessária. Se você não usar a opção de instalação global, vcremote será instalado sob o caminho ativo atual no aplicativo Terminal.

  Durante a instalação, vcremote é instalado e o modo de desenvolvedor é ativado no seu Mac. Homebrew e dois pacotes npm, vcremote-lib e vcremote-utils, também estão instalados. Quando a instalação for concluída, é seguro ignorar quaisquer avisos sobre dependências opcionais ignoradas.

  Observação

  Para instalar o Homebrew, você deve ter acesso sudo (administrador). Se precisar instalar o vcremote sem sudo, pode instalar o Homebrew manualmente numa localização usr/local e adicionar a sua pasta bin ao seu caminho. Para obter mais informações, consulte a documentação do Homebrew. Para habilitar manualmente o modo de desenvolvedor, digite este comando no aplicativo Terminal: DevToolsSecurity -enable

Se você atualizar para uma nova versão do Visual Studio, você deve atualizar para a versão atual do vcremote também. Para atualizar o vcremote, repita as etapas para baixar e instalar o agente remoto.

Iniciar vcremote

O agente remoto vcremote deve estar em execução para que o Visual Studio crie e execute seu código iOS. O Visual Studio deve ser emparelhado com vcremote antes de se comunicar. Por padrão, vcremote é executado no modo de conexão segura, que requer a transferência de certificados de cliente e servidor entre as máquinas Visual Studio e Mac.

Para iniciar o vcremote

• A partir da aplicação Terminal no Mac, introduza:

  vcremote

  Este comando inicia o agente remoto com um diretório de compilação padrão de ~/vcremote. Para obter mais opções de configuração, consulte Configurar vcremote no Mac.

A primeira vez que você inicia vcremote, e cada vez que você cria um novo certificado de servidor, você recebe as informações necessárias para configurar a conexão no Visual Studio. As informações incluem o nome do host e a porta. Se você pretende configurar o agente remoto no Visual Studio usando o nome do host, execute ping no Mac do Windows usando o nome do host para verificar se ele está acessível. Caso contrário, poderá ter de utilizar o endereço IP.

Você pode usar o agente remoto no modo não seguro. No modo não seguro, o agente remoto pode ser emparelhado ao Visual Studio usando uma conexão HTTP simples que não criptografa dados. Use o modo não seguro por sua conta e risco. Recomendamos que você use um modo seguro para se conectar:

Visual Studio 2022 versão 17.5 ou posterior com vcremote 1.0.19 ou posterior:

No vcremote 1.0.19 e posterior, vcremote relata o caminho para um arquivo de server-cert.pem certificado, que deve ser carregado no Visual Studio.

Visual Studio 2022 versão 17.4 e versões anteriores com vcremote 1.0.17 e anteriores:

A versão 1.0.17 e versões mais antigas do vcremote geram um PIN para comunicação segura com versões do Visual Studio por meio do Visual Studio 2022 versão 17.4.

O PIN gerado é para uso único e é válido apenas por um tempo limitado. Se você não emparelhar o Visual Studio com o agente remoto antes que o tempo expire, será necessário gerar um novo PIN. Para obter mais informações, consulte Gerar um novo PIN de segurança.

Para desativar o modo de conexão segura

• Para desativar o modo de ligação segura no vcremote, introduza este comando na aplicação Terminal no seu Mac:

  vcremote --secure false

Para ativar o modo de conexão segura

• Para ativar o modo de conexão segura, digite este comando:

  vcremote --secure true

Depois de iniciar o agente remoto, você pode usá-lo do Visual Studio até pará-lo.

Para parar o agente remoto

• Na janela Terminal em que vcremote está em execução, digite Control+C.

Configurar vcremote no Visual Studio

Para se conectar ao agente remoto vcremote do Visual Studio, você deve especificar a configuração remota nas opções do Visual Studio. O Visual Studio usa as mesmas informações para se conectar ao agente remoto em seu Mac cada vez que você usá-lo. Você não precisa emparelhar o Visual Studio com o agente remoto novamente, a menos que gere um novo certificado de segurança no seu Mac ou seu nome de host ou endereço IP sejam alterados.

Para configurar o vcremote no Visual Studio 2022 versão 17.5 e versões posteriores

1. Se o agente ainda não estiver em execução no seu Mac, siga as etapas em Iniciar o agente remoto. Para emparelhar, conectar e compilar seu projeto com êxito, o seu Mac deve estar a executar o vcremote para o Visual Studio.

2. No seu Mac, obtenha o nome do anfitrião ou o endereço IP do seu Mac.

   Você pode obter o endereço IP usando o comando ifconfig em uma janela do Terminal. Use o endereço listado inet na interface de rede ativa.

3. Na barra de menus do Visual Studio, escolhaOpções de ferramentas>.

4. Na caixa de diálogo Opções, expanda Plataforma Cruzada>C++>iOS.

5. Nos campos Nome do Host e Porta , insira os valores especificados pelo agente remoto quando você o iniciou. O nome do host pode ser o nome DNS ou o endereço IP do seu Mac. A porta padrão é 3030.

   Observação

   Se não conseguir executar ping no Mac usando o nome do host, talvez seja necessário usar o endereço IP.

6. Se você usar o agente remoto no modo de conexão segura padrão, marque a caixa de seleção Seguro e transfira o server-cert.pem arquivo do Mac para o Visual Studio para upload. Em seguida, escolha o botão Gerar para gerar um novo client-cert.pem arquivo, que deve aparecer na área de trabalho. Em seguida, transfira o certificado do cliente para o Mac em /vcremote/certs/Authorized-Clients. (Você pode transferir vários arquivos de certificado de cliente para este diretório, para que várias máquinas autorizadas do Visual Studio possam enviar solicitações para este Mac.)

   Observação

   Se estiver a utilizar uma unidade USB para transferir certificados, elimine os certificados da unidade USB após a conclusão da transferência.

7. Escolha Emparelhar para ativar o emparelhamento.

   

   O emparelhamento persiste até que você altere o nome do host, a porta ou gere um novo certificado de servidor ou cliente. Se você alterar o nome do host ou a porta na caixa de diálogo Opções , poderá escolher o botão Reverter para desfazer a alteração e reverter para o emparelhamento anterior.

   Se o emparelhamento não for bem-sucedido, verifique se o agente remoto está em execução seguindo as etapas em Iniciar o agente remoto. Siga as etapas para Gerar um novo certificado de servidor e Gerar um novo certificado de cliente. Se estiver a utilizar o nome de anfitrião do seu Mac, tente utilizar o endereço IP no campo Nome do anfitrião .

8. Atualize o nome da pasta no campo Raiz remota para especificar a pasta usada pelo agente remoto no diretório home (~) no Mac. Por padrão, o agente remoto usa /Users/<username>/vcremote como a raiz remota.

9. Escolha OK para salvar as configurações de conexão de emparelhamento remoto.

Para configurar vcremote a partir de versões anteriores ao Visual Studio 2022 versão 17.5

1. Se o agente ainda não estiver em execução no seu Mac, siga as etapas em Iniciar o agente remoto. Para emparelhar, conectar e compilar seu projeto com êxito, o seu Mac deve estar a executar o vcremote para o Visual Studio.

2. No seu Mac, obtenha o nome do anfitrião ou o endereço IP do seu Mac.

   Você pode obter o endereço IP usando o comando ifconfig em uma janela do Terminal. Use o endereço listado inet na interface de rede ativa.

3. Na barra de menus do Visual Studio, escolhaOpções de ferramentas>.

4. Na caixa de diálogo Opções, expanda Plataforma Cruzada>C++>iOS.

5. Nos campos Nome do Host e Porta , insira os valores especificados pelo agente remoto quando você o iniciou. O nome do host pode ser o nome DNS ou o endereço IP do seu Mac. A porta padrão é 3030.

   Observação

   Se não for possível executar ping no Mac usando o nome do host, talvez seja necessário usar o endereço IP.

6. Se você usar o agente remoto no modo de conexão segura padrão, marque a caixa de seleção Seguro e insira o valor do PIN especificado pelo agente remoto no campo Pin . Se você usar o agente remoto no modo de conexão não segura, desmarque a caixa de seleção Seguro e deixe o campo Pin em branco.

7. Escolha Emparelhar para ativar o emparelhamento.

   

   O emparelhamento persiste até que você altere o nome do host ou a porta. Se você alterar o nome do host ou a porta na caixa de diálogo Opções , para desfazer a alteração, escolha o botão Reverter para reverter para o emparelhamento anterior.

   Se o emparelhamento não for bem-sucedido, verifique se o agente remoto está em execução seguindo as etapas em Iniciar o agente remoto. Se tiver passado demasiado tempo desde que o PIN do agente remoto foi gerado, siga os passos indicados em Gerar um novo PIN de segurança. Em seguida, tente novamente. Se estiver a utilizar o nome de anfitrião do seu Mac, tente utilizar o endereço IP no campo Nome do anfitrião .

8. Atualize o nome da pasta no campo Raiz remota para especificar a pasta usada pelo agente remoto no diretório home (~) no Mac. Por padrão, o agente remoto usa /Users/<username>/vcremote como a raiz remota.

9. Escolha OK para salvar as configurações de conexão de emparelhamento remoto.

Gerar um novo PIN de segurança

Aplica-se a: Visual Studio 2022 versão 17.4 e versões anteriores, usando vcremote versão 1.0.17 e anteriores.

Quando você inicia o agente remoto pela primeira vez, o PIN gerado é válido por um período limitado de tempo — por padrão, 10 minutos. Se você não emparelhar o Visual Studio com o agente remoto antes que o tempo expire, será necessário gerar um novo PIN.

Para gerar um novo PIN

1. Pare o agente ou abra uma segunda janela do aplicativo Terminal no Mac e use-a para inserir o comando.

2. Introduza este comando na aplicação Terminal:

   vcremote generateClientCert

   O agente remoto gera um novo PIN temporário. Para emparelhar o Visual Studio usando o novo PIN, repita as etapas em Configurar o agente remoto no Visual Studio.

Gerar um novo certificado de cliente

Aplica-se a: Visual Studio 2022 versão 17.5 e versões posteriores, usando vcremote versão 1.0.19 e posterior.

Ao emparelhar no Visual Studio, você gerará um novo arquivo client-cert.pem. Transfira o arquivo de certificado para a máquina de compilação do Mac em /vcremote/certs/Authorized-Clients. Este certificado permite que o Mac autorize solicitações que vêm de sua máquina Visual Studio.

Gerar um novo certificado de servidor

Aplica-se a: Visual Studio 2022 versão 17.5 e versões posteriores, usando vcremote versão 1.0.19 e posterior.

Para fins de segurança, os certificados de servidor que emparelham o Visual Studio com o agente remoto estão vinculados ao endereço IP ou nome de host do seu Mac. Se esses valores forem alterados, você deverá gerar um novo certificado de servidor e reconfigurar o Visual Studio com os novos valores.

Para gerar um novo certificado de servidor

1. Pare o vcremote agente.

2. Introduza este comando na aplicação Terminal:

   vcremote resetServerCert

3. Quando for solicitada a confirmação, digite Y.

4. Para emparelhar o Visual Studio com o Mac, transfira o arquivo recém-gerado server-cert.pem do Mac e carregue-o para o Visual Studio, repetindo as etapas em Configurar o agente remoto no Visual Studio.

Configurar vcremote no Mac

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 é de 10 compilações. O agente remoto removerá compilações que excedam o máximo ao desligar.

Para configurar o agente remoto

• Para ver uma lista completa dos comandos do agente remoto, no aplicativo Terminal, digite:

  vcremote --help

• Para desativar o modo seguro e habilitar conexões simples baseadas em HTTP, digite:

  vcremote --secure false

  Quando utilizar esta opção, desmarque a caixa de verificação Seguro.

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

  vcremote --serverDir directory_path

  Substitua directory_path pelo local no Mac para colocar arquivos de log, compilações e certificados de servidor. Por padrão, esse local é /Users/<username>/vcremote. As compilações, neste local, são organizadas por número de compilação.

• Para usar um processo em segundo plano para capturar stdout e stderr para um arquivo chamado server.log, digite:

  vcremote > server.log 2>&1 &

  O server.log arquivo pode ajudar a solucionar problemas de compilação.

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

  vcremote --config config_file_path

  Substitua config_file_path pelo caminho para um arquivo de configuração no formato JSON. As opções de inicialização e seus valores não devem incluir hífenes.

Solucionar problemas do agente remoto

Depurar num dispositivo iOS

Se a depuração em um dispositivo iOS não funcionar, pode haver problemas com a ferramenta ideviceinstaller, que é usada para se comunicar com um dispositivo iOS. Esta ferramenta é normalmente instalada a partir do Homebrew durante a instalação do vcremote. Siga as próximas etapas como uma solução alternativa:

Abra o aplicativo Terminal e atualize ideviceinstaller e suas dependências executando os seguintes comandos na ordem:

1. Certifique-se de que o Homebrew está atualizado

   brew update

2. Desinstale libimobiledevice e usbmuxd

   brew uninstall --ignore-dependencies libimobiledevice

   brew uninstall --ignore-dependencies usbmuxd

3. Instale a versão mais recente do libimobiledevice e usbmuxd

   brew install --HEAD usbmuxd

   brew unlink usbmuxd

   brew link usbmuxd

   brew install --HEAD libimobiledevice

4. Desinstalar e reinstalar ideviceinstaller

   brew uninstall ideviceinstaller

   brew install ideviceinstaller

Verifique se ideviceinstaller é possível se comunicar com o dispositivo tentando listar os aplicativos instalados no dispositivo:

ideviceinstaller -l

Se ideviceinstaller comunicar um erro a indicar que não consegue aceder à pasta /var/db/lockdown, altere o privilégio na pasta utilizando este comando:

sudo chmod 777 /var/db/lockdown

Em seguida, verifique novamente se ideviceinstaller é possível se comunicar com o dispositivo.

Ver também

• Instale o desenvolvimento móvel multiplataforma com C++