A macOS 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.

Kezdjük azzal, hogy az alkalmazásában beállítjuk az App Center macOS SDK-t az App Center Analytics és az App Center Hibakeresés használatához.

1. Előfeltételek

Az App Center SDK használatához a következő követelményeknek kell teljesülniük:

• A macOS-projekt az Xcode 13 vagy újabb verziójában van beállítva, a macOS 10.14.4 vagy újabb verzión.
• MacOS 10.13 vagy újabb rendszeren futó eszközöket céloz meg.
• Ön nem használ más olyan könyvtárat, amely összeomlásjelentési funkciót biztosít.

Megjegyzés:

Az App Center SDK a júniusi SDK-kiadással elveti az Xcode 10 támogatását .

Az App Center SDK Analytics és Crashes kompatibilisek a Mac Catalysttal XCFramework vagy SwiftPM használva.

Az App Center SDK kompatibilis az Apple Silicon szolgáltatással.

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. Válassza ki a macOS-t operációs rendszerként és az Objective-C/Swiftet platformként.
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-moduljainak hozzáadása

A macOS-hez készült App Center SDK a Cocoapods, a Carthage, a Swift Package Manager vagy a bináris fájlok projekthez való manuális hozzáadásával adható hozzá az alkalmazáshoz.

Megjegyzés:

Az App Center 4.0.0 verziójában kompatibilitástörő változások jelentek meg. Kövesse az Áttelepítés az App Center SDK 4.0.0-s és újabb verziójára című szakaszt az App Center korábbi verziókból való áttelepítéséhez.

3.1 Integráció a Cocoapods használatával

1. Adja hozzá az alábbi függőségeket az podfile, hogy az alkalmazásában elérhető legyen az App Center Analytics és az App Center Crashes. Ez a következő keretrendszerekben jelenik meg: AppCenter, AppCenterAnalytics és AppCenterCrashes. Ehelyett megadhatja, hogy mely szolgáltatásokat szeretné használni az alkalmazásban. Minden szolgáltatásnak saját altspecifikációja van, és mindegyik a AppCenter-re támaszkodik. Automatikusan be lesz vonva.

    # Use the following line to use App Center Analytics and Crashes.
    pod 'AppCenter'
   
    # Use the following lines if you want to specify which service you want to use.
    pod 'AppCenter/Analytics'
    pod 'AppCenter/Crashes'
   

2. Futtassa a(z) pod install parancsot az újonnan definiált pod telepítéséhez, és nyissa meg a projekt .xcworkspace fájlját.

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

3.2 Integráció Carthage-on keresztül

Az alábbiakban bemutatjuk, hogyan integrálható az App Center SDK az Xcode-projektben a Carthage0.30-s vagy újabb verziójával, amely egy decentralizált függőségkezelő, amely létrehozza a függőségeket, és bináris keretrendszereket biztosít.

1. Adja hozzá az alábbi függőségeket az Cartfile-hez, hogy alkalmazása tartalmazza az App Center-t. Ez behúzza az összes keretrendszert. Ezután csak azokat a keretrendszereket kapcsolhatja össze, amelyeket használni szeretne az alkalmazásban.

   # Use the following line to get the latest version of App Center
   github "microsoft/appcenter-sdk-apple"
   

   # Use the following line to get the specific version of App Center
   github "microsoft/appcenter-sdk-apple" ~> X.X.X
   

2. Futtassa a carthage update --platform macOS programot. Ez beolvassa a függőségeket egy Carthage/Checkouts mappába, majd létrehozza az egyes keretrendszereket.

3. Nyissa meg az alkalmazáscél Általános beállítások lapját. Húzza az AppCenter.framework, az AppCenterAnalytics.framework és az AppCenterCrashes.framework fájlokat a Carthage/Build/macOS mappából az Xcode Project Navigator mappájába. Az SDK elindításához az AppCenter.framework szükséges. Ha nincs hozzáadva a projekthez, a többi modul nem fog működni, és az alkalmazás nem fog lefordítani.

