Unity'i Kullanmaya Başlama

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

• Android
• iOS
• iOS Uzantıları
• React Native
• MAUI/Xamarin
• UWP
• WPF/WinForms
• Unity
• macOS
• macOS Uzantıları
• tvOS
• Cordova

App Center SDK'sı modüler bir mimari kullanarak hizmetlerin herhangi birini veya tümünü kullanabilirsiniz.

Kullanmaya başlayalım ve App Center Unity SDK'sını App Center Analytics ve Kilitlenmeleri kullanacak şekilde ayarlayalım. Uygulamanıza App Center Distribute eklemek için App Center Distribute belgelerine bakın.

1. Önkoşullar

Başlamadan önce, projenizin Unity 2018.1 veya sonraki bir sürümde ayarlandığından emin olun.

Unity için App Center SDK'sı aşağıdaki platformları destekler:

• iOS (9.0 veya üzeri)
• Android (5.0/API 21 veya üzeri)
• UWP (Derleme 16299 veya üzeri)

Not

.NET 3.5 betik çalışma zamanı sürümü ve .NET betik arka ucu artık UWP platformunda desteklenmiyor.

Arka uç yerine async/await.NET 3.5 eş yordamları/geri çağırmaları kullanmayı öğrenmek için belgelerin Unity SDK'sı bölümündeki Zaman Uyumsuz API'lere bakın.

Ayrıca Unity için App Center SDK'sı yalnızca C# dilinde kullanılabilir.

2. Uygulama Gizli Anahtarını 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.

1. appcenter.ms'a gidin.
2. App Center'a kaydolun veya oturum açın.
3. Portalın sağ üst köşesindeki Yeni ekle ifadesinin yer aldığı mavi düğmeye tıklayın ve açılan menüden Yeni uygulama ekle'yi seçin.
4. Uygulamanız için bir ad ve isteğe bağlı bir açıklama girin.
5. Yukarıda açıklandığı gibi projenize bağlı olarak uygun işletim sistemini ve platformu seçin.
6. Sayfanın sağ alt kısmındaki Yeni uygulama ekle düğmesine tıklayı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öşesindeki üç dikey noktaya tıklayın ve Uygulama Gizli Dizinizi almak için öğesini seçinCopy app secret.

3. App Center SDK'sını projenize ekleme

3a Uzantıyı Yükleme Düzenleyici

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 Uzantıları ve "App Center SDK'sını Yükle" seçeneğini belirleyin.

Not

Unity 2019.1.2f1 ve daha yeni sürümlerinde, yükleme sırasında günlüklerde gibi Coroutine continue failurehatalar olabilir. Bu bilinen bir Unity sorunudur ve bunu yoksaymalısınız.

3.1b Tek Tek Paketleri Yükleme

Alternatif olarak, tek tek Unity paketlerinin her biri indirilebilir ve içeri aktarılabilir. Bunlar App Center Unity SDK GitHub sayfasında bulunur. Kullanmak istediğiniz paketlerin en son sürümünü indirin. Adı AppCenter{Analytics/Crashes/Distribute}-v{version}.unitypackage biçiminde olmalıdır.

3.2b Paketi içeri aktarma

Unity projenizi açın, ardından indirdiğiniz pakete çift tıklayın. Unity projenizde bir dosya listesi içeren bir açılır pencere görünmelidir. İçeri Aktar'ı seçtiğinizde SDK projenize eklenir. projenizde kullanmayı planladığınız ve indirdiğiniz her paket için bu adımı yineleyin.

4. SDK'yı etkinleştirme

4.1 Boş bir Oyun Nesnesi Oluşturma

App Center, oyununuzun başlatıldığı sahnede bir oyun nesnesine eklediğiniz bir bileşen olarak çalışır. Bu sahneye gidin ve boş bir oyun nesnesi ekleyin. "App Center" gibi açıklayıcı bir ad verin.

4.2 App Center betiğini ekleme

Proje penceresinde, projenize eklenen "AppCenter" klasörüne gidin. AppCenterBehavior adlı betiği bulun ve Hiyerarşi penceresinde yeni oluşturduğunuz oyun nesnesine sürükleyin.

Not

App Center'ı kullanmak istediğiniz her sahneye eklemeniz gerekmez. İlk yüklenen sahneye eklemek yeterlidir.

4.3 App Center ayarlarını yapılandırma

