Začínáme s iOSem

Článek
03/15/2024

Důležité

Visual Studio App Center je naplánované k vyřazení na 31. března 2025. I když můžete Visual Studio App Center dál používat, dokud ho úplně nevyřadíte, existuje několik doporučených alternativ, na které můžete migraci zvážit.

Přečtěte si další informace o časových osách a alternativách podpory.

Sada App Center SDK používá modulární architekturu, takže můžete používat některou nebo všechny služby.

Informace o datech shromažďovaných službou App Center najdete na stránkách Věnovaném datům shromažďovaným sadami SDK služby App Center, Obecné nařízení o ochraně dat a nejčastějších dotazech . Nejčastější dotazy obsahují také odpovědi, které potřebujete poskytnout pro App Store konfiguraci ochrany osobních údajů.

Pojďme začít nastavením sady App Center iOS SDK ve vaší aplikaci tak, aby používala analýzy app center a chyby app center. Pokud chcete do své aplikace přidat distribuci v App Center, projděte si dokumentaci k distribuci v App Center.

1. Požadavky

Aby bylo možné používat sadu App Center SDK, musí být splněné následující požadavky:

Váš projekt pro iOS je nastavený v Xcode 13 nebo novějším v systému macOS verze 10.14.4 nebo novějším.
Cílíte na zařízení se systémem ios 11.0 nebo novějším.
Nepoužíváte žádnou jinou knihovnu, která poskytuje funkci zasílání zpráv o chybách (jenom v případě chyb app center).
Pokud k integraci App Center používáte CocoaPods , potřebujete CocoaPods verze 1.10 nebo novější.

Analýzy a chyby sady App Center SDK jsou kompatibilní s nástrojem Mac Catalyst prostřednictvím XCFramework nebo SwiftPM.

2. Vytvořte aplikaci na portálu App Center a získejte tajný kód aplikace.

Pokud jste už vytvořili aplikaci na portálu App Center, můžete tento krok přeskočit.

Přejděte do appcenter.ms.
Zaregistrujte se nebo se přihlaste a stiskněte modré tlačítko v pravém horním rohu portálu s textem Přidat novou a v rozevírací nabídce vyberte Přidat novou aplikaci .
Zadejte název a volitelný popis aplikace.
Jako operační systém vyberte iOS a jako platformu objective-C/Swift .
V pravém dolním rohu klikněte na tlačítko Přidat novou aplikaci.

Jakmile vytvoříte aplikaci, můžete její tajný kód aplikace získat na stránce Nastavení na portálu App Center. V pravém horním rohu stránky Nastavení klikněte na tři svislé tečky a výběrem Copy app secret získáte tajný kód aplikace.

3. Přidání modulů sady App Center SDK

Sadu App Center SDK pro iOS můžete do aplikace přidat prostřednictvím Cocoapods, Carthage, Swift Package Manageru nebo ručním přidáním binárních souborů do projektu.

Poznámka

4.0.0 Ve verzi App Center byly zavedeny zásadní změny. Pokud chcete migrovat App Center z předchozích verzí, postupujte podle části Migrace na sadu App Center SDK 4.0.0 a vyšší .

3.1 Integrace přes Cocoapods

Poznámka

Simulátory ARM64 (při spuštění z Xcode běžícího na Apple Silicon Mac) nejsou podporovány prostřednictvím CocoaPods, zvažte použití jiných metod integrace, aby fungovaly.

Přidejte do podfile souboru následující závislosti, které budou zahrnovat App Center Analytics a App Center chybově selhává do vaší aplikace. Tato akce načte následující architektury: AppCenter, AppCenterAnalytics a AppCenterCrashes. Místo toho můžete zadat služby, které chcete v aplikaci používat. Každá služba má svůj vlastní poddruh a všechny závisejí na AppCenter. Automaticky se natáhne.
```
 # 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'
```
Spuštěním příkazu pod install nainstalujte nově definovaný pod a otevřete projekt .xcworkspace.

Poznámka

Pokud se při spuštění pod installzobrazí chyba typu [!] Unable to find a specification for `AppCenter` , spuštěním příkazu pod repo update získejte nejnovější pody z úložiště Cocoapods a pak spusťte pod installpříkaz .

Teď, když jste integrovali architektury do aplikace, je čas spustit sadu SDK a využít služby App Center.

3.2 Integrace přes Carthage

Níže najdete postup integrace sady App Center SDK do projektu Xcode pomocí decentralizovaného správce závislostí Carthage verze 0.30 nebo vyšší, který sestavuje závislosti a poskytuje binární architektury.

Poznámka

Integrace Carthage nefunguje v Xcode 12. Pokud chcete, aby to fungovalo, přečtěte si tuto instrukce pro Carthage.

