Aracılığıyla paylaş


iOS geliştirmesi için Mac ile eşleştirme

.NET Çok Platformlu Uygulama Kullanıcı Arabirimi (.NET MAUI) kullanarak yerel iOS uygulamaları oluşturmak için Apple'ın yalnızca Mac üzerinde çalışan derleme araçlarına erişim gerekir. Bu nedenle, Visual Studio 2022'nin .NET MAUI iOS uygulamaları oluşturmak için ağdan erişilebilir bir Mac'e bağlanması gerekir.

Visual Studio 2022'nin Mac ile Eşleştir özelliği, Windows üzerinde verimli çalışabilmeniz için Mac derleme konaklarını bulur, bu konaklara bağlanır, kimlik doğrulaması yapar ve bunları hatırlar.

Mac ile Eşleştir, aşağıdaki yazılım geliştirme iş akışını etkinleştirir:

  • Visual Studio 2022'de .NET MAUI iOS kodu yazabilirsiniz.
  • Visual Studio 2022, Mac derleme konağına bir ağ bağlantısı açar ve iOS uygulamasını derlemek ve imzalamak için bu makinedeki derleme araçlarını kullanır.
  • Mac'te ayrı bir uygulama çalıştırmaya gerek yoktur. Visual Studio 2022, Mac derlemelerini SSH üzerinden güvenli bir şekilde çağırır.
  • Visual Studio 2022, değişiklikler gerçekleşir gerçekleşmez bildirilir. Örneğin, bir iOS cihazı Mac'e takılı olduğunda veya ağda kullanılabilir olduğunda, iOS Araç Çubuğu anında güncelleştirilir.
  • Birden çok Visual Studio 2022 örneği Mac'e aynı anda bağlanabilir.
  • iOS uygulamaları oluşturmak için Windows komut satırını kullanmak mümkündür.

Not

Bu makaledeki yönergeleri takip etmeden önce, Mac'te Xcode'u yükleyin. Ardından, ek bileşenler ekleyebilmesi için yüklemeden sonra Xcode'ı el ile açın. Mono'ya da yüklemeniz gerekir. Buna ek olarak, Apple silikonlu bir Mac bilgisayarınız varsa lütfen Rosetta'nın yüklü olduğundan emin olun.

Visual Studio 2022, Mac derleme ana bilgisayarını otomatik olarak yapılandıracaktır. Ancak yine de Xcode'u yükleyip çalıştırmanız ve Mono yüklemeniz gerekir.

Mac'te uzaktan oturum açmayı etkinleştirme

Mac derleme ana bilgisayarını ayarlamak için önce uzaktan oturum açmayı etkinleştirin:

  1. Mac'te Sistem Tercihleri'ni açın ve Paylaşım bölmesine gidin.

  2. Gelişmiş listesinde Uzaktan Oturum Açma etkinleştirin.

    uzaktan oturum açmayı etkinleştir ayarını .

  3. Daha fazla ayar yapılandırmak için Uzaktan Oturum Açma ayarının yanındaki i tıklayın:

    • Etkinleştiruzak kullanıcılar için tam disk erişimine izin ver.

    • Uzaktan oturum açmanın tüm kullanıcılar için erişime izin verecek şekilde yapılandırıldığından veya Mac kullanıcı adınızın veya grubunuzun izin verilen kullanıcılar listesine eklendiğinden emin olun.

    Tam disk erişimine izin verin ve tüm kullanıcı ayarları için erişime izin verin.

  4. İstenirse macOS güvenlik duvarını yapılandırın. macOS güvenlik duvarını gelen bağlantıları engelleyecek şekilde ayarladıysanız, gelen bağlantıları almaya izin mono-sgen vermeniz gerekebilir. İstenirse sizden bir uyarı görüntülenir.

  5. Windows makinesiyle aynı ağdaysa, Mac artık Visual Studio 2022 tarafından bulunabilir olmalıdır. Mac hala bulunamazsa mac'i el ile eklemeyi deneyin.

Visual Studio 2022'den Mac'e bağlanma

