App Store dağıtımı için iOS uygulaması yayımlama

2025-02-25

iOS uygulamalarını kullanıcılara dağıtmaya ilişkin en yaygın yaklaşım App Store üzerinden yapılır. Uygulamalar App Store'a App Store Connect adlı çevrimiçi bir araç aracılığıyla gönderilir. Yalnızca Apple Geliştirici Programı'na ait geliştiriciler bu araca erişebilir. Apple Developer Enterprise Program üyelerinin erişimi yoktur. App Store'a gönderilen tüm uygulamalar Apple'dan onay gerektirir.

Bir iOS uygulamasının dağıtılması için uygulamanın sağlama profili kullanılarak sağlanması gerekir. Sağlama profilleri, kod imzalama bilgilerinin yanı sıra uygulamanın kimliğini ve hedeflenen dağıtım mekanizmasını içeren dosyalardır.

.NET Çok Platformlu Uygulama Kullanıcı Arabirimi (.NET MAUI) iOS uygulamasını dağıtmak için, buna özgü bir dağıtım sağlama profili oluşturmanız gerekir. Bu profil, uygulamanın bir iOS cihazına yüklenebilmesi için yayın için dijital olarak imzalanmasını sağlar. Dağıtım sağlama profili uygulama kimliği ve dağıtım sertifikası içerir. Test için uygulamanızı bir cihaza dağıtırken kullandığınız Uygulama Kimliğinin aynısını kullanabilirsiniz. Ancak, henüz bir dağıtım sertifikanız yoksa kendinizi veya kuruluşunuzu tanımlamak için bir dağıtım sertifikası oluşturmanız gerekir.

App Store dağıtım sağlama profili oluşturma işlemi aşağıdaki gibidir:

Dağıtım sertifikası oluşturun. Daha fazla bilgi için bkz . Dağıtım sertifikası oluşturma.
Bir Uygulama Kimliği oluşturun. Daha fazla bilgi için bkz . Uygulama kimliği oluşturma.
Sağlama profili oluşturun. Daha fazla bilgi için bkz . Sağlama profili oluşturma.

Önemli

Apple,App Store'da iOS'u hedefleyen uygulamalar için bir gizlilik ilkesine sahiptir. Uygulamanın, .NET MAUI uygulamanızın veya herhangi bir üçüncü taraf SDK'ların ve paketlerin topladığı veri türlerini ve gerekli neden API'lerini kullanmanın nedenlerini listeleyen bir gizlilik bildirim dosyasını uygulama paketine eklemesini gerektirir. Gerekli neden API'lerini veya üçüncü taraf SDK'ları kullanımınız gizlilik bildiriminde bildirilmiyorsa, uygulamanız App Store tarafından reddedilebilir. Daha fazla bilgi için bkz . Apple gizlilik bildirimi.

Dağıtım sertifikası oluşturma

Kimliğinizi onaylamak için bir dağıtım sertifikası kullanılır. Dağıtım sertifikası oluşturmadan önce, Apple Geliştirici Hesabınızı Visual Studio'ya eklediğinizden emin olmanız gerekir. Daha fazla bilgi için bkz . Apple hesap yönetimi.

Yalnızca bir dağıtım sertifikanız yoksa oluşturmanız gerekir. Dağıtım sertifikası, Apple Geliştirici Hesabınızın Apple Kimliği kullanılarak oluşturulmalıdır.

Visual Studio'da dağıtım sertifikası oluşturmak için:

Visual Studio'da Araçlar > Seçenekleri Xamarin > Apple Hesapları'na> gidin.
Apple Geliştirici Hesapları iletişim kutusunda bir ekip seçin ve Ayrıntıları Görüntüle... düğmesine tıklayın.
Ayrıntılar iletişim kutusunda Sertifika Oluştur'a tıklayın ve iOS Dağıtımı'nı seçin. Yeni bir imzalama kimliği oluşturulur ve doğru izinlere sahip olmanız koşuluyla Apple ile eşitlenir.

Önemli

