Android 6.0 (interfejs API na poziomie 23) i nowsze wersje obsługują natywny interfejs API do śledzenia, trace.h, który umożliwia zapisywanie zdarzeń śledzenia w buforze systemowym, które można następnie analizować za pomocą narzędzia Perfetto lub systrace. Typowe przypadki użycia tego interfejsu API obejmują obserwowanie czasu wykonywania określonego bloku kodu i powiązanie bloku kodu z niepożądanym zachowaniem systemu.
Uwaga: jeśli na urządzeniach i emulatorach z interfejsem API na poziomie 27 lub niższym nie ma wystarczającej ilości pamięci lub jest ona zbyt pofragmentowana, pojawi się komunikat: Atrace could not allocate enough memory to record a trace.
Jeśli tak się stanie i nie będziesz mieć pełnego zestawu danych, zamknij procesy w tle lub uruchom ponownie urządzenie albo emulator.
Aby zdefiniować zdarzenia niestandardowe, które występują w kodzie natywnym w aplikacji lub grze, wykonaj te czynności:
Zdefiniuj wskaźniki funkcji ATrace, których używasz do rejestrowania zdarzeń niestandardowych w aplikacji lub grze, jak pokazano w tym fragmencie kodu:
#include <android/trace.h> #include <dlfcn.h> void *(*ATrace_beginSection) (const char* sectionName); void *(*ATrace_endSection) (void); typedef void *(*fp_ATrace_beginSection) (const char* sectionName); typedef void *(*fp_ATrace_endSection) (void);
Wczytaj symbole ATrace w czasie działania, jak pokazano w tym fragmencie kodu. Zwykle ten proces jest wykonywany w konstruktorze obiektu.
// Retrieve a handle to libandroid. void *lib = dlopen("libandroid.so", RTLD_NOW | RTLD_LOCAL); // Access the native tracing functions. if (lib != NULL) { // Use dlsym() to prevent crashes on devices running Android 5.1 // (API level 22) or lower. ATrace_beginSection = reinterpret_cast<fp_ATrace_beginSection>( dlsym(lib, "ATrace_beginSection")); ATrace_endSection = reinterpret_cast<fp_ATrace_endSection>( dlsym(lib, "ATrace_endSection")); }
Uwaga: ze względów bezpieczeństwa wywołania
dlopen()uwzględniaj tylko w wersji debugowanej aplikacji lub gry.Uwaga: aby zapewnić obsługę śledzenia w Androidzie 4.3 (poziom interfejsu API 18), możesz użyć interfejsu Java Native Interface do wywołania funkcji
Trace.beginSectioniTrace.endSectionw śledzonym kodzie lub śledzić wywołanie z kodu zarządzanego, jak pokazano w sekcji Definiowanie zdarzeń niestandardowych.Wywołaj
ATrace_beginSection()iATrace_endSection()odpowiednio na początku i na końcu zdarzenia niestandardowego:#include <android/trace.h> char *customEventName = new char[32]; sprintf(customEventName, "User tapped %s button", buttonName); ATrace_beginSection(customEventName); // Your app or game's response to the button being pressed. ATrace_endSection();
Uwaga: gdy wywołasz metodę
ATrace_beginSection()wielokrotnie, wywołanie metodyATrace_endSection()zakończy tylko ostatnio wywołaną metodęATrace_beginSection(). Dlatego w przypadku wywołań zagnieżdżonych upewnij się, że każde wywołanieATrace_beginSection()jest prawidłowo dopasowane do wywołaniaATrace_endSection().Nie można też wywołać metody
ATrace_beginSection()w jednym wątku i zakończyć jej w innym. Obie funkcje musisz wywołać z tego samego wątku.
Wskazówki dotyczące wygody
Poniższe wskazówki są opcjonalne, ale mogą ułatwić analizę kodu natywnego.
Śledzenie całej funkcji
Podczas instrumentowania stosu wywołań lub czasu działania funkcji przydatne może być śledzenie całych funkcji. Aby ułatwić sobie konfigurowanie tego typu śledzenia, możesz użyć makra ATRACE_CALL(). Ponadto takie makro pozwala pominąć tworzenie bloków try i catch w przypadkach, gdy śledzona funkcja może zgłosić wyjątek lub wcześniej wywołać return.
Aby utworzyć makro do śledzenia całej funkcji, wykonaj te czynności:
Zdefiniuj makro:
#define ATRACE_NAME(name) ScopedTrace ___tracer(name) // ATRACE_CALL is an ATRACE_NAME that uses the current function name. #define ATRACE_CALL() ATRACE_NAME(__FUNCTION__) class ScopedTrace { public: inline ScopedTrace(const char *name) { ATrace_beginSection(name); } inline ~ScopedTrace() { ATrace_endSection(); } };
Wywołaj makro w funkcji, którą chcesz śledzić:
void myExpensiveFunction() { ATRACE_CALL(); // Code that you want to trace. }
Nazywanie wątków
Możesz nadać nazwę każdemu wątkowi, w którym występują zdarzenia, jak pokazano w tym fragmencie kodu. Ten krok ułatwia identyfikowanie wątków, które należą do konkretnych działań w grze.
#include <pthread.h> static void *render_scene(void *parm) { // Code for preparing your app or game's visual components. } static void *load_main_menu(void *parm) { // Code that executes your app or game's main logic. } void init_threads() { pthread_t render_thread, main_thread; pthread_create(&render_thread, NULL, render_scene, NULL); pthread_create(&main_thread, NULL, load_main_menu, NULL); pthread_setname_np(render_thread, "MyRenderer"); pthread_setname_np(main_thread, "MyMainMenu"); }
Polecane dla Ciebie
- Uwaga: tekst linku jest wyświetlany, gdy język JavaScript jest wyłączony.
- Sprawdzone metody dotyczące wydajności SQLite
- Tworzenie i pomiar profili podstawowych bez użycia biblioteki Macrobenchmark