Wprowadzenie do systemu macOS

Ważne

Program Visual Studio App Center ma zostać wycofany 31 marca 2025 r. Mimo że możesz nadal używać programu Visual Studio App Center do momentu jej pełnego wycofania, istnieje kilka zalecanych alternatyw, do których można rozważyć migrację.

Dowiedz się więcej o osiach czasu pomocy technicznej i alternatywach.

• Android
• iOS
• Rozszerzenia systemu iOS
• React Native
• MAUI/Xamarin
• UWP
• WPF/WinForms
• Unity
• macOS
• Rozszerzenia systemu macOS
• tvOS
• Cordova

Zestaw SDK centrum aplikacji korzysta z architektury modułowej, aby można było używać dowolnych lub wszystkich usług.

Zacznijmy od konfigurowania zestawu SDK systemu macOS w usłudze App Center w aplikacji w celu korzystania z usług App Center Analytics i App Center Crash.

1. Wymagania wstępne

Aby korzystać z zestawu SDK centrum aplikacji, należy spełnić następujące wymagania:

• Projekt systemu macOS został skonfigurowany w programie Xcode 13 lub nowszym w systemie macOS w wersji 10.14.4 lub nowszej.
• Dotyczysz urządzeń z systemem macOS 10.13 lub nowszym.
• Nie używasz żadnej innej biblioteki, która zapewnia funkcję raportowania awarii.

Uwaga

Zestaw SDK centrum aplikacji spadnie obsługę środowiska Xcode 10 wraz z czerwcowym wydaniem zestawu SDK.

Analiza i awarie zestawu SDK usługi App Center są zgodne z narzędziem Mac Catalyst za pośrednictwem narzędzia XCFramework lub SwiftPM.

Zestaw SDK usługi App Center jest zgodny z aplikacją Apple Silicon.

2. Utwórz aplikację w portalu Centrum aplikacji, aby uzyskać wpis tajny aplikacji

Jeśli aplikacja została już utworzona w portalu Centrum aplikacji, możesz pominąć ten krok.

1. Przejdź do appcenter.ms.
2. Zarejestruj się lub zaloguj się i naciśnij niebieski przycisk w prawym górnym rogu portalu z komunikatem Dodaj nową i wybierz pozycję Dodaj nową aplikację z menu rozwijanego.
3. Wprowadź nazwę i opcjonalny opis aplikacji.
4. Wybierz system macOS jako system operacyjny i objective-C/Swift jako platformę.
5. Naciśnij przycisk w prawym dolnym rogu, który wskazuje polecenie Dodaj nową aplikację.

Po utworzeniu aplikacji możesz uzyskać jej wpis tajny aplikacji na stronie Ustawienia w portalu Centrum aplikacji. W prawym górnym rogu strony Ustawienia kliknij potrójne pionowe kropki i wybierz, Copy app secret aby uzyskać wpis tajny aplikacji.

3. Dodawanie modułów zestawu SDK centrum aplikacji

Zestaw SDK centrum aplikacji dla systemu macOS można dodać do aplikacji za pośrednictwem cocoapods, Carthage, Swift Package Manager lub ręcznie dodając pliki binarne do projektu.

Uwaga

4.0.0 Wprowadzono zmiany powodujące niezgodność w usłudze App Center. Postępuj zgodnie z sekcją Migrowanie do zestawu APP Center SDK 4.0.0 i nowszych , aby przeprowadzić migrację usługi App Center z poprzednich wersji.

3.1 Integracja za pośrednictwem cocoapods

1. Dodaj następujące zależności, podfile aby uwzględnić usługę App Center Analytics i App Center Awarie w aplikacji. Jest to ściągane w następujących strukturach: AppCenter, AppCenterAnalytics i AppCenterCrashes. Zamiast tego możesz określić, które usługi mają być używane w aplikacji. Każda usługa ma własny podzec i wszystkie polegają na AppCenter. Zostanie on ściągnięty automatycznie.

    # 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. Uruchom polecenie pod install , aby zainstalować nowo zdefiniowany zasobnik i otworzyć projekt .xcworkspace.

Teraz, po zintegrowaniu struktur w aplikacji, nadszedł czas, aby uruchomić zestaw SDK i korzystać z usług App Center.

3.2 Integracja za pośrednictwem Carthage

Poniżej przedstawiono kroki integracji zestawu SDK centrum aplikacji w projekcie Xcode przy użyciu pakietu Carthagew wersji 0.30 lub nowszej, zdecentralizowanego menedżera zależności, który tworzy zależności i udostępnia struktury binarne.

