A WPF/WinForms használatának első lépései

2025-05-05

Fontos

A Visual Studio App Center 2025. március 31-én megszűnt, kivéve az Elemzési és diagnosztikai funkciókat, amelyek 2026. június 30-ig továbbra is támogatottak lesznek. Tudj meg többet.

Az App Center SDK moduláris architektúrát használ, így bármely vagy az összes szolgáltatást használhatja.

Első lépésként állítsa be az App Center SDK-t az alkalmazásban az App Center Analytics és az App Center Összeomlások használatára.

1. Előfeltételek

Mielőtt hozzákezdene, győződjön meg arról, hogy a következő előfeltételek teljesülnek:

A projekt a .NET-keretrendszer 4.6.2-s (vagy újabb) vagy a .NET Core 3.1-et (vagy újabbat) célozza.
A .NET Core csak akkor támogatott, ha a WPF/WinForms alkalmazás Windows rendszeren fut.
Ha hordozható kódtárból használja az SDK-t, akkor a .NET standard 2.0-s vagy újabb verzióját kell céloznia (a PCL nem támogatott).
PackageReference projekt típusa. Ez a követelmény a könyvtárból SQLitePCL.raw származik. További információ: https://github.com/ericsink/SQLitePCL.raw/issues/537.
Ismert probléma merül fel az SDK VSTO-projektekbe való integrálásakor. További részletekért látogasson el https://github.com/microsoft/appcenter-sdk-dotnet/issues/1583/ide.

2. Az alkalmazás létrehozása az App Center portálon az alkalmazás titkos kódjának beszerzéséhez

Ha már létrehozta az alkalmazást az App Center portálon, kihagyhatja ezt a lépést.

Regisztráljon vagy jelentkezzen be, és nyomja le a portál jobb felső sarkában található kék gombot, amelyen az Új hozzáadása felirat látható, és válassza az Új alkalmazás hozzáadása lehetőséget a legördülő menüből.
Adja meg az alkalmazás nevét és leírását.
A projekttől függően válassza ki a megfelelő operációs rendszert és platformot a fent leírtak szerint.
Nyomja le az Új alkalmazás hozzáadása gombot a jobb alsó sarokban.

Miután létrehozott egy alkalmazást, beszerezheti annak titkos kódját az App Center portál Beállítások lapján. A Beállítások lap jobb felső sarkában kattintson a három függőleges pontra , és válassza ki Copy app secret az alkalmazás titkos kódjának lekéréséhez.

3. Az App Center SDK-moduljainak hozzáadása

Az App Center SDK integrálható a Visual Studióval vagy a Package Manager konzollal.

Megjegyzés:

Az App Center SDK erős névvel ellátott szerelvényeket használ az erős névvel ellátott jeleket használó alkalmazásokkal való kompatibilitáshoz.

Visual Studio

Nyissa meg a Visual Studiót.
Kattintson a Fájl>megnyitása gombra, és válassza ki a megoldást.
A megoldáskezelőben kattintson a jobb gombbal a Hivatkozások elemre , és válassza a NuGet-csomagok kezelése lehetőséget.
A Tallózás lapon keresse meg az App Centert, és telepítse a Microsoft.AppCenter.Analytics és a Microsoft.AppCenter.Crashes csomagokat.

Csomagkezelő konzol

Nyissa meg a konzolt a Visual Studióban. Ehhez válassza az Eszközök>NuGet Package Manager Csomagkezelő>konzolt.
Írja be a következő parancsokat:

Install-Package Microsoft.AppCenter.Analytics
Install-Package Microsoft.AppCenter.Crashes

Megjegyzés:

Ha az App Center SDK-t egy hordozható projektben használja, telepítenie kell a csomagokat az egyes projektekben: a hordozható és a WPF/WinForms alkalmazást futtató projektben. Ehhez nyissa meg az egyes alprojekteket, és kövesse a Visual Studio szakaszban leírt lépéseket.

4. Az SDK indítása

