Mulai menggunakan Unity

Penting

Visual Studio App Center dihentikan pada 31 Maret 2025, kecuali untuk fitur Analitik dan Diagnostik, yang akan terus didukung hingga 30 Juni 2026. Pelajari lebih lanjut.

• Android
• Ios
• Ekstensi iOS
• React Native
• MAUI/Xamarin
• UWP
• WPF/WinForms
• Persatuan
• macOS
• Ekstensi macOS
• tvOS

App Center SDK menggunakan arsitektur modular sehingga Anda dapat menggunakan salah satu atau semua layanan.

Mari kita mulai dan siapkan App Center Unity SDK untuk menggunakan App Center Analytics dan Crash. Untuk menambahkan Distribusi App Center ke aplikasi Anda, lihat dokumentasi untuk Distribusi App Center.

1. Prasyarat

Sebelum memulai, pastikan proyek Anda disiapkan di Unity 2018.1 atau yang lebih baru.

App Center SDK untuk Unity mendukung platform berikut:

• iOS (9.0 atau yang lebih baru)
• Android (5.0/API 21 atau yang lebih baru)
• UWP (Build 16299 atau yang lebih baru)

Nota

Versi runtime pembuatan skrip .NET 3.5 dan backend skrip .NET tidak lagi didukung pada platform UWP.

Untuk mempelajari cara menggunakan coroutine/callback sebagai pengganti async/await dengan .NET 3.5 backend, lihat bagian API Asinkron dalam Unity SDK di dokumentasi.

Selain itu, App Center SDK untuk Unity hanya tersedia di C#.

2. Buat aplikasi Anda di Portal App Center untuk memperoleh Rahasia Aplikasi

Jika Anda sudah membuat aplikasi di portal App Center, Anda dapat melewati langkah ini.

1. Pergilah ke appcenter.ms.
2. Mendaftar atau masuk ke App Center.
3. Klik tombol biru di sudut kanan atas portal yang bertuliskan Tambahkan baru dan pilih Tambahkan aplikasi baru dari menu dropdown.
4. Masukkan nama dan deskripsi opsional untuk aplikasi Anda.
5. Pilih OS dan platform yang sesuai tergantung pada proyek Anda seperti yang dijelaskan di atas.
6. Klik tombol Tambahkan aplikasi baru di kanan bawah halaman.

Setelah membuat aplikasi, Anda dapat memperoleh Rahasia Aplikasi di halaman Pengaturan di Portal App Center. Di sudut kanan atas halaman Pengaturan , klik titik vertikal tiga kali dan pilih Copy app secret untuk mendapatkan Rahasia Aplikasi Anda.

3. Tambahkan App Center SDK ke proyek Anda

3a Pasang Editor Ekstensi

App Center SDK terintegrasi dengan mengimpor Paket Unity ke dalam proyek Anda. Untuk melakukannya, pertama instal plugin App Center Unity Editor Extensions. Buka Ekstensi Editor melalui menu Unity: Ekstensi Editor Window > App Center > dan pilih "Instal App Center SDK".

Nota

Dalam Versi Unity 2019.1.2f1 dan yang lebih baru, mungkin ada kesalahan dalam log selama penginstalan seperti Coroutine continue failure. Ini adalah masalah Unity yang diketahui dan Anda harus mengabaikannya.

3.1b Pasang Paket Mandiri

Sebagai alternatif, masing-masing paket Unity individu dapat diunduh dan diimpor. Mereka ditemukan di halaman App Center Unity SDK GitHub. Unduh rilis terbaru paket yang ingin Anda gunakan. Namanya harus dalam format AppCenter{Analytics/Crashes/Distribute}-v{version}.unitypackage.

3.2b Mengimpor paket

Buka proyek Unity Anda, lalu klik dua kali paket yang Anda unduh. Jendela pop-up akan muncul di proyek Unity Anda yang berisi daftar file. Pilih Impor, dan SDK akan ditambahkan ke proyek Anda. Ulangi langkah ini untuk setiap paket yang Anda unduh dan rencanakan untuk digunakan dalam proyek Anda.