1. Dodaj następujące zależności do aplikacji Cartfile , aby uwzględnić centrum aplikacji w aplikacji. Jest to ściągane we wszystkich strukturach. Następnie możesz połączyć tylko te struktury, których chcesz użyć w aplikacji.

   # 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. Uruchom polecenie carthage update --platform macOS. Spowoduje to pobranie zależności do folderu Carthage/Checkouts , a następnie skompilowanie każdej platformy.

3. Otwórz kartę Ustawienia ogólne aplikacji. Przeciągnij i upuść pliki AppCenter.framework, AppCenterAnalytics.framework i AppCenterCrashes.framework z folderu Carthage/Build/macOS do nawigatora projektu Xcode. Do uruchomienia zestawu SDK jest wymagany program AppCenter.framework . Jeśli nie zostanie on dodany do projektu, inne moduły nie będą działać, a aplikacja nie zostanie skompilowana.

4. Zostanie wyświetlone okno dialogowe, upewnij się, że element docelowy aplikacji jest zaznaczony. Następnie kliknij przycisk Zakończ.

   Uwaga

   Jeśli używasz carthage copy-frameworks w fazie kompilacji , nie należy dodawać zestawów SDK centrum aplikacji, ponieważ są one dostarczane jako struktury statyczne.

Teraz, po zintegrowaniu struktur w aplikacji, nadszedł czas, aby uruchomić zestaw SDK i korzystać z usług App Center.

3.3 Integracja za pośrednictwem menedżera pakietów Swift

1. W menu Xcode kliknij pozycję File Swift Packages > Add Package Dependency (Dodaj > zależność pakietów Swift).
2. W wyświetlonym oknie dialogowym wprowadź adres URL repozytorium: https://github.com/microsoft/appcenter-sdk-apple.git.
3. W obszarze Wersja wybierz pozycję Do następnej wersji głównej i wybierz opcję domyślną.
4. Wybierz moduły potrzebne w kolumnie Package Product (Produkt pakietu ).

Teraz, po zintegrowaniu struktur w aplikacji, nadszedł czas, aby uruchomić zestaw SDK i korzystać z usług App Center.

Uwaga

Jeśli integrujesz centrum aplikacji za pośrednictwem aplikacji SwiftPM i chcesz go użyć również w docelowym miejscu docelowym rozszerzenia aplikacji, upewnij się, że w konfiguracji jest ona udostępniana DISABLE_DIAMOND_PROBLEM_DIAGNOSTIC=YES . Jest to konieczne, aby uniknąć ograniczeń swiftPM podczas łączenia modułu z wieloma elementami docelowymi.

3.4 Integracja przez skopiowanie plików binarnych do projektu

Poniżej przedstawiono kroki integracji skompilowanych plików binarnych w projekcie Xcode w celu skonfigurowania usługi App Center Analytics i awarii centrum aplikacji dla systemu macOS.

Uwaga

Zestaw SDK usługi App Center obsługuje korzystanie z usługi XCframework. Jeśli chcesz zintegrować aplikację XCframeworks z projektem, pobierz AppCenter-SDK-Apple-XCFramework.zip ze strony wydań i rozpakuj go. Wynikowa zawartość folderu nie jest specyficzna dla platformy, zamiast tego zawiera element XCframeworks dla każdego modułu. Można je zintegrować w taki sam sposób jak w zwykłych strukturach, jak opisano poniżej.

1. Pobierz struktury zestawu SDK centrum aplikacji udostępnione jako plik zip.

2. Rozpakuj plik i zobaczysz folder o nazwie AppCenter-SDK-Apple zawierający różne struktury dla każdej usługi App Center w każdym folderze platformy. Struktura o nazwie AppCenter jest wymagana w projekcie, ponieważ zawiera kod współużytkowany między różnymi modułami.

3. [Opcjonalnie] Utwórz podkatalog dla bibliotek innych firm.

   • Biblioteki innych firm są zwykle w podkatalogu (często nazywane dostawcą), więc jeśli projekt nie używa podkatalogu dla bibliotek, utwórz teraz podkatalog Vendor .
   • Utwórz grupę o nazwie Vendor wewnątrz projektu Xcode, aby naśladować strukturę plików na dysku.

4. Otwórz rozpakowany folder AppCenter-SDK-Apple w programie Finder i skopiuj folder do folderu projektu w lokalizacji, w której chcesz. Folder zawiera struktury w podfolderach dla innych platform, które obsługuje zestaw SDK centrum aplikacji, więc może być konieczne usunięcie niepotrzebnych podfolderów.

5. Dodaj struktury zestawu SDK do projektu w środowisku Xcode:

   • Upewnij się, że nawigator projektu jest widoczny ((*)+1).
   • Teraz przeciągnij i upuść plik AppCenter.framework, AppCenterAnalytics.framework i AppCenterCrashes.framework z narzędzia Finder (tych w folderze Vendor ) do nawigatora projektu Xcode. Do uruchomienia zestawu SDK jest wymagany program AppCenter.framework. Jeśli brakuje innych modułów, nie będzie działać, a aplikacja nie zostanie skompilowana.
   • Zostanie wyświetlone okno dialogowe, upewnij się, że element docelowy aplikacji jest zaznaczony. Następnie kliknij przycisk Zakończ.

