Xamarin.iOS için el ile sağlama

  • Makale

Xamarin.iOS başarıyla yüklendikten sonra, iOS geliştirmenin bir sonraki adımı iOS cihazınızı sağlamaktır. Bu kılavuz, geliştirme sertifikalarını ve profillerini ayarlamak için el ile sağlamayı kullanmayı inceler.

Not

Bu sayfadaki yönergeler, Apple Geliştirici Programı'na ücretli erişimi olan geliştiriciler için geçerlidir. Ücretsiz bir hesabınız varsa cihaz içi test hakkında daha fazla bilgi için lütfen Ücretsiz sağlama kılavuzuna bakın.

Geliştirme sertifikası oluşturma

Geliştirme cihazı ayarlamanın ilk adımı bir imzalama sertifikası oluşturmaktır. İmzalama sertifikası iki şeyden oluşur:

  • Geliştirme Sertifikası
  • Özel anahtar

Geliştirme sertifikaları ve ilişkili anahtarlar bir iOS geliştiricisi için kritik önem taşır: Apple ile kimliğinizi oluşturur ve uygulamalarınıza dijital imzanızı koymaya benzer şekilde sizi belirli bir geliştirme cihazı ve profiliyle ilişkilendirir. Apple, dağıtmanıza izin verilen cihazlara erişimi denetlemek için sertifikaları denetler.

Geliştirme ekipleri, sertifikalar ve profiller, Apple Üye Merkezi'nin Sertifikalar, Tanımlayıcılar ve Profiller (oturum açma gerekli) bölümüne erişilerek yönetilebilir. Apple, cihaz veya simülatör için kodunuzu oluşturmak için bir imzalama kimliğine sahip olmanız gerekir.

Önemli

Bir kerede yalnızca iki iOS Geliştirme sertifikasına sahip olabileceğinizi unutmayın. Daha fazla oluşturmanız gerekirse, mevcut olanı iptal etmeniz gerekir. İptal edilmiş sertifika kullanan herhangi bir makine, uygulamasını imzalayamaz.

El ile sağlama işlemine başlamadan önce, Apple Hesap Yönetimi kılavuzunda açıklandığı gibi Visual Studio'da bir Apple geliştirici hesabınızın eklendiğinden emin olmalısınız. Apple geliştirici hesabınızı ekledikten sonra, imzalama sertifikası oluşturmak için aşağıdakileri yapın:

  1. Visual Studio'da Apple geliştirici hesapları penceresine gidin.

    1. Mac: Visual Studio > Tercihleri > Apple Geliştirici Hesabı
    2. Windows: Araçlar > Seçenekleri > Xamarin > Apple Hesapları

  2. Bir ekip seçin ve Ayrıntıları Görüntüle... seçeneğine tıklayın .

  3. Sertifika Oluştur'a tıklayın ve Apple Geliştirme veya iOS Geliştirme'yi seçin. Doğru izinlere sahipseniz, birkaç saniye sonra yeni bir imzalama kimliği görüntülenir.

Sertifika anahtar çiftlerini anlama

Geliştirici Profili sertifikalar, ilişkili anahtarları ve hesapla ilişkili tüm sağlama profillerini içerir. Bir Geliştirici Profilinin iki sürümü vardır; biri Geliştirici Portalı'nda, diğeri ise yerel mac'te bulunur. İkisi arasındaki fark, içerdikleri anahtar türüdür: Portaldaki Profil, sertifikalarınızla ilişkili tüm ortak anahtarları barındırırken, yerel Mac'inizdeki 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 geçici dağıtım için kaydedilenler de dahil olmak üzere ilişkili cihazların yeniden sağlanmasını gerektireceği için son derece kesintiye neden olabilir. Geliştirme Sertifikalarını başarıyla ayarladıktan sonra yedek kopyayı dışarı aktarın ve güvenli bir yerde depolayın. Bunun nasıl yapacağı hakkında daha fazla bilgi için, Apple belgelerindeki Sertifikaları Koruma kılavuzunun Sertifikaları ve Profilleri Dışarı ve İçeri Aktarma bölümüne bakın.

Geliştirme için bir iOS cihazı sağlama

