İngilizce dilinde oku

Aracılığıyla paylaş


macOS için Objective-C veya Swift uygulamaları oluşturma

Önemli

Visual Studio App Center 31 Mart 2025'te kullanımdan kaldırılıyor. Tamamen kullanımdan kaldırılana kadar Visual Studio App Center'ı kullanmaya devam edebilirsiniz ancak geçiş yapmayı düşünebileceğiniz birkaç önerilen alternatif vardır.

Destek zaman çizelgeleri ve alternatifleri hakkında daha fazla bilgi edinin.

İlk Mac uygulamanızı oluşturmaya başlamak için şu adımları uygulayın:

  1. Depo hizmet hesabınıza (GitHub, Bitbucket, VSTS, Azure DevOps) bağlanın.
  2. Bir depo ve uygulamanızın yaşadığı bir dal seçin.
  3. Derlemenin projesini veya çalışma alanını ve oluşturmak istediğiniz düzeni yapılandırın.

Not

Uygulamanın dağıtılması için derlemenin bir sertifikayla kod imzalanması gerekir. Sağlama profili isteğe bağlıdır. Ayrıca, Mac Yükleyicileri için derleme şu anda desteklenmemektedir.

1. Deponuzu bağlama

Depo hizmet hesabınıza bağlanmanız gerekir. Hesabınız bağlandıktan sonra Mac projenizin bulunduğu depoyu seçin. Bir depo için derleme ayarlamak için yönetici ve çekme izni gerekir.

2. Dal seçme

Bir depo seçtikten sonra, oluşturmak istediğiniz dalı seçin. Varsayılan olarak, tüm etkin dallar listelenir.

3. İlk derlemenizi ayarlama

İlk derlemenizden önce Mac projesinin yapılandırılması gerekir.

3.1. Proje/çalışma alanı ve şema

Derleme yapılandırması için bir Xcode projesi veya Xcode çalışma alanı ve paylaşılan bir şema gerekir. App Center, dalınızdaki projeleri, çalışma alanlarını ve paylaşılan düzenleri otomatik olarak algılar. Oluşturmak istediğiniz projeyi veya çalışma alanını ve ilgili düzeni seçin.

Düzen bulunamazsa, birlikte oluşturmak istediğiniz düzenin paylaşıldığından ve şemanın kapsayıcısının seçtiğiniz proje veya çalışma alanı olduğundan emin olun. Ayrıca bu değişikliklerin derlemeyi ayarlamakta olduğunuz dalda denetlendiğinden emin olun.

Düzeni paylaşılan olarak işaretleme

3.2. Xcode sürümü

Derlemeyi çalıştırmak için Xcode sürümünü seçin.

3.3. Derleme tetikleyicileri

Varsayılan olarak, geliştirici yapılandırılmış bir dala her gönderildiğinde yeni bir derleme tetiklenir. Buna "Sürekli Tümleştirme" denir. Yeni bir derlemeyi el ile tetiklemek isterseniz, bu ayarı derleme yapılandırmasında değiştirebilirsiniz.

3.4. Derleme numarasını artırma

Etkinleştirildiğinde, CFBundleVersion uygulamanızın Info.plist dosyasındaki her derleme için otomatik olarak artar. Değişiklik derleme öncesi gerçekleşir ve deponuza işlenmez.

3.5. Testler

Seçilen düzende bir test hedefinin seçili olduğu bir test eylemi varsa, testleri her derlemenin bir parçası olarak çalışacak şekilde yapılandırabilirsiniz. App Center şu anda XCTest birim testleri çalıştırabilir. App Center, Mac derlemeleri için başlatma testlerini desteklemez.

3.6. Kod imzalama

Başarılı bir derleme bir .app dosya oluşturur. Derlemeyi bir cihaza yüklemek için imzalı sertifikaya sahip olması gerekir. Bir daldan oluşturulan derlemeleri imzalamak için yapılandırma bölmesinde kod imzalamayı etkinleştirin ve sertifikanın parolası ile birlikte geçerli bir sertifika (.p12) yükleyin. Xcode projenizdeki ayarların karşıya yüklediğiniz dosyalarla uyumlu olması gerekir. Sağlama profili, kod imzalama için isteğe bağlıdır.

App Center şu anda yalnızca şu imzalama yapılandırmalarını destekler:

  • Yalnızca geliştirme sertifikasıyla Geliştirme dışarı aktarma yöntemini kullanarak el ile imzalama
  • Geliştirici Kimliği dışarı aktarma yöntemini kullanarak el ile imzalama
  • Geliştirme dışarı aktarma yöntemini kullanarak otomatik imzalama

