Začínáme s WPF/WinForms

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.

• Android
• iOS
• Rozšíření iOSu
• React Native
• MAUI/Xamarin
• UWP
• WPF/WinForms
• Unity
• macOS
• rozšíření pro macOS
• tvOS
• Cordova

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:

• Váš projekt cílí na rozhraní .NET Framework 4.6.2 (nebo vyšší) nebo .NET Core 3.1 (nebo vyšší).
• .NET Core se podporuje jenom v případech, kdy aplikace WPF/WinForms běží ve Windows.
• Pokud používáte sadu SDK z přenosné knihovny, musí cílit na .NET Standard 2.0 nebo vyšší (PCL se nepodporuje).
• PackageReference typ projektu. Tento požadavek pochází z SQLitePCL.raw knihovny. Další informace najdete na adrese https://github.com/ericsink/SQLitePCL.raw/issues/537.
• Při integraci sady SDK do projektů VSTO je známý problém. Další podrobnosti najdete tady: https://github.com/microsoft/appcenter-sdk-dotnet/issues/1583/.

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ů.

Poznámka

Sada App Center SDK používá sestavení se silnými názvy pro kompatibilitu s aplikacemi, které používají znaménko se silným názvem.

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

Poznámka

Pokud používáte sadu App Center SDK v přenosném projektu, musíte nainstalovat balíčky v každém z projektů: přenosný a projekt, na kterém běží aplikace WPF/WinForms. 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. Spuštění sady SDK

Pokud chcete používat App Center, přihlaste se k modulům, které chcete použít. 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.

4.1 Přidání Start() metody

WPF

Pro aplikaci WPF upravte App.xaml.cs a přidejte následující příkazy using:

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

Pak do stejného souboru přidejte do OnStartup metody následující kód:

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

App.xaml.cs Pokud soubor tuto metodu OnStartup neobsahuje, můžete ji přidatApplication.OnStartup(StartupEventArgs). Soubor App.xaml.cs by měl vypadat nějak takto:

public partial class App : Application
{
    protected override void OnStartup(StartupEventArgs e)
    {
      base.OnStartup(e);
      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)); 
}

WinForms

V aplikaci WinForms upravte Program.cs soubor a přidejte následující příkazy using:

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

Pak do stejného souboru přidejte následující kód v Main metodě před Application.Run příkaz.

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

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)); 
}

Upozornění

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

4.2 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é tak, abyste na portálu, který sada SDK shromažďuje automaticky, vizualizovali chybové ukončení.

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 .