Sdílet prostřednictvím

Začínáme s 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.

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

Pojďme začít s nastavením sady App Center macOS SDK ve vaší aplikaci tak, aby se používaly analýzy App Center a chybové ukončení 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 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.

Poznámka:

Sada App Center SDK přestane podporovat Xcode 10 s červnovou verzí sady SDK.

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

Sada App Center SDK je kompatibilní s Apple Silicon.

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 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 .
  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 , jestli chcete získat 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 do sady App Center SDK 4.0.0 a vyšší .

3.1 Integrace přes Cocoapods

  1. Přidejte následující závislosti do podfile vaší aplikace k zahrnutí App Center Analytics a App Center Crashes. To načte následující frameworky: 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šichni spoléhají na AppCenter. Automaticky se přitá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'

  2. Spusťte pod install k instalaci nově definovaného podu a otevřete projekt .xcworkspace.

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

  2. Spusťte carthage update --platform macOS. 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, 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 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 uvedené kroky pro integraci kompilovaných binárních souborů do projektu Xcode, aby se pro vaši aplikaci macOS nastavily chyby App Center Analytics a App Center.

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.

    • Knihovny třetích stran jsou obvykle v podadresáři (často se tomu říká Dodavatel), takže pokud váš projekt nepoužívá podadresář 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 nepotřebné podsložky.

  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, AppCenterAnalytics.framework a AppCenterCrashes.framework z Finderu (těch uvnitř složky Vendor ) do Navigátoru projektů Xcode. K spuštění sady SDK se vyžaduje appCenter.framework. Pokud chybí 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:

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

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, 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é volat každý z nich. 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 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

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ředat 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])

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:

  1. Nakonfigurujte nebo spusťte ji s App Secretem.
  2. Pokud se kód dá volat vícekrát, zkontrolujte, jestli je App Center už nakonfigurované.
  3. 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 explicitně nezadáte jednotlivé moduly jako parametry 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í 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])

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

Pokud vaše aplikace používá Sandbox aplikace, 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 aplikace, ale možnosti odchozích připojení je potřeba nastavit explicitně.

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

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 Analýzám App Center a dokumentaci o chybách App Center, abyste se dozvěděli, jak přizpůsobit a používat pokročilé funkce každé služby.

  • Last updated on