Koppelen aan Mac voor iOS-ontwikkeling

Voor het bouwen van systeemeigen iOS-toepassingen met behulp van .NET Multi-Platform App UI (.NET MAUI) is toegang vereist tot de buildhulpprogramma's van Apple, die alleen worden uitgevoerd op een Mac. Daarom moet Visual Studio 2022 verbinding maken met een mac die toegankelijk is voor het netwerk om .NET MAUI iOS-apps te bouwen.

De functie Pair to Mac van Visual Studio 2022 detecteert, maakt verbinding met, verifieert met en onthoudt Mac-buildhosts, zodat u productief kunt werken in Windows.

Koppelen aan Mac maakt de volgende werkstroom voor softwareontwikkeling mogelijk:

• U kunt .NET MAUI iOS-code schrijven in Visual Studio 2022.
• Visual Studio 2022 opent een netwerkverbinding met een Mac-buildhost en gebruikt de buildhulpprogramma's op die computer om de iOS-app te compileren en te ondertekenen.
• U hoeft geen afzonderlijke toepassing op de Mac uit te voeren. Visual Studio 2022 roept Mac-builds veilig aan via SSH.
• Visual Studio 2022 wordt op de hoogte gesteld van wijzigingen zodra deze plaatsvinden. Wanneer een iOS-apparaat bijvoorbeeld is aangesloten op de Mac of beschikbaar is in het netwerk, wordt de iOS-werkbalk direct bijgewerkt.
• Meerdere exemplaren van Visual Studio 2022 kunnen tegelijkertijd verbinding maken met de Mac.
• Het is mogelijk om de Windows-opdrachtregel te gebruiken om iOS-apps te bouwen.

Externe aanmelding op de Mac inschakelen

Als u de Mac-buildhost wilt instellen, moet u eerst externe aanmelding inschakelen:

1. Open op de Mac Systeemvoorkeuren en ga naar het deelvenster Delen.

2. Schakel Externe aanmelding in de Geavanceerde lijst in.

   

3. Klik op de i naast de instelling voor Externe Aanmelding voor het configureren van meer instellingen.

   • Schakel Volledige schijftoegang toestaan voor externe gebruikers in.

   • Zorg ervoor dat externe aanmelding is geconfigureerd om toegang toe te staan voor Alle gebruikers, of dat uw Mac-gebruikersnaam of -groep is opgenomen in de lijst met toegestane gebruikers.

   

4. Als u hierom wordt gevraagd, configureert u de macOS-firewall. Als u de macOS-firewall hebt ingesteld om binnenkomende verbindingen te blokkeren, moet u mogelijk toestaan dat mono-sgen binnenkomende verbindingen ontvangt. Er verschijnt een waarschuwing die u vraagt om verder te gaan indien dat het geval is.

5. Als het zich in hetzelfde netwerk bevindt als de Windows-computer, moet de Mac nu worden gedetecteerd door Visual Studio 2022. Als de Mac nog steeds niet detecteerbaar is, probeert u handmatig een Mac-toe te voegen.

Verbinding maken met de Mac vanuit Visual Studio 2022

Nadat u externe aanmelding op de Mac hebt ingeschakeld, verbindt u Visual Studio 2022 met de Mac:

1. Open in Visual Studio 2022 een bestaand .NET MAUI-project of maak een nieuw project.

2. Open het dialoogvenster Koppelen aan Mac met de knop Koppelen aan Mac in de iOS-werkbalk:

   

   Selecteer als alternatief Hulpprogramma's > iOS > Koppelen aan Mac.

   In het dialoogvenster Koppelen aan Mac wordt een lijst weergegeven met alle eerder verbonden en momenteel beschikbare Mac-buildhosts:

   

3. Selecteer een Mac in de lijst en selecteer Verbinding maken.

4. Voer uw gebruikersnaam en wachtwoord in. De eerste keer dat u verbinding maakt met een bepaalde Mac, wordt u gevraagd uw gebruikersnaam en wachtwoord voor die computer in te voeren:

   

   Fooi

   Wanneer u zich aanmeldt, gebruikt u de gebruikersnaam van uw systeem.

   Koppelen met Mac gebruikt deze inloggegevens om een nieuwe SSH-verbinding met de Mac te maken. Als dit lukt, wordt er een sleutel toegevoegd aan het authorized_keys-bestand op de Mac. Volgende verbindingen met dezelfde Mac worden automatisch aangemeld.

5. Met koppelen aan Mac wordt de Mac automatisch geconfigureerd. Visual Studio 2022 installeert of werkt indien nodig vereisten voor een verbonden Mac-buildhost bij. Xcode moet echter nog steeds handmatig worden geïnstalleerd.

6. Controleer het verbindingsstatuspictogram. Wanneer Visual Studio 2022 is verbonden met een Mac, wordt in dat Mac-item in het dialoogvenster Koppelen aan Mac een pictogram weergegeven dat aangeeft dat het momenteel is verbonden:

   

   Er kan slechts één verbonden Mac tegelijk zijn.

   Fooi

   Als u met de rechtermuisknop op een Mac klikt in de lijst Koppelen aan Mac, wordt een snelmenu geopend waarmee u verbinding kunt maken ..., Vergeet deze Mac-of Verbinding verbreken:

   

   Als u Vergeet deze Mackiest, worden uw inloggegevens voor de geselecteerde Mac vergeten. Als u opnieuw verbinding wilt maken met die Mac, moet u uw gebruikersnaam en wachtwoord opnieuw invoeren.

