Rozwiązywanie problemów z narzędziami MAUI i Xamarin SDK

Zbieranie szczegółowych dzienników

Aby uzyskać instrukcje dotyczące dostosowywania poziomu dziennika do VERBOSE, zapoznaj się z sekcją Inne interfejsy API .
Szczegółowe dzienniki można znaleźć w oknie Debug>Windows>Output.

Problemy podczas instalacji

1. W przypadku aplikacji platformy Xamarin.Forms upewnij się, że pakiety są zainstalowane we wszystkich projektach odwołujących się do wszystkich bibliotek. W przeciwnym razie zobaczysz błędy.
2. Jeśli ten błąd występuje podczas kompilowania dla platformy Xamarin.iOS: MTOUCH: Error MT3001: Could not AOT the assembly 'obj/**/Build/Microsoft.AppCenter.**.iOS.Bindings.dll' (MT3001) musisz zaktualizować składnik Xamarin.iOS do wersji 10.4.0.128 lub nowszej .
3. Jeśli ten błąd zostanie wyświetlony podczas kompilowania dla platformy Xamarin.iOS: MTOUCH: Error MT5210: Native linking failed, undefined symbol: _OBJC_METACLASS_$_MS{SomeSdkClassName}. Please verify that all the necessary frameworks have been referenced and native libraries are properly linked in. (MT5210) lub podobny błąd (MT5211 kod z podobnym komunikatem z wzmianką o centrum aplikacji), przed użyciem interfejsów API określonej usługi upewnij się, że wykonasz wywołanie AppCenter.Start . Jeśli dzwonisz Start, ale masz ten problem, musisz zaktualizować komponent Xamarin.iOS do wersji 10.4.0.128 lub nowszej.
4. W konsoli wyszukaj dziennik Assert z komunikatem "SDK App Center został pomyślnie skonfigurowany". Sprawdza to, czy zestaw SDK został pomyślnie skonfigurowany.

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 tajny klucz aplikacji jest dołączony wraz z wywołaniem Start() metody. Możesz skopiować dokładny Start() 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 . Przed uruchomieniem zestawu SDK wywołaj poniższy interfejs API.

   AppCenter.LogLevel = LogLevel.Verbose;
   

   Sprawdź, czy w dziennikach znajduje się komunikat "Zestaw SDK centrum aplikacji został pomyślnie skonfigurowany" (na poziomie informacyjnym), a następnie sprawdź, czy widzisz dzienniki żądań HTTPS.

4. Upewnij się, że urządzenie jest w trybie online.

5. Czasami może minąć kilka minut, zanim dzienniki pojawią się w portalu. Poczekaj chwilę, 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. Twoje zdarzenia powinny pojawić się, gdy zostaną wysłane.

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 tajny klucz aplikacji jest dołączony wraz z wywołaniem Start() metody. Możesz skopiować dokładny Start() kod, otwierając aplikację w portalu i przechodząc do strony Wprowadzenie.

3. Uruchom ponownie aplikację po awarii. App Center Crashes przekaże raport awarii dopiero po ponownym uruchomieniu aplikacji. Ponadto w systemach Xamarin.iOS i Xamarin.Mac zestaw SDK nie zapisze żadnego dziennika awarii w przypadku dołączenia debugera. Upewnij się, że debuger nie jest dołączony podczas awarii aplikacji systemu iOS. Na platformie Xamarin.Android może wystąpić awaria przy podłączonym debugerze, ale należy kontynuować wykonywanie po wystąpieniu nieobsługiwanego wyjątku.

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 . Przed uruchomieniem zestawu SDK wywołaj poniższy interfejs API.

   AppCenter.LogLevel = LogLevel.Verbose;
   

   Sprawdź, czy w dziennikach znajduje się komunikat "Zestaw SDK centrum aplikacji został pomyślnie skonfigurowany" (na poziomie informacyjnym), a następnie sprawdź, czy widzisz dzienniki żądań HTTPS.

