Implantação sem fio para aplicativos iOS .NET MAUI

Em vez de ter que usar um cabo USB para conectar um dispositivo iOS ao Mac para implantar e depurar um aplicativo .NET Multi-platform App UI (.NET MAUI), o Visual Studio e o Visual Studio para Mac podem implantar aplicativos iOS .NET MAUI em dispositivos sem fio e depurá-los sem fio. Para fazer isso, você deve emparelhar seu dispositivo iOS com o Xcode no Mac. Depois de emparelhado, o dispositivo pode ser selecionado na lista de destino do dispositivo no Visual Studio e no Visual Studio para Mac.

Importante

Os aplicativos iOS do .NET MAUI devem ter sido provisionados antes de poderem ser implantados em um dispositivo para teste e depuração. Para obter mais informações, consulte Provisionamento de dispositivos para iOS.

Emparelhar um dispositivo iOS

Execute as seguintes etapas para emparelhar um dispositivo iOS com o Xcode no Mac:

1. Certifique-se de que o dispositivo iOS está ligado à mesma rede sem fios que o Mac.

2. Ligue o dispositivo iOS ao Mac através de um cabo USB.

   Observação

   Na primeira vez que ligar um dispositivo iOS ao Mac, terá de tocar no botão Confiar na caixa de diálogo Confiar neste computador no dispositivo.

3. Abra o Xcode e clique em Dispositivos e simuladores de janela>. Na janela exibida, clique em Dispositivos.

4. Na janela Dispositivos e simuladores, na coluna esquerda, selecione seu dispositivo. Em seguida, na área de detalhes, marque a caixa de seleção Conectar via rede :

   

   O Xcode emparelha com o dispositivo iOS.

5. Na janela Dispositivos e simuladores, na coluna esquerda, um ícone de rede aparecerá ao lado de um dispositivo conectado emparelhado:

   

6. Desconecte o cabo USB e verifique se o dispositivo permanece emparelhado.

O Xcode manterá as configurações de emparelhamento, portanto, o dispositivo não precisará ser emparelhado novamente.

Desemparelhar um dispositivo iOS

Execute as seguintes etapas para desemparelhar um dispositivo iOS do Xcode no Mac:

1. Certifique-se de que o dispositivo iOS está ligado à mesma rede sem fios que o Mac.

2. Abra o Xcode e clique em Dispositivos e simuladores de janela>. Na janela exibida, clique em Dispositivos.

3. Na janela Dispositivos e simuladores, na coluna esquerda, selecione o dispositivo emparelhado. Em seguida, clique com o botão direito do mouse no dispositivo e selecione o item Desemparelhar dispositivo .

   

Implantar no dispositivo

Depois de emparelhar seu dispositivo sem fio com o Xcode, os aplicativos iOS .NET MAUI provisionados podem ser implantados sem fio no dispositivo.

Visual Studio

1. Certifique-se de que o dispositivo iOS está emparelhado sem fios com o anfitrião de compilação do Mac. Para obter mais informações, consulte Emparelhar um dispositivo iOS.

2. No Visual Studio, verifique se o IDE está emparelhado a um host Mac Build. Para obter mais informações, consulte Emparelhar com Mac para desenvolvimento iOS.

3. Na barra de ferramentas do Visual Studio, use o menu suspenso Destino de depuração para selecionar Dispositivos remotos do iOS e, em seguida, o dispositivo conectado ao host de compilação do Mac:

   

4. Na barra de ferramentas do Visual Studio, pressione o botão verde Iniciar para iniciar o aplicativo em seu dispositivo remoto:

   

Observação

Uma abordagem alternativa para implantar um aplicativo iOS .NET MAUI em um dispositivo é usar a reinicialização a quente. A reinicialização a quente permite implantar um aplicativo .NET MAUI em um dispositivo iOS local de 64 bits, a partir do Visual Studio, sem a necessidade de um host de compilação do Mac. Para obter mais informações, consulte Implantar um aplicativo iOS usando a reinicialização ativa.

Visual Studio para Mac

Observação

O Visual Studio para Mac está programado para ser desativado até 31 de agosto de 2024, de acordo com a Política de Ciclo de Vida Moderno da Microsoft. O Visual Studio para Mac 17.6 continuará a ter suporte até 31 de agosto de 2024, com atualizações de manutenção para problemas de segurança e plataformas atualizadas da Apple. Para obter mais informações, incluindo opções alternativas para desenvolver em um Mac, consulte O que está acontecendo com o Visual Studio para Mac?.

1. Certifique-se de que o dispositivo iOS está emparelhado sem fios com o anfitrião de compilação do Mac. Para obter mais informações, consulte Emparelhar um dispositivo iOS.

2. Na barra de ferramentas do Visual Studio para Mac, verifique se o destino de depuração está definido para o dispositivo iOS conectado:

   

3. Na barra de ferramentas do Visual Studio para Mac, pressione o botão Reproduzir para iniciar o aplicativo em seu dispositivo:

   

Solucionar problemas

• Certifique-se de que o dispositivo iOS está ligado à mesma rede que o Mac.
• Verifique se o dispositivo está provisionado. Para obter mais informações sobre provisionamento, consulte Provisionamento de dispositivo para iOS.
• Verifique se o Xcode pode ver o dispositivo:
  • No Xcode, escolha Dispositivos e simuladores de janela e, na janela > exibida, clique em Dispositivos. O dispositivo deve aparecer em Conectado.
• Execute ping no dispositivo:

  • Localize o endereço IP do dispositivo. No dispositivo, abra Definições, toque em Wi-Fi e, em seguida, toque no botão de informações junto à rede que está ativa.

  • Em um Mac, abra o Terminal e digite ping seguido do endereço IP do dispositivo. Desde que o Mac possa ver o dispositivo, você receberá uma saída semelhante a:

    PING 192.168.1.107 (192.168.1.107): 56 data bytes
    64 bytes from 192.168.1.107: icmp_seq=0 ttl=64 time=121.015 ms
    64 bytes from 192.168.1.107: icmp_seq=1 ttl=64 time=28.387 ms
    64 bytes from 192.168.1.107: icmp_seq=2 ttl=64 time=49.890 ms
    64 bytes from 192.168.1.107: icmp_seq=3 ttl=64 time=72.283 ms
    

    Se houver um erro, a saída será Request timeout for icmp_seq 0. Se não conseguir executar ping no dispositivo, o protocolo ICMP (Internet Control Message Protocol) está bloqueado ou existe outro problema de conectividade.

• Verifique se a porta 62078 está aberta.
• Conecte o dispositivo à rede usando um cabo Ethernet:
  • Use o adaptador de câmera Lightning para USB e um adaptador USB para Ethernet.
• Emparelhe novamente o dispositivo iOS:
  • Desemparelhe o dispositivo. Para obter mais informações, consulte Desemparelhar um dispositivo iOS.
  • Emparelhe o dispositivo iOS com o Xcode. Para obter mais informações, consulte Emparelhar um dispositivo iOS.