Mac'te uzaktan oturum açmayı etkinleştirdikten sonra Visual Studio 2022'yi Mac'e bağlayın:

  1. Visual Studio 2022'de mevcut bir .NET MAUI projesini açın veya yeni bir proje oluşturun.

  2. Mac ile Eşleştir düğmesi iOS araç çubuğuyla Mac'e Eşleştir iletişim kutusunu açın:

    Mac ile Eşleştir düğmesinin vurgulandığı iOS araç çubuğu.

    Alternatif olarak, Araçlar > iOS > Mac'e Eşle'yi seçin.

    Mac'e Eşleştir iletişim kutusunda, önceden bağlı olan ve şu anda kullanılabilir durumdaki tüm Mac derleme konaklarının listesi görüntülenir:

    Mac ile Eşleştir iletişim kutusu.

  3. Listeden bir Mac seçin ve Bağlan'ı seçin.

  4. Kullanıcı adınızı ve parolanızı girin. Belirli bir Mac'e ilk kez bağlandığınızda, bu makine için kullanıcı adınızı ve parolanızı girmeniz istenir:

    Mac için bir kullanıcı adı ve parola girme.

    İpucu

    Oturum açarken sistem kullanıcı adınızı kullanın.

    Mac ile Eşleştir, Mac'e yeni bir SSH bağlantısı oluşturmak için bu kimlik bilgilerini kullanır. Başarılı olursa Mac'te authorized_keys dosyasına bir anahtar eklenir. Aynı Mac'e yapılan sonraki bağlantılar otomatik olarak oturum açar.

  5. Mac ile eşleştir, Mac'i otomatik olarak yapılandırıyor. Visual Studio 2022, bağlı bir Mac derleme konağına önkoşulları gerektiği gibi yükler veya güncelleştirir. Ancak Xcode yine de el ile yüklenmelidir.

  6. Bağlantı durumu simgesini inceleyin. Visual Studio 2022 bir Mac'e bağlandığında, Mac'in Mac ile Eşleştir iletişim kutusundaki öğesi şu anda bağlı olduğunu belirten bir simge görüntüler:

    Bağlı bir Mac.

    Aynı anda yalnızca bir bağlı Mac olabilir.

    İpucu

    Mac'e Eşleştir listesinde herhangi bir Mac'e sağ tıklanması, Bağlanabilmenizi sağlayan bir bağlam menüsü getirir..., Bu Mac'i unutun veya Bağlantıyı Kesin:

    Mac ile Eşleştir bağlam menüleri.

    Bu Mac'i unut'u seçerseniz, seçili Mac için kimlik bilgileriniz unutulur. Bu Mac'e yeniden bağlanmak için kullanıcı adınızı ve parolanızı yeniden girmeniz gerekir.

Mac derleme konağıyla başarıyla eşleştirdiyseniz Visual Studio 2022'de .NET MAUI iOS uygulamaları oluşturmaya hazırsınız demektir. Daha fazla bilgi için bkz . İlk uygulamanızı oluşturma.

Mac eşleştiremediyseniz mac'i el ile eklemeyi deneyin.

Mac'i el ile ekleme

Mac ile Eşleştir iletişim kutusunda belirli bir Mac'in listelendiğini görmüyorsanız el ile ekleyin:

  1. Mac'inizin IP adresini bulmak için Mac bilgisayarınızda Sistem Tercihleri > Paylaşımı > Uzaktan Oturum Açma'nı açın:

    Sistem Tercihleri > Paylaşımı'nda Mac'in IP adresi.

    Alternatif olarak, komut satırını kullanın. Terminal'de aşağıdaki komutu çalıştırın:

    ipconfig getifaddr en0
    

    Ağ yapılandırmanıza bağlı olarak, örneğin en0 veya en1dışında en2bir arabirim adı kullanmanız gerekebilir.

  2. Visual Studio 2022'nin Mac ile Eşleştir iletişim kutusunda Mac Ekle...'yi seçin:

    Mac ile Eşleştir iletişim kutusundaki Mac Ekle düğmesi.

  3. Mac'in IP adresini girin ve Ekle'yi seçin:

    Mac'in IP adresini girme.

  4. Mac için kullanıcı adınızı ve parolanızı girin:

    Bir kullanıcı adı ve parola girin.

    İpucu

    Oturum açarken sistem kullanıcı adınızı kullanın.

  5. Visual Studio 2022'yi SSH üzerinden Mac'e bağlamak ve bilinen makineler listesine eklemek için Oturum Aç'ı seçin.

Bilinen Mac'lere otomatik bağlantıyı etkinleştirme