İmzalama kimliğinizi oluşturan özel anahtar ve sertifika, IDE ile eşleştirilmiş olması koşuluyla Mac derleme konağınızdaki Anahtar Zinciri Erişimi'ne de aktarılır. Daha fazla bilgi için bkz . iOS geliştirmesi için Mac ile eşleştirme.

Sertifika anahtar çiftlerini anlama

Dağıtım profili sertifikaları, ilişkili anahtarlarını ve Apple Geliştirici Hesabınızla ilişkili tüm sağlama profillerini içerir. Dağıtım profilinin iki sürümü vardır: biri Apple Geliştirici Hesabınızda, diğeri ise yerel bir makinede bulunur. İkisi arasındaki fark, içerdikleri anahtar türüdür: Apple Geliştirici Hesabınızdaki profil sertifikalarınızla ilişkili tüm ortak anahtarları içerirken, yerel makinenizdeki kopya tüm özel anahtarları içerir. Sertifikaların geçerli olması için anahtar çiftlerinin eşleşmesi gerekir.

Uyarı

Sertifikanın ve ilişkili anahtarların kaybedilmesi, mevcut sertifikaların iptal edilmesi ve sağlama profillerinin yeniden oluşturulması gerekeceği için son derece kesintiye neden olabilir.

Dağıtım profili oluşturma

Dağıtım sağlama profili, .NET MAUI iOS uygulamanızın bir iOS cihazına yüklenebilmesi için yayın için dijital olarak imzalanmasını sağlar. Dağıtım sağlama profili uygulama kimliği ve dağıtım sertifikası içerir.

Uygulama Kimliği oluşturma

Dağıttığınız uygulamayı tanımlamak için bir Uygulama Kimliği gereklidir. Uygulama Kimliği, bir uygulamayı benzersiz olarak tanımlayan ve uygulamanızın paket tanımlayıcısıyla aynı olması gereken ters DNS dizesine benzer. Test için uygulamanızı bir cihaza dağıtırken kullandığınız Uygulama Kimliğinin aynısını kullanabilirsiniz.

İki tür Uygulama Kimliği vardır:

Joker karakter. Joker uygulama kimliği, birden çok uygulamayla eşleştirmek için tek bir Uygulama Kimliği kullanmanıza olanak tanır ve genellikle biçimindedir com.domainname.*. Joker karakterli Uygulama Kimliği birden çok uygulamayı dağıtmak için kullanılabilir ve uygulamaya özgü özellikleri etkinleştirmeyen uygulamalar için kullanılmalıdır.
Açık. Açık uygulama kimliği tek bir uygulama için benzersizdir ve genellikle biçimindedir com.domainname.myid. Açık uygulama kimliği, eşleşen paket tanımlayıcısı ile bir uygulamanın dağıtılmasına olanak tanır. Açık Uygulama Kimlikleri genellikle Apple Pay veya Game Center gibi uygulamaya özgü özellikleri etkinleştiren uygulamalar için kullanılır. Özellikler hakkında daha fazla bilgi için bkz . Özellikler.

Yeni bir Uygulama Kimliği oluşturmak için:

Apple Geliştirici Hesabınızda Sertifikalar, Kimlikler ve Profiller'e gidin.
Sertifikalar, Tanımlayıcılar ve Profiller sayfasında Tanımlayıcılar sekmesini seçin.
Tanımlayıcılar sayfasında, yeni bir Uygulama Kimliği oluşturmak için düğmeye tıklayın+.
Yeni tanımlayıcı kaydet sayfasında, Devam düğmesine tıklamadan önce Uygulama Kimlikleri radyo düğmesini seçin:
Yeni tanımlayıcı kaydet sayfasında Devam düğmesine tıklamadan önce Uygulama'yı seçin:
Uygulama Kimliğini Kaydet sayfasında bir açıklama girin ve Açık veya Joker Karakter Paket Kimliği radyo düğmesini seçin. Ardından uygulamanızın Paket Kimliğini ters DS biçiminde girin:

