A tvOS 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 tvOS SDK-t az alkalmazásban az App Center Analytics és az App Center Crashes funkciók használatához.

1. Előfeltételek

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

• Az Ön tvOS rendszere az Xcode 13 vagy annál újabb verzióján van beállítva, tvOS 11 vagy annál magasabb verzión.
• Nem használ más olyan kódtárat, amely összeomlásjelentési funkciót biztosít.

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 tvOS-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 tvOS-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 integrálható az alkalmazásba.

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, hogy az alkalmazásában elérhető legyen az App Center Analytics és az App Center Crashes.

   # 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 tvOS 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/tvOS 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-projektbe az App Center Analytics és az App Center Crashes tvOS-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.

   • Ajánlott eljárásként a harmadik féltől származó kódtárak általában egy alkönyvtárban vannak (ezt gyakran Szállítónak hívják), ezért ha nem rendezi a projektet a kódtárak alkönyvtárával, 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 kicsomagolt AppCenter-SDK-Apple mappát a Finderben, és másolja a mappát a projekt mappájába a kívánt helyre. 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 azokat az almappákat, amelyekre nincs szüksége.

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, győződjön meg arról, hogy hozzá lett adva a projekthez, különben a többi modul nem fog működni, é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 tvOS-keretrendszer konvenciója alapján van csomagolva. Ennek az az oka, hogy a tvOS-hez készült App Center SDK nem hagyományos keretrendszer, hanem statikus. Statikus keretrendszerként kell csatolnia: 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 explicit módon kell meghívnia őket.

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])

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.

Ha nem adja meg az egyes modulokat paraméterké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])

---

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.