tvOS Başla ile birlikte

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

App Center App Center Analytics ve App Center'leri kullanmak için uygulamanıza tvOS SDK'App Center ayarlamaya başlayın.

1. Önkoşullar

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

• tvOS'niz tvOS sürüm 11 veya sonraki sürümlerde Xcode 11 veya sonraki bir sürümde ayarlanır.
• Kilitlenme Raporlama işlevi sağlayan başka bir kitaplık kullanmazsanız.

2. Uygulama Gizli App Center almak için App Center Portal'da 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. Işletim sistemi olarak tvOS'u 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 App Center Portal'ın Ayarlar sayfasından edinebilirsiniz. Ayarlar sayfasının sağ üst köşesinde üç dikey noktaya tıklayın ve App Copy app secret Secret'inizi almak için öğesini seçin.

3. App Center SDK modüllerini ekleyin

TvOS için App Center SDK, uygulamanıza Cocoapods, Carthage, Swift Paket Yöneticisi aracılığıyla veya ikili dosyaları projenize el ile ekleyerek tümleştirilebilen.

Cocoapods aracılığıyla 3,1 tümleştirmesi

1. Uygulamanıza podfile App Center analizlerini ve App Center kilitlenmeleri dahil etmek için aşağıdaki bağımlılıkları ekleyin. Bu, şu çerçeveleri çeker: AppCenter, Appcenteranalytics ve appcenterkilitleniyor. Bunun yerine, uygulamanızda kullanmak istediğiniz hizmetleri belirtebilirsiniz. Her hizmet kendi alt belirtimine sahiptir ve bunların tümü kullanır AppCenter . Otomatik olarak çekilmeyecektir.

   # Use the following line to use App Center Analytics and Crashes.
   pod 'AppCenter'
   
   # Use the following lines if you want to specify which service you want to use.
   pod 'AppCenter/Analytics'
   pod 'AppCenter/Crashes'
   

2. pod installYeni tanımlanmış Pod 'nizi yüklemek ve projenin ' i açmak için öğesini çalıştırın .xcworkspace .

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

Carthage aracılığıyla 3,2 tümleştirmesi

Aşağıda, bağımlılıklarınızı oluşturan ve ikili çerçeveler sağlayan merkezi olmayan bir bağımlılık Yöneticisi olan Carthage sürüm 0,30 veya üstünü kullanarak XCODE projenizde App Center SDK 'yı tümleştirme adımları verilmiştir.

1. Uygulamanıza Cartfile App Center analizlerini ve App Center kilitlenmeleri dahil etmek için aşağıdaki bağımlılıkları ekleyin.

   # 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 --platform tvOS öğesini çalıştırın. Bu, bağımlılıkları bir Carthage/checmalar klasörüne getirir ve sonra her bir çerçeveyi oluşturur.

3. Uygulama hedefinin genel ayarlar sekmesini açın. AppCenter. Framework, appcenteranalytics. Framework ve appcentercrash. Framework dosyalarını Carthage/Build/tvOS klasöründen Xcode 'un proje Gezgininden sürükleyip bırakın. SDK 'Yı başlatmak için AppCenter. Framework gereklidir. Projeye eklenmemişse, 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.

   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

Aşağıda, tvOS uygulamanıza App Center Analytics ve App Center Kilitlenmeleri 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ı AppCenter modüller arasında paylaşılan kodu içerdiği için adlı ç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 bir alt dizinin içindedir (genellikle Satıcı olarak da anilir), bu nedenle projeniz kitaplıklar için bir alt dizinle düzenlenmiş yoksa ş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örde, App Center SDK'nın desteklediği diğer platformlar için alt klasörlerde çerçeveler bulunur, bu nedenle ihtiyacınız olan 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, AppCenterAnalytics.framework ve AppCenterCrashes.framework'i Finder'dan (Satıcı klasörünün içindekiler) sürükleyip Xcode'un Proje Gezgini'ne bırakın. SDK 'Yı başlatmak için AppCenter. Framework gereklidir, projenize eklendiğinden emin olun, aksi takdirde diğer modüller çalışmaz ve uygulamanız derlenmez.
   • Bir iletişim kutusu görünür, uygulama hedeflerinizin işaretli olduğundan emin olun. Ardından, Son'a tıklayın.

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

4. SDK 'Yı başlatın

App Center kullanmak için, kullanmak istediğiniz modüller (ler) i 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 import deyimlerini ekleme

Projenin Appdelegate dosyasını 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öntemi ekleme start:withServices:

Uygulamanın temsilci yöntemine aşağıdaki satırı ekleyin didFinishLaunchingWithOptions :

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

AppCenter.start(withAppSecret: "{Your 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 uygulamanızın gizli anahtarı ile değiştirin

{Your App Secret}Metninizi uygulamanızın gerçek değeri ile değiştirdiğinizden emin olun. Uygulama gizli anahtarı, App Center portalındaki Başlarken sayfası veya ayarları sayfasında bulunabilir.

Başlarken sayfası, uygulama gizli anahtarı ile birlikte yukarıdaki kod örneğini içerir. tüm örneği kopyalayabilir ve yapıştırabilirsiniz.

Yukarıdaki örnekte, start:withServices ( start(withAppSecret:services:) Swift için) yönteminin nasıl kullanılacağı ve hem App Center analizlerinin hem de App Center kilitlenmelerin nasıl dahil olduğu gösterilmektedir.

İki hizmetten birini kullanmak istemiyorsanız, Yukarıdaki yöntem çağrısından karşılık gelen parametreyi kaldırın.

Her modülü start yönteminde parametre olarak belirtmediğiniz sürece bu App Center hizmetini kullanamazsınız. 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 hizmette de daha gelişmiş işlevleri özelleştirmeyi ve kullanmayı öğrenmek App Center Analytics ve App Center Kilitlenmeleri belgelerine bakın.