Uwaga

Plik binarny zestawu SDK nie jest spakowany zgodnie z konwencją struktury systemu macOS. Powodem jest to, że zestaw SDK centrum aplikacji dla komputerów Mac nie jest konwencjonalną strukturą, ale statyczną. Musisz połączyć ją jako strukturę statyczną: upewnij się, że nie osadzasz plików binarnych i nie dołączaj ich do fazy kompilacji "kopiuj zasoby pakietu".

Teraz, po zintegrowaniu struktur w aplikacji, nadszedł czas, aby uruchomić zestaw SDK i korzystać z usług App Center.

4. Uruchamianie zestawu SDK

Aby korzystać z usługi App Center, musisz wyrazić zgodę na moduły, których chcesz użyć. Domyślnie nie są uruchamiane żadne moduły i podczas uruchamiania zestawu SDK należy wywoływać poszczególne moduły. Jeśli tworzysz rozszerzenie, zapoznaj się ze stroną Wprowadzenie do rozszerzenia.

4.1 Dodawanie instrukcji importu

Otwórz plik AppDelegate projektu i dodaj następujące instrukcje importowania:

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

import AppCenter
import AppCenterAnalytics
import AppCenterCrashes

4.2 Dodawanie start:withServices: metody

Wstaw następujący wiersz w metodzie delegata didFinishLaunchingWithOptions aplikacji:

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

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

Jeśli masz aplikację Catalyst, możesz jednocześnie przekazać wpisy tajne aplikacji dla systemów 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])

Ostrzeżenie

Nie zaleca się osadzania wpisu tajnego aplikacji w kodzie źródłowym.

Jeśli musisz uruchomić usługi App Center oddzielnie, wykonaj następujące kroki:

1. Skonfiguruj lub uruchom go za pomocą wpisu tajnego aplikacji.
2. Jeśli kod może być wywoływany wiele razy, sprawdź, czy centrum aplikacji jest już skonfigurowane.
3. Uruchom wymagane usługi bez wpisu tajnego aplikacji.

[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 Zastąp symbol zastępczy wpisem tajnym aplikacji

Pamiętaj, aby zastąpić {Your App Secret} tekst rzeczywistą wartością aplikacji. Wpis tajny aplikacji można znaleźć na stronie Wprowadzenie lub stronie Ustawienia w portalu Centrum aplikacji.

Strona Wprowadzenie zawiera powyższy przykładowy kod z wpisem tajnym aplikacji. Możesz skopiować i wkleić cały przykład.

W powyższym przykładzie pokazano, jak używać start:withServices metody (start(withAppSecret:services:) dla języka Swift) i uwzględnić zarówno analizę centrum aplikacji, jak i awarie centrum aplikacji.

Jeśli nie chcesz używać jednej z dwóch usług, usuń odpowiedni parametr z powyższego wywołania metody.

Jeśli nie określisz jawnie każdego modułu jako parametrów w metodzie startowej, nie możesz użyć tej usługi Centrum aplikacji. start:withServices Ponadto interfejs API (start(withAppSecret:services:) dla języka Swift) może być używany tylko raz w cyklu życia aplikacji — wszystkie inne wywołania będą rejestrować ostrzeżenie do konsoli, a tylko moduły zawarte w pierwszym wywołaniu będą dostępne.

Na przykład — jeśli chcesz dołączyć do usługi App Center Analytics, zmodyfikuj wywołanie interfejsu start:withServices API (start(withAppSecret:services:) for Swift) w następujący sposób:

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

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

4.4. Dodawanie możliwości internetowych dla aplikacji w trybie piaskownicy

Jeśli aplikacja korzysta z piaskownicy aplikacji, musisz ustawić możliwość zezwalania na połączenia wychodzące (klienta) w celu umożliwienia aplikacji dostępu do Internetu. Program Xcode 9 domyślnie włącza piaskownicę aplikacji, ale możliwości dla połączeń wychodzących muszą być ustawiane jawnie.

Wybierz projekt w nawigatorze projektu, wybierz kartę Możliwości , a jeśli aplikacja korzysta z piaskownicy, włącz połączenia wychodzące.

---

Świetnie— wszystko jest gotowe do wizualizacji danych analizy i awarii w portalu, które zestaw SDK zbiera automatycznie.

Zapoznaj się z dokumentami usługi App Center Analytics i Dokumentami awarii usługi App Center, aby dowiedzieć się, jak dostosowywać i używać zaawansowanych funkcji poszczególnych usług.