.NET CLI ile iOS uygulaması oluşturma

Bu öğreticide, macOS üzerinde .NET Komut Satırı Arabirimi (CLI) kullanarak iOS üzerinde .NET Çok Platformlu Uygulama Kullanıcı Arabirimi (.NET MAUI) uygulaması oluşturmayı ve çalıştırmayı öğreneceksiniz:

1. .NET MAUI uygulamaları oluşturmak için en son .NET çalışma zamanı için yükleyiciyi indirip çalıştırmanız gerekir. Ayrıca kullanmakta olduğunuz .NET MAUI sürümünün gerektirdiği Xcode sürümünü indirip yüklemeniz gerekir. Daha fazla bilgi için bkz . Sürüm sürümleri.

2. Mac bilgisayarınızda Terminal'i açın ve en son .NET çalışma zamanının yüklü olup olmadığını denetleyin:

   dotnet --version
   

3. Terminal'de .NET MAUI'nin en son genel derlemesini yükleyin:

   sudo dotnet workload install maui --source https://api.nuget.org/v3/index.json
   

   Bu komut, gerekli platform SDK'ları da dahil olmak üzere .NET MAUI'nin en son yayımlanan sürümünü yükler.

4. Terminal'de .NET CLI kullanarak yeni bir .NET MAUI uygulaması oluşturun:

   dotnet new maui -n "MyMauiApp"
   

5. Terminal'de dizini MyMauiApp olarak değiştirin ve uygulamayı derleyip çalıştırın:

   cd MyMauiApp
   dotnet build -t:Run -f net8.0-ios
   

   dotnet build komutu projeyi bağımlılıkları geri yükler, uygulamayı derler ve varsayılan simülatörde başlatır.

6. Varsayılan simülatörde Bana birkaç kez tıklayın düğmesine basın ve düğme tıklama sayısı sayısının arttığını gözlemleyin.

   

Xcode'un belirli bir sürümüyle derleme

Mac bilgisayarınızda Xcode'un birden çok sürümü yüklüyse, uygulamanızı oluştururken hangi Xcode sürümünün kullanılacağını belirtebilirsiniz. Bunu gerçekleştirmek için kullanılabilecek bir dizi yaklaşım vardır, ancak önerilen yaklaşım ortam değişkenini MD_APPLE_SDK_ROOT Xcode sürümünün yoluna ayarlamaktır.

Uyarı

xcode-select -s Xcode sürümünü kullanacak şekilde ayarlamak için kullanılması önerilmez.

Geçerli terminal oturumunun süresi için ortam değişkenini ayarlamak MD_APPLE_SDK_ROOT için:

1. Terminal uygulamasını açın.

2. Xcode sürümünüzün yerine aşağıdaki komutu yazın ve Enter tuşuna basın:

   export MD_APPLE_SDK_ROOT=/Applications/Xcode_14.1.0.app
   

Bu ortam değişkenini export kalıcı olarak ayarlamak istiyorsanız komutunu kabuk profilinize ekleyebilirsiniz, örneğin .zprofile.

Uygulamayı belirli bir simülatörde başlatma

Bir .NET MAUI iOS uygulaması, benzersiz cihaz kimliğini (UDID) sağlayarak mac'ten belirli bir iOS simülatöründe başlatılabilir:

1. Mac bilgisayarınızda Xcode'ı açın, Windows > Cihazlar ve Simülatörler menü öğesini ve ardından Simülatörler sekmesini seçin.

   

2. Seçtiğiniz simülatöre sağ tıklayın ve UDID'yi panoya kopyalamak için Tanımlayıcıyı Kopyala'yı seçin.

   

   Alternatif olarak, komutunu yürüterek UDID değerlerinin simctl list listesini alabilirsiniz:

   /Applications/Xcode.app/Contents/Developer/usr/bin/simctl list
   

3. Terminal'de uygulamayı derleyin ve MSBuild seçeneğini kullanarak MSBuild özelliğini belirterek _DeviceName seçtiğiniz simülatörde -pçalıştırın:

   dotnet build -t:Run -f net8.0-ios -p:_DeviceName=:v2:udid=MY_SPECIFIC_UDID
   

   Örneğin, uygulamayı derlemek ve i Telefon 13 Pro simülatöründe çalıştırmak için aşağıdaki komutu kullanın:

   dotnet build -t:Run -f net8.0-ios -p:_DeviceName=:v2:udid=E25BBE37-69BA-4720-B6FD-D54C97791E79
   

4. Seçtiğiniz simülatörde Bana birkaç kez tıklayın düğmesine basın ve düğme tıklama sayısının arttığını gözlemleyin.

   

Uygulamayı cihazda başlatma

Bir iOS uygulamasını dağıtabilmeniz için önce bir cihazın sağlanması gerekir. Daha fazla bilgi için bkz . iOS için cihaz sağlama. Bir cihaz sağlandıktan sonra, benzersiz cihaz kimliği (UDID) sağlanarak mac cihazda bir .NET MAUI iOS uygulaması başlatılabilir:

1. Cihazınızı usb kablosuyla yerel Mac'inize Bağlan.

2. Xcode'ı açın ve Pencere > Cihazları ve Simülatörler'e gidin.

3. Xcode'da Cihazlar sekmesini seçin ve bağlı cihazlar listesinden cihazı seçin.

4. Xcode'da Tanımlayıcı değerini panoya kopyalayın:

   

   Alternatif olarak, cihazınıza sağ tıklayıp Tanımlayıcıyı Kopyala'yı seçerek UDID'yi panoya kopyalayın.

5. Terminal'de uygulamayı derleyin ve MSBuild seçeneğini kullanarak MSBuild özelliğini belirterek _DeviceName seçtiğiniz simülatörde -pçalıştırın:

   dotnet build -t:Run -f net8.0-ios -p:RuntimeIdentifier=ios-arm64 -p:_DeviceName=MY_SPECIFIC_UDID
   

   "MY_SPECIFIC_UDID" değerini panoya kopyaladığınız cihaz tanımlayıcısıyla değiştirin.