iOS’i Kullanmaya Başlama

App Center SDK'sı modüler bir mimari kullandığı için hizmetlerin herhangi birini veya hepsini kullanabilirsiniz.

App Center tarafından toplanan veriler hakkında App Center, Genel Veri Koruma Yönetmeliği ve SSSsayfalarında bulabilirsiniz. Ayrıca SSS bölümü, gizlilik yapılandırmasına yardımcı olmak için App Store içerir.

App Center App Center Analytics ve App Center Kilitlenmelerini kullanmak için uygulamanıza iOS SDK'App Center ayarlamaya başlayın. Uygulamanıza App Center eklemek için Dağıt'a ilişkin belgelere App Center bakın.

1. Önkoşullar

App Center SDK'sı kullanmak için aşağıdaki App Center karşılanmıştır:

• iOS projeniz macOS sürüm 10.14.4 veya sonraki sürümlerde Xcode 11 veya sonraki bir sürümde ayarlanır.
• iOS 9.0 veya üzerinde çalışan cihazları hedefleyebilirsiniz.
• Kilitlenme Raporlama işlevi sağlayan başka bir kitaplık kullanmazsınız (yalnızca App Center Kilitlenmeleri için).
• CocoaPods'u kullanarak tümleştirilmiş App Center CocoaPods sürüm 1.10 veya sonraki bir sürüme ihtiyacınız vardır.

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

2. Uygulama Gizli App Center almak için App Center portalında oluşturun

App Center portalında zaten App Center bu adımı atlayabilirsiniz.

1. appcenter.ms.
2. Kaydol veya oturum açın ve portalın sağ üst köşesindeki Yeni ekle'ye tıklayın ve açılan menüden Yeni uygulama ekle'yi seçin.
3. Uygulamanıza bir ad ve isteğe bağlı bir açıklama girin.
4. iOS'u işletim sistemi olarak ve platform olarak Objective-C/Swift'i seçin.
5. Sağ alttaki Add new app (Yeni uygulama ekle) düğmesine basın.

Bir uygulama oluşturduktan sonra Uygulama Gizli Ayarlar Portal'App Center edinebilirsiniz. Uygulama sayfasının sağ üst köşesindeki üç dikey Ayarlar tıklayın ve Uygulama Gizli Bilginizi Copy app secret almak için öğesini seçin.

3. App Center SDK modüllerini ekleme

iOS App Center SDK'sı Cocoapods, Carthage, Swift Paket Yöneticisiveya ikili dosyaları projenize el ile ekleyerek uygulamanıza eklenebilir.

Cocoapods aracılığıyla 3.1 Tümleştirmesi

1. App Center Analytics ve App Center podfile uygulamanıza eklemek için aşağıdaki bağımlılıkları uygulamanıza ekleyin. Bu eylem şu çerçeveleri çeker: AppCenter, AppCenterAnalytics ve AppCenterCrashes. Bunun yerine, uygulamanıza istediğiniz hizmetleri belirtebilirsiniz. Her hizmetin kendi alt türü vardır ve hepsi AppCenter'a güvenmektedir. Otomatik olarak çekilir.

   # 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'
   

2. Yeni pod install tanımlanan pod'unu yüklemek ve projenin 'ini açmak için .xcworkspace çalıştırın.

Artık uygulamanıza çerçeveleri tümleştirebilirsiniz. Artık SDK'yı başlatmanın ve App Center kullanmanın zamanı geldi.

3.2 Carthage ile tümleştirme

Aşağıda, bağımlılıklarınızı derlemenizi sağlayan ve ikili çerçeveler sağlayan merkezi olmayan bir bağımlılık yöneticisi olan Carthage sürüm 0.30 veya daha yüksek bir sürümünü kullanarak Xcode projenize App Center SDK'sı ile nasıl tümleştirilecek adımları verilmiştir.

1. Aşağıdaki bağımlılıkları kendi bağımlılıklarınızı Cartfile dahil etmek App Center. Bu bağımlılıklar tüm çerçeveleri çeker. Ardından, yalnızca uygulamanıza kullanmak istediğiniz çerçeveleri bağabilirsiniz.

   # 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. Bağımlılıkları carthage update bir Carthage/Checkouts klasörüne getirmek için çalıştırın. Ardından her çerçeveyi derleme.

3. Uygulama hedefinizin Genel ayarlar sekmesini açın. AppCenter.framework, AppCenterAnalytics.framework ve AppCenterCrashes.framework dosyalarını Carthage/Build/iOS klasöründen Xcode'un Project Navigator'a sürükleyip bırakın. SDK'yı başlatmak için AppCenter.framework gereklidir. Projeye eklenmezse, diğer modüller çalışmaz ve uygulama derlemez.

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.

   Not

   Derleme carthage copy-frameworks Aşamanızı kullanıyorsanız, statik çerçeveler olarak App Center BUDK'ları buraya eklemeyin.

Artık uygulamanıza çerçeveleri tümleştirebilirsiniz. Artık SDK'yı başlatmanın ve App Center kullanmanın zamanı geldi.

Swift Paket Yöneticisi üzerinden 3,3 tümleştirmesi

1. Xcode menüsünde dosya > Swift paketleri ' ne tıklayın > paket bağımlılığı ekleyin.
2. Görüntülenen iletişim kutusunda depo URL 'sini girin: https://github.com/microsoft/appcenter-sdk-apple.git .
3. Sürümünde, en fazla bir sonraki ana ' ı seçin ve varsayılan seçeneği uygulayın.
4. Paket ürün sütununda ihtiyacınız olan modülleri seçin.

