Uygulamanızı Kullanarak İzleme Günlükleri Oluşturma

Uygulamanızın yürütülmesine ilişkin bir yöntem izi oluşturmak için Debug sınıfını kullanarak uygulamanızı izleyebilirsiniz. Uygulamanızı bu şekilde donatmak, cihazın izleme bilgilerini kaydetmeye tam olarak ne zaman başlayıp ne zaman durduracağı konusunda size daha fazla kontrol sağlar. Cihaz, iz günlüklerinizi belirttiğiniz adları kullanarak kaydeder. Böylece her günlüğü daha sonra kolayca tanımlayabilirsiniz. Ardından, Android Studio CPU Profiler'ı kullanarak her bir iz günlüğünü görüntüleyebilirsiniz.

Uygulamanızın kodunu izlemeden CPU Profiler'da izlemeyi başlatıp durdurabilirsiniz.

İz günlükleri oluşturmaya başlamadan önce uygulamanızın, iz günlüklerini uygulamaya özel dizinine kaydetmek için mantık eklediğinden emin olun.

Uygulamanızı hazırlama

İzleme günlükleri oluşturmak için sistemin izleme verilerini günlüğe kaydetmeye başlamasını istediğiniz yerde startMethodTracing() yöntemini çağırın.

Çağrıda, .trace dosyasının adını belirtebilirsiniz. Sistem, dosyayı hedef cihazdaki kalıcı uygulama verileri için tasarlanmış pakete özel bir dizine kaydeder. Bu, getExternalFilesDir() tarafından döndürülen dizindir ve çoğu cihazda ~/sdcard/ dizininde bulunur. Bu dosya, ikili yöntem izleme verilerini ve iş parçacığı ile yöntem adlarını içeren bir eşleme tablosunu içerir. İzlemeyi durdurmak için stopMethodTracing() işlevini çağırın.

Aşağıdaki örnekte, sample.trace adlı iz günlüğünün kaydı başlatılır ve durdurulur:

// Starts recording a trace log with the name you provide. For example, the
// following code tells the system to start recording a .trace file to the
// device with the name "sample.trace".
Debug.startMethodTracing("sample")

// The system begins buffering the generated trace data, until your
// application calls stopMethodTracing(), at which time it writes
// the buffered data to the output file.
Debug.stopMethodTracing()

Uygulamanız iz günlüğünün adını değiştirmeden startMethodTracing() yöntemini tekrar çağırırsa cihaza kaydedilen mevcut günlüğün üzerine yazar. Her iz günlüğünün adını dinamik olarak nasıl değiştireceğinizi öğrenmek için birden fazla günlük kaydetme ile ilgili bölüme gidin.

Siz stopMethodTracing() yöntemini çağırmadan önce sistem maksimum arabellek boyutuna ulaşırsa izleme durdurulur ve konsola bir bildirim gönderilir. İzleri başlatan ve durduran yöntemler, uygulama sürecinizin tamamında çalışır. Yani etkinliğinizin onCreate(Bundle) yönteminde startMethodTracing() yöntemini, etkinliğinizin onDestroy() yönteminde ise stopMethodTracing() yöntemini çağırabilirsiniz.

Profil oluşturma etkinleştirildiğinde uygulamanızın daha yavaş çalıştığını unutmayın. Yani, mutlak zamanlamaları belirlemek için profil oluşturma verilerini kullanmamalısınız (ör. "foo() yönteminin çalışması 2,5 saniye sürer"). İz günlüklerindeki zamanlama bilgileri yalnızca önceki iz günlükleriyle karşılaştırıldığında faydalıdır. Böylece son değişikliklerin uygulamanızı hızlandırıp hızlandırmadığını görebilirsiniz.

Android 5.0 (API düzeyi 21) ve sonraki sürümleri çalıştıran cihazlara dağıtım yaparken, çalışma zamanı performansını daha az etkileyecek şekilde profil oluşturmak için örnek tabanlı profil oluşturmayı kullanabilirsiniz. Örnekleme profil oluşturmayı etkinleştirmek için belirtilen örnekleme aralığıyla startMethodTracingSampling() işlevini çağırın (startMethodTracing() işlevini çağırmak yerine). Sistem, uygulamanız stopMethodTracing() yöntemini çağırana kadar düzenli aralıklarla örnek toplar.

Birden fazla günlük kaydetme

Uygulamanız, iz günlüğü için yeni bir ad belirtmeden bir yöntem izini birden çok kez başlatıp durdurursa cihaz, eski iz günlüğünün üzerine yenisini yazar. Yani yalnızca en son iz günlüğünü saklar. Cihazınıza birden fazla iz günlüğü kaydetmek için uygulamanız startMethodTracing() yöntemini her çağırdığında iz günlüğünü dinamik olarak yeniden adlandırın. Aşağıdaki örnekte, her iz günlüğünü adlandırırken geçerli tarih ve saati eklemek için SimpleDateFormat sınıfı kullanılmaktadır:

// Uses the SimpleDateFormat class to create a String with
// the current date and time.
val dateFormat: DateFormat = SimpleDateFormat("dd_MM_yyyy_hh_mm_ss", Locale.getDefault())
val logDate: String = dateFormat.format(Date())
// Applies the date and time to the name of the trace log.
Debug.startMethodTracing("sample-$logDate")

Cihazdaki iz günlüklerine erişme

Sistem, cihazınızda iz günlüğünü oluşturduktan sonra dosyaya aşağıdaki yöntemlerden biriyle erişebilirsiniz:

  • Cihaz Gezgini'ni kullanma Cihaz Gezgini'ni açmak için View > Tool Windows > Device Explorer'ı (Görünüm > Araç Pencereleri > Cihaz Gezgini) tıklayın (veya araç penceresi çubuğundaki Device Explorer düğmesini tıklayın). Şekil 1'de gösterildiği gibi, uygulamanızın pakete özel dizinine giderek .trace dosyalarını bulabilirsiniz.

    Şekil 1. Cihaz Gezgini'ni kullanarak iz günlüklerini bulma

  • adb pull komutunu kullanarak dosyayı yerel makinenize kopyalayın. Aşağıdaki komut, cihazdaki sample.trace adlı iz günlüğünü yerel makinenizin ~/Documents/trace-logs/ dizinine kopyalar.

    adb pull path-on-device/sample.trace ~/Documents/trace-logs/

Ardından, CPU Profiler ile izleme dosyasını içe aktarabilirsiniz.