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

Az UWP/WinUI használatának első lépései

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:

UWP-projekt esetén:

  • A projekt a Visual Studio 2017 15.9-s vagy újabb frissítésében van beállítva.
  • A Windows 10 16299-ben vagy újabb buildben futó eszközöket célozza meg.
  • A projekt az Univerzális Windows Platform 6.2.8-as vagy újabb verziójára hivatkozik (ez a csomag általában implicit módon hivatkozik rá).
  • NuGet 4.3 vagy újabb.

WinUI-projekt esetén:

  • A projekt a Visual Studio 2019 16.9-s vagy újabb frissítésében van beállítva.
  • A Windows 10 17763-ás vagy újabb buildet futtató eszközöket célozza meg.
  • A projekt a WinUI 3 0.8.0-s vagy újabb verziójára hivatkozik.

Megjegyzés:

Ha a Xamarin.Forms for UWP-t szeretné használni, kövesse a Xamarin Első lépések dokumentációját ahelyett, hogy ezt használna.

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.

  1. 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.
  2. Adja meg az alkalmazás nevét és leírását.
  3. A projekttől függően válassza ki a megfelelő operációs rendszert és platformot a fent leírtak szerint.
  4. 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.

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

Most, hogy integrálta az SDK-t az alkalmazásba, ideje elindítani az SDK-t, és használni az App Center szolgáltatásait.

Megjegyzés:

Ha az App Center SDK-t egy hordozható projektben (például Xamarin.Forms) használja, telepítenie kell a csomagokat az egyes projektekben: a hordozható, az Android és az iOS rendszerű projektekben. Ehhez nyissa meg az egyes alprojekteket, és kövesse a Visual Studio szakaszban leírt lépéseket.

Add hozzá a Internet (Client) képességet

A Visual Studio megoldáskezelőjében kattintson duplán az alkalmazás Package.appxmanifest fájljára. Kattintson a Képességek fülre, majd ellenőrizze az internet (ügyfél) képességeit.

5. Az SDK indítása

Az App Center használatához be kell jelentkeznie 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.

5.1 A felhasználói irányelvek hozzáadása

Az API-k használata előtt adja hozzá a megfelelő névtereket.

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

5.2 Add hozzá a Start() metódust

Adja hozzá a következő hívást az alkalmazás konstruktorához:

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:

  1. Konfigurálja vagy indítsa el az alkalmazás titkos kódjával.
  2. Ha a kód többször is meghívható, ellenőrizze, hogy az App Center már konfigurálva van-e.
  3. 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)); 
}

5.3 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ű, mind úgy van beállítva, hogy vizualizálja az Analitikát a portálon, amelyet az SDK automatikusan gyűjt.

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.