Artık, uygulamanızdaki çerçeveleri tümleştirmiş olduğunuza göre SDK 'yı başlatıp App Center hizmetlerinden yararlanabilirsiniz.

3.4 Projenize ikili dosyaları kopyalayıp tümleştirme

iOS uygulamanız için App Center Analytics ve App Center Kilitlenmelerini ayarlamak için derlenmiş ikilileri Xcode projenize nasıl tümleştirebilirsiniz?

1. Zip dosyası App Center SDK çerçevelerini indirin.

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

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

   • En iyi uygulama olarak, 3. taraf kitaplıklar genellikle Satıcı olarak adlandırılan bir alt dizindedir. Proje kitaplıklar için bir alt dizinle düzenlenmse şimdi bir Vendor alt dizini oluşturun.
   • Diskte dosya yapınızı taklit etmek için Xcode projenizin içinde Vendor adlı bir grup oluşturun.

4. Finder'da sıkıştırması açılmamış AppCenter-SDK-Apple klasörünü açın ve klasörü istediğiniz konumda projenizin klasörüne kopyalayın. klasör, App Center SDK'nın desteklediği diğer platformlar için alt klasörlerde çerçeveler içerir, bu nedenle ihtiyacınız olan alt klasörleri silmeniz gerekebilir.

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

   • Gezgin'in Project (⌘+1) olduğundan emin olun.
   • Şimdi & AppCenter.framework, AppCenterAnalytics.framework ve AppCenterCrashes.framework'leri Finder'dan Xcode'un Project Navigator'a sürükleyin. SDK'yı başlatmak için AppCenter.framework gereklidir. Projeye eklenmezse, diğer modüller çalışmaz ve uygulama derlemez.
   • Bir iletişim kutusu görüntülenir ve uygulama hedefinizin işaretli olduğundan emin olun. Ardından, Son'a tıklayın.

Artık uygulamanıza çerçeveleri tümleştirebilirsiniz. Artık SDK'yı başlatmanın ve App Center kullanmanın zamanı geldi.

4. SDK'yı başlatma

Bu App Center kullanmak için kullanmak istediğiniz modülleri kabul edersiniz. Varsayılan olarak, hiçbir modül başlamaz ve SDK'yı başlatmanız için 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 kullanabilirsiniz: "Swift UI Uygulaması" (Xcode 12'de varsayılan olarak seçilidir) ve "UI Kit AppDelegate". Xcode 11 veya daha düşük bir değer kullanıyorsanız UI Kit AppDelegate yaşam döngüsü kullanıyorsanız. Bir uzantı için geliştiriyorsanız Uzantı başlarken 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 Uygulama 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 Yöntemini start:withServices: ekleme

UI Kit AppDelegate

Temsilci yöntemine başlatma didFinishLaunchingWithOptions kodu ekleyin.

Swift UI Uygulaması yaşam döngüsü

içine init() yöntemi oluşturun ve içine başlatma kodu struct ekleyin.

SDK'yı başlatmak için bu kodu daha önce açıklanan yöntemlerde kullanın:

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

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

Katalizör uygulama varsa, hem iOS hem de macOS için uygulama gizli dizilerini aynı anda geçebilirsiniz:

[MSACAppCenter start:@"ios={Your iOS App Secret};macos={Your macOS App Secret}" withServices:@[[MSACAnalytics class], [MSACCrashes class]]];

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

Hizmetleri ayrı olarak App Center gerekirse:

1. Uygulama Gizli Gizli'yi yapılandırarak veya başlatabilirsiniz.
2. Kod birden çok kez çağrılabilirse, uygulamanın App Center olup ola bir kontrol edin.
3. App Secret olmadan gerekli hizmetleri başlatma.

[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 tutucusunu App Secret'iniz ile değiştirin

Metni, {Your App Secret} uygulamanıza uygun gerçek değerle değiştir mutlaka kullanın. Uygulama Gizli Başlarken sayfasında veya Ayarlar portalında App Center bulunabilir.

Aşağıdaki Başlarken app secret kodunuz içeren yukarıdaki kod örneğini içerir; örneğin tamamını kopyalayıp yapıştırabilirsiniz.

Yukarıdaki örnekte , ( Swift için) yönteminin nasıl ve hem App Center Analytics hem start:withServices start(withAppSecret:services:) de App Center Kilitlenmeleri'nin nasıl App Center gösterir.

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

Her modülü başlangıç yönteminde parametre olarak açıkça belirtmedikçe, bu modülü App Center kullanaabilirsiniz. Ayrıca , ( Swift için) API'si, uygulamanın yaşam döngüsünde yalnızca bir kez kullanılabilir. Diğer tüm çağrılar konsolda bir uyarı günlüğe kaydedilir ve yalnızca ilk çağrıya dahil edilen start:withServices start(withAppSecret:services:) modüller kullanılabilir.

Örneğin- App Center Analytics'e ekleme yapmak için ( Swift start:withServices start(withAppSecret:services:) için) API çağrısını aşağıdaki gibi değiştirmeniz gerekir:

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

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

Harika, sdk'nın otomatik olarak toplayan portalda Analytics ve Kilitlenme verilerini görselleştirmek için hazırsınız.

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

Uygulama güncelleştirmeleri ile çalışmaya başlamayı öğrenmek için Dağıt'ın App Center okuyun.