A MAUI és a Xamarin 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.

• Android
• Ios
• iOS-bővítmények
• React Native
• MAUI/Xamarin
• UWP
• WPF/WinForms
• Egység
• macOS
• macOS-bővítmények
• tvOS-

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 .NET SDK-t az alkalmazásban az App Center Analytics és az App Center Összeomlások használatára. Az App Center Distribute alkalmazáshoz való hozzáadásához tekintse meg az App Center Distribute dokumentációját.

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 Visual Studióban vagy a Mac Visual Studióban van beállítva.
• Az iOS 11.0-s vagy újabb verzióját vagy Android 5.0-s (API 21-es szintű) vagy újabb verzióját futtató eszközöket céloz meg.
• Nem használ más SDK-t, amely összeomlásjelentési funkciót biztosít.

Támogatott platformok:

• MAUI iOS
• MAUI Android
• MAUI Windows
• .NET 6.0 macOS
• Xamarin.Android
• Xamarin.iOS
• Xamarin.Mac
• Xamarin.Forms (iOS, macOS Android, UWP és Windows Desktop alkalmazások)

1.1 MAUI

Megjegyzés:

Jelenleg nincs MAUI-platform az App Center portálon. Használja a Xamarint iOS-hez, Androidhoz és UWP-hez Windowshoz.

1.2 A Xamarin.Android bemutatása

Hozzon létre egy alkalmazást az App Center portálon az Android operációs rendszer és a Xamarin platformmal.

1.3 A Xamarin.iOS ismertetése

Hozzon létre egy alkalmazást az App Center portálon az iOS operációs rendszerrel és a Xamarin platformmal.

1.4 A Xamarin.Mac ismertetése

Hozzon létre egy alkalmazást az App Center portálon macOS operációs rendszerrel és Xamarin platformmal.

Figyelmeztetés

Van egy ismert probléma, amely megakadályozza, hogy egy alkalmazás fel legyen töltve az App Store-ba. Kövesse az előrehaladást a GitHubon.

1.5 A Xamarin.Forms bemutatása (iOS, macOS, Android, UWP és Windows Desktop)

Hozzon létre 5 alkalmazást az App Centerben – egy-egy az egyes operációs rendszerekhez.

A Xamarint kell választania androidos, iOS- és macOS-alkalmazások platformjaként (az UWP- és asztali alkalmazások nem rendelkeznek Xamarin-beállítással).

A Windows Desktop - és macOS-alkalmazások esetében konfigurálnia kell a projektet a Xamarin.Forms platformmal való kompatibilitás érdekében.

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. Irány appcenter.ms.
2. 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.
3. Adja meg az alkalmazás nevét és leírását.
4. A projekttől függően válassza ki a megfelelő operációs rendszert és platformot a fent leírtak szerint.
5. Nyomja le az Új alkalmazás hozzáadása gombot a jobb alsó sarokban.

Miután létrehozott egy alkalmazást, az app titkos kódját az App Center portál Beállítások lapján szerezheti be. 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 hozzáadása a megoldáshoz

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 for Mac

• 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 Csomagok szakaszra , és válassza a NuGet-csomagok hozzáadása... lehetőséget.
• Keresse meg az App Centert, és válassza az App Center Analytics és az App Center Összeomlások lehetőséget.
• Kattintson a Csomagok hozzáadása elemre.

Visual Studio for Windows

• 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.
• 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.
• Ha a Mac Visual Studióban dolgozik, győződjön meg arról, hogy telepítette a NuGet Csomagkezelési bővítményeket. Ehhez válassza a Visual>, keresse meg a NuGetet, és telepítse, ha szükséges.
• Írja be a következő parancsot a konzolba:

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 meg kell nyitnia az egyes alprojekteket, és követnie kell a Visual Studio for Mac vagy a Visual Studio for Windows szakaszokban leírt lépéseket.

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

4.1 A felhasználói utasítások hozzáadása

Adja hozzá a megfelelő névtereket a következő fájlokhoz:

• MAUI és Xamarin.Forms - App.xaml.cs
• Xamarin.iOS és Xamarin.Mac - AppDelegate.cs
• Xamarin.Android - MainActivity.cs

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