App Center'ın macOS kod imzalama kılavuzunda ve resmi Apple Geliştirici kılavuzunda kod imzalama hakkında daha fazla bilgi edinebilirsiniz.

3.7. CocoaPods

App Center seçili dalı tarar ve pod dosyası bulursa, her derlemenin başında otomatik olarak bir pod install adım gerçekleştirir. Bu, tüm bağımlılıkların yüklenmesini sağlar.

Depoda zaten bir /Pods klasörü varsa, App Center deponuzdaki podları iade ettiğinizi ve artık çalışmayacağını pod installvarsayar.

3.8. Dağıtım grubuna dağıtma

Bir daldan başarıyla imzalanan her derlemeyi daha önce oluşturulmuş bir dağıtım grubuna dağıtılacak şekilde yapılandırabilirsiniz. Dağıt bölümünden yeni bir dağıtım grubu ekleyebilirsiniz. Her zaman uygulamaya erişimi olan tüm kullanıcıları içeren "Ortak Çalışanlar" adlı bir varsayılan dağıtım grubu vardır.

Yapılandırmayı kaydettikten sonra yeni bir derleme otomatik olarak başlatılır.

4. Derleme sonuçları

Bir derleme tetiklendiğinde aşağıdaki durumlarda olabilir:

  • kuyruğa alındı - derleme kuyruğa alınır ve kaynakların ücretsiz olması beklenebilir.
  • building - derleme önceden tanımlanmış görevleri çalıştırıyor.
  • başarılı - derleme başarıyla tamamlandı.
  • failed - derleme tamamlanmasını engelleyen hatalar buldu. Derleme günlüklerini indirip inceleyerek derleme sorunlarını giderebilirsiniz.
  • iptal edildi - derleme bir kullanıcı eylemi tarafından iptal edildi veya zaman aşımına uğradı.

4.1. Derleme günlükleri

Tamamlanmış bir derleme için (başarılı veya başarısız), derlemenin nasıl gittiği hakkında daha fazla bilgi edinmek için günlükleri indirin. App Center aşağıdaki dosyaları içeren bir arşiv sağlar:

|-- 1_build.txt (this is the general build log)
|-- build (this folder contains a separate log file for each build step)
    |-- <build-step-1> (e.g. 2_Get Sources.txt)
    |-- <build-step-2> (e.g. 3_Pod install.txt)
    |--
    |-- <build-step-n> (e.g. n_Post Job Cleanup.txt)

Derleme adımına özgü günlükler (arşivin build dizininde bulunur), derlemenin hangi adımda ve neden başarısız olduğunu anlamak için sorun gidermeye ve anlamaya yardımcı olur.

4.2. Uygulama (.app)

Dosya .app , Mac uygulamasını içeren bir Mac uygulaması arşiv dosyasıdır.

  • Derleme doğru imzalanmışsa, .app dosya imzalama sırasında kullanılan sağlama profiline karşılık gelen bir cihaza yüklenebilir. App Center ile kod imzalama ve dağıtma hakkında daha fazla bilgi App Center'ın macOS kod imzalama belgelerinde bulunabilir.
  • Derleme imzalanmamışsa, .app dosya geliştirici tarafından imzalanabilir. Örneğin, birlikte tasarlamayı kullanma.

4.3. Simgeler dosyası (.dsym)

Dosyalar, .dsym uygulamanın hata ayıklama simgelerini içerir.

  • Uygulamanıza kilitlenme raporlama modülü etkin app Center SDK'sını eklediyseniz, kilitlenme raporlama hizmeti bir derlemenin insan tarafından okunabilir (sembolik) kilitlenme raporlarını görüntülemesi için bu .dsym dosyayı gerektirir.
  • Uygulamanıza HockeyApp SDK'sı gibi kilitlenme raporlaması için başka bir SDK eklediyseniz, hizmetin insan tarafından okunabilir kilitlenme raporlarını görüntülemesi .dsym gerekir.

.dsym kod ile imzalandığında .appdosyalar değişmez. Derlemeyi daha sonra kod imzalamaya karar verirseniz, .dsym kod imzalamadan önce oluşturulan geçerli olmaya devam edecektir.

İç bileşenler oluşturma

Projenizi oluşturmak için, Xcode projelerinizi ve çalışma alanlarınızı derlemenize, sorgulamanıza, analiz etmenizi, test etmenizi ve arşivleyebilmek için bir komut satırı aracı kullanırız xcodebuild.

Desteklenen sürümler ve gereksinimler

Derleme makinesi sürüm ayrıntıları , macOS'un her yeni sürümü eklendiğinde güncelleştirilir. Derleme VM'lerimize Apple tarafından yayınlanan en son sürümleri en kısa sürede dahil ediyoruz.