macOS kullanmaya başlama

Makale
06/12/2023

Önemli

Visual Studio App Center 31 Mart 2025'te kullanımdan kaldırılıyor. Tamamen kullanımdan kaldırılana kadar Visual Studio App Center'ı kullanmaya devam edebilirsiniz ancak geçiş yapmayı düşünebileceğiniz birkaç önerilen alternatif vardır.

Destek zaman çizelgeleri ve alternatifleri hakkında daha fazla bilgi edinin.

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

Uygulamanızda App Center Analytics ve App Center Kilitlenmelerini kullanmak için 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 sonraki sürümlerde Xcode 13 veya sonraki bir sürümde ayarlanmıştır.
macOS 10.13 veya sonraki sürümlerde çalışan cihazları hedefliyorsunuz.
Kilitlenme Raporlama işlevselliği sağlayan başka bir kitaplık kullanmıyorsunuz.

Not

App Center SDK, Haziran SDK sürümüyle birlikte Xcode 10 desteğini bırakacaktır .

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

App Center SDK' sı Apple Silicon ile uyumludur.

2. Uygulama Gizli Dizisini almak için uygulamanızı App Center Portalı'nda oluşturun

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 macOS'yi 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 Uygulama Gizli Dizinizi almak için seçinCopy app secret.

3. App Center SDK modüllerini ekleme

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

Not

4.0.0 App Center sürümünde hataya neden olan değişiklikler kullanıma sunulmuştur. 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

Uygulamanıza podfile App Center Analytics ve App Center Kilitlenmeleri eklemek için aşağıdaki bağımlılıkları ekleyin. Bu, aşağıdaki çerçeveleri çeker: AppCenter, AppCenterAnalytics ve AppCenterCrashes. Bunun yerine, uygulamanızda hangi hizmetleri kullanmak istediğinizi belirtebilirsiniz. Her hizmetin kendi alt türü vardır ve hepsi öğesine güvenir AppCenter. 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'
```
Komutunu çalıştırarak pod install yeni tanımlanan podunuzu yükleyin ve projenin .xcworkspaceöğesini açın.

Artık uygulamanızda çerçeveleri tümleştirdiğinize göre, 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ğıdadır.

Uygulamanıza Cartfile App Center eklemek için aşağıdaki bağımlılıkları uygulamanıza ekleyin. Bu, tüm çerçeveleri ç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
```
carthage update --platform macOS öğesini çalıştırın. Bu işlem bağımlılıkları bir Carthage/Checkouts klasörüne getirir ve ardından her çerçeveyi oluşturur.
Uygulama hedefinizin Genel ayarlar sekmesini açın. AppCenter.framework, AppCenterAnalytics.framework ve AppCenterCrashes.framework dosyalarını Carthage/Build/macOS 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.

Not

Derleme Aşamanızda kullanıyorsanız carthage copy-frameworks App Center SDK'larını statik çerçeveler olarak gönderildikleri için oraya eklememelisiniz.

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

3.3 Swift Paket Yöneticisi aracılığıyla tümleştirme

Xcode menüsünde 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 Seçeneğe Kadar'ı seçin ve varsayılan seçeneği kullanın.
Ürün Paketi sütununda ihtiyacınız olan modülleri seçin.

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

Not

App Center'ı SwiftPM aracılığıyla tümleştiriyorsanız ve 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ğlamada SwiftPM sınırlamalarından kaçınmak için gereklidir.

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

Aşağıda, macOS uygulamanız için App Center Analytics ve App Center Kilitlenmelerini ayarlamak üzere Xcode projenizdeki derlenmiş ikili dosyaları tümleştirme adımları yer almaktadır.

Not