5. Nie używaj żadnej innej biblioteki, która udostępnia funkcje raportowania awarii, takie jak Xamarin Insights lub HockeyApp. Możesz mieć zintegrowany tylko jeden zestaw SDK do raportowania awarii.

6. Upewnij się, że urządzenie jest w trybie online.

7. Czasami może minąć kilka minut, zanim dzienniki pojawią się w portalu. Poczekaj chwilę, 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, aby sprawdzić, czy został pomyślnie wysłany na serwer.

9. Aby sprawdzić, czy backend App Center odebrał awarię, przejdź do sekcji Przepływ logów w usłudze Analytics. Awarie powinny się tam pojawić, gdy tylko zostaną wysłane.

Aktualizacje dystrybucji i aplikacji blokują automatyczne testy interfejsu użytkownika

Jeśli uruchamiasz zautomatyzowane testy interfejsu użytkownika, włączone aktualizacje w aplikacji zablokują automatyczne testy interfejsu użytkownika, ponieważ będą one próbowały uwierzytelnić się w zapleczu Centrum aplikacji. Zalecamy, aby nie włączać usługi App Center Distribute dla testów interfejsu użytkownika.

Sklep Google Play odrzuca aplikację po dodaniu funkcji DistributePlay

Sklep Google Play odrzuca aplikacje korzystające z modułu Distribute , ponieważ zawiera implementację aktualizacji w aplikacji. Aby uniknąć takiej sytuacji, zestaw SDK centrum aplikacji zawiera DistributePlay moduł zawierający wycinki modułu głównego. Zastępuje on główny zestaw zestawem stubbed, który imituje Distribute interfejs API. W aplikacji klienckiej nie są wymagane żadne dodatkowe zmiany. Element DistributePlay nie ma żadnego kodu powiązanego z aktualizacją w aplikacji. Jeśli po zastąpieniu Distribute modułu aplikacją DistributePlay nadal zostanie odrzucona, wykonaj poniższe kroki, aby sprawdzić, czy Distribute moduł został poprawnie zastąpiony:

• Upewnij się, że zastąpiłeś Distribute na DistributePlay w każdej wersji dla wszystkich grup publikacyjnych w konsoli Google Play.
• Jeśli używasz Xamarin.Forms, upewnij się, że dodasz moduł DistributePlay zarówno do projektów udostępnionych, jak i Xamarin.Android.
• Sprawdź, czy plik wyjściowy nie zawiera Microsoft.AppCenter.Distribute.Android.Bindings.dll zestawu. Możesz użyć analizatora APK , aby go sprawdzić.

Komunikaty w konsoli, które wskazują, że nie można otworzyć bazy danych w systemie iOS

Usługa App Center używa narzędzia SQLite do utrwalania dzienników przed ich wysłaniem do zaplecza. Jeśli do swojej aplikacji dołączasz własną bibliotekę SQLite zamiast korzystać z tej udostępnianej przez system operacyjny, w konsoli mogą pojawić się błędy, takie jak [AppCenter] ERROR: -[MSACDBStorage executeSelectionQuery:]/147 Failed to open database, i nie będą widoczne żadne dane analityczne ani dotyczące awarii w backendzie. Zaktualizuj zestaw SDK do wersji 0.16.0 lub nowszej.

Chroń tajną wartość centrum aplikacji

app_secret jest identyfikatorem aplikacji, który jest wymagany, aby wiedzieć, do której aplikacji odnosi się ruch sieciowy, ale nie może być używany do pobierania ani edytowania istniejących danych. Jeśli twoje app_secret jest narażone, największym ryzykiem jest wysłanie złych danych do aplikacji, ale nie wpłynie to 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.

Zabezpieczenie aplikacji można poprawić, używając zmiennej środowiskowej do wstrzykiwania tajnych danych aplikacji do kodu. W ten sposób sekret nie jest widoczny w kodzie.