Als u verbinding hebt gemaakt met een Mac-buildhost, kunt u .NET MAUI iOS-apps bouwen in Visual Studio 2022. Zie Uw eerste app bouwenvoor meer informatie.

Als u een Mac niet heeft kunnen koppelen, probeer dan een Mac-handmatig toe te voegen.

Handmatig een Mac toevoegen

Als er geen specifieke Mac wordt weergegeven in het dialoogvenster Koppelen aan Mac, voegt u deze handmatig toe:

1. Open Systeemvoorkeuren > Delen > Externe Aanmelding op uw Mac om het IP-adres van uw Mac te vinden:

   

   U kunt ook de opdrachtregel gebruiken. Voer in Terminalde volgende opdracht uit:

   ipconfig getifaddr en0
   

   Afhankelijk van uw netwerkconfiguratie moet u mogelijk een andere interfacenaam dan en0gebruiken, bijvoorbeeld en1 of en2.

2. In het dialoogvenster Koppelen met Mac van Visual Studio 2022, selecteer Mac toevoegen...:

   

3. Voer het IP-adres van de Mac in en selecteer Toevoegen:

   

4. Voer uw gebruikersnaam en wachtwoord voor de Mac in:

   

   Tip

   Wanneer u zich aanmeldt, gebruikt u de gebruikersnaam van uw systeem.

5. Selecteer Aanmelden om Visual Studio 2022 via SSH te verbinden met de Mac en toe te voegen aan de lijst met bekende machines.

Automatische verbinding met bekende Macs inschakelen

Standaard wordt er geen verbinding met eerder gekoppelde Macs tot stand gebracht wanneer Visual Studio wordt gestart. Automatische verbinding met bekende Macs kan echter worden ingeschakeld in Visual Studio door te navigeren naar Tools > Options > Xamarin > iOS Settings en ervoor te zorgen dat Automatische verbinding met bekende Macs is ingeschakeld:

Nadat Visual Studio opnieuw is opgestart, wordt er automatisch verbinding gemaakt met bekende Macs bij elke lancering.

Automatische Mac-inrichting

Koppelen aan Mac richt automatisch een Mac in met de software die nodig is voor het bouwen van .NET MAUI iOS-apps. Dit omvat .NET en verschillende Xcode-gerelateerde hulpprogramma's (maar niet Xcode zelf).

Bovendien voert Pair to Mac vereiste software-installaties en updates voor de Mac uit, wanneer Visual Studio 2022 er verbinding mee maakt.

Xcode-hulpprogramma's en -licentie

Bij het koppelen aan een Mac wordt ook gecontroleerd of Xcode is geïnstalleerd en of de licentie is geaccepteerd. Hoewel Koppelen aan Mac Xcode niet installeert, wordt er gevraagd om licentieacceptatie.

Bovendien installeert of werkt Pair to Mac verschillende pakketten die zijn gedistribueerd met Xcode, bij. De installatie van deze pakketten vindt snel en zonder prompt plaats.

problemen met automatische Mac-inrichting oplossen

Als u problemen ondervindt bij het gebruik van automatische Mac-inrichting, bekijkt u de IDE-logboeken van Visual Studio 2022, opgeslagen in %LOCALAPPDATA%\Xamarin\Logs\17.0. Deze logboeken bevatten mogelijk foutberichten om u te helpen de fout beter te diagnosticeren of ondersteuning te krijgen.

iOS-apps bouwen vanaf de Windows-opdrachtregel

Koppelen aan Mac biedt ondersteuning voor het bouwen van .NET MAUI-apps vanaf de opdrachtregel. Navigeer naar de map die de bron van uw .NET MAUI iOS-app bevat en voer de volgende opdracht uit:

dotnet build -f net8.0-ios -p:ServerAddress={macOS build host IP address} -p:ServerUser={macOS username} -p:ServerPassword={macOS password} -p:TcpPort=58181 -p:_DotNetRootRemoteDirectory=/Users/{macOS username}/Library/Caches/Xamarin/XMA/SDKs/dotnet/

De parameters die worden doorgegeven aan dotnet in het bovenstaande voorbeeld zijn:

• ServerAddress: het IP-adres van de Mac-buildhost.
• ServerUser: de gebruikersnaam die moet worden gebruikt bij het aanmelden bij de Mac-buildhost. Gebruik de gebruikersnaam van uw systeem in plaats van uw volledige naam.
• ServerPassword: het wachtwoord dat moet worden gebruikt bij het aanmelden bij de Mac-buildhost.
• _DotNetRootRemoteDirectory: de map op de Mac-buildhost die de .NET SDK bevat.

De eerste keer dat Pair to Mac verbinding maakt met een Mac-buildhost via Visual Studio 2022 of de command-line, worden SSH-sleutels ingesteld. Met deze sleutels hebben toekomstige aanmeldingen geen gebruikersnaam of wachtwoord nodig. Nieuw gemaakte sleutels worden opgeslagen in %LOCALAPPDATA%\Xamarin\MonoTouch.

Als de parameter ServerPassword wordt weggelaten uit een aanroep van een opdrachtregel-build, probeert Pair to Mac zich aan te melden bij de Mac-buildhost met behulp van de opgeslagen SSH-sleutels.

Zie Een iOS-app publiceren met behulp van de opdrachtregelvoor meer informatie over het bouwen van iOS-apps vanaf de Windows-opdrachtregel.