4. Ekkor megjelenik egy párbeszédpanel, amely ellenőrzi, hogy az alkalmazás célhelye be van-e jelölve. Ezután kattintson a Befejezés gombra.

   Megjegyzés:

   Ha a carthage copy-frameworks használja, nem szabad hozzáadnia az App Center SDK-jait, mivel azok statikus keretrendszerként vannak szállítva.

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

3.3 Integráció a Swift Package Managerrel

1. Az Xcode menüben kattintson a File > Swift Packages > Add Package Dependency (Csomagfüggőség hozzáadása) elemre.
2. A megjelenő párbeszédpanelen adja meg az adattár URL-címét: https://github.com/microsoft/appcenter-sdk-apple.git.
3. A Verzió területen válassza a Következő főverzióig lehetőséget, és válassza az alapértelmezett beállítást.
4. Válassza ki a szükséges modulokat a Csomagtermék oszlopban.

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

Megjegyzés:

Ha az App Centert a SwiftPM-en keresztül integrálja, és az alkalmazás bővítmény céljában is használni szeretné, győződjön meg arról, hogy megadja DISABLE_DIAMOND_PROBLEM_DIAGNOSTIC=YES a konfigurációjában. Erre azért van szükség, hogy elkerüljük a SwiftPM korlátozásait, ha egy modult több célhoz kapcsolunk.

3.4 Integráció a bináris fájlok projektbe másolásával

Az alábbiakban bemutatjuk, hogyan integrálhatja a lefordított bináris fájlokat az Xcode-projektben az App Center Analytics és az App Center Crashes macOS-alkalmazáshoz való beállításához.

Megjegyzés:

Az App Center SDK támogatja a XCframework használatát. Ha az XCframeworkst szeretné integrálni a projektbe, töltse le a AppCenter-SDK-Apple-XCFramework.zip a kiadási oldalról, és bontsa ki. Az eredményként kapott mappatartalmak nem platformspecifikusak, hanem az egyes modulokhoz tartozó XCframeworkseket tartalmazzák. Az alábbiakban ismertetett módon ugyanúgy integrálhatók, mint a szokásos keretrendszerek.

1. Töltse le a zip-fájlként megadott App Center SDK-keretrendszereket .

2. Bontsa ki a fájlt, és megjelenik egy AppCenter-SDK-Apple nevű mappa, amely különböző keretrendszereket tartalmaz az egyes App Center-szolgáltatásokhoz az egyes platformmappákon. A projektben szükség van a(z) AppCenter nevű keretrendszerre, mivel a különféle modulok között oszt meg kódot.

3. [Nem kötelező] Hozzon létre egy alkönyvtárat harmadik féltől származó könyvtárakhoz.

   • A harmadik féltől származó kódtárak általában egy alkönyvtárban találhatók (ezt gyakran Szállítónak hívják), ezért ha a projekt nem használ alkönyvtárat a tárakhoz, hozzon létre egy Szállítói alkönyvtárat.
   • Hozzon létre egy Vendor nevű csoportot az Xcode-projektben a fájlstruktúra lemezen való utánzásához.

4. Nyissa meg a kódolatlan AppCenter-SDK-Apple mappát a Finderben, és másolja a mappát a projekt mappájába a kívánt helyen. A mappa az App Center SDK által támogatott más platformok almappáiban lévő keretrendszereket tartalmaz, ezért előfordulhat, hogy törölnie kell a szükségtelen almappákat.

5. Adja hozzá az SDK-keretrendszereket a projekthez az Xcode-ban:

   • Győződjön meg arról, hogy a Project Navigator látható (⌘+1).
   • Ezután húzza az AppCenter.framework, az AppCenterAnalytics.framework és az AppCenterCrashes.framework fájlt a Finderből (a Vendor mappában lévőkből) az Xcode Project Navigatorébe. Az SDK elindításához az AppCenter.framework szükséges. Ha hiányzik, a többi modul nem működik, és az alkalmazás nem fog lefordítani.
   • Ekkor megjelenik egy párbeszédpanel, amely ellenőrzi, hogy az alkalmazás célhelye be van-e jelölve. Ezután kattintson a Befejezés gombra.

