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

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.

• Android
• Ios
• Rozšíření pro iOS
• React Native
• MAUI/Xamarin
• UPW
• WPF/WinForms
• Jednota
• macOS
• Rozšíření pro macOS
• tvOS

Rozšíření podporují pouze hlášení pádů.

Informace o přidání sady App Center SDK do aplikace kontejneru najdete v dokumentaci k sadě App Center pro macOS Začínáme.

Začněme nastavením App Center macOS SDK v rozšíření aplikace pro použití funkce App Center Crashes.

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 macOS 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 macOS 10.13 nebo novějším.
• Nepoužíváte žádnou jinou knihovnu, která poskytuje funkce zasílání zpráv o chybách.

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.

1. Přejděte na 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 nový a v rozevírací nabídce vyberte Přidat novou aplikaci .
3. Zadejte název a volitelný popis aplikace.
4. Jako platformu vyberte macOS a Objective-C/Swift .
5. 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 tajný kód aplikace.

Poznámka:

Použití existujícího tajného kódu aplikace z jiného projektu macOS má vedlejší účinky. App Center nepodporuje filtrování podle projektu ve stejné aplikaci App Center. Například vypsání pádů pro konkrétní verzi zobrazí všechny pády 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 do sady 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 následující závislosti, abyste zahrnuli App Center Crashes do vaší aplikace. To načte následující frameworky: AppCenter a AppCenterCrashes.

    pod 'AppCenter/Crashes'
   

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

1. Přidejte do své Cartfile aplikace následující závislosti, které do aplikace zahrnou App Center. To načítá všechny rámce. Pak můžete propojit jenom ty architektury, které se mají použít 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 vytvoří 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/ folder do navigátoru projektu 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.

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

1. V nabídce Xcode klikněte na Soubor > Swift balíčky > 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 Až další hlavní obor a použijte výchozí možnost.
4. 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 projektu Xcode pro nastavení App Center Crashes ve vašem rozšíření aplikace.

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.

1. Stáhněte si frameworky sady App Center SDK ve formátu 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. Volaná AppCenter architektura se v projektu vyžaduje, protože obsahuje kód sdílený 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é 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.

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

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

   • Ujistěte se, že 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 projektu Xcode. Ke spuštění sady SDK se vyžaduje AppCenter.framework . Pokud se nepřidá do projektu, ostatní moduly nebudou fungovat a rozšíření aplikace se nezkompiluje.
   • Zobrazí se dialogové okno, ujistěte se, že je cíl rozšíření aplikace zaškrtnutý. Klikněte na Dokončit.

Teď, když jste integrovali architektury do rozšíření 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, musíte se přihlásit 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é explicitně volat jednotlivé moduly.

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 rozšíření 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ř metody viewDidLoad hlavního souboru ViewController rozšíření Today.

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

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

V současné době se u rozšíření aplikací podporuje pouze hlášení pádů.

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

Nezapomeňte nahradit {Your App Secret} text skutečnou hodnotou rozšíření 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.

Skvělé, máte vše připraveno pro vizualizaci dat o pádech aplikací na portálu, které sada SDK shromažďuje automaticky.

Podívejte se do dokumentace App Center Crashes, kde se dozvíte, jak přizpůsobit rozšíření aplikace a používat pokročilejší funkce.