Párosítás Mac-hez iOS-fejlesztéshez

Natív iOS-alkalmazások létrehozása .NET többplatformos alkalmazás felhasználói felületével (.NET MAUI) az Apple buildelési eszközeihez szükséges, amelyek csak Mac gépen futnak. Emiatt a Visual Studio 2022-nek csatlakoznia kell egy hálózattal elérhető Mac géphez a .NET MAUI iOS-alkalmazások létrehozásához.

A Visual Studio 2022 Pár–Mac funkciója felderíti, csatlakozik, hitelesít, és emlékszik a Mac build gazdagépekre, hogy hatékonyan működjön a Windowson.

A Pair to Mac a következő szoftverfejlesztési munkafolyamatot teszi lehetővé:

• .NET MAUI iOS-kódot írhat a Visual Studio 2022-ben.
• A Visual Studio 2022 hálózati kapcsolatot nyit meg egy Mac buildszolgáltatóval, és a gépen található buildelési eszközökkel lefordítja és aláírja az iOS-alkalmazást.
• Nincs szükség külön alkalmazás futtatására a Mac gépen – A Visual Studio 2022 meghívja a Mac buildeket biztonságosan SSH-n keresztül.
• A Visual Studio 2022 azonnal értesítést kap a változásokról. Ha például egy iOS-eszköz csatlakoztatva van a Mac géphez, vagy elérhetővé válik a hálózaton, az iOS-eszköztár azonnal frissül.
• A Visual Studio 2022 több példánya is egyszerre tud csatlakozni a Mac géphez.
• A Windows parancssorával iOS-alkalmazásokat hozhat létre.

Távoli bejelentkezés engedélyezése Mac gépen

A Mac buildgazda beállításához először engedélyezze a távoli bejelentkezést:

1. A Mac gépen nyissa meg Rendszerbeállítások, és nyissa meg a Megosztás panelt.

2. Engedélyezze távoli bejelentkezési a Speciális listában.

   

3. További beállítások konfigurálásához kattintson a Távoli bejelentkezés beállítás melletti i:

   • Engedélyezze A távoli felhasználók teljes lemezhozzáférésének engedélyezése.

   • Győződjön meg arról, hogy a távoli bejelentkezés úgy van konfigurálva, hogy engedélyezze a hozzáférést Minden felhasználó, vagy hogy a Mac felhasználóneve vagy csoportja szerepel-e az engedélyezett felhasználók listájában.

   

4. Ha a rendszer kéri, konfigurálja a macOS-tűzfalat. Ha a macOS tűzfalat úgy állította be, hogy blokkolja a bejövő kapcsolatokat, előfordulhat, hogy engedélyeznie kell mono-sgen a bejövő kapcsolatok fogadását. Megjelenik egy riasztás, amely rákérdez, ha igen.

5. Ha ugyanazon a hálózaton van, mint a Windows-gép, akkor a Visual Studio 2022-nek most már fel kell derítenie a Macet. Ha a Mac továbbra sem észlelhető, próbálja meg manuálisan hozzáadni a Mac-et .

Csatlakozás Mac géphez a Visual Studio 2022-ből

Miután engedélyezte a távoli bejelentkezést a Mac gépen, csatlakoztassa a Visual Studio 2022-t a Machez:

1. A Visual Studio 2022-ben nyisson meg egy meglévő .NET MAUI-projektet, vagy hozzon létre egy újat.

2. Nyissa meg a Machez való párosítás párbeszédpanelt a Machez való párosítás gomb iOS eszköztárával.

   

   Másik lehetőségként válassza az Eszközök > iOS > Párosítás Mac-relehetőséget.

   A Pár–Mac párbeszédpanel megjeleníti az összes korábban csatlakoztatott és jelenleg elérhető Mac buildkiszolgáló listáját:

   

3. Jelöljön ki egy Macet a listában, és válassza a Csatlakozáslehetőséget.

4. Adja meg a felhasználónevet és a jelszót. Amikor először csatlakozik egy adott Mac géphez, a rendszer kérni fogja, hogy adja meg a gép felhasználónevét és jelszavát:

   

   Borravaló

   Bejelentkezéskor használja a rendszerbeli felhasználónevét.

   A Pair to Mac ezen hitelesítő adatokkal hoz létre új SSH-kapcsolatot a Mac géppel. Ha sikerül, a rendszer hozzáad egy kulcsot a Mac authorized_keys fájlhoz. Az ugyanahhoz a Machez kapcsolódó további kapcsolatok automatikusan bejelentkeznek.

5. A Pair to Mac automatikusan konfigurálja a Macet. A Visual Studio 2022 szükség esetén telepíti vagy frissíti az előfeltételeket egy csatlakoztatott Mac build gépen. Az Xcode-ot azonban továbbra is manuálisan kell telepíteni.

6. Vizsgálja meg a kapcsolat állapota ikont. Ha a Visual Studio 2022 egy Machez csatlakozik, a Mac elem a Párosítás Mac-kel párbeszédpanelen megmutat egy ikont, amely jelzi, hogy jelenleg csatlakoztatva van:

   

   Egyszerre csak egy csatlakoztatott Mac lehet.

   Tipp

   A Párosítani kívánt Mac listában a jobb gombbal kattintva megjelenik egy helyi menü, amellyel Csatlakozhat..., Elfelejtheti ezt a Macet, vagy Szétkapcsolhatja:

   

   Ha a Elfelejti ezt a Mac gépetopciót választja, a rendszer elfelejti a kiválasztott Mac géphez tartozó hitelesítő adatait. A Mac géphez való újracsatlakozáshoz újra meg kell adnia a felhasználónevét és a jelszavát.

