Začínáme s WPF/WinForms

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.

• Android
• Ios
• Rozšíření pro iOS
• React Native
• MAUI/Xamarin
• UPW
• WPF/WinForms
• Jednota
• macOS
• Rozšíření pro macOS
• tvOS

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:

• Váš projekt cílí na .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).
• Typ projektu PackageReference Tento požadavek pochází z SQLitePCL.raw knihovny. Další informace najdete na adrese https://github.com/ericsink/SQLitePCL.raw/issues/537.
• Existuje známý problém při integraci sady SDK do projektů VSTO. Další podrobnosti naleznete na adrese https://github.com/microsoft/appcenter-sdk-dotnet/issues/1583/.

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

Poznámka:

Sada App Center SDK používá sestavení se silným jménem pro kompatibilitu s aplikacemi, které používají silné pojmenování.

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

Poznámka:

Pokud používáte sadu App Center SDK v přenosném projektu, musíte balíčky nainstalovat do každého z projektů: přenositelný a projekt, na kterém běží aplikace WPF/WinForms. 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. 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í nejsou spuštěny žádné moduly a při spuštění sady SDK je nutné explicitně volat jednotlivé moduly.

4.1 Přidání Start() metody

WPF (Windows Presentation Foundation)

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;

Potom 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 metodu OnStartup nemá, 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));
    }
  }
}

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

WinForms

Pro 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;

V tom samém souboru pak přidejte následující kód do metody Main, před příkaz Application.Run.

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

Výstraha

Nedoporučuje se vkládat tajný kód aplikace 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 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ělé, jste připraveni vizualizovat pády na portálu, které SDK automaticky shromažďuje.

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.