MacOS için hedef C veya Swift uygulamaları oluşturma

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

1. Depo hizmeti hesabınıza (GitHub, Bitbucket, VSTS, Azure DevOps) bağlanın.
2. Uygulamanızın yaşadığı bir depoyu ve dalı seçin.
3. Yapı projesini veya çalışma alanını ve derlemek istediğiniz düzeni yapılandırın.

1. deponuzu bağlama

Depo hizmeti hesabınıza bağlanmanız gerekir. Hesabınız bağlandıktan sonra Mac projenizin bulunduğu depoyu seçin. Bir depoya yönelik derleme ayarlamak için yönetici ve çekme iznine sahip olmanız gerekir.

2. dal seçme

Bir depoyu seçtikten sonra derlemek istediğiniz dalı seçin. Varsayılan olarak, tüm etkin dallar listelenecektir.

3. ilk derlemenizi ayarlama

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

3.1. Proje/çalışma alanı ve düzen

Derleme yapılandırması için bir Xcode projesi veya Xcode çalışma alanı ve paylaşılan şema gereklidir. App Center projeleri, çalışma alanlarını ve paylaşılan şemaları otomatik olarak algılar. Oluşturmak istediğiniz projeyi veya çalışma alanını ve buna karşılık gelen düzeni seçin.

Herhangi bir düzen bulunamasa, oluşturmak istediğiniz şemanın paylaşılır ve şemanın kapsayıcısı proje veya seçtiğiniz çalışma alanıdır. Ayrıca bu değişikliklerin derlemeyi ayar yaptığınız dala iade edildiklerden emin olun.

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, bir geliştirici yapılandırılan bir dala her itişişte yeni bir derleme tetiklenir. Bu, "Sürekli Tümleştirme" olarak adlandırılır. Yeni bir derlemeyi el ile tetiklemeyi tercih ederseniz, bu ayarı derleme yapılandırmasında değiştirebilirsiniz.

3.4. Derleme numarasını artırma

Etkinleştirildiğinde, CFBundleVersion uygulamanın Info.plist'inde her derleme için otomatik olarak artırılır. Değişiklik derleme öncesi gerçekleşir ve depoya iş değişmez.

3.5. Testler

Seçilen şemada bir test hedefinin seçili olduğu bir test eylemi varsa, testleri her derlemenin parçası olarak çalıştıracak şekilde yapılandırarak. App Center şu anda XCTest birim testlerini çalıştıra çalıştırmaya devam ediyor. 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ı sertifika olması gerekir. Bir daldan oluşturulan derlemeleri imzalamak için Yapılandırma bölmesinde kod imzalamayı etkinleştirin ve sertifikanın parolasıyla birlikte geçerli bir sertifikayı (. p12)karşıya yükleyin. Xcode projenizdeki ayarların karşıya yüklediğiniz dosyalarla uyumlu olması gerekir. Bir sağlama profili, kod imzalama için isteğe bağlıdır.

Şu anda App Center yalnızca bu imzalama yapılandırmasını destekler:

• Yalnızca bir 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öntemi kullanılarak otomatik imzalama

Kod imzalama hakkında daha fazla bilgiyi App Center macOS kod imzalama kılavuzunda ve resmi Apple geliştirici kılavuzundabulabilirsiniz.

3,7. CocoaPods

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

Depo zaten bir /pods klasörü içeriyorsa, App Center deponuzdaki Pod 'yi iade ettiğiniz ve artık çalıştırılmayacak olduğunu varsayar pod install .

3,8. Dağıtım grubuna dağıtma

Bir daldan, başarıyla imzalanmış her bir derlemeyi, daha önce oluşturulmuş bir dağıtım grubuna dağıtılacak şekilde yapılandırabilirsiniz. Dağıtma bölümünün içinden yeni bir dağıtım grubu ekleyebilirsiniz. Uygulamaya erişimi olan tüm kullanıcıları içeren "ortak çalışanlar" adlı her zaman varsayılan bir dağıtım grubu vardır.

Yapılandırmayı kaydeden 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ınan - derleme kuyruğa alınan ve kaynakların serbest bırakılana kadar beklemesi.
• building - derleme önceden tanımlanmış görevleri çalıştırarak çalışıyor.
• başarılı - derleme başarıyla tamamlandı.
• başarısız - derlemenin tamamlanamasını engelleyen hatalar buldu. Derleme günlüklerini indirip inceerek derleme sorunlarını giderebilirsiniz.
• iptal edildi - Derleme bir kullanıcı eylemi tarafından iptal edildi veya zaman aldı.

4.1. Derleme günlükleri

Tamamlanmış bir derleme için (başarılı veya başarısız) derlemenin nasıl gittiğini daha iyi anlamak için günlükleri indirin. App Center dosyalarıyla birlikte 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şiv dizininde bulunur), hangi adımda sorun giderme ve derlemenin başarısız olduğunu build anlamada yardımcı olur.

4.2. Uygulama (.app)

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

• Derleme doğru şekilde imzalandıysa, dosya imzalamada kullanılan sağlama .app profiline karşılık gelen bir cihaza yüklenebilirsiniz. App Center ile kod imzalama ve dağıtma hakkında daha fazla bilgi App Center macOS kod imzalama belgelerinde bulunabilir.
• Derleme imzalandı ise, dosya .app geliştirici tarafından imzalandı olabilir. Örneğin, kod imzasını kullanma.

4.3. Semboller dosyası (.dsym)

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

• App Center SDK'yı uygulamanıza kilitlenme raporlama modülü etkinleştirilmiş olarak eklediydiyseniz, kilitlenme raporlama hizmeti bir derlemenin insanlar 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 eklediysanız, hizmet dosyanın insan tarafından okunabilir kilitlenme .dsym raporlarını görüntülemesi gerekir.

Kod .dsym imzalaması olduğunda dosyalar .app değişmez. Derlemeyi daha sonra kod imzalamaya karar verirsiniz, kod .dsym imzalamadan önce oluşturulan yine geçerli olur.

Derleme içleri

Projenizi oluşturmak için, Xcode projelerinizi ve çalışma alanlarınızı derlemenize, sorgulamanıza, analiz etmenize, test etmenize ve arşivlemenize olanak sağlayan bir komut satırı xcodebuild aracı olan kullanırız.

Desteklenen sürümler ve gereksinimler

Derleme makinesi sürüm ayrıntıları her yeni macOS sürümü ekleniyorken güncelleştirilir. Apple tarafından yayımlanan en son sürümleri derleme VM'lerimize mümkün olan en kısa sürede dahil ediyoruz.