Önemli

Girdiğiniz Paket Kimliği, uygulama projenizdeki Info.plist dosyasındaki Paket tanımlayıcısına karşılık gelir.

.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.
Uygulama Kimliğini Kaydet sayfasında, uygulamanın kullandığı özellikleri seçin. Tüm özellikler hem bu sayfada hem de uygulama projenizdeki Entitlements.plist dosyasında yapılandırılmalıdır. Daha fazla bilgi için bkz . Özellikler ve Yetkilendirmeler.
Uygulama Kimliğini Kaydet sayfasında Devam düğmesine tıklayın.
Uygulama Kimliğinizi onaylayın sayfasında Kaydet düğmesine tıklayın.

Sağlama profili oluşturma

Uygulama Kimliği oluşturulduktan sonra bir dağıtım sağlama profili oluşturmanız gerekir. Bu profil, uygulamanın bir iOS cihazına yüklenebilmesi için yayın için dijital olarak imzalanmasını sağlar.

App Store dağıtımı için bir sağlama profili oluşturmak için:

Apple Geliştirici Hesabınızın Sertifikalar, Tanımlayıcılar ve Profiller sayfasında Profiller sekmesini seçin.
Profiller sekmesinde, yeni bir profil oluşturmak için düğmeye tıklayın+.
Yeni Sağlama Profili Kaydet sayfasında, Devam düğmesine tıklamadan önce App Store radyo düğmesini seçin:
Sağlama Profili Oluştur sayfasındaki Uygulama Kimliği açılan listesinde, Devam düğmesine tıklamadan önce oluşturduğunuz Uygulama Kimliğini seçin:
Sağlama Profili Oluştur sayfasında, Devam düğmesine tıklamadan önce dağıtım sertifikanıza karşılık gelen radyo düğmesini seçin:
Sağlama Profili Oluştur sayfasında, Oluştur düğmesine tıklamadan önce sağlama profili için bir ad girin:

Not

Uygulamanızı imzalarken gerekli olacağı için sağlama profili adını not edin.
Sağlama Profili Oluştur sayfasında, isteğe bağlı olarak, sağlama profilinizi indirmek için İndir düğmesine tıklayın.

Not

Sağlama profilinizi şimdi indirmeniz gerekmez. Bunun yerine, bunu Visual Studio'da yapacaksınız.

Visual Studio'da sağlama profillerini indirme

Apple Geliştirici Hesabınızda bir dağıtım sağlama profili oluşturduktan sonra Visual Studio, uygulamanızı imzalamak için kullanılabilir olması için bu profili indirebilir:

Visual Studio'da Araçlar > Seçenekleri Xamarin > Apple Hesapları'na> gidin.
Apple Geliştirici Hesapları iletişim kutusunda ekibinizi seçin ve Ayrıntıları Görüntüle'ye tıklayın.
Ayrıntılar iletişim kutusunda, yeni profilin Sağlama Profilleri listesinde göründüğünü doğrulayın. Listeyi yenilemek için Visual Studio'yu yeniden başlatmanız gerekebilir.
Ayrıntılar iletişim kutusunda Tüm Profilleri İndir'e tıklayın.

Sağlama profilleri Windows'a indirilir ve IDE ile eşleştirilmişse Mac derleme konağınıza aktarılır. Daha fazla bilgi için bkz . iOS geliştirmesi için Mac ile eşleştirme.

Uygulamayı yayımlayın

Visual Studio, App Store dağıtımı için bir .NET MAUI iOS uygulaması yayımlayabilir ve bunu App Store'a yükleyebilir. Ancak, App Store'a bir uygulama yükleyebilmeniz için önce şunları uygulamanız gerekir:

