Začínáme s UPW/WinUI

  • Článek

Důležité

31. března 2025 je naplánované vyřazení z provozu. I když můžete dál používat Visual Studio App Center, dokud ho úplně vyřadíte, existuje několik doporučených alternativ, na které můžete zvážit migraci.

Přečtěte si další informace o časových osách a alternativách podpory.

Sada App Center SDK používá modulární architekturu, takže můžete používat libovolnou nebo všechny služby.

Začněme nastavením sady App Center SDK ve vaší aplikaci tak, aby používala analýzu App Center a chybové ukončení app center.

1. Požadavky

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

Pro projekt UPW:

  • Váš projekt je nastavený v sadě Visual Studio 2017 Update 15.9 nebo novější.
  • Cílíte na zařízení s Windows 10 buildem 16299 nebo novějším.
  • Odkazy na projekt Univerzální platforma Windows 6.2.8 nebo novější (na tento balíček se obvykle odkazuje implicitně).
  • NuGet 4.3 nebo novější.

Pro projekt WinUI:

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

Poznámka

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

2. Vytvořte aplikaci na portálu App Center a získejte tajný kód 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 v pravém horním rohu portálu stiskněte modré tlačítko Přidat novou a v rozevírací nabídce vyberte Přidat novou aplikaci .
  2. Zadejte název a volitelný popis aplikace.
  3. Vyberte odpovídající operační systém a platformu v závislosti na vašem projektu, jak je popsáno výše.
  4. V pravém dolním rohu klikněte na tlačítko 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 tři svislé tečky a výběrem Copy app secret získáte 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 sadu 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 vyhledejte App Center a nainstalujte balíčky Microsoft.AppCenter.Analytics a Microsoft.AppCenter.Crashes .

Konzola Správce balíčků

  • Otevřete konzolu v sadě Visual Studio. Chcete-li to provést, zvolte Nástroje> Správce >balíčků NuGetKonzola 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žít 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 nainstalovat balíčky v každém z projektů: v přenosném, Androidu a iOS. Chcete-li to provést, měli byste 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 Capabilities (Možnosti) a zkontrolujte možnost Internetu (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žívat. Ve výchozím nastavení se nespouští žádné moduly a při spuštění sady SDK je nutné explicitně volat každý z nich.

5.1 Přidání direktiv 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 vaší aplikace přidejte následující volání:

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

Upozornění

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

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

  1. Nakonfigurujte nebo spusťte tajný kód aplikace.
  2. Pokud je možné kó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 pro vaši aplikaci. 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. Můžete zkopírovat a vložit celou ukázku.

Výše uvedený příklad ukazuje, jak používat metodu Start() , a zahrnuje analýzu 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() je možné rozhraní API použít pouze jednou v životním cyklu vaší aplikace – všechna ostatní volání budou do konzoly protokolovat upozornění a k dispozici budou pouze služby zahrnuté v prvním volání.

Skvělé, máte všechno nastavené na vizualizaci Analýz na portálu, který sada SDK shromažďuje automaticky.

Informace o přizpůsobení a používání pokročilejších funkcí obou služeb najdete v dokumentaci k App Center Analytics a chybám App Center .