Varsayılan olarak, Visual Studio başlatıldığında önceden eşleştirilmiş Mac'lere bağlantı kurulmayacak. Ancak, Araçlar Seçenekleri Xamarin > iOS Ayarları'na >> gidip Bilinen Mac'lere otomatik bağlantıyı etkinleştir seçeneğinin işaretlendiğinden emin olarak Visual Studio'da bilinen Mac'lere otomatik bağlantı etkinleştirilebilir:

Visual Studio'da bilinen Mac'lere otomatik bağlantıyı etkinleştirin.

Visual Studio yeniden başlatıldıktan sonra, her başlatmada bilinen Mac'lere otomatik olarak bağlanır.

Otomatik Mac sağlama

Mac ile Eşleştirme, .NET MAUI iOS uygulamaları oluşturmak için gerekli yazılımı otomatik olarak bir Mac sağlar. Buna .NET ve Xcode ile ilgili çeşitli araçlar dahildir (ancak Xcode'un kendisini içermez).

Önemli

  • Mac ile eşleştir, Xcode'u yükleyemez. Mac derleme konağına el ile yüklemeniz gerekir. .NET MAUI iOS geliştirmesi için gereklidir.
  • Otomatik Mac sağlama için Mac'te uzaktan oturum açma özelliğinin etkinleştirilmesi ve Mac'in Windows makinesi için ağdan erişilebilir olması gerekir.
  • Otomatik Mac sağlama, .NET'i yüklemek için Mac'te yeterli boş alan gerektirir.

Buna ek olarak, Mac'e Eşleştir, Visual Studio 2022 bağlandığında Mac'e gerekli yazılım yüklemelerini ve güncelleştirmelerini gerçekleştirir.

Xcode araçları ve lisansı

Mac ile eşleştir ayrıca Xcode'un yüklenip yüklenmediğini ve lisansının kabul edilip edilmediğini de denetler. Mac'e Eşleştir özelliği Xcode'u yüklemese de lisans kabulü ister.

Ayrıca, Mac ile Eşleştir özelliği Xcode ile dağıtılan çeşitli paketleri yükler veya güncelleştirir. Bu paketlerin yüklenmesi hızlı bir şekilde ve bir istem olmadan gerçekleşir.

Otomatik Mac sağlama sorunlarını giderme

Otomatik Mac sağlamayı kullanırken herhangi bir sorunla karşılaşırsanız, %LOCALAPPDATA%\Xamarin\Logs\17.0 içinde depolanan Visual Studio 2022 IDE günlüklerine göz atın. Bu günlükler, hatayı daha iyi tanılamanıza veya destek almanıza yardımcı olacak hata iletileri içerebilir.

Windows komut satırından iOS uygulamaları oluşturma

Mac ile Eşleştir komutu, komut satırından .NET MAUI uygulamaları derlemeyi destekler. .NET MAUI iOS uygulamanızın kaynağını barındıran klasöre gidin ve aşağıdaki komutu çalıştırın:

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/

Yukarıdaki örnekte geçirilen dotnet parametreler şunlardır:

  • ServerAddress – Mac derleme ana bilgisayarının IP adresi.
  • ServerUser – Mac derleme ana bilgisayarında oturum açarken kullanılacak kullanıcı adı. Tam adınız yerine sistem kullanıcı adınızı kullanın.
  • ServerPassword – Mac derleme ana bilgisayarında oturum açarken kullanılacak parola.
  • _DotNetRootRemoteDirectory - Mac derleme konağındaki .NET SDK'sını içeren klasör.

Mac ile Eşleştir, Visual Studio 2022 veya komut satırından bir Mac derleme konağından ilk kez oturum açtığında, SSH anahtarlarını ayarlar. Bu anahtarlarla, gelecekteki oturum açma işlemleri için kullanıcı adı veya parola gerekmez. Yeni oluşturulan anahtarlar %LOCALAPPDATA%\Xamarin\MonoTouch konumunda depolanır.

ServerPassword Parametre bir komut satırı derleme çağrısından atlanırsa, Mac ile Eşleştir, kaydedilen SSH anahtarlarını kullanarak Mac derleme konağından oturum açmayı dener.

Windows komut satırından iOS uygulamaları oluşturma hakkında daha fazla bilgi için bkz . Komut satırını kullanarak iOS uygulaması yayımlama.