HockeySDK'den Unity için App Center SDK'sına geçiş
Ö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.
Uygulamanızı HockeySDK yerine App Center SDK'sını kullanacak şekilde güncelleştirmek istiyorsanız bu belgeleri izleyin.
1. Kitaplıkları güncelleştirme
1.1 Eski HockeySDK'yi kaldırın
SDK için oluşturduğunuz oyun nesnesini seçin ve Ayarlar simgesine > Bileşeni Kaldır'a tıklayarak bileşeni kaldırın /
HockeyAppAndroidHockeyAppiOS.HockeyAppUnityAndroid / HockeyAppUnityiOS klasörlerini Unity projenizin içindeki Assets klasöründen kaldırın.
1.2 Yeni App Center SDK'sı ekleme
App Center SDK'sı, Unity Paketlerini projenize içeri aktararak tümleştirilir. Bunu yapmak için önce App Center Unity Düzenleyici Uzantıları eklentisini yükleyin. Unity menüsü aracılığıyla Düzenleyici Uzantıları'nı açın: Window>App Center>Düzenleyici Extensions ve App Center SDK'sını Yükle'yi seçin.
App Center SDK modüler bir yaklaşımla tasarlanmıştır; yalnızca ilgilendiğiniz hizmetleri tümleştirebilirsiniz. Sonraki tabloda denkliklere bakın:
| HockeyApp modülü | App Center modülü |
|---|---|
Crashes and Exceptions |
Crashes |
Metrics |
Analytics |
Version Updates |
Distribute |
Hizmetleri ayrı olarak yüklemek için her sekmede SDK Yükle'yi seçebilirsiniz.
Not
App Center Unity SDK'sı üç platform için de bir tanedir: Android, iOS ve UWP. Her SDK'yi ayrı ayrı yüklemeniz gerekmez.
App Center Unity SDK'sını tümleştirmenin önerilen yolu App Center Düzenleyici Uzantısı'nı kullanmaktır, ancak diğer senaryoları destekliyoruz. Daha fazla bilgi için App Center Unity Belgeleri'ne bakın.
2. SDK'yi ayarlama
2.1 Uygulama tanımlayıcısını dönüştürme
App Center SDK'sı, uygulama tanımlayıcılarını genel olarak benzersiz tanımlayıcı (GUID) biçiminde kullanır. HockeyApp Uygulama Kimliğiniz App Center tarafından kullanılabilir ancak bunu farklı bir biçime dönüştürmeniz gerekir. Tanımlayıcıyı dönüştürmek için 8-4-4-4-12 gösterimi almak için dört kısa çizgi eklemeniz gerekir.
Önce (HockeyApp): 00112233445566778899aabbccddeeff
Sonra (App Center): 00112233-4455-6677-8899-aabbccddeeff
2.2 SDK'yi yapılandırma
App Center betiği ekleme
Proje penceresinde, projenize eklenen AppCenter klasörüne gidin. App Center logosunun simgesi olduğu betiği bulun ve adlı AppCenterBehaviorbetiği HockeySDK için daha önce kullandığınız oyun nesnesine sürükleyin.
App Center ayarlarını yapılandırma
Bu oyun nesnesine tıkladığınızda Denetçi penceresinde App Center yapılandırmasını görürsünüz.
Aşağıda verilen ayrıntılı yapılandırma eşleme tablosunu kullanarak ek bilgileri doldurun.
3. Hizmetler ve özellik karşılaştırması
| HockeyApp Ayarı | App Center Ayarı | Notlar |
|---|---|---|
| Uygulama Kimliği | Android/iOS Uygulama Gizli Dizisi | Önceki adımda dönüştürdüğünüz Uygulama Kimliğini kullanın |
| Sunucu URL'si | Özel Günlük URL'si, Diğer Kurulum bölümü | Özel Günlük URL'si Kullan seçeneğini işaretleyin |
| Kısıtlı uygulama içi güncelleştirmeler | NA | Distribute.UpdateTrack |
| Kilitlenmeler ve Özel Durumlar (varsayılan olarak etkindir) | Kilitlenmeleri kullanma | Modül kilitleniyor |
| Otomatik Karşıya Yükleme Kilitlenmeleri | NA (varsayılan olarak etkindir) | Belgeler (varsayılan olarak etkindir, yapılandırılabilir) |
| Özel Durum Günlüğü | İlk Günlük düzeyi, Diğer Kurulum bölümü | Daha ayrıntılı günlük kaydı istiyorsanız Verbose |
| Kullanıcı Ölçümleri | Analytics'i kullanma | Analiz modülü |
| Sürüm Güncelleştirmeler (varsayılan olarak etkindir) | Dağıt özelliğini kullanma | Modülü dağıtma |
| Uyarı Güncelleştirme | NA | Belgeler (yapılandırılması gerekir) |
Not
Projeniz ayarlarda listelenen üç platformdan birini desteklemiyorsa, uygulama gizli dizi alanını olduğu gibi bırakın; hiçbir etkisi olmayacaktır. Projeniz App Center'ın desteklemediği platformları destekliyorsa, API'lerin ve yapılandırmanın bu platformlar üzerinde hiçbir etkisi olmaz.
Projenizde uygulama genelinde HockeySDK API çağrıları varsa, bunları aşağıda verilen ayrıntılı API eşleme tablosunu kullanarak değiştirin.
| Özellik | HockeyApp | App Center |
|---|---|---|
| Özelliklere sahip özel olaylar | HockeyAppIOS.TrackEvent veya HockeyAppAndroid.TrackEvent | Analytics.TrackEvent |
| Güncelleştirmeleri açıkça denetleme | HockeyAppIOS.CheckForUpdate veya HockeyAppAndroid.CheckForUpdate | Distribute.CheckforUpdate |
| Geri bildirim formu görüntüleme | HockeyAppIOS.ShowFeedbackForm veya HockeyAppAndroid.ShowFeedbackForm | NA (aşağıdaki bölüme bakın) |
Geri Bildirim Hizmeti
Geri bildirim hizmeti App Center'da desteklenmez. Bkz . HockeyApp geri bildirimi.