Parkoppla till Mac för iOS-utveckling

Att skapa interna iOS-program med hjälp av .NET Multi-platform App UI (.NET MAUI) kräver åtkomst till Apples byggverktyg, som endast körs på en Mac. Därför måste Visual Studio 2022 ansluta till en nätverkstillgänglig Mac för att skapa .NET MAUI iOS-appar.

Funktionen Par till Mac i Visual Studio 2022 identifierar, ansluter till, autentiserar med och kommer ihåg Mac-byggvärdar så att du kan arbeta produktivt i Windows.

Par till Mac aktiverar följande arbetsflöde för programvaruutveckling:

• Du kan skriva .NET MAUI iOS-kod i Visual Studio 2022.
• Visual Studio 2022 öppnar en nätverksanslutning till en Mac-byggvärd och använder byggverktygen på datorn för att kompilera och signera iOS-appen.
• Du behöver inte köra ett separat program på Mac – Visual Studio 2022 anropar Mac-versioner på ett säkert sätt via SSH.
• Visual Studio 2022 meddelas om ändringar så snart de inträffar. När till exempel en iOS-enhet är ansluten till Mac-datorn eller blir tillgänglig i nätverket, uppdateras iOS-verktygsfältet omedelbart.
• Flera instanser av Visual Studio 2022 kan ansluta till Mac samtidigt.
• Det är möjligt att använda Windows-kommandoraden för att skapa iOS-appar.

Obs

Innan du följer anvisningarna i den här artikeln installera Xcodepå en Mac. Öppna sedan Xcode manuellt efter installationen så att det kan lägga till ytterligare komponenter. Du bör också installera Mono. Om du dessutom har en Mac-dator med Apple Silicon, kontrollera att Rosetta är installerat.

Visual Studio 2022 konfigurerar automatiskt Mac-byggvärden. Du måste dock fortfarande installera och köra Xcode och installera Mono.

Aktivera fjärrinloggning på Mac

För att konfigurera Mac-byggvärden aktiverar du först fjärrinloggning:

1. På Mac öppnar du Systeminställningar och går till fönstret Delning.

2. Aktivera fjärrinloggning i listan Avancerat.

   

3. Klicka på jag bredvid inställningen Fjärrinloggning för att konfigurera fler inställningar:

   • Aktivera Tillåt fullständig diskåtkomst för fjärranvändare.

   • Kontrollera att fjärrinloggning har konfigurerats för att tillåta åtkomst för Alla användareeller att ditt Mac-användarnamn eller -grupp ingår i listan över tillåtna användare.

   

4. Konfigurera macOS-brandväggen om du uppmanas till det. Om du har konfigurerat macOS-brandväggen för att blockera inkommande anslutningar kan du behöva tillåta att mono-sgen tar emot inkommande anslutningar. Ett meddelande visas för att uppmana dig i så fall.

5. Om den finns i samma nätverk som Windows-datorn bör Mac nu kunna identifieras av Visual Studio 2022. Om Mac fortfarande inte kan identifieras kan du prova lägga till en Mac-manuellt.

Ansluta till Mac från Visual Studio 2022

När du har aktiverat fjärrinloggning på Mac ansluter du Visual Studio 2022 till Mac:

1. I Visual Studio 2022 öppnar du ett befintligt .NET MAUI-projekt eller skapar ett nytt.

2. Öppna dialogrutan Par till Mac med knappen Par till Mac i iOS-verktygsfältet:

   

   Du kan också välja Verktyg > iOS > Para med Mac.

   Dialogrutan Par till Mac visar en lista över alla tidigare anslutna och för närvarande tillgängliga Mac-byggvärdar:

   

3. Välj en Mac i listan och välj Anslut.

4. Ange ditt användarnamn och lösenord. Första gången du ansluter till en viss Mac uppmanas du att ange ditt användarnamn och lösenord för den datorn:

   

   Tips

   När du loggar in använder du ditt systemanvändarnamn.

   Anslut till Mac använder dessa autentiseringsuppgifter för att etablera en ny SSH-anslutning till Mac. Om det lyckas läggs en nyckel till i authorized_keys-filen på Mac-datorn. Efterföljande anslutningar till samma Mac loggas in automatiskt.

5. Automatisk parkoppling konfigurerar Mac-datorn. Visual Studio 2022 installerar eller uppdaterar förkrav på en ansluten Mac-byggdator efter behov. Xcode måste dock fortfarande installeras manuellt.

6. Granska anslutningsstatusikonen. När Visual Studio 2022 är anslutet till en Mac visas en ikon i dialogrutan Pair to Mac bredvid Mac-posten, vilket indikerar att anslutningen är upprättad.

   

   Det kan bara finnas en ansluten Mac i taget.

   Tips

   Om du högerklickar på en Mac i listan Para till Mac visas en snabbmeny som gör att du kan Anslut..., Glöm den här Maceller Koppla från Mac:

   

   Om du väljer Glöm den här Mac-kommer dina autentiseringsuppgifter för den valda Mac att glömmas bort. Om du vill återansluta till mac-datorn måste du ange ditt användarnamn och lösenord igen.

