Wprowadzenie do platformy UWP/WinUI

  • Artykuł

Ważne

Program Visual Studio App Center ma zostać wycofany 31 marca 2025 r. Chociaż możesz nadal używać programu Visual Studio App Center do momentu jego pełnego wycofania, istnieje kilka zalecanych alternatyw, do których można rozważyć migrację.

Dowiedz się więcej o osiach czasu pomocy technicznej i alternatywach.

Zestaw SDK centrum aplikacji korzysta z architektury modułowej, dzięki czemu można używać dowolnych lub wszystkich usług.

Zacznijmy od konfigurowania zestawu SDK centrum aplikacji w aplikacji w celu używania analizy centrum aplikacji i awarii centrum aplikacji.

1. Wymagania wstępne

Przed rozpoczęciem upewnij się, że zostały spełnione następujące wymagania wstępne:

W przypadku projektu platformy UWP:

  • Projekt został skonfigurowany w programie Visual Studio 2017 Update 15.9 lub nowszym.
  • Są przeznaczone dla urządzeń z systemem Windows 10 kompilacji 16299 lub nowszej.
  • Projekt odwołuje się do platforma uniwersalna systemu Windows 6.2.8 lub nowszej (ten pakiet jest zwykle przywołyny niejawnie).
  • NuGet 4.3 lub nowszy.

W przypadku projektu WinUI:

  • Projekt został skonfigurowany w programie Visual Studio 2019 Update 16.9 lub nowszym.
  • Są przeznaczone dla urządzeń z systemem Windows 10 kompilacji 17763 lub nowszej.
  • Projekt odwołuje się do interfejsu WinUI 3 0.8.0 lub nowszego.

Uwaga

Jeśli chcesz użyć zestawu narzędzi Xamarin.Forms dla platformy UWP, postępuj zgodnie z dokumentacją wprowadzenie do platformy Xamarin zamiast tej.

2. Tworzenie aplikacji w portalu Centrum aplikacji w celu uzyskania wpisu tajnego aplikacji

Jeśli aplikacja została już utworzona w portalu Centrum aplikacji, możesz pominąć ten krok.

  1. Zarejestruj się lub zaloguj się i naciśnij niebieski przycisk w prawym górnym rogu portalu z komunikatem Dodaj nową i wybierz pozycję Dodaj nową aplikację z menu rozwijanego.
  2. Wprowadź nazwę i opcjonalny opis aplikacji.
  3. Wybierz odpowiedni system operacyjny i platformę w zależności od projektu zgodnie z powyższym opisem.
  4. Naciśnij przycisk w prawym dolnym rogu z komunikatem Dodaj nową aplikację.

Po utworzeniu aplikacji możesz uzyskać jej klucz tajny aplikacji na stronie Ustawienia w portalu Centrum aplikacji. W prawym górnym rogu strony Ustawienia kliknij potrójne pionowe kropki i wybierz pozycję Copy app secret , aby uzyskać wpis tajny aplikacji.

3. Dodawanie modułów zestawu SDK centrum aplikacji

Zestaw SDK centrum aplikacji można zintegrować przy użyciu programu Visual Studio lub konsoli menedżera pakietów.

Visual Studio

  • Otwórz program Visual Studio.
  • Kliknij pozycję Plik>Otwórz i wybierz rozwiązanie.
  • W nawigatorze rozwiązań kliknij prawym przyciskiem myszy pozycję Odwołania i wybierz polecenie Zarządzaj pakietami NuGet.
  • Na karcie Przeglądaj wyszukaj pozycję App Center i zainstaluj pakiety Microsoft.AppCenter.Analytics i Microsoft.AppCenter.Crash .

Konsola menedżera pakietów

  • Otwórz konsolę programu Visual Studio. W tym celu wybierz pozycję Narzędzia>Konsola menedżera pakietówNuGet Package Manager>.
  • Wpisz następujące polecenia:
Install-Package Microsoft.AppCenter.Analytics
Install-Package Microsoft.AppCenter.Crashes

Teraz, po zintegrowaniu zestawu SDK w aplikacji, nadszedł czas, aby uruchomić zestaw SDK i korzystać z usług Centrum aplikacji.

Uwaga

Jeśli używasz zestawu SDK usługi App Center w projekcie przenośnym (takim jak Xamarin.Forms), musisz zainstalować pakiety w każdym z projektów: przenośnych, Android i iOS. W tym celu należy otworzyć każdy podprojekt i wykonać odpowiednie kroki opisane w sekcji Visual Studio .

4. Dodawanie Internet (Client) możliwości

W Eksploratorze rozwiązań programu Visual Studio kliknij dwukrotnie plik Package.appxmanifest dla aplikacji. Kliknij kartę Możliwości, a następnie sprawdź możliwości Internetu (klienta).

5. Uruchamianie zestawu SDK

Aby korzystać z usługi App Center, musisz wyrazić zgodę na moduły, których chcesz użyć. Domyślnie nie są uruchamiane żadne moduły i podczas uruchamiania zestawu SDK należy jawnie wywołać każdą z nich.

5.1. Dodawanie dyrektyw using

Przed użyciem naszych interfejsów API dodaj odpowiednie przestrzenie nazw.

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

5.2 Dodawanie Start() metody

Dodaj następujące wywołanie do konstruktora aplikacji:

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

Ostrzeżenie

Nie zaleca się osadzania wpisu tajnego aplikacji w kodzie źródłowym.

Jeśli musisz uruchomić usługi App Center oddzielnie, wykonaj następujące kroki:

  1. Skonfiguruj lub uruchom go za pomocą wpisu tajnego aplikacji.
  2. Jeśli kod może być wywoływany wiele razy, sprawdź, czy centrum aplikacji jest już skonfigurowane.
  3. Uruchom wymagane usługi bez wpisu tajnego aplikacji.
AppCenter.Configure("{Your App Secret}");
if (AppCenter.Configured)
{
    AppCenter.Start(typeof(Analytics)); 
    AppCenter.Start(typeof(Crashes)); 
}

5.3 Zastąp symbol zastępczy wpisem tajnym aplikacji

Pamiętaj, aby zastąpić {Your App Secret} tekst rzeczywistą wartością aplikacji. Wpis tajny aplikacji można znaleźć na stronie Wprowadzenie lub stronie Ustawienia w portalu Centrum aplikacji.

Strona Wprowadzenie zawiera powyższy przykładowy kod z wpisem tajnym aplikacji. Możesz skopiować i wkleić cały przykład.

W powyższym przykładzie Start() pokazano, jak używać metody i uwzględniać usługę App Center Analytics.

Jeśli nie określisz jawnie każdej usługi jako parametrów w metodzie uruchamiania, nie możesz użyć tej usługi Centrum aplikacji. Ponadto Start() interfejs API może być używany tylko raz w cyklu życia aplikacji — wszystkie inne wywołania będą rejestrować ostrzeżenie do konsoli, a tylko usługi zawarte w pierwszym wywołaniu będą dostępne.

Świetnie— wszystko jest gotowe do wizualizacji analizy w portalu, który zestaw SDK zbiera automatycznie.

Zapoznaj się z dokumentacją dotyczącą awarii usług App Center Analytics i App Center , aby dowiedzieć się, jak dostosowywać i korzystać z bardziej zaawansowanych funkcji obu usług.