4. Aktifkan SDK

4.1 Membuat Objek Game kosong

App Center berfungsi sebagai komponen yang Anda lampirkan ke objek game di adegan tempat game Anda diluncurkan. Navigasi ke adegan ini dan tambahkan objek permainan kosong. Beri nama deskriptif, seperti "App Center".

4.2 Lampirkan skrip App Center

Di jendela Proyek , navigasikan ke folder "AppCenter" yang ditambahkan ke proyek Anda. Temukan skrip, bernama AppCenterBehavior, dan seret ke objek game yang baru dibuat di jendela Hierarki .

Nota

Anda tidak perlu menambahkan App Center ke setiap adegan tempat Anda ingin menggunakannya. Menambahkannya ke adegan pertama yang dimuat sudah cukup.

4.3 Mengonfigurasi pengaturan App Center

Klik objek "App Center" baru ini dan tambahkan rahasia aplikasi Anda ke bidang yang sesuai di jendela Pemeriksa . Pastikan juga untuk mencentang kotak "Gunakan {service}" untuk setiap layanan App Center yang ingin Anda gunakan

Peringatan

Tidak disarankan untuk menyematkan Rahasia Aplikasi Anda dalam kode sumber.

Nota

Jika proyek Anda tidak mendukung salah satu dari tiga platform yang tercantum dalam pengaturan, biarkan bidang rahasia aplikasi as-is; itu tidak akan berpengaruh. Jika proyek Anda mendukung platform yang tidak didukung App Center, API dan konfigurasi tidak akan berpengaruh bagi platform tersebut.

---

Bagus, Anda siap untuk memvisualisasikan data Analytics dan Diagnostics (Crash dan Error) pada portal yang akan dikumpulkan SDK secara otomatis.

Lihat dokumentasi untuk App Center Analytics dan App Center Crash untuk mempelajari cara menggunakan fungsionalitas yang lebih canggih dengan kedua layanan.

Untuk mempelajari cara memulai pembaruan aplikasi, baca dokumentasi untuk App Center Distribute.

5. Aturan pencadangan (khusus Android)

Nota

Aplikasi yang menargetkan Android 6.0 (API level 23) atau yang lebih tinggi mengaktifkan Pencadangan Otomatis secara otomatis.

Nota

Jika Anda sudah memiliki file kustom dengan aturan cadangan, beralihlah ke langkah ketiga.

Nota

Jika Anda belum memiliki file AndroidManifest.xml Anda sendiri, buat di folder Aset/Plugins/Android . Manifest ini akan digabungkan dengan yang dibuat secara default oleh Unity pada saat build.

Jika Anda menggunakan pencadangan otomatis untuk menghindari mendapatkan informasi yang salah tentang perangkat, ikuti langkah-langkah berikutnya:

5.1. Untuk Android 11 (API level 30) atau yang lebih rendah.

1. Buat file appcenter_backup_rule.xml di folder Aset/Plugins/Android/res/xml .

2. Buka file AndroidManifest.xml dari proyek. android:fullBackupContent Tambahkan atribut ke <application> elemen . Ini harus menunjuk ke file sumber daya appcenter_backup_rule.xml .

android:fullBackupContent="@xml/appcenter_backup_rule"

3. Tambahkan aturan cadangan berikut ke file appcenter_backup_rule.xml :

<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. Untuk Android 12 (API level 31) atau yang lebih tinggi.

1. Buat file appcenter_backup_rule.xml di folder Aset/Plugins/Android/res/xml .

2. Buka file AndroidManifest.xml dari proyek. android:dataExtractionRules Tambahkan atribut ke <application> elemen . Ini harus menunjuk ke file sumber daya appcenter_backup_rule.xml .

android:dataExtractionRules="@xml/appcenter_backup_rule"

3. Tambahkan aturan cadangan berikut ke file appcenter_backup_rule.xml :

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