Wprowadzenie do systemu iOS

2025-05-05

Ważne

Program Visual Studio App Center został wycofany 31 marca 2025 r. z wyjątkiem funkcji analizy i diagnostyki, które będą nadal obsługiwane do 30 czerwca 2026 r. Dowiedz się więcej.

Zestaw SDK centrum aplikacji korzysta z architektury modułowej, dzięki czemu można używać dowolnych lub wszystkich usług.

Informacje o danych zbieranych przez App Center można znaleźć na stronach Zebrane dane przez SDK App Center, Ogólnego Rozporządzenia o Ochronie Danych (GDPR), oraz FAQ. Ponadto często zadawane pytania zawierają odpowiedzi, które należy podać dla konfiguracji prywatności w sklepie App Store.

Zacznijmy od konfigurowania App Center iOS SDK w Twojej aplikacji, aby móc korzystać z App Center Analytics i App Center Crashes. Aby dodać usługę App Center Distribute do aplikacji, zapoznaj się z dokumentacją dotyczącą dystrybucji centrum aplikacji.

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 systemu iOS jest skonfigurowany w programie Xcode 13 lub nowszym w systemie macOS w wersji 10.14.4 lub nowszej.
Dotyczy to urządzeń z systemem ios 11.0 lub nowszym.
Nie używasz żadnej innej biblioteki, która zapewnia funkcję raportowania awarii (tylko w przypadku awarii centrum aplikacji).
Jeśli używasz narzędzia CocoaPods do integracji z usługą App Center, potrzebujesz aplikacji CocoaPods w wersji 1.10 lub nowszej.

Analizy i zdarzenia crash zestawu SDK App Center są kompatybilne z Mac Catalyst poprzez XCFramework lub SwiftPM.

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.

Przejdź do appcenter.ms.
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.
Wprowadź nazwę i opcjonalny opis aplikacji.
Wybierz system iOS jako system operacyjny i język Objective-C/Swift jako platformę.
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 w menu z trzema kropkami i wybierz Copy app secret, aby uzyskać Tajemnicę aplikacji.

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

Zestaw SDK centrum aplikacji dla systemu iOS można dodać do aplikacji za pomocą narzędzia Cocoapods, Carthage, Swift Package Manager lub ręcznie dodając pliki binarne do projektu.

Uwaga / Notatka

W wersji 4.0.0 App Center wprowadzono zmiany powodujące niezgodność. Postępuj zgodnie z sekcją Migrate to App Center SDK 4.0.0 and higher (Migrowanie do zestawu APP Center SDK 4.0.0 i nowszych ), aby przeprowadzić migrację centrum aplikacji z poprzednich wersji.

3.1 Integracja za pośrednictwem cocoapods

Uwaga / Notatka

Symulatory ARM64 uruchamiane z programu Xcode na komputerach Apple Silicon Mac nie są obsługiwane za pośrednictwem CocoaPods, rozważ użycie innych metod integracji, aby to działało poprawnie.

Dodaj następujące zależności do podfile, aby uwzględnić App Center Analytics i App Center Crashes w aplikacji. Ta akcja ściąga następujące struktury: AppCenter, AppCenterAnalytics i AppCenterCrashes. Zamiast tego możesz określić żądane usługi w aplikacji. Każda usługa ma własny podsekec i wszystkie korzystają z aplikacji AppCenter. Zostanie automatycznie ściągnięty.
```
 # Use the following line to use App Center Analytics and Crashes.x
 pod 'AppCenter'

 # Use the following lines if you want to specify which service you want to use.
 pod 'AppCenter/Analytics'
 pod 'AppCenter/Crashes'
 pod 'AppCenter/Distribute'
```
Uruchom pod install, aby zainstalować nowo zdefiniowany pod i otworzyć projekt .xcworkspace.

Uwaga / Notatka

Jeśli podczas uruchamiania [!] Unable to find a specification for `AppCenter` zostanie wyświetlony błąd pod install, uruchom pod repo update aby pobrać najnowsze zasobniki z repozytorium Cocoapods, a następnie uruchom pod install.

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.

Uwaga / Notatka

Integracja z Carthage nie działa automatycznie w środowisku Xcode 12. Aby to zrobić, zapoznaj się z tą instrukcją Carthage