Bu yeni "App Center" nesnesine tıklayın ve uygulama gizli dizilerinizi Denetçi penceresinde ilgili alanlara ekleyin. Kullanmayı planladığınız her App Center hizmeti için "{service} kullan" kutularını da işaretlediğinizden emin olun

Uyarı

Uygulama Gizli Dizinizi kaynak koduna eklemeniz önerilmez.

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.

---

Harika, SDK'nın otomatik olarak topladığı portalda Analiz ve Tanılama (Kilitlenme ve Hata) verilerini görselleştirmeye hazırsınız.

Her iki hizmette de daha gelişmiş işlevleri kullanmayı öğrenmek için App Center Analytics ve App Center Kilitlenmeleri belgelerine bakın.

Uygulama içi güncelleştirmeleri kullanmaya başlamayı öğrenmek için App Center Distribute belgelerini okuyun.

5. Yedekleme kuralları (yalnızca Android)

Not

Android 6.0 (API düzeyi 23) veya üzerini hedefleyen uygulamalarda Otomatik Yedekleme otomatik olarak etkinleştirilir.

Not

Yedekleme kuralı içeren özel bir dosyanız zaten varsa üçüncü adıma geçin.

Not

Henüz kendi AndroidManifest.xml dosyanız yoksa, bu dosyayı Varlıklar/Eklentiler/Android klasöründe oluşturun. Bu bildirim, derleme sırasında unity tarafından oluşturulan varsayılan bildirimle birleştirilir.

Cihaz hakkında yanlış bilgi almaktan kaçınmak için otomatik yedeklemeyi kullanıyorsanız, sonraki adımları izleyin:

5.1. Android 11 (API düzeyi 30) veya daha düşük sürümler için.

1. Assets/Plugins/Android/res/xml klasöründe appcenter_backup_rule.xml dosyası oluşturun.

2. Projenin AndroidManifest.xml dosyasını açın. özniteliğini android:fullBackupContent<application> öğesine ekleyin. appcenter_backup_rule.xml kaynak dosyasına işaret etmelidir.

android:fullBackupContent="@xml/appcenter_backup_rule"

3. aşağıdaki yedekleme kurallarını appcenter_backup_rule.xml dosyasına ekleyin:

<full-backup-content xmlns:tools="http://schemas.android.com/tools">
      <exclude domain="sharedpref" path="AppCenter.xml"/>
      <exclude domain="database" path="com.microsoft.appcenter.persistence"/>
      <exclude domain="database" path="com.microsoft.appcenter.persistence-journal"/>
      <exclude domain="file" path="error" tools:ignore="FullBackupContent"/>
      <exclude domain="file" path="appcenter" tools:ignore="FullBackupContent"/>
  </full-backup-content>

5.2. Android 12 (API düzeyi 31) veya üzeri için.

1. Assets/Plugins/Android/res/xml klasöründe appcenter_backup_rule.xml dosyası oluşturun.

2. Projenin AndroidManifest.xml dosyasını açın. özniteliğini android:dataExtractionRules<application> öğesine ekleyin. appcenter_backup_rule.xml kaynak dosyasına işaret etmelidir.

android:dataExtractionRules="@xml/appcenter_backup_rule"

3. appcenter_backup_rule.xml dosyasına aşağıdaki yedekleme kurallarını ekleyin:

<data-extraction-rules xmlns:tools="http://schemas.android.com/tools">
    <cloud-backup>
        <exclude domain="sharedpref" path="AppCenter.xml"/>
        <exclude domain="database" path="com.microsoft.appcenter.persistence"/>
        <exclude domain="database" path="com.microsoft.appcenter.persistence-journal"/>
        <exclude domain="file" path="error" tools:ignore="FullBackupContent"/>
        <exclude domain="file" path="appcenter" tools:ignore="FullBackupContent"/>
    </cloud-backup>
    <device-transfer>
        <exclude domain="sharedpref" path="AppCenter.xml"/>
        <exclude domain="database" path="com.microsoft.appcenter.persistence"/>
        <exclude domain="database" path="com.microsoft.appcenter.persistence-journal"/>
        <exclude domain="file" path="error" tools:ignore="FullBackupContent"/>
        <exclude domain="file" path="appcenter" tools:ignore="FullBackupContent"/>
    </device-transfer>
</data-extraction-rules>