Udostępnij przez

Wprowadzenie do platformy UWP/WinUI

Ważne

Program Visual Studio App Center został wycofany 31 marca 2025 r. z wyjątkiem funkcji analizy i diagnostyki, które będą nadal obsługiwane do 30 czerwca 2026 r. Dowiedz się więcej.

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

Zacznijmy od skonfigurowania zestawu SDK App Center w Twojej aplikacji, aby korzystać z funkcji App Center Analytics i App Center Crashes.

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.
  • Dotyczy to urządzeń z systemem Windows 10 build 16299 lub nowszym.
  • Projekt odwołuje się do platformy uniwersalnej systemu Windows 6.2.8 lub nowszej (ten pakiet jest zwykle przywołyyny niejawnie).
  • NuGet 4.3 lub nowszy.

W przypadku projektu WinUI:

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

Uwaga / Notatka

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

2. Utwórz swoją aplikację w Centrum aplikacji Portalu, aby uzyskać tajny klucz 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 napisem Dodaj nową aplikację.

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

3. Dodawanie modułów zestawu SDK usługi App Center

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ę w programie Visual Studio. W tym celu wybierz pozycję Narzędzia>Konsola menedżera pakietów>.
  • Wpisz następujące polecenia:
Install-Package Microsoft.AppCenter.Analytics
Install-Package Microsoft.AppCenter.Crashes

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

Uwaga / Notatka

Jeśli używasz zestawu SDK usługi App Center w przenośnym projekcie (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 Programu Visual Studio .

4. Dodaj Internet (Client) funkcję

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 Centrum aplikacji, 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żde z nich.

5.1 Dodaj dyrektywy 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ę umieszczać tajnego klucza 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 przy użyciu klucza 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 sekretu aplikacji.
AppCenter.Configure("{Your App Secret}");
if (AppCenter.Configured)
{
    AppCenter.Start(typeof(Analytics)); 
    AppCenter.Start(typeof(Crashes)); 
}

5.3 Zastąp symbol zastępczy sekretem 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, zawierający twój tajny klucz aplikacji. Możesz skopiować i wkleić cały ten przykład.

W powyższym przykładzie pokazano, jak używać metody Start() oraz jak włączyć App Center Analytics.

Jeśli nie określisz jawnie każdej usługi jako parametrów w metodzie startowej, nie można użyć tej usługi w 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 uwzględnione w pierwszym wywołaniu będą dostępne.

Gotowy do wizualizowania danych analitycznych w portalu, który zestaw SDK zbiera automatycznie.

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

  • Last updated on