Az iOS-bővítmények 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 alkalmazásbővítmények csak az összeomlási jelentéskészítést támogatják.

Az App Center SDK tárolóalkalmazáshoz való hozzáadásának megismeréséhez tekintse meg az App Center iOS első lépéseinek dokumentációját.

Első lépésként állítsa be az App Center iOS SDK-t az alkalmazásbővítményben az App Center Crashes használatára.

1. Előfeltételek

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

• Az iOS-projekt az Xcode 13 vagy újabb verziójában van beállítva a macOS 10.14.4-es vagy újabb verziójában.
• Az ios 11.0-s vagy újabb rendszeren futó eszközöket célozza meg.
• Ön nem használ más olyan könyvtá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 az iOS-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.

Megjegyzés:

Egy meglévő alkalmazáskulcs használata egy másik iOS-projektből mellékhatásokat okoz. Az App Center nem támogatja a projekt szerinti szűrést ugyanazon az App Center-alkalmazáson. Egy adott verzió összeomlásainak felsorolása például megkülönböztetés nélkül felsorolja a két projekt összes összeomlását. Ez zavaró lehet.

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. Az App Center SDK-moduljainak hozzáadása

Az App Center SDK a Cocoapods, a Carthage vagy a bináris fájlok projekthez való manuális hozzáadásával integrálható az alkalmazásba.

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

1. Adja hozzá a következő függőségeket az podfile-hoz, hogy az App Center összeomlás bekerüljön az alkalmazásba. Ez a következő keretrendszerekben jelenik meg: AppCenter és AppCenterCrashes.

    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.

Megjegyzés:

Ha a [!] Unable to find a specification for `AppCenter` hibajelzést látja a pod install futtatása közben, futtassa a pod repo update parancsot, hogy megszerezze a legfrissebb podokat a Cocoapods-adattárból, majd futtassa a pod install parancsot.

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 ezeket a keretrendszereket csatolhatja az alkalmazásban való használathoz.

   # 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 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 és az AppCenterCrashes.framework fájlokat a Carthage/Build/ mappából az Xcode Project Navigatorébe. 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 parancsot a Build fázisban használja, ne vegye fel az App Center SDK-kat, mert 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 Crashes alkalmazásbővítményhez 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 találhatók, amelyet gyakran Szállítónak neveznek. Ha a projekt nem könyvtárak alkönyvtárával van rendszerezve, 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).
   • Most húzza át az AppCenter.framework és az AppCenterCrashes.framework fájlt a Finderből (az előző lépés helyéről) az Xcode Project Navigátorá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ásbővítmény nem fog lefordítani.
   • Ekkor megjelenik egy párbeszédpanel, és győződjön meg arról, hogy az alkalmazásbővítmény-cél be van jelölve. Ezután kattintson a Befejezés gombra.

Most, hogy integrálta a keretrendszereket az alkalmazásbővítménybe, 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

Szúrja be a következő sorokat az alkalmazáskiterjesztés belépési pontját tartalmazó fájlba. Például egy Today bővítmény fő ViewController-fájlján belül.

@import AppCenter;
@import AppCenterCrashes;

import AppCenter
import AppCenterCrashes

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

Szúrja be a következő sort az alkalmazásbővítmény belépési pontjára. Például egy viewDidLoad Today kiterjesztés fő ViewController-fájljának metódusán belül.

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

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

Jelenleg csak az összeomlási jelentések támogatottak az alkalmazásbővítmények esetében.

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

Mindenképpen cserélje le {Your App Secret} a szöveget az alkalmazásbővítmény 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.

Nagyszerű, minden készen áll arra, hogy megjelenítse az összeomlási adatokat a portálon, amelyet az SDK automatikusan gyűjt.

Nézze meg az App Center Crashes dokumentációját, hogy megtudja, hogyan testreszabhatja az alkalmazásbővítményét, és hogyan használhat fejlettebb funkciókat.