App Center SDK'sı XCframeworkkullanımını destekler. XCframeworks'i projenizle tümleştirmek istiyorsanız yayınlar sayfasındanAppCenter-SDK-Apple-XCFramework.zip indirin ve sıkıştırması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ı] Üçüncü taraf kitaplıkları için bir alt dizin oluşturun.
- Üçüncü taraf kitaplıkları genellikle bir alt dizindedir (genellikle Vendor olarak adlandırılır), 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 projenizde Vendor adlı bir grup oluşturun.
Açılan AppCenter-SDK-Apple klasörünü Bulucu'da açın ve klasörü projenizin istediğiniz konumdaki klasörüne kopyalayın. Bu klasör, App Center SDK'sının desteklediği diğer platformlar için alt klasörlerde çerçeveler içerir, bu nedenle gereksiz 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 AppCenter.framework, AppCenterAnalytics.framework ve AppCenterCrashes.framework'i Bulucu'dan ( Vendor klasörünün içindekiler) Xcode'un Proje Gezgini'ne sürükleyip bırakın. SDK'nın başlatılması için AppCenter.framework gereklidir. Eksikse 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.

Not

SDK ikili dosyası macOS çerçeve kuralına göre paketlenmemiş. Bunun nedeni, Mac için App Center SDK'sının geleneksel bir çerçeve değil statik bir çerçeve olmasıdır. Bunu statik bir çerçeve olarak bağlamanız gerekir: İkili dosyaları eklemediğinizden ve bunları "paket kaynaklarını kopyalama" derleme aşamasına eklemediğinizden emin olun.

Artık 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 etmeniz gerekir. Varsayılan olarak hiçbir modül başlatılmaz ve SDK'yı başlatırken her birini çağırmanız gerekir. 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ı 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 ekleme `start:withServices:`

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

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

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

Catalyst uygulamanız varsa hem iOS hem de macOS için uygulama gizli dizilerini aynı anda geçirebilirsiniz:

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

Uyarı

Uygulama Gizli Dizinizi kaynak koduna eklemeniz önerilmez.

App Center hizmetlerini ayrı olarak başlatmanız gerekiyorsa şunları yapmalısınız:

Uygulama Gizli Dizisi'ni 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 Gizli Dizinizle değiştirme

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

Başlarken sayfası, uygulama gizli dizinizin bulunduğu yukarıdaki kod örneğini içerir; örneğin tamamını kopyalayıp yapıştırabilirsiniz.

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

İ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 belirtmediğiniz sürece, bu App Center hizmetini kullanamazsınız. Ayrıca ( start:withServicesstart(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'e eklemek istiyorsanız, (start(withAppSecret:services:) Swift için) API çağrısını start:withServices 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 (İstemci) bağlantıların uygulamanın İnternet erişimine izin verme özelliğini ayarlamanız gerekir. Xcode 9, Uygulama Korumalı Alanı'nı varsayılan olarak etkinleştirir, ancak giden bağlantılara yönelik özelliklerin açıkça ayarlanması gerekir.

Proje gezgininde projenizi seçin, Özellikler sekmesini seçin ve uygulamanız korumalı alanı kullanıyorsa giden bağlantıları etkinleştirin.

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

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

Aracılığıyla paylaş

macOS kullanmaya başlama

1. Önkoşullar

2. Uygulama Gizli Dizisini almak için uygulamanızı App Center Portalı'nda oluşturun

3. App Center SDK modüllerini ekleme

3.1 Cocoapods ile Tümleştirme

3.2 Kartaj Ile Tümleştirme

3.3 Swift Paket Yöneticisi aracılığıyla tümleştirme

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

4. SDK'yi başlatın

4.1 İçeri aktarma deyimlerini ekleme

4.2 Yöntemini ekleme `start:withServices:`

4.3 Yer tutucuyu Uygulama Gizli Dizinizle değiştirme

4.4 Korumalı uygulamalar için internet özellikleri ekleme

Ek kaynaklar

Aracılığıyla paylaş

macOS kullanmaya başlama

1. Önkoşullar

2. Uygulama Gizli Dizisini almak için uygulamanızı App Center Portalı'nda oluşturun

3. App Center SDK modüllerini ekleme

3.1 Cocoapods ile Tümleştirme

3.2 Kartaj Ile Tümleştirme

3.3 Swift Paket Yöneticisi aracılığıyla tümleştirme

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

4. SDK'yi başlatın

4.1 İçeri aktarma deyimlerini ekleme

4.2 Yöntemini ekleme start:withServices:

4.3 Yer tutucuyu Uygulama Gizli Dizinizle değiştirme

4.4 Korumalı uygulamalar için internet özellikleri ekleme

Ek kaynaklar

4.2 Yöntemini ekleme `start:withServices:`