Bagikan melalui

Mulai menggunakan UWP/WinUI

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.

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

Mari kita mulai menyiapkan App Center SDK di aplikasi Anda untuk menggunakan App Center Analytics dan App Center Crash.

1. Prasyarat

Sebelum memulai, pastikan prasyarat berikut terpenuhi:

Untuk proyek UWP:

  • Proyek Anda disiapkan di Visual Studio 2017 Update 15.9 atau yang lebih baru.
  • Anda menargetkan perangkat yang menjalankan Windows 10 build 16299 atau yang lebih baru.
  • Proyek Anda mereferensikan Universal Windows Platform 6.2.8 atau yang lebih baru (paket ini biasanya dirujuk secara implisit).
  • NuGet 4.3 atau yang lebih baru.

Untuk proyek WinUI:

  • Proyek Anda disiapkan di Visual Studio 2019 Update 16.9 atau yang lebih baru.
  • Anda menargetkan perangkat yang menjalankan Windows 10 build 17763 atau yang lebih baru.
  • Proyek Anda mereferensikan WinUI 3 0.8.0 atau yang lebih baru.

Nota

Jika Anda ingin menggunakan Xamarin.Forms untuk UWP, ikuti dokumentasi Xamarin Memulai alih-alih yang ini.

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

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

  1. Daftar atau masuk dan tekan tombol biru di sudut kanan atas portal yang bertuliskan Tambahkan baru dan pilih Tambahkan aplikasi baru dari menu dropdown.
  2. Masukkan nama dan deskripsi opsional untuk aplikasi Anda.
  3. Pilih OS dan platform yang sesuai tergantung pada proyek Anda seperti yang dijelaskan di atas.
  4. Tekan tombol di kanan bawah yang bertuliskan Tambahkan aplikasi baru.

Setelah membuat aplikasi, Anda dapat memperoleh Rahasia Aplikasinya 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 modul App Center SDK

App Center SDK dapat diintegrasikan menggunakan Visual Studio, atau Package Manager Console.

Visual Studio

  • Buka Visual Studio.
  • KlikBuka> dan pilih solusi Anda.
  • Di navigator solusi, klik kanan Referensi dan pilih Kelola Paket NuGet.
  • Di tab Telusuri, Cari Pusat Aplikasi, dan instal paket Microsoft.AppCenter.Analytics dan Microsoft.AppCenter.Crashes .

Konsol Manajer Paket

  • Buka konsol di Visual Studio. Untuk melakukan ini, pilih Alat>NuGet Package Manager>Package Manager Console.
  • Ketik perintah berikut:
Install-Package Microsoft.AppCenter.Analytics
Install-Package Microsoft.AppCenter.Crashes

Sekarang setelah Anda mengintegrasikan SDK di aplikasi Anda, saatnya untuk memulai SDK dan menggunakan layanan App Center.

Nota

Jika Anda menggunakan App Center SDK dalam proyek portabel (seperti Xamarin.Forms), Anda harus menginstal paket di setiap proyek: yang portabel, Android, dan iOS. Untuk melakukannya, Anda harus membuka setiap sub-proyek dan mengikuti langkah-langkah terkait yang dijelaskan di bagian Visual Studio .

4. Tambahkan kemampuan Internet (Client)

Di penjelajah solusi Visual Studio, klik dua kali file Package.appxmanifest untuk aplikasi Anda. Klik tab Kapabilitas lalu periksa kemampuan Internet (Klien).

5. Mulai SDK

Untuk menggunakan App Center, Anda harus ikut serta dalam modul yang ingin Anda gunakan. Secara default tidak ada modul yang dimulai dan Anda harus secara eksplisit memanggil masing-masing modul saat memulai SDK.

5.1 Tambahkan direktif 'using'

Tambahkan namespace yang sesuai sebelum Anda menggunakan API kami.

using Microsoft.AppCenter;
using Microsoft.AppCenter.Analytics;
using Microsoft.AppCenter.Crashes;

5.2 Tambahkan Start() metode

Tambahkan panggilan berikut ke konstruktor aplikasi Anda:

AppCenter.Start("{Your App Secret}", typeof(Analytics), typeof(Crashes));

Peringatan

Tidak disarankan untuk menyematkan Rahasia Aplikasi Anda dalam kode sumber.

Jika Anda perlu memulai layanan App Center secara terpisah, Anda harus:

  1. Konfigurasikan atau mulai dengan Kode Rahasia Aplikasi.
  2. Jika kode dapat dipanggil beberapa kali, periksa apakah App Center sudah dikonfigurasi.
  3. Mulai layanan yang diperlukan tanpa Rahasia Aplikasi.
AppCenter.Configure("{Your App Secret}");
if (AppCenter.Configured)
{
    AppCenter.Start(typeof(Analytics)); 
    AppCenter.Start(typeof(Crashes)); 
}

5.3 Ganti placeholder dengan Rahasia Aplikasi Anda

Pastikan untuk mengganti {Your App Secret} teks dengan nilai aktual untuk aplikasi Anda. Rahasia Aplikasi dapat ditemukan di halaman Memulai atau halaman Pengaturan di portal App Center.

Halaman Memulai berisi sampel kode di atas dengan Rahasia Aplikasi Anda di dalamnya, Anda dapat menyalin-tempel seluruh sampel.

Contoh di atas menunjukkan cara menggunakan Start() metode dan menyertakan App Center Analytics.

Kecuali Anda secara eksplisit menentukan setiap layanan sebagai parameter dalam metode mulai, Anda tidak dapat menggunakan layanan App Center tersebut. Selain itu, Start() API hanya dapat digunakan sekali dalam siklus hidup aplikasi Anda - semua panggilan lain akan mencatat peringatan ke konsol dan hanya layanan yang disertakan dalam panggilan pertama yang akan tersedia.

Bagus, Anda sudah siap memvisualisasikan Analytics di portal, yang akan dikumpulkan secara otomatis oleh SDK.

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

  • Last updated on