Apple ile kimliğinizi oluşturduğunuza ve geliştirme sertifikanıza sahip olduğunuza göre, bir uygulamayı Apple cihazına dağıtmanın mümkün olması için bir sağlama profili ve gerekli varlıkları ayarlamanız gerekir. Cihazın Xcode tarafından desteklenen bir iOS sürümü çalıştırıyor olması gerekir; cihazın, Xcode'un veya her ikisinin de güncelleştirilmesi gerekebilir.

Cihaz ekleme

Geliştirme için bir sağlama profili oluştururken, uygulamayı hangi cihazların çalıştırabileceğini belirtmemiz gerekir. Bunu etkinleştirmek için Geliştirici Portalımıza takvim yılı başına en fazla 100 cihaz eklenebilir ve buradan belirli bir sağlama profiline eklenecek cihazları seçebiliriz. Geliştirici Portalı'na cihaz eklemek için Mac bilgisayarınızda aşağıdaki adımları izleyin

  1. Sağlanan USB kablosuyla Mac'e sağlanacak cihazı Bağlan.

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

  3. Cihazlar sekmesinin altında, sol taraftaki menüden cihazı seçin.

  4. Tanımlayıcı dizesini vurgulayın ve panoya kopyalayın:

    Xcode devices and simulator window with the iOS identifier string location highlighted.

  5. Web tarayıcısında geliştirici portalındaki Cihazlar bölümüne gidin ve düğmeye + tıklayın:

    Screenshot of the devices page on the Apple Developer site with the add button highlighted.

  6. Doğru Platformu ayarlayın ve yeni cihaz için bir ad belirtin. Daha önce kopyalanan tanımlayıcıyı Cihaz Kimliği alanına yapıştırın:

    Screenshot of the new device registration page with the fields correctly populated.

  7. Continue (Devam) düğmesine tıklayın.

  8. Bilgileri gözden geçirin, ardından Kaydet'e tıklayın.

Xamarin.iOS uygulamasını test etmek veya hatalarını ayıklamak için kullanılacak tüm iOS cihazları için yukarıdaki adımları yineleyin.

Geliştirme sağlama profili oluşturma

Cihazı geliştirici portalına ekledikten sonra bir sağlama profili oluşturmak ve cihazı buna eklemek gerekir.

Sağlama profili oluşturmadan önce bir Uygulama Kimliği oluşturulmalıdır. Uygulama Kimliği, bir uygulamayı benzersiz olarak tanımlayan ters DNS stil dizesidir. Aşağıdaki adımlarda, çoğu uygulamayı derlemek ve yüklemek için kullanılabilecek joker uygulama kimliğinin nasıl oluşturulacağı gösterilmektedir. Açık Uygulama Kimlikleri yalnızca bir uygulamanın (eşleşen paket kimliğiyle) yüklenmesine izin verir ve genellikle Apple Pay ve HealthKit gibi belirli iOS özellikleri için kullanılır. Açık Uygulama Kimlikleri oluşturma hakkında bilgi için Özelliklerle Çalışma kılavuzuna bakın.

Yeni joker karakter Uygulama Kimliği

  1. Geliştirici portalında Tanımlayıcılar bölümüne gidin ve düğmeye + tıklayın.

  2. Uygulama Kimlikleri'ne tıklayın ve Devam'a tıklayın.

  3. Bir Açıklama girin. Ardından Paket Kimliği'ni Joker Karakter olarak ayarlayın ve biçiminde com.[DomainName].*bir kimlik girin:

    Screenshot of new App ID registration page with required fields populated.

  4. Continue (Devam) düğmesine tıklayın.

  5. Bilgileri gözden geçirin, ardından Kaydet'e tıklayın.

Yeni sağlama profili

Uygulama Kimliği oluşturulduktan sonra sağlama profili oluşturulabilir. Bu sağlama profili, bu profilin ilişkili olduğu uygulama (veya joker karakter uygulama kimliğiyse uygulamalar), profili kimlerinkullanabileceği (hangi geliştirici sertifikalarının eklendiğine bağlı olarak) ve uygulamayı hangi cihazların yükleyebileceği hakkında bilgi içerir.