Az App Center használatához jelentkezzen be a használni kívánt modul(ok)ba. Alapértelmezés szerint nem indulnak el modulok, és az SDK indításakor mindegyiknek explicit módon kell meghívnia őket.

4.1 Adja hozzá a `Start()` metódust

WPF (Windows Presentation Foundation)

A WPF-alkalmazásához módosítsa a App.xaml.cs elemet, és adja hozzá a következő using nyilatkozatokat:

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

Ezután ugyanabban a fájlban adja hozzá a következő kódot a OnStartup metódushoz:

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

Ha a App.xaml.cs fájl nem rendelkezik ezzel a OnStartup módszerrel, hozzáadhatja a metódust Application.OnStartup(StartupEventArgs) . A App.xaml.cs fájlnak a következőképpen kell kinéznie:

public partial class App : Application
{
    protected override void OnStartup(StartupEventArgs e)
    {
      base.OnStartup(e);
      AppCenter.Start("{Your App Secret}", typeof(Analytics), typeof(Crashes));
    }
  }
}

Figyelmeztetés

Nem ajánlott az alkalmazás titkos kódjának beágyazása a forráskódba.

Ha külön kell elindítania az App Center-szolgáltatásokat, a következőt kell elvégeznie:

Konfigurálja vagy indítsa el az alkalmazás titkos kódjával.
Ha a kód többször is meghívható, ellenőrizze, hogy az App Center már konfigurálva van-e.
Indítsa el a szükséges szolgáltatás(ok)t az App Secret nélkül.

AppCenter.Configure("{Your App Secret}");
if (AppCenter.Configured)
{
    AppCenter.Start(typeof(Analytics)); 
    AppCenter.Start(typeof(Crashes)); 
}

WinForms

A WinForms-alkalmazás esetében módosítsa a Program.cs fájlt, és adja hozzá a következő utasításokat:

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

Ezután ugyanabban a fájlban adja hozzá a következő kódot a metódushoz az MainApplication.Run utasítás előtt.

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

Ha külön kell elindítania az App Center-szolgáltatásokat, a következőt kell elvégeznie:

Konfigurálja vagy indítsa el az alkalmazás titkos kódjával.
Ha a kód többször is meghívható, ellenőrizze, hogy az App Center már konfigurálva van-e.
Indítsa el a szükséges szolgáltatás(ok)t az App Secret nélkül.

AppCenter.Configure("{Your App Secret}");
if (AppCenter.Configured)
{
    AppCenter.Start(typeof(Analytics)); 
    AppCenter.Start(typeof(Crashes)); 
}

Figyelmeztetés

Nem ajánlott az alkalmazás titkos kódjának beágyazása a forráskódba.

4.2 Cserélje le a helyőrzőt az alkalmazás titkos kódjára

Ügyeljen arra, hogy a {Your App Secret} szöveget cserélje le az alkalmazás tényleges értékére. Az alkalmazás titkos kódja az Első lépések lapon vagy a Beállítások lapon található az App Center portálon.

Az Első lépések lap tartalmazza a fenti kódmintát, benne az alkalmazás titkos kódjával, a teljes mintát másolhatja és beillesztheti.

A fenti példa bemutatja, hogyan használhatja a metódust, és magában foglalja az Start() App Center Analyticset is.

Ha nem adja meg az egyes szolgáltatásokat paraméterekként a start metódusban, nem használhatja az App Center szolgáltatást. Emellett az Start() API csak egyszer használható az alkalmazás életciklusában – minden más hívás figyelmeztetést fog naplózni a konzolon, és csak az első hívásban szereplő szolgáltatások lesznek elérhetők.

Nagyszerű, most már készen áll, hogy az SDK által automatikusan gyűjtött alkalmazás összeomlásokat vizualizálja a portálon.

Az App Center Analytics és az App Center Crashes dokumentációjában megtudhatja, hogyan szabhatja testre és használhatja a két szolgáltatás fejlettebb funkcióit.

Megosztás a következőn keresztül: