iOS ile Çalışmaya Başlama

2025-05-05

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

App Center SDK'sı modüler bir mimari kullanır, böylece hizmetlerin herhangi birini veya tümünü kullanabilirsiniz.

App Center SDK'ları tarafından Toplanan Veriler, Genel Veri Koruma Yönetmeliği ve SSS sayfalarında App Center tarafından toplanan veriler hakkında bilgi bulabilirsiniz. Ayrıca SSS , App Store gizlilik yapılandırması için sağlamanız gereken yanıtları içerir.

Şimdi App Center Analytics ve App Center Hatalarını kullanmak için uygulamanızda App Center iOS SDK'sını kurmaya başlayalım. Uygulamanıza App Center Distribute eklemek için App Center Distribute belgelerine bakın.

1. Önkoşullar

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

iOS projeniz macOS sürüm 10.14.4 veya sonraki sürümlerde Xcode 13 veya sonraki bir sürümde ayarlanmıştır.
ios 11.0 veya sonraki sürümlerde çalışan cihazları hedeflisiniz.
Kilitlenme Raporlama işlevselliği sağlayan başka bir kitaplık kullanmıyorsunuz (yalnızca App Center Kilitlenmeleri için).
App Center'ı tümleştirmek için CocoaPods kullanıyorsanız CocoaPods sürüm 1.10 veya üzeri gerekir.

App Center SDK Analizi ve Kilitlenmeleri, XCFramework veya SwiftPM aracılığıyla Mac Catalyst ile uyumludur.

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.

appcenter.ms gidin.
Kaydolun veya oturum açın ve portalın sağ üst köşesindeki Yeni ekle ifadesinin yer aldığı mavi düğmeye basın ve açılan menüden Yeni uygulama ekle'yi seçin.
Uygulamanız için bir ad ve isteğe bağlı bir açıklama girin.
İşletim sistemi olarak iOS'u ve platform olarak Objective-C/Swift'i seçin.
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 noktaya tıklayın ve Copy app secret almak için seçin.

3. App Center SDK modüllerini ekleme

iOS için App Center SDK'sı Cocoapods, Carthage, Swift Paket Yöneticisi aracılığıyla veya ikili dosyaları projenize el ile ekleyerek uygulamanıza eklenebilir.

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.1 Cocoapods ile Tümleştirme

Uyarı

