Začínáme s rozšířeními pro iOS

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.

• Android
• iOS
• Rozšíření iOSu
• React Native
• MAUI/Xamarin
• UWP
• WPF/WinForms
• Unity
• macOS
• rozšíření pro macOS
• tvOS
• Cordova

Rozšíření aplikací podporují pouze zasílání zpráv o chybách.

Informace o tom, jak do aplikace kontejneru přidat sadu App Center SDK, najdete v dokumentaci k app center pro iOS Začínáme.

Začněme nastavením sady App Center iOS SDK v rozšíření aplikace tak, aby používala chybové ukončení 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.

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.

1. Přejděte do appcenter.ms.
2. 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 .
3. Zadejte název a volitelný popis aplikace.
4. Jako operační systém vyberte iOS a jako platformu objective-C/Swift .
5. 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.

Poznámka

Použití existujícího tajného kódu aplikace z jiného projektu iOS má vedlejší účinky. App Center nepodporuje filtrování podle projektu ve stejné aplikaci App Center. Například výpis chybových ukončení pro konkrétní verzi zobrazí seznam všech chyb z obou projektů pro tuto verzi bez rozdílu. Může to být matoucí.

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. Přidání modulů sady App Center SDK

Sadu App Center SDK je možné integrovat do aplikace prostřednictvím Cocoapods, Carthage nebo ručním přidáním binárních souborů do projektu.

3.1 Integrace přes Cocoapods

1. Přidejte do podfile svého zařízení následující závislosti, aby se do aplikace zahrnula chyba app center. Tím se načte následující architektury: AppCenter a AppCenterCrashes.

    pod 'AppCenter/Crashes'
   

2. 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.

1. Přidejte do Cartfile svého zařízení následující závislosti, aby se do vaší aplikace zahrnula služba App Center. Tím se načítá všechna rozhraní. Pak můžete propojit pouze tyto architektury, které se budou používat ve vaší 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
   

2. Spusťte carthage update. Tím se načte závislosti do složky Carthage/Checkouts a pak se sestaví každá architektura.

3. Otevřete kartu Obecné nastavení cíle aplikace. Přetáhněte soubory AppCenter.framework a AppCenterCrashes.framework ze složky Carthage/Build/ 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.

4. 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

1. V nabídce Xcode klikněte na File Swift Packages (Soubor > balíčků Swift) > Add Package Dependency (Přidat závislost balíčku).
2. V dialogovém okně, které se zobrazí, zadejte adresu URL úložiště: https://github.com/microsoft/appcenter-sdk-apple.git.
3. V části Verze vyberte Up to Next Major (Až na další hlavní obor ) a použijte výchozí možnost.
4. 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 a nastavení chyb app Center pro rozšíření aplikace.

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.

1. Stáhněte si architektury sady App Center SDK , které jsou k dispozici jako soubor ZIP.

2. 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.

3. [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.

4. 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.

5. Přidejte do projektu v Xcode architektury sady SDK:

   • Zkontrolujte, jestli je navigátor projektu viditelný (⌘+1).
   • Teď přetáhněte AppCenter.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 rozšíření aplikace se nezkompiluje.
   • Zobrazí se dialogové okno se zaškrtnutým cílem rozšíření aplikace. Klikněte na Dokončit.

Teď, když jste integrovali architektury do rozšíření 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, musíte se přihlásit k modulům, které chcete použít. Ve výchozím nastavení se nespouští žádné moduly a každý z nich musíte při spuštění sady SDK explicitně volat.

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

Do souboru obsahujícího vstupní bod rozšíření aplikace vložte následující řádky. Například uvnitř hlavního souboru ViewController přípony Today.

@import AppCenter;
@import AppCenterCrashes;

import AppCenter
import AppCenterCrashes

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

Do vstupního bodu rozšíření aplikace vložte následující řádek. Například uvnitř viewDidLoad metody hlavního souboru ViewController přípony Today.

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

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

V současné době je pro rozšíření aplikací podporováno pouze hlášení chybových ukončení.

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

Nezapomeňte nahradit {Your App Secret} text skutečnou hodnotou pro rozšíření 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. Můžete zkopírovat a vložit celou ukázku.

Skvělé, máte všechno nastavené tak, abyste na portálu vizualizovali data o chybách, která sada SDK shromažďuje automaticky.

V dokumentaci k chybám App Center se dozvíte, jak přizpůsobit rozšíření aplikace a používat pokročilejší funkce.