Geliştirme için el ile bir sağlama profili oluşturmak için aşağıdakileri yapın:

  1. Geliştirici portalında Profiller bölümüne gidin ve düğmeye + tıklayın.

  2. Geliştirme'nin altında iOS Uygulama Geliştirme'yi seçin ve Devam'a tıklayın.

  3. Açılan menüden kullanılacak Uygulama Kimliği'ni seçin ve Devam'a tıklayın.

  4. Sağlama profiline eklenecek Sertifikaları seçin ve Devam'a tıklayın.

  5. Uygulamanın yükleneceği tüm cihazları seçin ve Devam'a tıklayın.

  6. Sağlama Profili Adı sağlayın ve Oluştur'a tıklayın.

  7. Sağlama profilini Mac'e indirmek için isteğe bağlı olarak sonraki sayfada İndir'e tıklayabilirsiniz.

Visual Studio'da sağlama profillerini indirme

Apple Geliştirici Portalı'nda yeni bir sağlama profili oluşturduktan sonra, uygulamanızda paket imzalama için kullanılabilir olması için indirmek için Visual Studio'yu kullanın.

  1. Visual Studio'da Apple geliştirici hesapları penceresine gidin.

    1. Mac: Visual Studio > Tercihleri > Apple Geliştirici Hesabı
    2. Windows: Araçlar > Seçenekleri > Xamarin > Apple Hesapları

  2. Ekibi seçin ve Ayrıntıları Görüntüle... seçeneğine tıklayın .

  3. 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.

  4. Tüm Profilleri İndir'e tıklayın.

Yeni sağlama profili artık Visual Studio'da kullanılabilir ve kullanıma hazır hale gelecek.

Bir cihaza dağıtma

Bu noktada sağlama tamamlanmalıdır ve uygulama cihaza dağıtılmaya hazırdır. Bunun için aşağıdaki adımları izleyin:

  1. Cihazınızı Mac'e Bağlan.

  2. Info.plist dosyasını açın ve Paket Tanımlayıcısı'nın daha önce oluşturulan Uygulama Kimliği ile eşleştiğinden emin olun (Uygulama Kimliği joker karakter değilse).

  3. İmzalama bölümünde, Düzen olarak El ile Sağlama'yı seçin:

    Screenshot of Info.plist in Visual Studio for Mac with manual provisioning selected

  4. Paket İmzalama Seçenekleri... seçeneğine tıklayın .

  5. Derleme yapılandırmasının Hata Ayıklama|i Telefon olarak ayarlandığından emin olun. Doğru sertifikaların ve sağlama profillerinin listelendiğini doğrulamak için hem İmzalama Kimliği hem de Sağlama Profili açılan menülerini açın:

    iOS bundle signing property page with the provisioning profile dropdown menu open listing all the available provisioning profiles for the app.

  6. Kullanılacak belirli bir kimliği ve profili seçin veya Otomatik olarak bırakın. Otomatik olarak ayarlandığında Mac için Visual Studio, Info.plist dosyasındaki Paket Tanımlayıcısı'na göre kimliği ve profili seçer.

  7. Tamam'a tıklayın.

  8. Uygulamayı cihazınıza dağıtmak için Çalıştır'a tıklayın.

Uygulama hizmetleri için sağlama

Apple, Xamarin.iOS uygulaması için etkinleştirilebilen özellikler olarak da adlandırılan bir dizi özel Uygulama Hizmeti sunar. Bu Uygulama Hizmetleri, uygulama kimliği oluşturulduğunda hem iOS Sağlama Portalı'nda hem de Xamarin.iOS uygulamasının projesinin parçası olan Entitlements.plist dosyasında yapılandırılmalıdır. Uygulamanıza Uygulama Hizmetleri ekleme hakkında bilgi için Özelliklere Giriş kılavuzuna ve Yetkilendirmelerle Çalışma kılavuzuna bakın.

  • Gerekli uygulama hizmetleriyle bir Uygulama Kimliği oluşturun.
  • Bu Uygulama Kimliğini içeren yeni bir sağlama profili oluşturun.
  • Xamarin.iOS Projesinde Yetkilendirmeleri Ayarlama