App Store Connect'te App Store'a yüklemek istediğiniz uygulama için bir kayıt oluşturun. Bu kayıt, Uygulama Mağazası'nda görüneceği için uygulama hakkındaki tüm bilgileri ve dağıtım işlemi aracılığıyla uygulamayı yönetmek için gereken tüm bilgileri içerir. Daha fazla bilgi için bkz . developer.apple.com üzerinde uygulama kaydı oluşturma.
Uygulamaya özgü bir parola oluşturun. Uygulamaya özgü parola oluşturma hakkında bilgi için bkz . support.apple.com'de uygulamaya özgü parolaları kullanarak Apple kimliğinizle uygulamalarda oturum açma.

App Store dağıtımı için bir .NET MAUI iOS uygulaması yayımlamak için:

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.
Visual Studio araç çubuğunda Hata Ayıklama Hedefi açılan listesini kullanarak iOS Uzak Cihazlar'ı ve ardından Uzak Cihaz'ı seçin:
Hata ayıklama yapılandırmasından sürüm yapılandırmasına geçmek için Visual Studio araç çubuğunda Çözümler Yapılandırması açılan listesini kullanın:
Çözüm Gezgini'da .NET MAUI uygulama projenize sağ tıklayın ve Özellikler'i seçin. Ardından iOS Paket İmzalama sekmesine gidin ve Şema'nın El ile Sağlama, İmzalama kimliği'nin Dağıtım (Otomatik) ve Sağlama profilinin Otomatik olarak ayarlandığından emin olun:

Bu ayarlar, Visual Studio'nun Info.plist dosyasındaki paket tanımlayıcısına göre doğru sağlama profilini seçmesini sağlar (proje dosyanızdaki Uygulama Kimliği özelliğinin değeriyle aynıdır). Alternatif olarak, İmzalama kimliğini uygun dağıtım sertifikasına, Sağlama profilini ise Apple Geliştirici Hesabınızda oluşturduğunuz profile ayarlayın.
Çözüm Gezgini'da .NET MAUI uygulama projenize sağ tıklayın ve Yayımla...:'ı seçin:

Arşiv Yöneticisi açılır ve Visual Studio uygulama paketinizi arşivlemeye başlar:

Arşivleme işlemi, seçilen çözüm yapılandırması için uygulamayı iOS Paket İmzalama sekmesinde belirttiğiniz sertifika ve sağlama profilleriyle imzalar.
Arşiv Yöneticisi'nde arşivleme başarıyla tamamlandıktan sonra arşivinizin seçildiğinden emin olun ve ardından dağıt ... düğmesini seçerek uygulamanızı dağıtım için paketleme işlemine başlayın:

Dağıt - Kanal Seç iletişim kutusu görüntülenir.

Dağıt - Kanal Seç iletişim kutusunda App Store düğmesini seçin:
Dağıt - İmzalama Kimliği iletişim kutusunda imzalama kimliğinizi ve sağlama profilinizi seçin:

Not

Uygulamanız ve seçili dağıtım kanalı için oluşturulan imzalama kimliğini ve sağlama profilini kullanmanız gerekir.
Dağıt - İmzalama Kimliği iletişim kutusunda Farklı Kaydet düğmesini veya Mağazaya Yükle düğmesini seçin. Farklı Kaydet düğmesi, uygulamanızı yeniden imzalamadan ve daha sonra Transporter gibi bir uygulama aracılığıyla App Store'a yüklemek üzere dosya sisteminizdeki bir .ipa dosyasında yayımlamadan önce bir dosya adı girmenizi sağlar. Mağazaya Yükle düğmesi uygulamanızı yeniden imzalar ve App Store'a yüklemeden önce bir .ipa dosyasında yayımlar.
1. Mağazaya Yükle düğmesini seçerseniz, Visual Studio .ipa dosyasını oluşturduktan sonra Kimlik bilgilerini depolamak için karşıya yükle iletişim kutusu görüntülenir. Kimlik bilgilerini depolamak için karşıya yükle iletişim kutusunda Apple kimliğinizi ve uygulamaya özgü parolanızı girin ve Tamam düğmesini seçin:
App Store Connect'te bir uygulama kaydı oluşturmuş olmanız koşuluyla Visual Studio uygulama paketinizi doğrular ve App Store'a yükler.