Wprowadzenie do rozszerzeń systemu macOS

Rozszerzenia obsługują tylko raportowanie awarii.

Aby dowiedzieć się, jak dodać zestaw SDK centrum aplikacji do aplikacji kontenera, zapoznaj się z dokumentacją dotyczącą programu App Center dla systemu macOS — wprowadzenie.

Zacznijmy od skonfigurowania zestawu SDK App Center dla systemu macOS w rozszerzeniu aplikacji, aby móc korzystać z funkcji App Center Crashes.

1. Wymagania wstępne

Aby można było korzystać z zestawu SDK usługi App Center, należy spełnić następujące wymagania:

• Projekt dla macOS jest skonfigurowany w Xcode 13 lub nowszym na macOS w wersji 10.14.4 lub nowszej.
• Dotyczy to urządzeń z systemem macOS 10.13 lub nowszym.
• Nie używasz żadnej innej biblioteki, która zapewnia funkcję raportowania awarii.

2. Utwórz swoją aplikację w Centrum aplikacji Portalu, aby uzyskać tajny klucz 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 język Objective-C/Swift jako platformę.
5. Naciśnij przycisk w prawym dolnym rogu z napisem 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 kropki pionowe i wybierz Copy app secret, aby uzyskać Sekret aplikacji.

3. Dodawanie modułów zestawu SDK usługi App Center

Zestaw SDK App Center można zintegrować z aplikacją za pomocą Cocoapods, Carthage lub poprzez ręczne dodanie plików binarnych do projektu.

3.1 Integracja za pośrednictwem cocoapods

1. Dodaj następujące zależności do podfile, aby zintegrować funkcję App Center Crashes z aplikacją. Spowoduje to ściągnięcie następujących struktur: AppCenter i AppCenterCrashes.

    pod 'AppCenter/Crashes'
   

2. Uruchom pod install, aby zainstalować nowo zdefiniowany pod i otworzyć projekt .xcworkspace.

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 procedurę integrowania zestawu SDK centrum aplikacji w projekcie Xcode przy użyciu programu 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 Cartfile, aby dodać App Center do swojej aplikacji. Spowoduje to ściągnięcie wszystkich struktur. Następnie możesz połączyć tylko te struktury, które będą używane 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 program carthage update. 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 docelowej. Przeciągnij i upuść pliki AppCenter.framework i AppCenterCrashes.framework z folderu Carthage/Build/ do nawigatora projektu Xcode. Do uruchomienia zestawu SDK jest wymagany program AppCenter.framework . Jeśli nie zostanie 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 docelowa aplikacja jest zaznaczona. Następnie kliknij przycisk Zakończ.

   Uwaga / Notatka

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

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. Z menu Xcode kliknij pozycję File > Swift Packages > Dodaj zależność pakietu.
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 kolejnej wersji głównej, a następnie opcję domyślną.
4. Wybierz moduły potrzebne w kolumnie Package Product (Produkt pakietu ).

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

3.4 Integracja przez skopiowanie plików binarnych do projektu

Poniżej przedstawiono procedurę integrowania skompilowanych plików binarnych w projekcie Xcode w celu skonfigurowania usługi App Center Crash dla rozszerzenia aplikacji.

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.

   • Najlepszym rozwiązaniem jest to, że biblioteki innych firm są zwykle w podkatalogu, często nazywanego dostawcą. Jeśli projekt nie jest zorganizowany przy użyciu 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 podfolderów, których nie potrzebujesz.

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 i AppCenterCrashes.framework z narzędzia Finder (w lokalizacji z poprzedniego kroku) do nawigatora projektu Xcode. Do uruchomienia zestawu SDK jest wymagany program AppCenter.framework . Jeśli nie zostanie dodany do projektu, pozostałe moduły nie będą działać, a rozszerzenie aplikacji nie zostanie skompilowane.
   • Zostanie wyświetlone okno dialogowe, upewnij się, że element docelowy rozszerzenia aplikacji jest zaznaczony. Następnie kliknij przycisk Zakończ.

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

4. Uruchamianie zestawu SDK

Aby korzystać z Centrum aplikacji, musisz wyrazić zgodę na korzystanie z modułów. Domyślnie podczas uruchamiania zestawu SDK nie są uruchamiane żadne moduły i należy jawnie wywołać każde z nich.

4.1 Dodaj instrukcje importu

Wstaw następujące wiersze w pliku zawierającym punkt wejścia rozszerzenia aplikacji. Na przykład wewnątrz głównego pliku ViewController rozszerzenia Today.

@import AppCenter;
@import AppCenterCrashes;

import AppCenter
import AppCenterCrashes

4.2. Dodawanie start:withServices: metody

Wstaw następujący wiersz do punktu wejścia rozszerzenia aplikacji. Na przykład wewnątrz viewDidLoad metody głównego pliku ViewController rozszerzenia Today.

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

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

Obecnie tylko raportowanie awarii jest obsługiwane w przypadku rozszerzeń aplikacji.

4.3 Zastąp zastępczy tekst sekretem swojej aplikacji

Pamiętaj, aby zastąpić {Your App Secret} tekst rzeczywistą wartością rozszerzenia 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, zawierający twój tajny klucz aplikacji. Możesz skopiować i wkleić cały ten przykład.

Wszystko jest gotowe, aby wizualizować dane awarii w portalu, które zestaw SDK zbiera automatycznie.

Zapoznaj się z dokumentacją dotyczącą awarii centrum aplikacji , aby dowiedzieć się, jak dostosować rozszerzenie aplikacji i korzystać z bardziej zaawansowanych funkcji.