Om du har parkopplat till en Mac-byggvärd är du redo att skapa .NET MAUI iOS-appar i Visual Studio 2022. Mer information finns i Skapa din första app.

Om du inte har kunnat parkoppla en Mac kan du prova lägga till en Mac-manuellt.

Lägga till en Mac manuellt

Om du inte ser en specifik Mac i dialogrutan Pair to Mac lägger du till den manuellt:

1. Öppna Systeminställningar > Delning > fjärrinloggning på mac-datorn för att hitta mac-datorns IP-adress:

   

   Du kan också använda kommandoraden. I Terminalutfärdar du följande kommando:

   ipconfig getifaddr en0
   

   Beroende på nätverkskonfigurationen kan du behöva använda ett annat gränssnittsnamn än en0, till exempel en1 eller en2.

2. Välj Lägg till Mac...i dialogrutan Para till Mac i Visual Studio 2022:

   

3. Ange Mac-ip-adressen och välj Lägg till:

   

4. Ange ditt användarnamn och lösenord för Mac:

   

   Tips

   När du loggar in använder du ditt systemanvändarnamn.

5. Välj Inloggning för att ansluta Visual Studio 2022 till Mac via SSH och lägga till det i listan över kända datorer.

Aktivera automatisk anslutning till kända Mac-datorer

Som standard upprättas inte en anslutning till tidigare kopplade Mac-datorer när Visual Studio startar. Automatisk anslutning till kända Mac-datorer kan aktiveras i Visual Studio genom att navigera till Verktyg > Alternativ > Xamarin > iOS-inställningar och säkerställa att Aktivera automatisk anslutning till kända Mac är markerat.

När du har startat om Visual Studio ansluter den automatiskt till kända Mac-datorer vid varje start.

Automatisk Mac-etablering

Parkoppla till Mac installerar automatiskt en Mac med den programvara som krävs för att utveckla .NET MAUI iOS-appar. Detta omfattar .NET och olika Xcode-relaterade verktyg (men inte själva Xcode).

Viktig

• Pair to Mac kan inte installera Xcode. Du måste installera den manuellt på Mac Build-värden. Det krävs för .NET MAUI iOS-utveckling.
• Automatisk Mac-etablering kräver att fjärrinloggning är aktiverat på Mac och att Mac-datorn måste vara nätverkstillgänglig för Windows-datorn.
• Automatisk Mac-etablering kräver tillräckligt med ledigt utrymme på Mac för att installera .NET.

Dessutom utför Par-till-Mac nödvändiga programvaruinstallationer och uppdateringar till Mac när Visual Studio 2022 ansluter till den.

Xcode-verktyg och -licens

Par till Mac kontrollerar också om Xcode har installerats och dess licens har godkänts. Även om Par till Mac inte installerar Xcode uppmanas det att godkänna licensen.

Dessutom installerar eller uppdaterar Par till Mac olika paket som distribueras med Xcode. Installationen av dessa paket sker snabbt och utan uppmaning.

Felsökning av automatisk Mac-tillhandahållande

Om du får problem med att använda automatisk Mac-etablering kan du ta en titt på Visual Studio 2022 IDE-loggarna som lagras i %LOCALAPPDATA%\Xamarin\Logs\17.0. Dessa loggar kan innehålla felmeddelanden som hjälper dig att bättre diagnostisera felet eller få support.

Skapa iOS-appar från Windows-kommandoraden

Paira med Mac har stöd för att skapa .NET MAUI-appar från kommandoraden. Gå till mappen som innehåller källan till .NET MAUI iOS-appen och kör följande kommando:

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/

Parametrarna som skickas till dotnet i exemplet ovan är:

• ServerAddress – IP-adressen för Mac-byggvärden.
• ServerUser – användarnamnet som ska användas när du loggar in på Mac Build-värden. Använd ditt systemanvändarnamn i stället för ditt fullständiga namn.
• ServerPassword – lösenordet som ska användas när du loggar in på Mac build-värden.
• _DotNetRootRemoteDirectory – mappen på Mac Build-värden som innehåller .NET SDK.

Första gången Pair to Mac loggar in på en Mac-byggvärd från antingen Visual Studio 2022 eller kommandoraden ställer den in SSH-nycklar. Med dessa nycklar kräver framtida inloggningar inget användarnamn eller lösenord. Nyligen skapade nycklar lagras i %LOCALAPPDATA%\Xamarin\MonoTouch.

Om parametern ServerPassword utelämnas vid ett kommandoradsbyggkommando försöker Pair to Mac logga in på Mac-byggvärden med hjälp av de sparade SSH-nycklarna.

Mer information om hur du skapar iOS-appar från Windows-kommandoraden finns i Publicera en iOS-app med hjälp av kommandoraden.