Çalışırken yeniden başlatma kullanarak iOS uygulaması dağıtma

Genellikle bir uygulama oluştururken kodunuz derlenip diğer proje kaynaklarıyla birleştirilerek simülatörünüze veya cihazınıza dağıtılan bir uygulama paketi oluşturulur. Bu modelle, uygulamanızda bir değişiklik yaptığınızda yeni bir uygulama paketinin derlenip dağıtılması gerekir. Artımlı derlemeler derleme süresini azaltmaya yardımcı olsa da, dağıtımlar genellikle değişikliğin boyutundan bağımsız olarak aynı süreyi alır.

.NET Çok Platformlu Uygulama Kullanıcı Arabirimi (.NET MAUI) sık erişimli yeniden başlatma, Mac derleme konağı gerektirmeden Visual Studio 2022'den bir .NET MAUI uygulamasını 64 bit yerel iOS cihazına hızla dağıtmanızı sağlar. Değişiklikleri yerel olarak bağlı iOS cihazınızda zaten mevcut olan uygulama paketine göndererek tam uygulama paketinin yeniden oluşturulması gereksinimini ortadan kaldırır. Kod dosyalarında, kaynaklarda ve proje başvurularında yapılan değişiklikleri destekleyerek geliştirme sırasında uygulamanızda yapılan değişiklikleri hızlı bir şekilde test etmenizi sağlar.

Yerel olarak bağlı bir iOS cihazına .NET MAUI uygulaması dağıtmak için sık erişimli yeniden başlatmayı kullanmak için karşılanması gereken çeşitli gereksinimler vardır:

• Visual Studio 2022 sürüm 17.3 veya üzerini kullanıyor olmanız gerekir.
• Geliştirme makinenizde iTunes (Microsoft Store veya 64 bit sürümü) yüklü olmalıdır.
• Bir Apple Geliştirici hesabınız ve ücretli Apple Geliştirici Programı kaydınız olmalıdır.

Ayarlama

Çalışırken yeniden başlatmayı ayarlamak için aşağıdaki adımları gerçekleştirin:

1. Visual Studio araç çubuğunda Hata Ayıklama Hedefi açılan listesini kullanarak iOS Yerel Cihazları'nıve ardından Yerel Cihaz girişini seçin:

   

2. Visual Studio araç çubuğunda Yerel Cihaz'ı seçin:

   

   Sık Erişimli Yeniden Başlatma kurulum sihirbazı görüntülenir ve bu sihirbaz, sık erişimli yeniden başlatma dağıtımı için yerel bir iOS cihazı ayarlama konusunda size yol gösterir.

3. Kurulum Sık Erişimli Yeniden Başlatma kurulum sihirbazında İleri'yi seçin:

   

4. iTunes yüklü değilse kurulum sihirbazı yüklemenizi ister. Kurulum Sık Erişimli Yeniden Başlatma kurulum sihirbazında iTunes'u İndir'i seçin:

   

   Not

   iTunes, Microsoft Store'dan veya Apple'dan indirilerek yüklenebilir.

   iTunes'un indirmesini bekleyin ve ardından yükleyin. Microsoft Store'dan yüklerseniz, yükleme tamamlandıktan sonra lütfen açın, ardından yerel olarak bağlı cihazları bulmasını sağlamak için ek istemleri izleyin.

5. Kurulum Çalışırken Yeniden Başlatma kurulum sihirbazında, yerel bir iOS cihazı bağlamanızı isteyecek sihirbazın sonraki adımına geçmek için İleri'yi seçin:

   

6. iOS cihazınızı bir USB kablosuyla geliştirme makinenize bağlayın. Cihazınızda geliştirme makinenize güvenmenizi isteyen bir istem görünebilir. Cihazınızda Güven'e tıklayın ve ek cihaz istemlerini izleyin.

7. Kurulum Çalışırken Yeniden Başlatma kurulum sihirbazında, yerel iOS cihazınız algılandıktan sonra İleri'yi seçin:

   

   Not

   Kurulum sihirbazı yerel iOS cihazınızı algılayamazsa bağlantıyı kesin ve ardından yerel iOS cihazınızı geliştirme makinenizden yeniden bağlayın. Ayrıca, iTunes'un yerel iOS cihazınızı tanıdığından emin olun.

8. Kurulum Sık Erişimli Yeniden Başlatma kurulum sihirbazında, apple geliştirici programı hesabınızı kullanmak üzere sık erişimli yeniden başlatmayı yapılandırmak için Tek bir hesapla oturum aç köprüsüne tıklayın:

   

   Tek tek hesap iletişim kutusu görüntülenir.

   Not

   Alternatif olarak, bir kurumsal Apple Developer hesabı kullanmak üzere sık erişimli yeniden başlatmayı yapılandırmak için Kurumsal hesapla oturum aç köprüsüne tıklayın ve görüntülenen iletişim kutusuna kimlik bilgilerinizi girin. Ardından 12. adıma geçin.

9. App Store Connect API anahtarı oluşturun. Bunun için bir Apple Geliştirici hesabına ve ücretli Apple Geliştirici Programı kaydına sahip olmanız gerekir. App Store Connect API anahtarı oluşturma hakkında bilgi için bkz . developer.apple.com'de App Store Connect API'si için API Anahtarları Oluşturma.

10. Bireysel hesap iletişim kutusunda App Store Connect API anahtar verilerinizi girin:

    

    Adı, Veren Kimliğive Anahtar Kimliği verileri, Kullanıcılar ve Erişim ve ardından Entegrasyonlar sekmesini seçerek App Store Connect bulunabilir:

    