Přidejte do svého Cartfile zařízení následující závislosti, které budou zahrnovat App Center. Tyto závislosti nabít ve všech architekturách. Pak můžete propojit jenom ty architektury, které chcete ve své aplikaci použít.
```
# 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
```
Spuštěním příkazu carthage update načtěte závislosti do složky Carthage/Checkouts . Pak sestavte každou architekturu.
Otevřete kartu Obecné nastavení cíle aplikace. Přetáhněte soubory AppCenter.framework, AppCenterAnalytics.framework a AppCenterCrashes.framework ze složky Carthage/Build/iOS do Navigátoru projektu Xcode. AppCenter.framework se vyžaduje ke spuštění sady SDK. Pokud se do projektu nepřidá, ostatní moduly nebudou fungovat a aplikace se nezkompiluje.
Zobrazí se dialogové okno se zaškrtnutým cílem aplikace. Klikněte na Dokončit.

Poznámka

Pokud používáte carthage copy-frameworks ve fázi sestavení , neměli byste tam přidávat sady App Center SDK, protože se dodávají jako statická rozhraní.

Teď, když jste integrovali architektury do aplikace, je čas spustit sadu SDK a využít služby App Center.

3.3 Integrace přes Swift Package Manager

V nabídce Xcode klikněte na File Swift Packages (Soubor > balíčků Swift) > Add Package Dependency (Přidat závislost balíčku).
V dialogovém okně, které se zobrazí, zadejte adresu URL úložiště: https://github.com/microsoft/appcenter-sdk-apple.git.
V části Verze vyberte Up to Next Major (Až na další hlavní obor ) a použijte výchozí možnost.
Požadované moduly vyberte ve sloupci Balení produktu .

Teď, když jste integrovali architektury do aplikace, je čas spustit sadu SDK a využít služby App Center.

Poznámka

Pokud integrujete App Center přes SwiftPM a chcete ho použít také v cíli rozšíření vaší aplikace, ujistěte se, že jste zadali DISABLE_DIAMOND_PROBLEM_DIAGNOSTIC=YES v konfiguraci. To je nezbytné k tomu, aby se zabránilo omezením SwiftPM při propojování modulu s více cíli.

3.4 Integrace zkopírováním binárních souborů do projektu

Níže najdete postup integrace zkompilovaných binárních souborů do projektu Xcode za účelem nastavení analýzy App Center a chyb app center pro vaši aplikaci pro iOS.

Poznámka

Sada App Center SDK podporuje použití .XCframework Pokud chcete do svého projektu integrovat XCframeworks, stáhněte siAppCenter-SDK-Apple-XCFramework.zip ze stránky vydaných verzí a rozbalte ho. Výsledný obsah složky není specifický pro platformu, ale obsahuje XCframeworks pro každý modul. Dají se integrovat stejným způsobem jako obvyklé architektury, jak je popsáno níže.

Stáhněte si architektury sady App Center SDK , které jsou k dispozici jako soubor ZIP.
Rozbalte soubor a uvidíte složku s názvem AppCenter-SDK-Apple , která obsahuje různé architektury pro každou službu App Center na každé složce platformy. V projektu se vyžaduje architektura s názvem AppCenter , protože obsahuje kód, který se sdílí mezi různými moduly.
[Volitelné] Vytvořte podadresář pro knihovny třetích stran.
- Osvědčeným postupem je, že knihovny třetích stran jsou obvykle v podadresáři, často označovaném jako Dodavatel. Pokud projekt není uspořádaný s podadresářem knihoven, vytvořte teď podadresář Vendor .
- Vytvořte v projektu Xcode skupinu Dodavatel , která bude napodobovat strukturu souborů na disku.
Otevřete rozbalenou složku AppCenter-SDK-Apple ve Finderu a zkopírujte ji do složky projektu v požadovaném umístění. Složka obsahuje architektury v podsložkách pro jiné platformy, které sada App Center SDK podporuje, takže možná budete muset odstranit podsložky, které nepotřebujete.
Přidejte do projektu v Xcode architektury sady SDK:
- Zkontrolujte, jestli je navigátor projektu viditelný (⌘+1).
- Teď přetáhněte & přetáhněte appCenter.framework, AppCenterAnalytics.framework a AppCenterCrashes.framework z Finderu (v umístění z předchozího kroku) do Navigátoru projektů Xcode. AppCenter.framework se vyžaduje ke spuštění sady SDK. Pokud se do projektu nepřidá, ostatní moduly nebudou fungovat a aplikace se nezkompiluje.
- Zobrazí se dialogové okno se zaškrtnutým cílem aplikace. Klikněte na Dokončit.

Teď, když jste integrovali architektury do aplikace, je čas spustit sadu SDK a využít služby App Center.