Dodaj następujące zależności do elementu Cartfile , aby uwzględnić centrum aplikacji. Te zależności ściągają wszystkie struktury. 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
```
Uruchom polecenie carthage update , aby pobrać zależności do folderu Carthage/Checkouts . Następnie zbuduj każdy framework.
Otwórz kartę Ustawienia ogólne aplikacji docelowej. Przeciągnij i upuść pliki AppCenter.framework, AppCenterAnalytics.framework i AppCenterCrashes.framework z folderu Carthage/Build/iOS 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.
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

Z menu Xcode kliknij pozycję File > Swift Packages > Dodaj zależność pakietu.
W wyświetlonym oknie dialogowym wprowadź adres URL repozytorium: https://github.com/microsoft/appcenter-sdk-apple.git.
W obszarze Wersja wybierz pozycję Do kolejnej wersji głównej, a następnie opcję domyślną.
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.

Uwaga / Notatka

Jeśli integrujesz App Center za pośrednictwem SwiftPM i chcesz używać go również w celu rozszerzenia aplikacji, upewnij się, że w konfiguracji określono DISABLE_DIAMOND_PROBLEM_DIAGNOSTIC=YES. Jest to konieczne, aby uniknąć ograniczeń swiftPM w łączeniu modułu z wieloma miejscami docelowymi.

3.4 Integracja przez skopiowanie plików binarnych do projektu

Poniżej przedstawiono kroki integracji skompilowanych plików binarnych w projekcie Xcode do skonfigurowania usług App Center Analytics i App Center Crashes dla aplikacji na system iOS.

Uwaga / Notatka

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

Pobierz struktury zestawu SDK centrum aplikacji udostępnione jako plik zip.
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.
[Opcjonalnie] Utwórz podkatalog dla bibliotek innych firm.
- Najlepszym rozwiązaniem jest to, że biblioteki innych firm znajdują się zwykle w podkatalogu, często nazywanym Vendor. 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.
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.
Dodaj struktury zestawu SDK do projektu w środowisku Xcode:
- Upewnij się, że nawigator projektu jest widoczny (⌘+1).
- Teraz przeciągnij i upuść AppCenter.framework, AppCenterAnalytics.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, inne moduły nie będą działać, a aplikacja nie zostanie skompilowana.
- Zostanie wyświetlone okno dialogowe, upewnij się, że docelowa aplikacja jest zaznaczona. Następnie kliknij przycisk Zakończ.

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

4. Uruchamianie zestawu SDK

Aby użyć centrum aplikacji, wybierz 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.

Instrukcje poniżej mogą się nieco różnić w zależności od cyklu życia, którego aktualnie używasz. Począwszy od Xcode 12, możesz wybrać jeden z dwóch cykli życia: "Aplikacja SwiftUI" (domyślnie wybrana w Xcode 12) i "UIKit AppDelegate". Jeśli tworzysz rozszerzenie, zapoznaj się ze stroną Wprowadzenie do rozszerzenia.

4.1 Dodaj instrukcje importu

Otwórz plik AppDelegate projektu (dla cyklu życia zestawu interfejsu użytkownika AppDelegate) lub <plik ProjectName>App.swift (dla cyklu życia aplikacji swift interfejsu użytkownika) 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

Zestaw interfejsu użytkownika AppDelegate

Dodaj kod inicjujący do metody delegata didFinishLaunchingWithOptions.

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

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

Cykl życia aplikacji interfejsu użytkownika usługi Swift

Aby upewnić się, że SDK App Center działa poprawnie z Swift UI, zainicjuj go po załadowaniu interfejsu użytkownika. Najprostszym sposobem osiągnięcia tego celu jest użycie interfejsu użytkownikaApplicationDelegate:

class AppDelegate: NSObject, UIApplicationDelegate {
    func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey : Any]? = nil) -> Bool {
          AppCenter.start(withAppSecret: "{Your App Secret}", services:[
            Crashes.self, Analytics.self, Distribute.self])
        return true
    }
}

Następnie użyj UIApplicationDelegateAdaptor w struct:

@main
struct YourAppName: App {

  @UIApplicationDelegateAdaptor(AppDelegate.self) var appDelegate

    var body: some Scene {
        WindowGroup {
            ContentView()
        }
    }
}

Jeśli masz aplikację Catalyst, możesz przekazać sekrety aplikacji dla systemów iOS i macOS jednocześnie.

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

Ostrzeżenie

Nie zaleca się umieszczać tajnego klucza aplikacji w kodzie źródłowym.

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

Skonfiguruj lub uruchom go przy użyciu klucza tajnego aplikacji.
Jeśli kod może być wywoływany wiele razy, sprawdź, czy centrum aplikacji jest już skonfigurowane.
Uruchom wymagane usługi bez sekretu 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 zastępczy tekst sekretem swojej 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, zawierający twój tajny klucz aplikacji. Możesz skopiować i wkleić cały ten przykład.

W powyższym przykładzie pokazano użycie metody start:withServices (start(withAppSecret:services:) dla Swift) i uwzględnienie zarówno App Center Analytics, jak i App Center Crashes.

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 parametru w metodzie startowej, nie można 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 i będą dostępne tylko moduły zawarte w pierwszym wywołaniu.

Na przykład — jeśli chcesz dołączyć do usługi App Center Analytics, należy zmodyfikować 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])

Świetnie, jesteś gotowy, aby wyświetlić dane analizy i awarii na portalu, które 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 korzystać z bardziej zaawansowanych funkcji obu usług.

Aby dowiedzieć się, jak rozpocząć korzystanie z aktualizacji wewnątrz aplikacji, zapoznaj się z dokumentacją App Center Distribute.

Udostępnij za pośrednictwem

Wprowadzenie do systemu iOS

1. Wymagania wstępne

2. Utwórz swoją aplikację w Centrum aplikacji Portalu, aby uzyskać tajny klucz aplikacji.

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

3.1 Integracja za pośrednictwem cocoapods

3.2 Integracja za pośrednictwem Carthage

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

3.4 Integracja przez skopiowanie plików binarnych do projektu

4. Uruchamianie zestawu SDK

4.1 Dodaj instrukcje importu

4.2. Dodawanie start:withServices: metody

Zestaw interfejsu użytkownika AppDelegate

Cykl życia aplikacji interfejsu użytkownika usługi Swift

4.3 Zastąp zastępczy tekst sekretem swojej aplikacji

Opinia

Dodatkowe zasoby

4.2. Dodawanie `start:withServices:` metody