iOS özellikleri

iOS'ta .NET Çok Platformlu Uygulama Kullanıcı Arabirimi (.NET MAUI) uygulamaları, uygulama ile sistem kaynakları veya kullanıcı verileri arasında erişimi sınırlayan bir dizi kural sağlayan bir korumalı alanda çalışır. Apple, işlevselliği genişletmek ve iOS uygulamalarının yapabileceklerinin kapsamını genişletmek için uygulama hizmetleri olarak da bilinen özellikler sağlar. Özellikler, uygulamanıza Siri ile tümleştirme gibi platform özellikleriyle daha derin bir tümleştirme eklemenize olanak tanır. Özellikler hakkında daha fazla bilgi için bkz. developer.apple.com özellikleri.

Özellikler uygulamanızın sağlama profiline eklenir ve uygulamanızı kod imzalama sırasında kullanılır. Sağlama profili, uygulamanızın paket tanımlayıcısıyla eşleşen ve gerekli özelliklerin etkinleştirildiği bir Uygulama Kimliği içermelidir. Sağlama profili Visual Studio'da otomatik olarak veya Apple Geliştirici Hesabınızda el ile oluşturulabilir.

Yetenekler, yetkilendirme kavramıyla yakından ilgilidir. Her ikisi de uygulamanızın çalıştığı korumalı alanın genişletilmesi isteğinde bulunarak ek özellikler sunar. Yetkilendirmeler genellikle uygulamanızı geliştirirken eklenirken, özellikler genellikle uygulamanızı dağıtım için kod imzalarken eklenir. Ancak, otomatik sağlama etkinleştirildiğinde, uygulamanıza belirli yetkilendirmeler eklemek, uygulamanızın sağlama profilindeki özelliklerini de güncelleştirir. Yetkilendirmeler hakkında daha fazla bilgi için bkz . Yetkilendirmeler.

Visual Studio ile özellik ekleme

Visual Studio'da bir sağlama profiline özellikler eklenebilir. Bu yaklaşım otomatik sağlamanın kullanılmasını gerektirir ve yalnızca özelliklerin bir alt kümesi için çalışır. Otomatik sağlama hakkında daha fazla bilgi için bkz . iOS uygulamaları için otomatik sağlama.

Aşağıdaki listede Visual Studio kullanılarak otomatik olarak sağlanabilir özellikler gösterilir:

• HealthKit
• HomeKit
• Etkin nokta yapılandırması
• Uygulamalar arası ses
• Çoklu Yol
• Ağ uzantıları
• Yakın alan iletişim etiketi okuyucusu
• Kişisel VPN
• Siri
• Kablosuz aksesuar yapılandırması

Visual Studio'da tüm özellikler uygulamanızın Entitlements.plist dosyasına eklenir. Yukarıda listelenen özellikler, sağlama profilinize de eklenir. Projenize yetkilendirme dosyası ekleme de dahil olmak üzere yetkilendirmeler hakkında daha fazla bilgi için bkz . Yetkilendirmeler.

Visual Studio'da özellik eklemek için:

1. Visual Studio'da IDE'nin mac derleme konağıyla eşlendiğinden emin olun. Daha fazla bilgi için bkz . iOS geliştirmesi için Mac ile eşleştirme.

2. Visual Studio'da projeniz için otomatik sağlamayı etkinleştirin. Daha fazla bilgi için bkz . Otomatik sağlamayı etkinleştirme.

3. Visual Studio'da projenize bir Entitlements.plist dosyası ekleyin. Daha fazla bilgi için bkz . Entitlements.plist dosyası ekleme.

4. Çözüm Gezgini,.NET MAUI uygulama projenizin Platformlar > iOS klasöründen Entitlements.plist dosyasına çift tıklayarak yetkilendirmeler düzenleyicisinde açın.

5. Yetkilendirmeler düzenleyicisinde, uygulamanız için gereken yetkilendirmeleri seçin ve yapılandırın:

   

