Začínáme s macOS

Článek
03/17/2024

Důležité

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

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 libovolnou nebo všechny služby.

Začněme nastavením sady App Center pro macOS SDK ve vaší aplikaci tak, aby používala analýzu App Center a chybové ukončení App Centeru.

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 macOS je nastavený v Xcode 13 nebo novějším v systému 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 funkci zasílání zpráv o chybách.

Poznámka

Sada App Center SDK zruší podporu Xcode 10 s červnovou verzí sady SDK.

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

Sada App Center SDK je kompatibilní s Apple Silicon.

2. Vytvořte aplikaci na portálu App Center a získejte tajný kód 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 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 macOS a jako platformu Objective-C/Swift .
V pravém dolním rohu klikněte na tlačítko Přidat novou aplikaci.

Po vytvoření aplikace můžete získat její tajný kód aplikace 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 vyberte Copy app secret , abyste získali tajný kód aplikace.

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

Sadu App Center SDK pro macOS 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

Přidejte do své podfile aplikace následující závislosti, které zahrnují App Center Analytics a App Center Crashes. Tím se vyžádají následující architektury: AppCenter, AppCenterAnalytics a AppCenterCrashes. Místo toho můžete určit, které služby chcete ve své aplikaci používat. Každá služba má svůj vlastní subspec a všechny spoléhají na AppCenter. Automaticky se vytáhne.
```
 # Use the following line to use App Center Analytics and Crashes.
 pod 'AppCenter'

 # Use the following lines if you want to specify which service you want to use.
 pod 'AppCenter/Analytics'
 pod 'AppCenter/Crashes'
```
Spuštěním příkazu pod install nainstalujte nově definovaný pod a otevřete projekt .xcworkspace.

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

3.2 Integrace přes Kartáž

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.

Přidejte do své Cartfile aplikace následující závislosti, které budou zahrnovat App Center. To vytáhne všechny architektury. 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

Spusťte carthage update --platform macOS. Tím se načte závislosti do složky Carthage/Checkouts a pak sestaví 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/macOS 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 nebude kompilovat.
Zobrazí se dialogové okno a zkontrolujte, jestli je zaškrtnutý cíl aplikace. Klikněte na Dokončit.

Poznámka

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

Teď, když jste do své aplikace integrovali architektury, 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 Add Packages > 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 Až další hlavní a použijte výchozí možnost.
Vyberte moduly, které potřebujete, ve sloupci Balíček produktu .

Teď, když jste do své aplikace integrovali architektury, 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 i 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 pro nastavení analýzy App Centeru a chyb app center pro aplikaci pro macOS.

Poznámka

Sada App Center SDK podporuje použití nástroje XCframework. Pokud chcete do 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 poskytované 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 v 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.
- Knihovny třetích stran jsou obvykle v podadresáři (často se nazývá Dodavatel), takže pokud váš projekt nepoužívá podadresář pro knihovny, vytvořte teď podadresář Vendor .
- Vytvořte v projektu Xcode skupinu s názvem Dodavatel , která bude napodobovat strukturu souborů na disku.
Otevřete ve Finderu rozbalenou složku AppCenter-SDK-Apple a zkopírujte ji do složky projektu na požadovaném místě. Složka obsahuje architektury v podsložkách pro jiné platformy, které podporuje sada App Center SDK, takže možná budete muset odstranit nepotřebné podsložky.
Přidejte rozhraní SDK do projektu v Xcode:
- Ujistěte se, že je viditelný Navigátor projektu (⌘+1).
- Teď přetáhněte AppCenter.framework, AppCenterAnalytics.framework a AppCenterCrashes.framework z Finderu (ty ve složce Vendor ) do Navigátoru projektu Xcode. Ke spuštění sady SDK se vyžaduje AppCenter.framework. Pokud chybí, ostatní moduly nebudou fungovat a vaše aplikace se nebude kompilovat.
- Zobrazí se dialogové okno a zkontrolujte, jestli je zaškrtnutý cíl aplikace. Klikněte na Dokončit.

Poznámka

Binární soubor sady SDK není zabalený podle konvencí architektury macOS. Důvodem je, že sada App Center SDK pro Mac není konvenční architektura, ale statická. Musíte ho propojit jako statickou architekturu: ujistěte se, že nevkládáte binární soubory a nezahrnujte je do fáze sestavení "kopírování prostředků balíčků".

Teď, když jste do své aplikace integrovali architektury, 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žívat. Ve výchozím nastavení se nespouští žádné moduly a při spuštění sady SDK je nutné volat každý z nich. Pokud vyvíjíte rozšíření, projděte si stránku Začínáme s rozšířením.

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

Otevřete soubor AppDelegate projektu 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

Do metody delegáta didFinishLaunchingWithOptions aplikace vložte následující řádek:

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

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

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

[MSACAppCenter start:@"ios={Your iOS App Secret};macos={Your macOS App Secret}" withServices:@[[MSACAnalytics class], [MSACCrashes class]]];

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

Upozornění

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

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

Nakonfigurujte nebo spusťte tajný kód 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. Můžete zkopírovat a vložit celou ukázku.

Výše uvedený příklad ukazuje, jak používat metodu start:withServices (start(withAppSecret:services:) pro Swift) a zahrnout jak App Center Analytics, tak i chybové ukončení App Centeru.

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 v metodě start explicitně nezadáte jednotlivé moduly jako parametry, nemůžete tuto službu App Center použít. start:withServices Rozhraní API (start(withAppSecret:services:)pro Swift) se navíc dá v životním cyklu vaší aplikace použít jenom jednou – všechna ostatní volání budou do konzoly protokolovat upozornění a dostupné budou pouze moduly zahrnuté v prvním volání.

Například pokud 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])

4.4 Přidání možností internetu pro aplikace v izolovaném prostoru (sandbox)

Pokud vaše aplikace používá sandbox aplikací, musíte nastavit možnost povolit odchozí (klientská) připojení, aby měla aplikace přístup k internetu. Xcode 9 ve výchozím nastavení povoluje sandbox aplikací, ale možnosti odchozích připojení je potřeba nastavit explicitně.

V navigátoru projektu vyberte svůj projekt, vyberte kartu Schopnosti a pokud vaše aplikace používá sandbox, povolte odchozí připojení.

Skvělé, na portálu, který sada SDK shromažďuje automaticky, můžete vizualizovat data analýzy a chybových ukončení.

Projděte si dokumentaci k App Center Analytics a dokumentaci k chybám App Center , kde se dozvíte, jak přizpůsobit a používat pokročilé funkce jednotlivých služeb.

Sdílet prostřednictvím

Začínáme s macOS

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 Kartáž

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

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

4.4 Přidání možností internetu pro aplikace v izolovaném prostoru (sandbox)

Další materiály

Sdílet prostřednictvím

Začínáme s macOS

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 Kartáž

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

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

4.4 Přidání možností internetu pro aplikace v izolovaném prostoru (sandbox)

Další materiály

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