Az iOS használatának első lépései

2025-05-05

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.

Az App Center által az App Center SDK-k által gyűjtött adatokról, az általános adatvédelmi rendeletről és a GYIK-oldalakról talál információkat. Emellett a gyakori kérdések tartalmazzák azOkat a válaszokat, amelyeket meg kell adnia az App Store adatvédelmi konfigurációjáról.

Első lépésként állítsa be az App Center iOS 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

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.
Nem használ más olyan kódtárat, amely összeomlásjelentési funkciót biztosít (csak az App Center összeomlásai esetén).
Ha Az App Center integrálásához CocoaPodst használ, akkor a CocoaPods 1.10-es vagy újabb verziójára van szüksége.

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

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.

Irány appcenter.ms.
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.
Adja meg az alkalmazás nevét és leírását.
Válassza ki az iOS-t operációs rendszerként és az Objective-C/Swiftet platformként.
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

Az iOS-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

Megjegyzés:

Az ARM64-szimulátorok (ha Apple Silicon Macen futó Xcode-ból indulnak el) nem támogatottak a CocoaPodson keresztül, fontolja meg más integrációs módszerek használatát.

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 művelet a következő keretrendszerekben jelenik meg: AppCenter, AppCenterAnalytics és AppCenterCrashes. Ehelyett megadhatja a kívánt szolgáltatásokat az alkalmazásban. Minden szolgáltatásnak saját al-specifikációja van, és mindegyik az AppCenterre támaszkodik. Automatikusan be lesz vonva.
```
 # Use the following line to use App Center Analytics and Crashes.x
 pod 'AppCenter'

 # Use the following lines if you want to specify which service you want to use.
 pod 'AppCenter/Analytics'
 pod 'AppCenter/Crashes'
 pod 'AppCenter/Distribute'
```
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.

Megjegyzés:

A kartázsintegráció nem működik az Xcode 12-ben. A működéshez tekintse meg ezt a Carthage utasítást

Adja hozzá a következő függőségeket az Cartfile App Center hozzáadásához. Ezek a függőségek minden keretrendszert bevonnak. 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
```
Futtassa carthage update a függőségek lehívásához a Carthage/Checkouts mappába. Ezután készítse el az egyes keretrendszereket.
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/iOS 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.
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

Az Xcode menüben kattintson a File > Swift Packages > Add Package Dependency (Csomagfüggőség hozzáadása) elemre.
A megjelenő párbeszédpanelen adja meg az adattár URL-címét: https://github.com/microsoft/appcenter-sdk-apple.git.
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.
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 beállításához az iOS-alkalmazáshoz.

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.

Töltse le a zip-fájlként megadott App Center SDK-keretrendszereket .
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.
[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.
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 azokat az almappákat, amelyekre nincs szüksége.
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 az AppCenter.framework, az AppCenterAnalytics.framework és az AppCenterCrashes.framework elemet a Finderből (az előző lépés helyérő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.
- 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.

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 jelentkezzen be 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.

Az alábbi utasítások kissé eltérnek attól függően, hogy milyen életciklust használ. Az Xcode 12-től kezdve két életciklus közül választhat: "Swift UI App" (alapértelmezés szerint a 12- es Xcode-ban van kiválasztva) és a "UI Kit AppDelegate". 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 (a UI Kit AppDelegate életciklusához) vagy <a ProjectName>App.swift fájlt (a Swift felhasználói felület alkalmazás életciklusához), é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

UI Kit AppDelegate

Inicializálási kód hozzáadása a delegált metódushoz didFinishLaunchingWithOptions :

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

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

Swift felhasználói felület alkalmazás életciklusa

Annak érdekében, hogy az App Center SDK megfelelően működjön a Swift felhasználói felülettel, inicializálja azt a felhasználói felület betöltése után. Ennek legegyszerűbb módja az UIApplicationDelegate használata:

class AppDelegate: NSObject, UIApplicationDelegate {
    func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey : Any]? = nil) -> Bool {
          AppCenter.start(withAppSecret: "{Your App Secret}", services:[
            Crashes.self, Analytics.self, Distribute.self])
        return true
    }
}

Ezután használja a UIApplicationDelegateAdaptor a struct-ban.

@main
struct YourAppName: App {

  @UIApplicationDelegateAdaptor(AppDelegate.self) var appDelegate

    var body: some Scene {
        WindowGroup {
            ContentView()
        }
    }
}

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

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:

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

Tekintse meg az App Center Analytics-dokumentumokat és az App Center Crashes-dokumentumokat , és ismerje meg, hogyan szabhatja testre és használhatja mindké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.

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

Az iOS használatának első lépései

1. Előfeltételek

2. Az alkalmazás létrehozása az App Center portálon az alkalmazás titkos kódjának beszerzéséhez

3. Az App Center SDK-moduljainak hozzáadása

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

3.2 Integráció Carthage-on keresztül

3.3 Integráció a Swift Package Managerrel

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

4. Az SDK indítása

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

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

UI Kit AppDelegate

Swift felhasználói felület alkalmazás életciklusa

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

Visszajelzés

További források

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