6. Yetkilendirme anahtarı/değer çiftlerini dosyaya eklemek için Entitlements.plist dosyanızdaki değişiklikleri kaydedin ve uygulama hizmetini Uygulama Kimliğinize ekleyin.

Belirli özellikler için Info.plist'te gizlilik anahtarlarının ayarlanması da gerekebilir.

Apple Geliştirici Hesabınıza özellikler ekleme

Tüm özellikler, Apple Geliştirici Hesabınızda uygulamanızın sağlama profiline eklenebilir. Bu yaklaşım el ile sağlamanın kullanılmasını gerektirir ve tüm özellikler için çalışır. El ile sağlama hakkında daha fazla bilgi için bkz . iOS uygulamaları için el ile sağlama.

Apple Geliştirici Hesabınıza özellik eklemek, Uygulama Kimliği oluşturma, sağlama profili oluşturma ve el ile sağlamayı etkinleştirmeyi gerektiren çok adımlı bir işlemdir.

Sağlama profilinize yeni bir özellik eklerken, uygulamanızın Entitlements.plist dosyasına da aynı özelliği eklemeniz ve uygulamanın bu dosyayı tükettiğinden emin olmanız gerekir. Daha fazla bilgi için bkz . Yetkilendirmeler. Belirli özellikler için Info.plist'te gizlilik anahtarlarının ayarlanması da gerekebilir.

Uygulama hizmetiyle Uygulama Kimliği oluşturma

Uygulama Kimliği, bir uygulamayı benzersiz olarak tanımlayan ters DNS dizesine benzer ve dağıttığınız uygulamayı tanımlamak için gereklidir. Uygulama Kimliği, uygulamanızın paket tanımlayıcısı ile aynı olmalıdır.

Önemli

.NET MAUI uygulamasının paket tanımlayıcısı proje dosyasında Uygulama Kimliği özelliği olarak depolanır. Visual Studio'da Çözüm Gezgini .NET MAUI uygulama projenize sağ tıklayın ve Özellikler'i seçin. Ardından MAUI Paylaşılan > Genel sekmesine gidin. Uygulama Kimliği alanında paket tanımlayıcısı listelenir.

Uygulama Kimliği alanının değeri güncelleştirildiğinde, Info.plist dosyasındaki Paket tanımlayıcısının değeri otomatik olarak güncelleştirilir.

İki tür Uygulama Kimliği vardır: açık ve joker karakter. Açık uygulama kimliği tek bir uygulama için benzersizdir ve genellikle biçimindedir com.domainname.myid. Açık uygulama kimliği, bir cihaza eşleşen paket tanımlayıcısı olan bir uygulamanın yüklenmesine olanak tanır. Uygulamaya özgü özellikleri etkinleştiren uygulamalar için açık Uygulama Kimlikleri gereklidir.

Aşağıdaki adımlarla açık bir Uygulama Kimliği oluşturulabilir:

1. Web tarayıcısında Apple Geliştirici Hesabınızın Tanımlayıcılar bölümüne gidin ve düğmeye + tıklayın.

2. Yeni tanımlayıcı kaydet sayfasında Uygulama Kimlikleri'ni seçin ve Devam düğmesine tıklayın.

3. Yeni tanımlayıcı kaydet sayfasında Uygulama türünü seçin ve Devam düğmesine tıklayın.

4. Uygulama Kimliğini Kaydet sayfasında bir Açıklama girin ve Paket Kimliği'ni Açık olarak ayarlayın. Ardından biçiminde com.domainname.myidbir Uygulama Kimliği girin:

   

5. Uygulama Kimliğini Kaydet sayfasında, Özellikler ve Uygulama Hizmetleri sekmeleri altında gerekli yeteneklerinizi etkinleştirin:

   

6. Uygulama Kimliğini Kaydet sayfasında Devam düğmesine tıklayın.

