macOS uzantılarını kullanmaya başlama

Önemli

Visual Studio App Center, 30 Haziran 2026'ya kadar desteklenmeye devam edecek Analiz ve Tanılama özellikleri dışında 31 Mart 2025'te kullanımdan kaldırılmıştır. Daha fazla bilgi edinin.

• Android
• Ios
• iOS Uzantıları
• React Native
• MAUI/Xamarin
• UWP
• WPF/WinForms
• Birlik
• macOS
• macOS Uzantıları
• tvOS

Uzantılar yalnızca kilitlenme raporlamasını destekler.

Kapsayıcı uygulamanıza App Center SDK'sı eklemeyi öğrenmek için App Center macOS Kullanmaya Başlama belgelerine bakın.

App Center Çökmelerini kullanmak için uygulama uzantınızda App Center macOS SDK'sını ayarlamaya başlayalım.

1. Önkoşullar

App Center SDK'sını kullanmak için aşağıdaki gereksinimlerin karşılanması gerekir:

• macOS projeniz, macOS sürüm 10.14.4 veya üstü bir sürümde Xcode 13 veya daha yeni bir sürümle kurulmuştur.
• macOS 10.13 veya sonraki sürümlerde çalışan cihazları hedeflisiniz.
• Çökme Raporlama işlevselliği sağlayan başka bir kütüphane kullanmıyorsunuz.

2. Uygulama Sırrını almak için Uygulamanızı App Center Portalı'nda oluşturmak için

Uygulamanızı App Center portalında zaten oluşturduysanız bu adımı atlayabilirsiniz.

1. appcenter.ms gidin.
2. Kaydolun veya oturum açın ve portalın sağ üst köşesindeki Yeni ekle yazan mavi düğmeye basın ve açılan menüden Yeni uygulama ekle'yi seçin.
3. Uygulamanız için bir ad ve isteğe bağlı bir açıklama girin.
4. İşletim sistemi olarak macOS'u ve platform olarak Objective-C/Swift'i seçin.
5. Sağ alttaki Yeni uygulama ekle yazan düğmeye basın.

Bir uygulama oluşturduktan sonra Uygulama Gizli Dizisi'ni App Center Portalı'nın Ayarlar sayfasından edinebilirsiniz. Ayarlar sayfasının sağ üst köşesinde üç dikey noktalı simgeye tıklayın ve seçerek Uygulama Gizli Kodunuzu alın.

Uyarı

Başka bir macOS projesinden mevcut Uygulama Gizliliği'ni kullanmanın olumsuz etkileri vardır. App Center, aynı App Center uygulamasında projeye göre filtrelemeyi desteklemez. Örneğin, belirli bir sürümün kilitlenmelerini listelemek, bu sürüm için her iki projedeki tüm kilitlenmeleri ayrımsız olarak listeler. Kafa karıştırıcı olabilir.

Uyarı

4.0.0 App Center sürümünde büyük değişiklikler yapılmıştır. App Center'ı önceki sürümlerden geçirmek için App Center SDK 4.0.0 ve üzeri sürümlere geçiş bölümünü izleyin.

3. App Center SDK modüllerini ekleme

App Center SDK'sı Cocoapods, Carthage aracılığıyla veya ikili dosyaları projenize el ile ekleyerek uygulamanızla tümleştirilebilir.

3.1 Cocoapods ile Tümleştirme

1. App Center Kilitlenmelerini uygulamanıza eklemek için podfile içine aşağıdaki bağımlılıkları ekleyin. Bu, aşağıdaki çerçeveleri çeker: AppCenter ve AppCenterCrashes.

    pod 'AppCenter/Crashes'
   

2. Komutunu çalıştırarak pod install yeni tanımlanan podunuzu yükleyin ve projenin .xcworkspaceöğesini açın.

Uyarı

tr-TR: [!] Unable to find a specification for `AppCenter` komutunu çalıştırırken pod install gibi bir hata görürseniz, Cocoapods deposundan en son podları almak için pod repo update komutunu çalıştırın ve ardından pod install komutunu çalıştırın.

