Rozwiązywanie problemów z zestawem SDK 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
• macOS
• tvOS
• React Native
• Cordova
• Unity
• Windows
• MAUI/Xamarin

Problemy podczas instalacji

1. W konsoli poszukaj dziennika asertywnego z komunikatem "Zestaw SDK centrum aplikacji został pomyślnie skonfigurowany". Sprawdza to, czy zestaw SDK został pomyślnie skonfigurowany.
2. Jeśli używasz platformy Cocoapods do integracji centrum aplikacji z systemem macOS i wystąpi błąd z komunikatem — CocoaPods - Unable to find a specification for AppCenteruruchom polecenie pod repo update , aby zaktualizować lokalne repozytorium Cocoapods, a następnie uruchom ponownie.pod install
3. Jeśli integrujesz pliki binarne zestawu SDK ręcznie, upewnij się, że moduły są włączone dla projektu.

Dane analizy nie są wyświetlane w portalu.

1. Upewnij się, że moduły zestawu SDK zostały poprawnie zintegrowane.

2. Upewnij się, że prawidłowy wpis tajny aplikacji jest uwzględniony wraz z start:withServices: wywołaniem metody. Możesz skopiować dokładny start:withServices:kod, otwierając aplikację w portalu i przechodząc do strony Wprowadzenie.

3. Jeśli chcesz wyświetlić dzienniki wysyłane do zaplecza, zmień poziom dziennika na Pełne w aplikacji, a zestaw SDK wyświetli dzienniki w konsoli programu . Wstaw następujące wywołanie przed uruchomieniem zestawu SDK:

   [MSACAppCenter setLogLevel:MSACLogLevelVerbose]
   

   AppCenter.logLevel = .verbose
   

   Upewnij się, że w dziennikach pojawi się komunikat "Zestaw SDK usługi App Center został pomyślnie skonfigurowany", a następnie sprawdź, czy widzisz dzienniki żądań HTTPS.

4. Upewnij się, że urządzenie jest w trybie online, a aplikacja ma dostęp do Internetu.

   Uwaga

   Jeśli aplikacja korzysta z piaskownicy aplikacji, musisz ustawić możliwość zezwalania na połączenia przychodzące (serwer) i wychodzące (klient), aby umożliwić aplikacji dostęp do Internetu. Program Xcode 9 domyślnie włącza piaskownicę aplikacji, ale możliwości połączeń przychodzących i wychodzących muszą być ustawione jawnie.

   Wybierz projekt w nawigatorze projektu, wybierz kartę Możliwości , a jeśli aplikacja korzysta z piaskownicy, dodaj możliwości dla połączeń przychodzących i wychodzących.

5. Czasami dzienniki mogą potrwać kilka minut, aby wyświetlić je w portalu. Poczekaj trochę czasu, jeśli tak jest.

6. Aby sprawdzić, czy zaplecze usługi App Center odebrało dane, przejdź do sekcji Przepływ dzienników w usłudze Analytics . Zdarzenia powinny pojawić się po wysłaniu.

Awarie nie są wyświetlane w portalu.

1. Upewnij się, że moduły zestawu SDK zostały poprawnie zintegrowane.

2. Upewnij się, że prawidłowy wpis tajny aplikacji jest uwzględniony wraz z start:withServices: wywołaniem metody. Możesz skopiować dokładny start:withServices: kod, otwierając aplikację w portalu i przechodząc do strony Wprowadzenie.

3. Uruchom ponownie aplikację po awarii. Awarie usługi App Center będą przekazywać dziennik awarii dopiero po ponownym uruchomieniu aplikacji. Ponadto zestaw SDK nie będzie przekazywać żadnych dzienników awarii, jeśli jesteś dołączony do debugera. Upewnij się, że debuger nie jest dołączony podczas awarii aplikacji.

4. Jeśli chcesz wyświetlić dzienniki wysyłane do zaplecza, zmień poziom dziennika na Pełne w aplikacji, a zestaw SDK wyświetli dzienniki w konsoli programu . Wstaw następujące wywołanie przed uruchomieniem zestawu SDK:

   [MSACAppCenter setLogLevel:MSACLogLevelVerbose]
   

   AppCenter.logLevel = .verbose
   

   Upewnij się, że w dziennikach pojawi się komunikat "Zestaw SDK usługi App Center został pomyślnie skonfigurowany", a następnie sprawdź, czy widzisz dzienniki żądań HTTPS.

5. Nie używaj żadnych innych bibliotek, które zapewniają funkcję raportowania awarii. W aplikacji można zintegrować tylko jeden zestaw SDK raportowania awarii.

6. Upewnij się, że urządzenie jest w trybie online, a aplikacja ma dostęp do Internetu.

   Uwaga

   Jeśli aplikacja korzysta z piaskownicy aplikacji, musisz ustawić możliwość zezwalania na połączenia przychodzące (serwer) i wychodzące (klient), aby umożliwić aplikacji dostęp do Internetu. Program Xcode 9 domyślnie włącza piaskownicę aplikacji, ale możliwości połączeń przychodzących i wychodzących muszą być ustawione jawnie.

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

7. Czasami dzienniki mogą potrwać kilka minut, aby wyświetlić je w portalu. Poczekaj trochę czasu, jeśli tak jest.

8. Jeśli chcesz sprawdzić, czy zestaw SDK wykrył awarię podczas następnego uruchomienia aplikacji, możesz wywołać interfejs API, aby sprawdzić, czy aplikacja uległa awarii w ostatniej sesji i wyświetli alert. Możesz też rozszerzyć wywołanie zwrotne awarii didSucceedSendingErrorReport , aby sprawdzić, czy została pomyślnie wysłana na serwer.

9. Aby sprawdzić, czy zaplecze usługi App Center odebrało awarię, przejdź do sekcji Przepływ dzienników w usłudze Analytics. Awarie powinny pojawić się tam po wysłaniu.

Ochrona wartości wpisu tajnego centrum aplikacji

Jest app_secret to identyfikator aplikacji, który musi wiedzieć, która aplikacja ma zastosowanie, i nie może być używana do pobierania ani edytowania istniejących danych. W przypadku uwidocznienia największe app_secret ryzyko polega na wysyłaniu złych danych do aplikacji, ale nie będzie miało wpływu na bezpieczeństwo danych.

Aby pobrać wszelkie poufne dane, należy podać token aplikacji/użytkownika, który jest generowany po stronie klienta. Nie ma możliwości całkowitego zabezpieczenia danych po stronie klienta.

Zabezpieczenia aplikacji można poprawić przy użyciu zmiennej środowiskowej w celu wstrzyknięcia wpisu tajnego aplikacji do kodu. W ten sposób wpis tajny nie jest widoczny w kodzie.