7. Uygulama Kimliğinizi onaylayın sayfasında, bilgileri gözden geçirin ve kaydet düğmesine tıklayın. Uygulama Kimliğinizin başarıyla kaydedilmesi koşuluyla, Apple Geliştirici Hesabınızın Tanımlayıcılar bölümüne geri dönersiniz.

8. Tanımlayıcılar sayfasında, yeni oluşturduğunuz Uygulama Kimliği'ne tıklayın.

9. Uygulama Kimliği Yapılandırmanızı düzenleyin sayfasında, ek kurulum gerektiren etkinleştirilen özelliklerinizden herhangi birinin Yapılandır düğmesi bulunur:

   

   Etkinleştirilen özelliklerinizi yapılandırmak için herhangi bir Yapılandır düğmesine tıklayın. Daha fazla bilgi için bkz . developer.apple.com uygulama özelliklerini yapılandırma.

Sağlama profili oluşturma

Bir Uygulama Kimliği oluşturduktan sonra, Uygulama Kimliği için bir sağlama profili oluşturmanız gerekir. Bunun için daha önce bir imzalama sertifikası oluşturmuş ve Apple Geliştirici Hesabınıza bir cihaz eklemiş olmanız gerekir. Daha fazla bilgi için bkz . İmzalama sertifikası oluşturma ve Cihaz ekleme.

Aşağıdaki adımlarla bir sağlama profili oluşturulabilir:

1. Web tarayıcısında Apple Geliştirici Hesabınızın Profiller bölümüne gidin ve düğmeye + tıklayın.

2. Yeni Sağlama Profili Kaydet sayfasında, Geliştirme bölümünde iOS Uygulama Geliştirme'yi (veya Dağıtım bölümünden bir dağıtım profili türü) seçin ve Devam düğmesine tıklayın:

   

3. Sağlama Profili Oluştur sayfasında Uygulama Kimliğinizi seçin ve ardından Devam düğmesine tıklayın:

   

4. Sağlama Profili Oluştur sayfasında, sağlama profiline eklenecek sertifikaları seçin ve ardından Devam düğmesine tıklayın:

   

5. Sağlama Profili Oluştur sayfasında, uygulamanın yükleneceği cihazları seçin ve ardından Devam düğmesine tıklayın:

   

6. Sağlama Profili Oluştur sayfasında bir sağlama profili adı sağlayın ve oluştur düğmesine tıklayın:

   

El ile sağlamayı etkinleştirme

Bir sağlama profili oluşturduktan sonra Visual Studio tarafından indirilmeli ve projeniz için sağlama profili olarak ayarlanmalıdır:

1. Visual Studio'da, uygulamanızı imzalamak için kullanılabilir olması için yeni oluşturduğunuz sağlama profilini indirin. Daha fazla bilgi için bkz . Visual Studio'da sağlama profillerini indirme.
2. Visual Studio'da projeniz için el ile sağlamayı etkinleştirin. Daha fazla bilgi için bkz . El ile sağlamayı etkinleştirme.

Sorun giderme

Aşağıdaki listede, özellikleri kullanan bir .NET MAUI iOS uygulaması geliştirirken sorunlara neden olabilecek yaygın sorunlar ayrıntılı olarak açıklanmış olur:

• Apple Geliştirici Hesabınızın Tanımlayıcılar bölümünde doğru Uygulama Kimliğinin oluşturulduğundan ve kaydedildiğinden emin olun.
• Özelliğin Uygulama Kimliği'ne eklendiğinden ve özelliğin doğru değerler kullanılarak yapılandırıldığından emin olun.
• Sağlama profilinin geliştirme makinenize yüklendiğinden ve uygulamanın Info.plist dosyasının Uygulama Kimliğinizle aynı paket tanımlayıcısını kullandığından emin olun.
• Uygulamanın Entitlements.plist dosyasında doğru yetkilendirmelerin etkinleştirildiğinden emin olun.
• Gerekli gizlilik anahtarlarının Info.plist dosyasında ayarlandığından emin olun.
• Uygulamanın Entitlements.plist dosyasını tükettiğinden emin olun.