Uygulamanızda çerçeveleri tümleştirdiğinize göre ARTıK SDK'yı başlatmanın ve App Center hizmetlerinden yararlanmanın zamanı geldi.

3.2 Kartaj Ile Tümleştirme

Bağımlılıklarınızı oluşturan ve size ikili çerçeveler sağlayan merkezi olmayan bir bağımlılık yöneticisi olan Carthage sürüm 0.30 veya üzerini kullanarak App Center SDK'sını Xcode projenizle tümleştirme adımları aşağıda açıklanmaktadır.

1. App Center'ı uygulamanıza Cartfile eklemek için aşağıdaki bağımlılıkları uygulamanıza ekleyin. Bu, tüm çerçeveleri bünyesine katar. Ardından yalnızca uygulamanızda kullanılacak çerçeveleri bağlayabilirsiniz.

   # Use the following line to get the latest version of App Center
   github "microsoft/appcenter-sdk-apple"
   

   # Use the following line to get the specific version of App Center
   github "microsoft/appcenter-sdk-apple" ~> X.X.X
   

2. carthage update'i çalıştırın. Bu işlem bağımlılıkları bir Carthage/Checkouts klasörüne getirir ve sonra her çerçeveyi oluşturur.

3. Uygulama hedefinizin Genel ayarlar sekmesini açın. AppCenter.framework ve AppCenterCrashes.framework dosyalarını Carthage/Build/ klasöründen Xcode'un Proje Gezgini'ne sürükleyip bırakın. SDK'nın başlatılması için AppCenter.framework gereklidir. Projeye eklenmezse diğer modüller çalışmaz ve uygulamanız derlenmez.

4. Bir iletişim kutusu görüntülenir ve uygulama hedefinizin işaretli olduğundan emin olun. Ardından, Son'a tıklayın.

   Uyarı

   carthage copy-frameworks kullanıyorsanız App Center SDK'larını statik çerçeveler olarak gönderildiklerinden oraya eklememelisiniz.

Uygulamanızda çerçeveleri tümleştirdiğinize göre ARTıK SDK'yı başlatmanın ve App Center hizmetlerinden yararlanmanın zamanı geldi.

Swift Paket Yöneticisi aracılığıyla 3.3 Tümleştirmesi

1. Xcode Menüsü'nden Dosya > Swift Paketleri > Paket Bağımlılığı Ekle'ye tıklayın.
2. Görüntülenen iletişim kutusuna depo URL'sini girin: https://github.com/microsoft/appcenter-sdk-apple.git.
3. Sürüm'deSonraki Ana Branş'a Kadar'ı seçin ve varsayılan seçeneği kullanın.
4. Ürün Paketi sütununda ihtiyacınız olan modülleri seçin.

Uygulamanızda çerçeveleri tümleştirdiğinize göre ARTıK SDK'yı başlatmanın ve App Center hizmetlerinden yararlanmanın zamanı geldi.

Uyarı

App Center'ı SwiftPM aracılığıyla tümleştirip uygulamanızın uzantı hedefinde de kullanmak istiyorsanız yapılandırmanızda sağladığınızdan DISABLE_DIAMOND_PROBLEM_DIAGNOSTIC=YES emin olun. Bu, bir modülü birden çok hedefe bağlamak için SwiftPM sınırlamalarından kaçınmak için gereklidir.

3.4 İkili dosyaları projenize kopyalayarak tümleştirme

Uygulama uzantınız için App Center Kilitlenmelerini ayarlamak üzere Xcode projenizdeki derlenmiş ikili dosyaları tümleştirme adımları aşağıda açıklanmıştır.

Uyarı

App Center SDK'sı XCframeworkkullanımını destekler. XCframework'leri projenize tümleştirmek istiyorsanız, sürümler sayfasındanAppCenter-SDK-Apple-XCFramework.zip dosyasını indirin ve zip dosyasını açın. Sonuçta elde edilen klasör içeriği platforma özgü değildir, bunun yerine her modül için XCframeworks içerir. Bunlar, aşağıda açıklandığı gibi her zamanki çerçevelerle aynı şekilde tümleştirilebilir.

1. Zip dosyası olarak sağlanan App Center SDK çerçevelerini indirin.

