Diğer tvOS API'leri
Ö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.
Konsolunda App Center'dan görünen günlük iletilerinin miktarını denetleyebilirsiniz. Hata ayıklama sırasında setLogLevel:
ek günlüğe kaydetmeyi etkinleştirmek için -API kullanın. Varsayılan olarak, App Store ortamı için olarak ayarlanır LogLevelAssert
ve LogLevelWarning
aksi halde ayarlanır.
Mümkün olduğunca çok günlük iletisine sahip olmak için kullanın MSACLogLevelVerbose
/LogLevel.verbose
.
[MSACAppCenter setLogLevel:MSACLogLevelVerbose];
AppCenter.logLevel = .verbose
Uygulama yüklendikten sonra App Center SDK'sı her cihaz için bir UUID oluşturur. Bu tanımlayıcı, uygulama güncelleştirildiğinde cihaz için aynı kalır ve yalnızca uygulama yeniden yüklendiğinde yeni bir tanımlayıcı oluşturulur. Aşağıdaki API, hata ayıklama amacıyla yararlıdır.
NSUUID *installId = [MSACAppCenter installId];
var installId = AppCenter.installId
App Center SDK'sı, kilitlenme raporlarını artırmak için kullanılan bir kullanıcı kimliği ayarlamayı destekler. Bu özelliği kullanmak için:
- App Center SDK'sını, App Center SDK'sı Başlarken kılavuzunda açıklandığı gibi çağırarak
:start:withServices:
yapılandırın. - Aşağıdaki kodu kullanarak SDK'da bir
userID
ayarlayın:
[MSACAppCenter setUserId:@"your-user-id"];
AppCenter.userId = "your-user-id"
Kullanıcı kimliği ayarladıktan sonra, kimliğin belirli kilitlenme raporlarını aramak için App Center'ın arama özelliğini kullanabilirsiniz. App Center'ın arama belgelerinde daha fazla bilgi edinin.
Not
Kullanıcı kimliği değeri 256 karakterle sınırlıdır. Kilitlenme raporlarınızla birlikte gösterilir, ancak etkilenen kullanıcıların toplama veya sayılarında kullanılmaz. Kullanıcı kimliğini birden çok kez ayarlamanız durumunda, yalnızca son kullanıcı kimliği kullanılır. Bu değer SDK tarafından başlatmalar arasında depolanmadığından, her uygulama başlatılmadan önce kullanıcı kimliğini kendiniz ayarlamanız gerekir.
Tüm App Center hizmetlerini aynı anda devre dışı bırakmak istiyorsanız API'yi setEnabled
kullanın. Devre dışı bırakıldığında SDK, App Center'a herhangi bir bilgi iletmez.
[MSACAppCenter setEnabled:NO];
AppCenter.enabled = false
Tüm hizmetleri bir kerede etkinleştirmek için aynı API'yi kullanın ancak parametre olarak geçirin YES
/true
.
[MSACAppCenter setEnabled:YES];
AppCenter.enabled = true
Durum, uygulama başlatmaları arasında cihazın depolama alanında kalıcı hale getirilir.
Not
Bu yöntem yalnızca başlatıldıktan sonra AppCenter
kullanılmalıdır.
App Center SDK'sında ağ isteklerine varsayılan olarak izin verilir. App Center SDK'sının kullanıcı endişesi tarafından topladığı verileri göndermek istiyorsanız, otomatik veri göndermeye izin verilmiyebilirsiniz.
[MSACAppCenter setNetworkRequestsAllowed:false];
AppCenter.networkRequestsAllowed = false
Bu durumda App Center SDK'sı veri toplamaya devam eder ancak yalnızca ağ isteklerine izin verildiğinde gönderilir.
[MSACAppCenter setNetworkRequestsAllowed:true];
AppCenter.networkRequestsAllowed = true
Not
Bu değer başlangıçlar arasında korunur.
İstediğiniz zaman App Center SDK'sında veri göndermeye izin verilip verilmeyeceğini de kontrol edebilirsiniz.
[MSACAppCenter isNetworkRequestsAllowed];
AppCenter.networkRequestsAllowed
Aşağıdaki kodla çalışma zamanında hizmetleri etkinleştirin veya devre dışı bırakın:
[MSACAnalytics setEnabled:NO];
Analytics.enabled = false
Not
Bu yöntem yalnızca başlatıldıktan sonra Analytics
kullanılmalıdır.
App Center'ın etkinleştirilip etkinleştirilmediğini de de de kontrol edebilirsiniz.
[MSACAppCenter isEnabled];
AppCenter.enabled
Not
Bu yöntem yalnızca başlatıldıktan sonra AppCenter
kullanılmalıdır; her zaman başlamadan önce döndürülecektir false
.
Şu anda kullanmakta olduğunuz App Center SDK sürümünü alabilirsiniz.
[MSACAppCenter sdkVersion];
AppCenter.sdkVersion
App Center SDK'sı kullanılırken günlükler cihazda yerel olarak depolanır. Büyük günlükler çok fazla yer kaplayabilir, bu nedenle yerel veritabanının boyutunu sınırlamayı seçebilirsiniz. Ayrıca ve resume
API'leriyle pause
birlikte de kullanışlıdır. Uzun süre duraklatılmayı bekliyorsanız, daha fazla olay depolamak için daha büyük bir veritabanı boyutu kullanabilirsiniz.
setMaxStorageSize
Yerel veritabanı boyutunu ayarlamak için API'yi kullanın. API zaman uyumsuzdur ve completionHandler
App Center hizmetlerini başlattığınızda çağrılır. Bu nedenle, setMaxStorageSize
çağrısınızdan önce çağrılmalıdır AppCenter.start
. API'yi yalnızca bir kez çağırabilirsiniz.
// Use 20 MB for storage.
[MSACAppCenter setMaxStorageSize:(20 * 1024 * 1024) completionHandler:^(BOOL success) {
if (!success) {
// The success parameter is false when the size can't be honored.
}
}];
[MSACAppCenter start:@"{Your App Secret}", withServices:@[[MSACAnalytics class]]];
// Use 20 MB for storage.
AppCenter.setMaxStorageSize(20 * 1024 * 1024, completionHandler: { (success) in
if !success {
// The success parameter is false when the size can't be honored.
}
})
AppCenter.start(withAppSecret: "{Your App Secret}", services:[Analytics.self])
Maksimum depolama boyutunu ayarlamazsanız SDK varsayılan maksimum 10 MB boyutunu kullanır. Ayarlamanıza izin verilen en küçük boyut 20 KB'tır.
Not
Gerçek maksimum depolama boyutu, seçtiğiniz değerden biraz daha yüksek olabilir. SQLite, sayfa boyutunun sonraki katına kadar boyutu yuvarlar. App Center SDK'sı 4 KB sayfa boyutu kullanır.
Not
25 günden eski günlükler atılır.
Çağrının false döndürmesinin completionHandler
birçok nedeni vardır.
- Belirtilen boyut geçersiz bir değer (20 KB'tan küçük veya 140 TB'tan büyük).
- Geçerli veritabanı boyutu belirtilen en büyük boyuttan daha büyük.
- API zaten çağrıldı. İşlem başına yalnızca bir kez yapılandırabilirsiniz.
- API, veya
AppCenter.configure
sonrasındaAppCenter.start
çağrıldı.
Yapılandırma sorunlarını gidermek için günlük etiketini kullanarak AppCenter
konsoldaki uyarıları ve hataları de kontrol edebilirsiniz.