4.2 Adja hozzá a Start() metódust

4.2.1 MAUI és Xamarin.Forms

Az App Center portálon minden platformhoz különböző alkalmazásokat kell létrehoznia. Minden alkalmazáshoz más-más alkalmazáskulcs tartozik. Nyissa meg a projekt App.xaml.cs fájlját, és adja hozzá a következő sort a konstruktorhoz (vagy a OnStart() Xamarin.Forms metódusához).

AppCenter.Start("ios={Your App Secret};macos={Your App Secret};android={Your App Secret};uwp={Your App Secret};windowsdesktop={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:

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("ios={Your App Secret};macos={Your App Secret};android={Your App Secret};uwp={Your App Secret};windowsdesktop={Your App Secret}");
if (AppCenter.Configured)
{
    AppCenter.Start(typeof(Analytics));
    AppCenter.Start(typeof(Crashes));
}

4.2.2 Xamarin.Android

Megjegyzés:

Győződjön meg róla, hogy ha az Android HockeyApp SDK-t használja, akkor inicializálja a HockeyApp SDK-t az App Center SDK UTÁN.

Nyissa meg a projekt MainActivity.cs fájlját, és adja hozzá a Start() hívást a OnCreate() metódushoz

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

Megjegyzés:

Ha az alkalmazás háttérszolgáltatásokkal vagy több belépési ponttal rendelkezik, például egy broadcast vevővel, exportált tevékenységekkel vagy tartalomszolgáltatókkal, ajánlott, hogy a AppCenter-t a Application.OnCreate visszahívásban kezdje el.

4.2.3 Xamarin.iOS és Xamarin.Mac

Megjegyzés:

Nem lehet több aktív összeomlásjelentési SDK-val rendelkezni az alkalmazásban. Tiltsa le a többi SDK összeomlásjelentési funkcióját, hogy az App Center észlelhesse az összeomlásokat.

Nyissa meg a projekt fájlját AppDelegate.cs , és adja hozzá a Start() hívást a FinishedLaunching() metóduson belül

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

Megjegyzés:

Összeomlások használata esetén ezt a metódust a felhasználói felületen/főszálban kell meghívnia, és el kell kerülnie a háttérfeladatok indítását, amíg a Start metódus vissza nem tér. Ennek az az oka, hogy az összeomlások inicializálása során egy másik szálból kifogott null referenciakivétel natív összeomlást válthat ki, és figyelmen kívül hagyhatja a kivételkezelő záradékot. Miután a AppCenter.Start metódus visszatér, ismét kezelheti a nullhivatkozási kivételeket. Az időzítési probléma okáról a Jelek és a külső összeomlási riporterek című cikkben olvashat bővebben.

Figyelmeztetés

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

Fontos

A kapcsos zárójelek azt mutatják, hol kell elhelyezni a tényleges alkalmazástitkokat; ne helyezzen kapcsos zárójeleket a Start hívásba.

Megjegyzés:

Egy iOS-alkalmazás esetében nem lehet több aktív összeomlásjelentési SDK-val rendelkezni az alkalmazásban. Tiltsa le a többi SDK összeomlásjelentési funkcióját, hogy az App Center észlelhesse az összeomlásokat.

4.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álható a Start() módszer, és hogyan foglalható bele az App Center Analytics és az App Center Crashes.

Ha nem szeretné használni a két szolgáltatás egyikét, távolítsa el a megfelelő paramétert a fenti metódushívásból.

Hacsak nem adja meg az egyes modulokat paraméterekként a kezdő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ő modulok lesznek elérhetők.

Ha például az App Center Analyticsbe szeretne bejelentkezni, módosítsa a hívást az Start() alábbiak szerint:

4.3.1 MAUI és Xamarin.Forms

AppCenter.Start("ios={Your App Secret};macos={Your App Secret};android={Your App Secret};uwp={Your App Secret};windowsdesktop={Your App Secret}", typeof(Analytics));

4.3.2 Natív Xamarin

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

---

Nagyszerű, most már készen áll arra, hogy a portálon megjelenítse az SDK által automatikusan gyűjtött analitikai és összeomlási adatokat.

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.

Az alkalmazáson belüli frissítések használatának megkezdéséhez olvassa el az App Center Distribute dokumentációját.

Megjegyzés:

A Xamarin Forms hordozható API-jait használva az összes modul API-jai megjelennek, azonban nem minden API támogatott az UWP és a Windows Desktop platformokon, és semmit sem tesznek, ha az UWP - és a Windows Desktop-alkalmazásokon futnak. Különösen az UWP és a Windows Desktop nem támogatja a következő modult: Elosztott. A visszatérési típussal rendelkező metódusok az UWP- és Windows Desktop-alkalmazásokban vagy null (objektumok esetében), 0 (számok esetén), vagy false (logikai értékek esetén) értéket adnának vissza.

5. Biztonsági mentési szabályok (csak Android esetén)

Megjegyzés:

Az Android 6.0-s (API 23-es szintű) vagy újabb verziót megcélzott alkalmazások automatikusan engedélyezve vannak az Automatikus biztonsági mentés funkcióval. 

Megjegyzés:

Ha már rendelkezik biztonsági mentési szabályokkal rendelkező egyéni fájllal, váltson a harmadik lépésre.

Ha automatikus biztonsági mentést használ az eszközökkel kapcsolatos helytelen információk lekérésének elkerülése érdekében, kövesse a következő lépéseket:

5.1. Android 11 (API level 30) vagy alacsonyabb.

1. Hozzon létre appcenter_backup_rule.xml fájlt az Erőforrások/xml mappában.

2. Nyissa meg a projekt AndroidManifest.xml fájlját. Adja hozzá az android:fullBackupContent attribútumot az <application> elemhez. A appcenter_backup_rule.xml erőforrásfájlra kell mutatnia.

android:fullBackupContent="@xml/appcenter_backup_rule"

3. Adja hozzá a következő biztonsági mentési szabályokat a appcenter_backup_rule.xml fájlhoz:

<full-backup-content xmlns:tools="http://schemas.android.com/tools">
      <exclude domain="sharedpref" path="AppCenter.xml"/>
      <exclude domain="database" path="com.microsoft.appcenter.persistence"/>
      <exclude domain="database" path="com.microsoft.appcenter.persistence-journal"/>
      <exclude domain="file" path="error" tools:ignore="FullBackupContent"/>
      <exclude domain="file" path="appcenter" tools:ignore="FullBackupContent"/>
  </full-backup-content>

5.2. Android 12 (API level 31) vagy újabb verzióhoz.

1. Hozzon létre appcenter_backup_rule.xml fájlt az Erőforrások/xml mappában.

2. Nyissa meg a projekt AndroidManifest.xml fájlját. Adja hozzá az android:dataExtractionRules attribútumot az <application> elemhez. A appcenter_backup_rule.xml erőforrásfájlra kell mutatnia.

android:dataExtractionRules="@xml/appcenter_backup_rule"

3. Adja hozzá a következő biztonsági mentési szabályokat a appcenter_backup_rule.xml fájlhoz:

<data-extraction-rules xmlns:tools="http://schemas.android.com/tools">
    <cloud-backup>
        <exclude domain="sharedpref" path="AppCenter.xml"/>
        <exclude domain="database" path="com.microsoft.appcenter.persistence"/>
        <exclude domain="database" path="com.microsoft.appcenter.persistence-journal"/>
        <exclude domain="file" path="error" tools:ignore="FullBackupContent"/>
        <exclude domain="file" path="appcenter" tools:ignore="FullBackupContent"/>
    </cloud-backup>
    <device-transfer>
        <exclude domain="sharedpref" path="AppCenter.xml"/>
        <exclude domain="database" path="com.microsoft.appcenter.persistence"/>
        <exclude domain="database" path="com.microsoft.appcenter.persistence-journal"/>
        <exclude domain="file" path="error" tools:ignore="FullBackupContent"/>
        <exclude domain="file" path="appcenter" tools:ignore="FullBackupContent"/>
    </device-transfer>
</data-extraction-rules>