ARM64 Simülatörleri (Apple Silicon Mac üzerinde çalışan Xcode'dan başlatıldığında) CocoaPods aracılığıyla desteklenmez, çalışması için diğer tümleştirme yöntemlerini kullanmayı göz önünde bulundurun.

Uygulamanıza App Center Analytics ve App Center Çöküşleri eklemek için aşağıdaki bağımlılıkları podfile bileşeninize ekleyin. Bu eylem şu çerçeveleri çeker: AppCenter, AppCenterAnalytics ve AppCenterCrashes. Bunun yerine, uygulamanızda istediğiniz hizmetleri belirtebilirsiniz. Her hizmetin kendi alt türü vardır ve hepsi AppCenter'e güvenir. Otomatik olarak içeri alınacak.
```
 # Use the following line to use App Center Analytics and Crashes.x
 pod 'AppCenter'

 # Use the following lines if you want to specify which service you want to use.
 pod 'AppCenter/Analytics'
 pod 'AppCenter/Crashes'
 pod 'AppCenter/Distribute'
```
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.

Uyarı

Xcode 12'de Carthage tümleştirmesi kutudan çıkar çıkmaz çalışmaz. Çalışması için bu Carthage yönergesine başvurun

App Center'ı dahil etmek için aşağıdaki bağımlılıkları ekleyin Cartfile . Bu bağımlılıklar tüm frameworkleri kendine çeker. Ardından yalnızca uygulamanızda kullanmak istediğiniz ç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
```
Bağımlılıkları bir carthage update klasörüne getirmek için komutunu çalıştırın. Ardından her çerçeveyi oluşturun.
Uygulama hedefinizin Genel ayarlar sekmesini açın. AppCenter.framework, AppCenterAnalytics.framework ve AppCenterCrashes.framework dosyalarını Carthage/Build/iOS 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.
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

Xcode Menüsü'nden Dosya > Swift Paketleri > Paket Bağımlılığı Ekle'ye tıklayın.
Görüntülenen iletişim kutusuna depo URL'sini girin: https://github.com/microsoft/appcenter-sdk-apple.git.
Sürüm'deSonraki Ana Branş'a Kadar'ı seçin ve varsayılan seçeneği kullanın.
Ü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

Aşağıda, iOS uygulamanız için App Center Analytics ve App Center Crashes'ı ayarlamak üzere Xcode projenize derlenmiş ikili dosyaları entegre etme adımları yer almaktadı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.

Zip dosyası olarak sağlanan App Center SDK çerçevelerini indirin.
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.
[İ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.
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.
SDK çerçevelerini Xcode'da projeye ekleyin:
- Proje Gezgini'nin görünür olduğundan emin olun (⌘+1).
- Şimdi Bulucu'dan (önceki adımdaki konumda) AppCenter.framework, AppCenterAnalytics.framework ve AppCenterCrashes.framework'ü 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.
- Bir iletişim kutusu görüntülenir ve uygulama hedefinizin işaretli olduğundan emin olun. Ardından, Son'a tıklayı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.

4. SDK'yi başlatın

App Center'ı kullanmak için, kullanmak istediğiniz modülleri kabul edin. Varsayılan olarak, hiçbir modül başlatılmaz ve SDK'yı başlatırken her birini çağırmanız gerekir.

Aşağıdaki yönergeler, kullandığınız yaşam döngüsüne bağlı olarak biraz farklıdır. Xcode 12'den başlayarak iki yaşam döngüsünden birini seçebilirsiniz: "Swift UI App" (Xcode 12'de varsayılan olarak seçilidir) ve "UI Kit AppDelegate". Bir uzantı için geliştiriyorsanız Uzantıyı kullanmaya başlama sayfasına bakın.

4.1 İçeri aktarma deyimlerini ekleme

Projenin AppDelegate dosyasını (UI Kit AppDelegate yaşam döngüsü için) veya <ProjectName>App.swift dosyasını (Swift UI Uygulaması yaşam döngüsü için) açın ve aşağıdaki içeri aktarma deyimlerini ekleyin:

@import AppCenter;
@import AppCenterAnalytics;
@import AppCenterCrashes;

import AppCenter
import AppCenterAnalytics
import AppCenterCrashes

4.2 `start:withServices:` yöntemini ekle

UI Kit AppDelegate

Temsilci yöntemine didFinishLaunchingWithOptions başlatma kodu ekleyin:

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

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

Swift Kullanıcı Arabirimi Uygulaması yaşam döngüsü

App Center SDK'sının Swift kullanıcı arabirimiyle düzgün çalıştığından emin olmak için kullanıcı arabirimi yüklendikten sonra başlatın. Bunu yapmanın en basit yolu UIApplicationDelegate kullanmaktır:

class AppDelegate: NSObject, UIApplicationDelegate {
    func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey : Any]? = nil) -> Bool {
          AppCenter.start(withAppSecret: "{Your App Secret}", services:[
            Crashes.self, Analytics.self, Distribute.self])
        return true
    }
}

Ardından UIApplicationDelegateAdaptor içinde struct kullanın.

@main
struct YourAppName: App {

  @UIApplicationDelegateAdaptor(AppDelegate.self) var appDelegate

    var body: some Scene {
        WindowGroup {
            ContentView()
        }
    }
}

Catalyst uygulamanız varsa hem iOS hem de macOS için uygulama sırlarını aynı anda iletebilirsiniz.

AppCenter.start(withAppSecret:"ios={Your iOS App Secret};macos={Your macOS App Secret}", services: [Analytics.self, Crashes.self])

Uyarı

Uygulama Sırrınızı kaynak koduna yerleştirmek önerilmez.

App Center hizmetlerini ayrı olarak başlatmanız gerekiyorsa şunları yapmanız gerekir:

Uygulama Gizli Anahtarı ile yapılandırın veya başlatın.
Kod birden çok kez çağrılabiliyorsa App Center'ın zaten yapılandırılmış olup olmadığını denetleyin.
Uygulama Gizli Anahtarı olmadan gerekli hizmetleri başlatın.

[MSACAppCenter configureWithAppSecret:@"{Your App Secret}"];
if ([MSACAppCenter isConfigured]) {
   [MSACAppCenter startService:[MSACAnalytics class]];
   [MSACAppCenter startService:[MSACCrashes class]];
}

AppCenter.configure(withAppSecret: "{Your App Secret}")
if AppCenter.isConfigured {
    AppCenter.startService(Analytics.self)
    AppCenter.startService(Crashes.self)
}

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

{Your App Secret} metnini uygulamanız için gerçek değerle 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.

Yukarıdaki örnek, start:withServices (start(withAppSecret:services:) Swift için) yönteminin yanı sıra App Center Analytics ve App Center Kilitlenmeleri'nin nasıl kullanılacağını göstermektedir.

İki hizmetten birini kullanmak istemiyorsanız yukarıdaki yöntem çağrısından ilgili parametreyi kaldırın.

Başlangıç yönteminde her modülü parametre olarak açıkça belirtmediğiniz sürece, bu App Center hizmetini kullanamazsınız. start:withServices Ayrıca (start(withAppSecret:services:) Swift için) API'si uygulamanızın yaşam döngüsünde yalnızca bir kez kullanılabilir. Diğer tüm çağrılar konsola bir uyarı kaydeder ve yalnızca ilk çağrıda yer alan modüller kullanılabilir.

Örneğin - App Center Analytics'i kullanmaya başlamak istiyorsanız, API çağrısını start:withServices şu şekilde değiştirmeniz gerekir (start(withAppSecret:services:) Swift için):

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

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

Harika, SDK'nın otomatik olarak topladığı portalda Analytics ve Crashes verilerini görselleştirmeye hazırsınız.

Her iki hizmetin daha gelişmiş işlevlerini özelleştirmeyi ve kullanmayı öğrenmek için App Center Analytics belgelerine ve App Center Çökme belgelerine bakın.

Uygulama içi güncelleştirmeleri kullanmaya başlamayı öğrenmek için App Center Distribute belgelerini okuyun.

Aracılığıyla paylaş

iOS ile Çalışmaya Başlama

1. Önkoşullar

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

3. App Center SDK modüllerini ekleme

3.1 Cocoapods ile Tümleştirme

3.2 Kartaj Ile Tümleştirme

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

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

4. SDK'yi başlatın

4.1 İçeri aktarma deyimlerini ekleme

4.2 start:withServices: yöntemini ekle

UI Kit AppDelegate

Swift Kullanıcı Arabirimi Uygulaması yaşam döngüsü

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

Geri Bildirim

Ek kaynaklar

4.2 `start:withServices:` yöntemini ekle