Megjegyzés:

Az SDK-bináris nem a macOS-keretrendszer konvenciója alapján van csomagolva. Ennek az az oka, hogy a Mac App Center SDK nem hagyományos keretrendszer, hanem statikus. Statikus keretrendszerként kell összekapcsolnia: győződjön meg arról, hogy nem ágyazza be a bináris fájlokat, és nem foglalja bele őket a "köteg-erőforrások másolása" buildelési fázisba.

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

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 meg kell hívnia azokat. Ha bővítményt fejleszt, tekintse meg a bővítmény első lépéseit ismertető oldalt.

4.1 Az importálási utasítások hozzáadása

Nyissa meg a projekt AppDelegate-fájlját , és adja hozzá a következő importálási utasításokat:

@import AppCenter;
@import AppCenterAnalytics;
@import AppCenterCrashes;

import AppCenter
import AppCenterAnalytics
import AppCenterCrashes

4.2 Adja hozzá a start:withServices: metódust

Szúrja be a következő sort az alkalmazás delegálási módszerében didFinishLaunchingWithOptions :

[MSACAppCenter start:@"{Your App Secret}" withServices:@[[MSACAnalytics class], [MSACCrashes class]]];

AppCenter.start(withAppSecret: "{Your App Secret}", services: [Analytics.self, Crashes.self])

Ha rendelkezik Katalizátor-alkalmazással, egyszerre adhat át alkalmazáskulcsokat iOS és macOS rendszeren is:

[MSACAppCenter start:@"ios={Your iOS App Secret};macos={Your macOS App Secret}" withServices:@[[MSACAnalytics class], [MSACCrashes class]]];

AppCenter.start(withAppSecret:"ios={Your iOS App Secret};macos={Your macOS App Secret}", services: [Analytics.self, Crashes.self])

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.

[MSACAppCenter configureWithAppSecret:@"{Your App Secret}"];
if ([MSACAppCenter isConfigured]) {
   [MSACAppCenter startService:[MSACAnalytics class]];
   [MSACAppCenter startService:[MSACCrashes class]];
}

AppCenter.configure(withAppSecret: "{Your App Secret}")
if AppCenter.isConfigured {
    AppCenter.startService(Analytics.self)
    AppCenter.startService(Crashes.self)
}

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:withServices metódus (start(withAppSecret:services:) Swifthez) az App Center Analytics és az App Center Crashes integrálására.

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 a start:withServices (start(withAppSecret:services:) Swifthez készült) 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 Analytics szolgáltatásba szeretne bejelentkezni, módosítsa a (start:withServicesSwift) API-hívást az start(withAppSecret:services:) alábbiak szerint:

[MSACAppCenter start:@"{Your App Secret}" withServices:@[[MSACAnalytics class]]];

AppCenter.start(withAppSecret: "{Your App Secret}", services: [Analytics.self])

4.4 Internetes képességek hozzáadása védőfalas alkalmazásokhoz

Ha az alkalmazás az alkalmazás tesztkörnyezetét használja, meg kell adnia azt a képességet, hogy engedélyezze a kimenő (ügyfél-) kapcsolatokat, hogy az alkalmazás hozzáférhessen az internethez. Az Xcode 9 alapértelmezés szerint engedélyezi az alkalmazás tesztkörnyezetét, de a kimenő kapcsolatok képességeit explicit módon kell beállítani.

Jelölje ki a projektet a projektgazdában, válassza a Képességek lapot, és ha az alkalmazás a tesztkörnyezetet használja, engedélyezze a kimenő kapcsolatokat.

---

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 dokumentációjában és az App Center Crashes-dokumentumokban megtudhatja , hogyan szabhatja testre és használhatja az egyes szolgáltatások speciális funkcióit.