Başlarken macOS ile yükleme

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'ı kullanmak için uygulamanıza macOS 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:

• macOS projeniz macOS sürüm 10.14.4 veya sonraki sürümlerde Xcode 11 veya sonraki bir sürümde ayarlanır.
• macOS 10.9 veya üzerinde çalışan cihazları hedefleyebilirsiniz.
• Kilitlenme Raporlama işlevi sağlayan başka bir kitaplık kullanmazsanız.

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

App Center SDK Apple Silikon 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. Işletim sistemi olarak macOS 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

macOS App Center SDK'sı Cocoapods, Carthage, Swift Paket Yöneticisi aracılığıyla veya 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, şu çerçeveleri çeker: AppCenter, AppCenterAnalytics ve AppCenterCrashes. Bunun yerine, uygulamanıza hangi hizmetleri kullanmak istediğinizi belirtebilirsiniz. Her hizmetin kendi alt özellisi vardır ve hepsine AppCenter güvenmektedir. Otomatik olarak çekilir.

   # 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. 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ı uygulamanıza Cartfile eklemek App Center ekleyin. Bu, 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. carthage update --platform macOS öğesini çalıştırın. Bu, bağımlılıkları bir Carthage/Checkouts klasörüne getirir ve ardından her çerçeveyi oluşturur.

3. Uygulama hedefinizin Genel ayarlar sekmesini açın. AppCenter.framework, AppCenterAnalytics.framework ve AppCenterCrashes.framework dosyalarını Carthage/Build/macOS 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 Aşamanız'da kullanıyorsanız, statik carthage copy-frameworks ç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

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

   • 3. taraf kitaplıklar genellikle bir alt dizindedir (genellikle Satıcı olarak anlarız), bu nedenle projeniz kitaplıklar için bir alt dizin kullanmıyorsa ş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, SDK'nın desteklediği diğer platformların alt klasörlerini App Center, bu nedenle ihtiyaç olmayan 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'i Bulıcı'dan (Satıcı klasörünün içindekiler) sürükleyip Xcode'un Project Gezgini'ne bırakın. SDK'yı başlatmak için AppCenter.framework gereklidir. Eksikse diğer modüller çalışmaz ve uygulama derlenmiş olmayacaktır.
   • 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 etmek gerekir. Varsayılan olarak hiçbir modül başlamaz ve SDK'yı başlatmanız için her birini çağırmanız gerekir. Bir uzantı için geliştiriyorsanız Uzantı başlarken sayfasına bakın.

4.1 İçeri aktarma 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öntemini start:withServices: ekleme

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

[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 kullanabilirsiniz. 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])

4,4 korumalı uygulamalar için internet özellikleri ekleme

Uygulamanız uygulama korumalı alanını kullanıyorsa, giden (Istemci) bağlantılarına izin ver özelliğini uygulamanın internet 'e erişmesine izin verecek şekilde ayarlamanız gerekir. Xcode 9 varsayılan olarak uygulama korumalı alanı sağlar, ancak giden bağlantılara yönelik yeteneklerin açıkça ayarlanması gerekir.

Proje Gezgini 'nde projenizi seçin, yetenekler sekmesini seçin ve uygulamanız korumalı alanı kullanıyorsa giden bağlantıları etkinleştirin.

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

Her hizmetin gelişmiş özelliklerini özelleştirmeyi ve kullanmayı öğrenmek için App Center Analytics docs ve App Center kilitlenme belgelerine bakın.