Ha sikeresen párosított egy Mac buildszolgáltatóval, készen áll a .NET MAUI iOS-alkalmazások visual Studio 2022-ben való létrehozására. További információ: Az első alkalmazás létrehozása.

Ha még nem tudta párosítani a Macet, próbálja meg manuálisan hozzáadni egy Mac.

Mac manuális hozzáadása

Ha nem jelenik meg egy adott Mac a Pár–Mac párbeszédpanelen, adja hozzá manuálisan:

1. Nyissa meg a Rendszerbeállítások > Megosztás > Távoli bejelentkezés lehetőséget a Mac számítógépén a Mac IP-címének megkereséséhez:

   

   Alternatívaként használja a parancssort. Terminálesetén adja ki a következő parancsot:

   ipconfig getifaddr en0
   

   A hálózati konfigurációtól függően előfordulhat, hogy a en0kívül más adapternevet kell használnia, például en1 vagy en2.

2. A Visual Studio 2022 Párosítás Mac-kel párbeszédpaneljében válassza Mac Hozzáadása...:

   

3. Írja be a Mac IP-címét, és válassza ki a Hozzáadásopciót.

   

4. Adja meg a Mac felhasználónevét és jelszavát:

   

   Borravaló

   Bejelentkezéskor használja a rendszerfelhasználónevét.

5. Válassza Bejelentkezési lehetőséget a Visual Studio 2022 és a Mac SSH közötti csatlakoztatásához, és adja hozzá az ismert gépek listájához.

Az ismert Mac gépekkel való automatikus kapcsolat engedélyezése

Alapértelmezés szerint a Visual Studio indításakor nem jön létre kapcsolat a korábban párosított Mac gépekkel. Az ismert Mac gépekkel való automatikus kapcsolat azonban engedélyezhető a Visual Studióban az Eszközök > Beállítások > Xamarin > iOS-beállítások, valamint annak biztosításával, hogy Az ismert Mac gépekhez való automatikus kapcsolat engedélyezése jelölőnégyzet be legyen jelölve:

A Visual Studio újraindítása után minden indításkor automatikusan csatlakozik az ismert Macekhez.

Automatikus Mac-telepítés

A Pair to Mac automatikusan kiépít egy Macet a .NET MAUI iOS-alkalmazások létrehozásához szükséges szoftverrel. Ez magában foglalja a .NET-et és a különböző Xcode-tal kapcsolatos eszközöket (de magát az Xcode-ot nem).

A Párosítás Mac-kel funkció emellett elvégzi a szükséges szoftvertelepítéseket és frissítéseket a Mac gépen, amikor a Visual Studio 2022 csatlakozik hozzá.

Xcode-eszközök és licenc

A Pair to Mac azt is ellenőrzi, hogy az Xcode telepítve van-e, és hogy a licence elfogadott-e. Bár a Pair to Mac nem telepíti az Xcode-ot, a licenc elfogadását kéri.

Emellett a Mac-kel való párosítás az Xcode-dal terjesztett különféle csomagokat is telepít vagy frissít. Ezeknek a csomagoknak a telepítése gyorsan és kérés nélkül történik.

Automatikus Mac-kiépítés hibaelhárítása

Ha problémát tapasztal az automatikus Mac-kiépítés használatakor, tekintse meg a Visual Studio 2022 IDE naplóit, amelyeket a %LOCALAPPDATA%\Xamarin\Logs\17.0tárol. Ezek a naplók tartalmazhatnak hibaüzeneteket, amelyek segítenek a hiba jobb diagnosztizálásában vagy támogatásban.

iOS-alkalmazások létrehozása a Windows parancssorából

A .NET MAUI-alkalmazások parancssorból történő fejlesztéséhez használható a Mac-csatlakozó funkció. Lépjen a .NET MAUI iOS-alkalmazás forrását tartalmazó mappára, és hajtsa végre a következő parancsot:

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/

A fenti példában dotnet átadott paraméterek a következők:

• ServerAddress – a Mac build szerver IP-címe.
• ServerUser – a Mac build gazdagépére való bejelentkezéskor használandó felhasználónév. A teljes neve helyett használja a rendszerbeli felhasználónevét.
• ServerPassword – a Mac build gazdagépére való bejelentkezéskor használandó jelszó.
• _DotNetRootRemoteDirectory – a .NET SDK-t tartalmazó Mac buildgazda mappája.

Amikor a Pár–Mac első alkalommal jelentkezik be a Visual Studio 2022-ből vagy a parancssorból egy Mac buildszolgáltatóba, SSH-kulcsokat állít be. Ezekkel a kulcsokkal a jövőbeli bejelentkezések nem igényelnek felhasználónevet vagy jelszót. Az újonnan létrehozott kulcsok a %LOCALAPPDATA%\Xamarin\MonoTouchtárolódnak.

Ha a ServerPassword paraméter kihagyásra kerül egy parancssori buildhívás esetén, a Pair to Mac megpróbál a mentett SSH-kulcsokkal bejelentkezni a Mac buildkiszolgálóra.

Az iOS-alkalmazások Windows parancssorból való létrehozásával kapcsolatos további információkért lásd: iOS-alkalmazás közzététele a parancssorihasználatával.