Mulai menggunakan UWP/WinUI

  • Artikel

Penting

Visual Studio App Center dijadwalkan untuk dihentikan pada 31 Maret 2025. Meskipun Anda dapat terus menggunakan Visual Studio App Center hingga sepenuhnya dihentikan, ada beberapa alternatif yang direkomendasikan yang dapat Anda pertimbangkan untuk bermigrasi.

Pelajari selengkapnya tentang garis waktu dukungan dan alternatif.

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.
  • Referensi proyek Anda Platform Windows Universal 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.

Catatan

Jika Anda ingin menggunakan Xamarin.Forms untuk UWP, ikuti dokumentasi Memulai Xamarin 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 Aplikasi di halaman Pengaturan di Portal App Center. Di sudut kanan atas halaman Pengaturan , klik tiga titik vertikal 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.
  • Klik Buka File> 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 melakukannya, pilih Alat>NuGet Package Manager>Package Manager Console.
  • Ketikkan perintah berikut:
Install-Package Microsoft.AppCenter.Analytics
Install-Package Microsoft.AppCenter.Crashes

Sekarang setelah Anda mengintegrasikan SDK dalam aplikasi Anda, saatnya untuk memulai SDK dan memanfaatkan layanan App Center.

Catatan

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 Internet (Client) kemampuan

Di penjelajah solusi Visual Studio, klik dua kali file Package.appxmanifest untuk aplikasi Anda. Klik tab Kapabilitas lalu periksa kapabilitas 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 Menambahkan menggunakan direktif

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. Mengonfigurasi atau memulainya dengan 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 tempat penampung 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 Pusat Aplikasi.

Halaman Memulai berisi sampel kode di atas dengan Rahasia Aplikasi Anda di dalamnya, Anda dapat menyalin-menempelkan 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 siap untuk memvisualisasikan Analytics di portal yang dikumpulkan SDK secara otomatis.

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