Začínáme s iOSem

Důležité

Visual Studio App Center bylo vyřazeno 31. března 2025 s výjimkou funkcí Analýzy a diagnostiky, které se budou dál podporovat až do 30. června 2026. Další informace.

Sada App Center SDK používá modulární architekturu, abyste mohli používat libovolnou nebo všechny služby.

Informace o datech shromážděných službou App Center najdete na stránkách s daty shromážděnými sadami SDK App Center, Obecné nařízení o ochraně dat a nejčastějšími dotazy. Nejčastější dotazy také obsahují odpovědi, které potřebujete poskytnout pro konfiguraci ochrany osobních údajů v App Storu.

Pojďme začít s nastavením sady App Center SDK pro iOS ve vaší aplikaci tak, aby používala App Center Analytics a App Center Crashes. Pokud chcete do aplikace přidat distribuci App Center, podívejte se do dokumentace k distribuci App Center.

1. Požadavky

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

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

Analýza a chybové ukončení sady App Center SDK jsou kompatibilní s Mac Catalystem prostřednictvím XCFramework nebo SwiftPM.

2. Vytvoření aplikace na portálu App Center pro získání tajného kódu aplikace

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

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

Jakmile vytvoříte aplikaci, můžete 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 trojité svislé tečky a vyberte Copy app secret , jestli chcete získat 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 do sady 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 spuštěného na Apple Silicon Mac) nejsou podporovány prostřednictvím CocoaPods, zvažte použití jiných metod integrace, aby fungovala.

Přidejte následující závislosti do podfile vaší aplikace k zahrnutí App Center Analytics a App Center Crashes. Tato akce zahrne následující frameworky: AppCenter, AppCenterAnalytics a AppCenterCrashes. Místo toho můžete zadat požadované služby v aplikaci. Každá služba má svůj subspec a všechny spoléhají na AppCenter. Automaticky se přitá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'
```
Spusťte pod install k instalaci nově definovaného podu a otevřete projekt .xcworkspace.

Poznámka:

Pokud se při spuštění [!] Unable to find a specification for `AppCenter` zobrazí chyba pod install, spusťte pod repo update, abyste získali nejnovější moduly z úložiště Cocoapods, a pak spusťte pod install.

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

3.2 Integrace přes Karthage

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

Poznámka:

Integrace Carthage nefunguje bez nutnosti další konfigurace v Xcode 12. Pokud chcete, aby to fungovalo, podívejte se na tuto instrukci pro Carthage

Přidejte následující závislosti do Cartfile ke zahrnutí App Center. Tyto závislosti zahrnují všechny rámce. Pak můžete propojit jenom ty architektury, které chcete použít ve své aplikaci.

# 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 projektů Xcode. Ke spuštění sady SDK se vyžaduje AppCenter.framework . Pokud se do projektu nepřidá, ostatní moduly nebudou fungovat a vaše aplikace se nezkompiluje.
Zobrazí se dialogové okno, ujistěte se, že je zaškrtnutý správný cíl vaší 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 SDK app Center, protože se dodávají jako statické architektury.

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

3.3 Integrace přes Swift Package Manager

V nabídce Xcode klikněte na Soubor > Swift balíčky > 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 Až další hlavní obor a použijte výchozí možnost.
Zvolte moduly, které potřebujete, ve sloupci Balíček produktu .

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

Poznámka:

Pokud integrujete App Center přes SwiftPM a chcete ho použít i v cíli rozšíření aplikace, ujistěte se, že jste poskytli DISABLE_DIAMOND_PROBLEM_DIAGNOSTIC=YES ve své konfiguraci. To je nezbytné, 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 jsou uvedeny kroky, jak integrovat kompilované binární soubory do vašeho projektu Xcode k nastavení App Center Analytics a App Center Crashes pro vaši iOS aplikaci.

Poznámka:

Sada App Center SDK podporuje použití XCframework. Pokud chcete integrovat XCframeworks do vašeho projektu, stáhněte si AppCenter-SDK-Apple-XCFramework.zip a rozbalte je ze stránky vydaných verzí. Výsledný obsah složky není specifický pro platformu, místo toho 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 frameworky sady App Center SDK ve formátu 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. Volaná AppCenter architektura se v projektu vyžaduje, protože obsahuje kód sdílený 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é jako Dodavatel. Pokud projekt není uspořádaný s podadresářem pro knihovny, vytvořte teď podadresář Vendor .
- Vytvořte skupinu s názvem Vendor v projektu Xcode, která napodobuje strukturu souborů na disku.
Ve Finderu otevřete rozbalenou složku AppCenter-SDK-Apple a zkopírujte ji do složky projektu v umístění, kam ho chcete. 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:
- Ujistěte se, že je navigátor projektu viditelný (⌘+1).
- Nyní 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. Ke spuštění sady SDK se vyžaduje AppCenter.framework . Pokud se do projektu nepřidá, ostatní moduly nebudou fungovat a vaše aplikace se nezkompiluje.
- Zobrazí se dialogové okno, ujistěte se, že je zaškrtnutý správný cíl vaší aplikace. Klikněte na Dokončit.

Teď, když jste integrovali architektury do aplikace, je čas spustit sadu SDK a využívat 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žít. Ve výchozím nastavení nejsou spuštěny žádné moduly a při spuštění sady SDK je nutné volat každý z nich.

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" (ve výchozím nastavení v Xcode 12) a "UI Kit AppDelegate". Pokud vyvíjíte rozšíření, odkažte se na úvodní stránku rozšíření.

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

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

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

import AppCenter
import AppCenterAnalytics
import AppCenterCrashes

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

AppDelegate pro UI Kit

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 uživatelského rozhraní Swiftu

Chcete-li zajistit, aby sada SDK App Center správně fungovala se Swift UI, inicializujte ji po načtení UI. Nejjednodušším způsobem, jak toho dosáhnout, je použití 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 současně předat tajné kódy aplikací pro iOS i macOS:

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

Výstraha

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 nebo spusťte ji s App Secretem.
Pokud se kód 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 vaší aplikace. 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 a můžete zkopírovat celou ukázku.

Výše uvedený příklad ukazuje, jak použít metodu start:withServices (start(withAppSecret:services:) pro Swift) a zahrnout jak App Center Analytics, tak App Center Crashes.

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

Pokud v metodě start explicitně nezadáte každý modul jako parametr, 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í budou do konzoly protokolovat upozornění a budou k dispozici pouze moduly zahrnuté do prvního volání.

Pokud například chcete připojit k 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])

Skvělé, jste připraveni vizualizovat data analytiky a havárií v portálu, která sada SDK shromažďuje automaticky.

Podívejte se na dokumentaci k App Center Analytics a dokumentaci k App Center Crashes, kde se dozvíte, jak přizpůsobit a používat pokročilejší funkce obou služeb.

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

Váš názor

Byla tato stránka užitečná?

Last updated on 2025-05-05

Sdílet prostřednictvím

Začínáme s iOSem

1. Požadavky

2. Vytvoření aplikace na portálu App Center pro získání tajného kódu aplikace

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

3.1 Integrace přes Cocoapods

3.2 Integrace přes Karthage

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

AppDelegate pro UI Kit

Životní cyklus aplikace uživatelského rozhraní Swiftu

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

Váš názor

Další materiály

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