4. Spuštění sady SDK

Pokud chcete používat App Center, přihlaste se k modulům, které chcete používat. Ve výchozím nastavení se nespouští žádné moduly a při spouštění sady SDK musíte každý z nich volat.

Následující pokyny se mírně liší podle toho, jaký životní cyklus používáte. Od Xcode 12 můžete vybrat jeden ze dvou životních cyklů: "Swift UI App" (vybraná ve výchozím nastavení v Xcode 12) a "UI Kit AppDelegate". Pokud vyvíjíte rozšíření, podívejte se na úvodní stránku s rozšířením.

4.1 Přidání příkazů importu

Otevřete soubor AppDelegate projektu (pro životní cyklus AppDelegate sady UI Kit) nebo <soubor ProjectName>App.swift (pro životní cyklus aplikace Swift UI) a přidejte následující příkazy pro import:

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

import AppCenter
import AppCenterAnalytics
import AppCenterCrashes

4.2 Přidání `start:withServices:` metody

Sada uživatelského rozhraní AppDelegate

Přidejte inicializační kód do didFinishLaunchingWithOptions metody delegáta:

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

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

Životní cyklus aplikace Swift UI

Pokud chcete zajistit, aby sada App Center SDK správně fungovala s uživatelským rozhraním Swift, inicializujte ji po načtení uživatelského rozhraní. Nejjednodušší způsob, jak toho dosáhnout, je pomocí uiApplicationDelegate:

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
    }
}

Pak použijte UIApplicationDelegateAdaptor v struct:

@main
struct YourAppName: App {

  @UIApplicationDelegateAdaptor(AppDelegate.self) var appDelegate

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

Pokud máte aplikaci Catalyst, můžete předávat tajné kódy aplikací pro iOS i macOS současně:

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

Upozornění

Nedoporučuje se vkládat tajný kód aplikace do zdrojového kódu.

Pokud potřebujete spustit služby App Center samostatně, měli byste:

Nakonfigurujte ho nebo spusťte pomocí tajného kódu aplikace.
Pokud je možné kód volat vícekrát, zkontrolujte, jestli je app center už nakonfigurované.
Spusťte požadované služby bez tajného kódu aplikace.

[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 Nahrazení zástupného symbolu tajným kódem aplikace

Nezapomeňte nahradit {Your App Secret} text skutečnou hodnotou pro vaši aplikaci. Tajný kód aplikace najdete na stránce Začínáme nebo na stránce Nastavení na portálu App Center.

Stránka Začínáme obsahuje výše uvedenou ukázku kódu s tajným kódem aplikace. Celou ukázku můžete zkopírovat a vložit.

Výše uvedený příklad ukazuje, jak použít metodu start:withServices (start(withAppSecret:services:) pro Swift) a zahrnout analýzu App Center i chybové ukončení app center.

Pokud nechcete použít jednu z těchto dvou služeb, odeberte odpovídající parametr z výše uvedeného volání metody.

Pokud explicitně nezadáte jednotlivé moduly jako parametr v metodě start, nemůžete tuto službu App Center použít. start:withServices Rozhraní API (start(withAppSecret:services:) pro Swift) je také možné použít pouze jednou v životním cyklu vaší aplikace – všechna ostatní volání zahlásí upozornění do konzoly a k dispozici budou pouze moduly zahrnuté v prvním volání.

Například pokud chcete provést onboarding do App Center Analytics, měli byste upravit start:withServices volání rozhraní API (start(withAppSecret:services:) pro Swift) následujícím způsobem:

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

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

Je skvělé, že máte všechno nastavené tak, abyste na portálu, který sada SDK shromažďuje automaticky, vizualizovali data analýzy a chybových ukončení.

Informace o přizpůsobení a používání pokročilejších funkcí obou služeb najdete v dokumentaci k analýze app center a v dokumentaci k chybám App Center .

Informace o tom, jak začít s aktualizacemi v aplikaci, najdete v dokumentaci k distribuci v App Center.

Začínáme s iOSem

1. Požadavky

2. Vytvořte aplikaci na portálu App Center a získejte tajný kód aplikace.

3. Přidání modulů sady App Center SDK

3.1 Integrace přes Cocoapods

3.2 Integrace přes Carthage

3.3 Integrace přes Swift Package Manager

3.4 Integrace zkopírováním binárních souborů do projektu

4. Spuštění sady SDK

4.1 Přidání příkazů importu

4.2 Přidání start:withServices: metody

Sada uživatelského rozhraní AppDelegate

Životní cyklus aplikace Swift UI

4.3 Nahrazení zástupného symbolu tajným kódem aplikace

Další materiály

4.2 Přidání `start:withServices:` metody