Unity ile Başlarken

  • Makale
  • Okumak için 2 dakika

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

App Center Unity SDK 'sını kullanmaya başlayın ve App Center analizlerini ve kilitlenmeleri kullanacak şekilde ayarlayın. Uygulamanıza App Center dağıtım eklemek için App Center dağıtım belgelerinebakın.

1. ön koşullar

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

Unity için App Center SDK 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 Scripting Runtime sürümü ve .NET Scripting arka ucu UWP platformunda artık desteklenmiyor.

Arka uç ile yerine coroutines/Callbacks kullanmayı öğrenmek için async/await .NET 3.5 , BELGELERININ Unity SDK bölümünde zaman uyumsuz API 'ler bölümüne bakın.

Ayrıca, Unity için App Center SDK 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'e gidin.
  2. App Center kaydolma veya oturum açma.
  3. Portalın sağ üst köşesindeki mavi düğmesine tıklayarak Yeni Ekle ' ye 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, App Center portalındaki Ayarlar sayfasında uygulama gizli anahtarını elde edebilirsiniz. Ayarlar sayfanın sağ üst köşesinde üçlü dikey noktalara tıklayın ve Copy app secret uygulama gizli dizisini almak için öğesini seçin.

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

3A uzantı düzenleyicisini yükler

App Center SDK, Unity paketlerini projenize aktararak tümleştirilir. Bunu yapmak için önce App Center Unity Düzenleyici uzantıları eklentisini yüklemeniz gerekir. Bkz. Unity menüsünü kullanarak düzenleyici uzantılarını açın: pencere > App Center > Düzenleyici uzantıları ve "Install App Center SDK" yı seçin.

Not

Unity sürümlerindeki 2019.1.2 F1 ve daha yeni bir deyişle, yükleme sırasında, gibi günlüklerde hata olabilir Coroutine continue failure . Bilinen bir Unity sorunudur ve bunu yoksayabilirsiniz.

3.1 b ayrı paketleri yükler

Alternatif olarak, her bir Unity paketinin her biri indirilebilir ve içeri aktarılabilir. bunlar App Center Unity SDK GitHub sayfasındabulunur. Kullanmak istediğiniz paket (ler) in en son sürümünü indirin. Adı AppCenter {Analytics/kilitlenmeler/dağıt}-v {Version}. unitypackage biçiminde olmalıdır.

3.2 b 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. Içeri aktar' ı SEÇIN ve SDK projenize eklenir. İndirdiğiniz her paket için bu adımı tekrarlayın ve projenizde kullanmayı planlayın.

3,3 cihaz hakkında yanlış bilgi almayı önlemek için otomatik yedekleme kullanıyorsanız, sonraki adımları izleyin:

Not

Android 6,0 (API düzeyi 23) veya üzeri hedeflenen uygulamalar otomatik yedekleme otomatik olarak etkinleştirilmiştir.

Not

Yedekleme kuralına sahip bir özel dosyanız zaten varsa, üçüncü adıma geçin.

a. Varlıklar/eklentiler/Android/res/XML klasöründe appcenter_backup_rule.xml dosya oluşturun.

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

Not

Zaten kendi AndroidManifest.xml dosyanız yoksa, bu dosyayı varlıklar/eklentiler/Android klasöründe oluşturun. Bu bildirim, derleme sırasında varsayılan Unity tarafından oluşturulan bir ile birleştirilir.

android:fullBackupContent="@xml/appcenter_backup_rule"

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

4. SDK 'Yı etkinleştirme

4,1 boş bir oyun nesnesi oluştur

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

4,2 App Center betiği iliştirme

Project penceresinde, projenize eklenmiş olan "appcenter" klasörüne gidin. Appcenterbehavior adlı betiği bulun ve hiyerarşi penceresinde yeni oluşturduğunuz oyun nesneniz üzerine sürükleyin.

Not

Kullanmak istediğiniz her sahneye App Center 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 sırlarınızı Inspector penceresindeki ilgili alanlara ekleyin. Kullanmayı düşündüğünüz App Center her bir hizmet için "{Service}" kutularını da kontrol ettiğinizden emin olun.

App Center betik yapılandırması

Not

Projeniz ayarlarda listelenen üç platformdan birini desteklemiyorsa, uygulama gizli alanını-olduğu gibi bırakın; hiçbir etkisi olmayacaktır. Projeniz App Center desteklemediği platformları destekliyorsa, API 'Ler ve yapılandırma bu platformlar için hiçbir etkiye sahip olmaz.

Harika, portalda SDK 'nın otomatik olarak toplanacağı analiz ve tanılama (kilitlenme ve hata) verilerini görselleştirmeye hazırsınız.

Her iki hizmet ile daha gelişmiş işlevsellik kullanmayı öğrenmek için App Center Analytics ve App Center kilitlenmelere yönelik belgelere bakın.

Uygulama içi güncelleştirmelerle çalışmaya başlama hakkında bilgi edinmek için App Center dağıtımbelgelerini okuyun.