2. Dosyanın sıkıştırmasını açtığınızda, her platform klasöründeki her App Center hizmeti için farklı çerçeveler içeren AppCenter-SDK-Apple adlı bir klasör görürsünüz. Adlı AppCenter çerçeve, farklı modüller arasında paylaşılan kodu içerdiğinden projede gereklidir.

3. [İsteğe bağlı] 3. taraf kitaplıkları için bir alt dizin oluşturun.

   • En iyi yöntem olarak, 3. taraf kitaplıkları genellikle Genellikle Satıcı olarak adlandırılan bir alt dizinde yer alır. Proje kitaplıklar için bir alt dizinle düzenlenmemişse, şimdi bir Satıcı alt dizini oluşturun.
   • Diskte dosya yapınızı taklit etmek için Xcode projenizde Vendor adlı bir grup oluşturun.

4. Zipten çıkarılmış AppCenter-SDK-Apple klasörünü Finder'da açın ve klasörü istediğiniz konumda projenizin klasörüne kopyalayın. Bu klasör, App Center SDK'sının desteklediği diğer platformların alt klasörlerinde çerçeveler içerdiğinden ihtiyacınız olmayan alt klasörleri silmeniz gerekebilir.

5. SDK çerçevelerini Xcode'da projeye ekleyin:

   • Proje Gezgini'nin görünür olduğundan emin olun (⌘+1).
   • Şimdi AppCenter.framework ve AppCenterCrashes.framework'u Bulucu'dan (önceki adımdaki konumda) Xcode'un Proje Gezgini'ne sürükleyip bırakın. SDK'nın başlatılması için AppCenter.framework gereklidir. Projeye eklenmezse diğer modüller çalışmaz ve uygulama uzantınız derlenmez.
   • Bir iletişim kutusu görüntülenir ve uygulama uzantısı hedefinizin işaretli olduğundan emin olun. Ardından, Son'a tıklayın.

Artık çerçeveleri uygulama uzantınıza tümleştirdiğinize göre ARTıK SDK'yı başlatmanın ve App Center hizmetlerinden yararlanmanın zamanı geldi.

4. SDK'yi başlatın

App Center'ı kullanmak için, kullanmak istediğiniz modül(ler)i seçerek kabul etmeniz gerekir. Varsayılan olarak hiçbir modül başlatılmaz ve SDK'yı başlatırken bunların her birini açıkça çağırmanız gerekir.

4.1 İçeri aktarma deyimlerini ekleme

Uygulama uzantısının giriş noktasını içeren dosyaya aşağıdaki satırları ekleyin. Örneğin, bir Today uzantısının ana ViewController dosyasının içinde.

@import AppCenter;
@import AppCenterCrashes;

import AppCenter
import AppCenterCrashes

4.2 start:withServices: yöntemini ekle

Uygulama uzantısının giriş noktasına aşağıdaki satırı ekleyin. Örneğin, bir Today uzantısının viewDidLoad ana ViewController dosyasının yönteminin içinde.

[MSACAppCenter start:@"{Your App Secret}" withServices:@[[MSACCrashes class]]];

AppCenter.start(withAppSecret: "{Your App Secret}", services: [Crashes.self])

Şu anda uygulama uzantıları için yalnızca kilitlenme raporlaması desteklenmektedir.

4.3 Yer tutucuyu Uygulama Sırrınızla değiştirin

Metni {Your App Secret} uygulama uzantınızın gerçek değeriyle değiştirdiğinizden emin olun. Uygulama Gizli Anahtarı, App Center portalında Başlarken veya Ayarlar sayfasında bulunabilir.

Başlarken sayfasında, uygulama gizli anahtarınızı içeren yukarıdaki kod örneği bulunmaktadır. Kodun tamamını kopyalayıp yapıştırabilirsiniz.

Harika, SDK'nin otomatik olarak topladığı çökme verilerini portaldan görselleştirmeye hazırsınız.

Uygulama uzantınızı özelleştirmeyi ve daha gelişmiş işlevleri kullanmayı öğrenmek için App Center Crashes hakkındaki belgelere bakın.