Sdílet prostřednictvím

Začínáme s UPW/WinUI

Důležité

Visual Studio App Center bylo vyřazeno 31. března 2025 s výjimkou funkcí Analýzy a diagnostiky, které se budou dál podporovat až do 30. června 2026. Další informace.

Sada App Center SDK používá modulární architekturu, abyste mohli používat libovolnou nebo všechny služby.

Začněme nastavením sady App Center SDK ve vaší aplikaci pro použití App Center Analytics a App Center Crashes.

1. Požadavky

Než začnete, ujistěte se, že jsou splněny následující požadavky:

Pro projekt UWP:

  • Váš projekt je nastaven v aplikaci Visual Studio 2017 od aktualizace 15.9 nebo v novější verzi.
  • Cílíte na zařízení s Windows 10 buildem 16299 nebo novějším.
  • Váš projekt odkazuje na univerzální platformu Windows Platform 6.2.8 nebo novější (tento balíček se obvykle odkazuje implicitně).
  • NuGet 4.3 nebo novější

Pro projekt WinUI:

  • Váš projekt je nastavený v prostředí Visual Studio 2019 Update 16.9 nebo novější.
  • Cílíte na zařízení s Windows 10 buildem 17763 nebo novějším.
  • Projekt odkazuje na WinUI 3 0.8.0 nebo novější.

Poznámka:

Pokud chcete použít Xamarin.Forms pro UPW, použijte místo toho dokumentaci Začínáme s Xamarinem.

2. Vytvoření aplikace na portálu App Center pro získání tajného kódu aplikace

Pokud jste už aplikaci vytvořili na portálu App Center, můžete tento krok přeskočit.

  1. Zaregistrujte se nebo se přihlaste a stiskněte modré tlačítko v pravém horním rohu portálu s textem Přidat nový a v rozevírací nabídce vyberte Přidat novou aplikaci .
  2. Zadejte název a volitelný popis aplikace.
  3. V závislosti na vašem projektu vyberte odpovídající operační systém a platformu, jak je popsáno výše.
  4. Klikněte na tlačítko v pravém dolním rohu s textem Přidat novou aplikaci.

Jakmile vytvoříte aplikaci, můžete získat její tajný kód aplikace na stránce Nastavení na portálu App Center. V pravém horním rohu stránky Nastavení klikněte na trojité svislé tečky a vyberte Copy app secret tajný kód aplikace.

3. Přidání modulů sady App Center SDK

Sadu App Center SDK je možné integrovat pomocí sady Visual Studio nebo konzoly Správce balíčků.

Visual Studio

  • Otevřete Visual Studio.
  • Klikněte na Otevřít soubor> a zvolte řešení.
  • V navigátoru řešení klikněte pravým tlačítkem na Odkazy a zvolte Spravovat balíčky NuGet.
  • Na kartě Procházet vyhledejteApp Center a nainstalujte balíčky Microsoft.AppCenter.Analytics a Microsoft.AppCenter.Crashes .

Konzola Správce balíčků

  • Otevřete konzolu v sadě Visual Studio. Provedete to tak, že zvolíte Nástroje>, Správce balíčků NuGet> a Konzolu Správce balíčků.
  • Zadejte následující příkazy:
Install-Package Microsoft.AppCenter.Analytics
Install-Package Microsoft.AppCenter.Crashes

Teď, když jste sadu SDK integrovali do aplikace, je čas spustit sadu SDK a využívat služby App Center.

Poznámka:

Pokud používáte sadu App Center SDK v přenosném projektu (například Xamarin.Forms), musíte balíčky nainstalovat do každého z projektů: přenosné, Android a iOS. K tomu byste měli otevřít každý dílčí projekt a postupovat podle odpovídajících kroků popsaných v části Visual Studio .

4. Přidání Internet (Client) funkce

V Průzkumníku řešení sady Visual Studio poklikejte na soubor Package.appxmanifest pro vaši aplikaci. Klikněte na kartu Schopnosti a pak zkontrolujte možnost Internet (klient ).

5. Spuštění sady SDK

Pokud chcete používat App Center, musíte se přihlásit k modulům, které chcete použít. Ve výchozím nastavení nejsou spuštěny žádné moduly a při spuštění sady SDK je nutné explicitně volat jednotlivé moduly.

5.1 Přidejte direktivy using

Před použitím našich rozhraní API přidejte příslušné obory názvů.

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

5.2 Přidání Start() metody

Do konstruktoru aplikace přidejte následující volání:

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

Výstraha

Nedoporučuje se vkládat tajný kód aplikace do zdrojového kódu.

Pokud potřebujete spustit služby App Center samostatně, měli byste:

  1. Nakonfigurujte nebo spusťte ji s App Secretem.
  2. Pokud se kód dá volat vícekrát, zkontrolujte, jestli je App Center už nakonfigurované.
  3. Spusťte požadované služby bez tajného kódu aplikace.
AppCenter.Configure("{Your App Secret}");
if (AppCenter.Configured)
{
    AppCenter.Start(typeof(Analytics)); 
    AppCenter.Start(typeof(Crashes)); 
}

5.3 Nahrazení zástupného symbolu tajným kódem aplikace

Nezapomeňte nahradit {Your App Secret} text skutečnou hodnotou vaší aplikace. Tajný kód aplikace najdete na stránce Začínáme nebo na stránce Nastavení na portálu App Center.

Stránka Začínáme obsahuje výše uvedenou ukázku kódu s tajným kódem aplikace a můžete zkopírovat celou ukázku.

Výše uvedený příklad ukazuje, jak použít metodu Start() a zahrnuje analýzy App Center.

Pokud v metodě start explicitně nezadáte každou službu jako parametry, nemůžete tuto službu App Center použít. Kromě toho Start() se rozhraní API dá použít jenom jednou v životním cyklu vaší aplikace – všechna ostatní volání do konzoly zahlásí upozornění a budou k dispozici pouze služby zahrnuté do prvního volání.

Skvěle, jste připraveni vizualizovat analýzy na portálu, které sada SDK shromažďuje automaticky.

Podívejte se do dokumentace k App Center Analytics a App Center Crashes, abyste se naučili, jak přizpůsobit a používat pokročilejší funkce obou služeb.

  • Last updated on