11. Bireysel hesap iletişim kutusunda Ekle düğmesine tıklayın. Tek tek hesap iletişim kutusu kapatılır.

12. Kurulum Çalışırken Yeniden Başlatma kurulum sihirbazında Son düğmesine tıklayın:

    

    Apple Geliştirici Programı hesabınız Visual Studio'ya eklenir ve Kurulum Sık Erişimli Yeniden Başlatma kurulum sihirbazı kapatılır.

13. Çözüm Gezgini'da projenize sağ tıklayın ve Özellikler'i seçin.

14. Proje özelliklerinde iOS'yi genişletin ve Paket İmzalama'yı seçin. Şema açılan listesini kullanarak Otomatik Sağlama'yi seçin ve ardından Otomatik Sağlamayı Yapılandır köprüsüne tıklayın:

    

    Otomatik Sağlamayı Yapılandır iletişim kutusu görüntülenir.

15. Otomatik Sağlamayı Yapılandır iletişim kutusunda Connect API anahtarınız için ekibi seçin:

    

    Visual Studio otomatik sağlama işlemini tamamlar. Ardından Tamam düğmesine tıklayarak Otomatik Sağlamayı Yapılandır iletişim kutusunu kapatın.

    Not

    Ek iOS cihazlarının dağıtım için kolayca yapılandırılabilmesi için otomatik sağlama kullanılması önerilir. Ancak makinenizde doğru sağlama profilleri varsa el ile sağlamayı kullanabilirsiniz.

Sık erişimli yeniden başlatma kullanarak dağıtma ve hata ayıklama

İlk kurulumu gerçekleştirdikten sonra, yerel bağlı iOS cihazınız hata ayıklama hedefi açılan menüsünde görünür. Uygulamanızı dağıtmak ve hatalarını ayıklamak için:

1. Yerel bağlı iOS cihazınızın kilidinin açık olduğundan emin olun.

2. Visual Studio araç çubuğunda, hata ayıklama hedefi açılan listesinde yerel bağlı iOS cihazınızı seçin ve çalıştır düğmesine tıklayarak uygulamanızı derleyin ve yerel iOS cihazınıza dağıtın:

   

3. Uygulamanızı dağıttığınızda Visual Studio, Hata Ayıklayıcıya Bağlanma iletişim kutusunu görüntüler:

   

   Uygulamayı cihazınızda başlattığınızda Visual Studio hata ayıklayıcıyı çalışan uygulamanıza bağlar ve Hata Ayıklayıcıyı Bağlama iletişim kutusu kapatılır.

Uygulamanızda hata ayıklarken C# kodunuzu düzenleyebilir ve visual studio araç çubuğundaki yeniden başlat düğmesine basarak hata ayıklama oturumunuzu yeni değişiklikler uygulanarak yeniden başlatabilirsiniz:

Kodun yürütülmesini engelleme

Önişlemci HOTRESTART simgesi, çalışırken yeniden başlatma ile hata ayıklarken kodun yürütülmesini önlemek için kullanılabilir:

#if !HOTRESTART
  // Code here won't be executed when debugging with hot restart
#endif

Sık erişimli yeniden başlatmayı etkinleştirme

Visual Studio 2022'de etkin yeniden başlatma varsayılan olarak etkindir. Daha önce devre dışı bırakılmışsa, Visual Studio menü çubuğundan Araçlar > Seçenekleri seçilerek etkinleştirilebilir. Ardından Seçenekler iletişim kutusunda Xamarin'i genişletin ve iOS Ayarları'nı seçin. Ardından Sık Erişimli Yeniden Başlatmayı Etkinleştir seçeneğinin işaretli olduğundan emin olun:

Sınırlamalar

Sık erişimli yeniden başlatma kullanırken sınırlamalar vardır:

• Yalnızca hata ayıklama derleme yapılandırmasını kullanan uygulamaları dağıtmak için kullanılabilir. Uygulamanızı üretim amacıyla derlemek, imzalamak ve dağıtmak için bir Mac derleme konağına ihtiyacınız olacaktır.
• Görsel taslak ve XIB dosyaları desteklenmez ve çalışma zamanında bunları yüklemeyi denerse uygulamanız kilitlenebilir.
• Statik iOS kitaplıkları ve statik kitaplıklar içeren çerçeveler desteklenmez ve uygulamanız bunları yüklemeye çalışırsa çalışma zamanı hataları veya kilitlenmeleri görebilirsiniz.
• XCFrameworks ve bağlama kaynak paketleri, statik iOS kitaplıkları veya statik kitaplıkları olan çerçeveler içermediği sürece desteklenir.
• Varlık katalogları desteklenmez. Sık Erişimli Yeniden Başlatma'yı kullanırken, uygulamanız bir .NET simgesi ve başlatma ekranı gösterir.

Sorun giderme

iOS, uygulama başlatma sürelerini ve yanıt verme hızını izleyen ve yanıt vermeyen uygulamaları sonlandıran bir watchdog kullanır. Örneğin, watchdog ana iş parçacığını engelleyen uygulamaları önemli bir süre için sonlandırır. Eski iOS cihazlarında watchdog, hata ayıklayıcı bağlanmadan önce sık erişimli yeniden başlatma kullanılarak dağıtılan bir uygulamayı sonlandırabilir. Geçici çözüm, uygulamanın başlangıç yolunda gerçekleştirilen işlem miktarını azaltmak ve daha yeni bir iOS cihazı kullanmaktır.

Ek sorunları bildirmek için lütfen Geri Bildirim Göndermeye Yardımcı Olun > Sorun>geri bildirim aracını kullanın.