Cihazda sistem izlemeyi yakalama

Android 9 (API düzeyi 28) veya sonraki sürümleri çalıştıran cihazlarda Sistem İzleme adlı sistem düzeyinde bir uygulama bulunur. Bu uygulama systrace komut satırı yardımcı programına benzer ancak uygulama, izleri doğrudan test cihazından kaydetmenize olanak tanır. Bunu yaparken cihazı fişe takmanıza ve adb üzerinden bağlanmanıza gerek kalmaz. Daha sonra uygulamayı kullanarak bu izlerden elde edilen sonuçları geliştirme ekibinizle paylaşabilirsiniz.

Android 10 ve sonraki sürümleri çalıştıran cihazlar Perfetto biçiminde, önceki sürümlere sahip cihazlar ise bunları Systrace biçiminde kaydeder. Her iki biçimi de açıp izleri analiz etmek için Perfetto trace Viewer'ı kullanmanızı öneririz.

Uygulamanızdaki yavaş başlatma, yavaş geçişler veya kullanıcı arayüzü duraklaması gibi performansla ilgili hataları ele alırken izlerin kaydedilmesine yardımcı olur.

Sistem izlemesi kaydet

Sistem İzleme uygulaması, Hızlı Ayarlar kutusunu veya uygulamanın kendi içindeki bir menüyü kullanarak sistem izlemesi kaydetmenize olanak tanır. Aşağıdaki bölümlerde bu arayüzler kullanılarak kayıt işleminin nasıl tamamlanacağı açıklanmaktadır.

Hızlı Ayarlar kutusunu kullanarak kaydetme

Hızlı Ayarlar kutusu genellikle cihaz üzerinde sistem izleme işlemini tamamlamanın daha kolay yoludur.

Kutu oluştur

Sistem İzleme'yi test cihazınızda ilk kez kullanıyorsanız veya Şekil 2'de gösterildiği gibi cihazınızın Hızlı Ayarlar panelinde Sistem İzleme kutusunu görmüyorsanız aşağıdaki kurulum adımlarını tamamlayın:

  1. Geliştirici seçeneklerini etkinleştirin.
  2. Geliştirici Seçenekleri ayarlar ekranını açın.
  3. Hata Ayıklama bölümünde Sistem İzleme'yi seçin. Sistem İzleme uygulaması açılır ve uygulama menüsünü gösterir.
  4. Uygulama menüsünden, Şekil 1'de gösterildiği gibi Hızlı Ayarlar kutusunu göster'i etkinleştirin. Sistem, Hızlı Ayarlar paneline şekil 2'de gösterildiği gibi Sistem İzleme kutusunu ekler:

    Şekil 1. Sistem İzleme uygulamasındaki Hızlı Ayarlar kutusunu göster anahtarı.
    Şekil 2. Hızlı Ayarlar panelindeki Sistem İzleme bölümü.

    Not: Varsayılan olarak sistem, Sistem İzleme kutusunu Hızlı Ayarlar panelindeki ilk kutu olarak ekler. Karonun farklı bir konumda görünmesini istiyorsanız karoyu taşımak için panelin düzenleme modunu kullanın.

Sistem izleme kaydını tamamlama

Hızlı Ayarlar panelini kullanarak bir sistem izlemesi kaydetmek için aşağıdaki adımları tamamlayın:

  1. Record trace (Kayıt izleme) etiketli Sistem İzleme kutucuğuna dokunun. Kutu etkinleşir ve Şekil 3'te gösterildiği gibi sistemin bir iz kaydettiğini bildiren kalıcı bir bildirim görünür:

    'İzleme kaydediliyor. İzlemeyi durdurmak için dokunun."
    Şekil 3. Cihaz üzerinde sistem izlemesi başlatıldıktan sonra görünen kalıcı bildirim.
  2. Uygulamanızda sistemin denetlemesini istediğiniz işlemleri gerçekleştirin.

  3. Hızlı Ayarlar panelindeki veya Sistem İzleme bildirimindeki Sistem İzleme kutusuna dokunarak izlemeyi durdurun.

    Sistem, "İzleme kaydediliyor" mesajını içeren yeni bir bildirim gösterir. Kaydetme işlemi tamamlandığında sistem bildirimi kapatır ve üçüncü bir bildirim göstererek izininizin kaydedildiğini ve Şekil 4'te gösterildiği gibi sistem izlemeyi paylaşmaya hazır olduğunuzu onaylar:

    'Trace kaydedildi. İzinizi paylaşmak için dokunun."
    Şekil 4. Sistem kayıtlı bir izi kaydetmeyi bitirdikten sonra sürekli görüntülenen bildirimdir.

Uygulama menüsünü kullanarak kaydedin

Uygulama menüsü, sistem izlemeyle ilgili çeşitli gelişmiş ayarları yapılandırmanıza olanak tanır ve sistem izlemeyi başlatmak ve durdurmak için bir anahtar sağlar.

Sistem İzleme uygulama menüsünü kullanarak sistem izlemesi kaydetmek için aşağıdaki adımları tamamlayın:

  1. Geliştirici seçeneklerini etkinleştirin.
  2. Geliştirici Seçenekleri ayarlar ekranını açın. Hata Ayıklama bölümünde Sistem İzleme'yi seçin. Sistem İzleme uygulaması açılır.

    Alternatif olarak, Sistem İzleme kutucuğunu ayarladıysanız Sistem İzleme uygulamasına girmek için kutuya dokunup basılı tutabilirsiniz.

  3. Sistem izlemede hata ayıklama etkin olan uygulamaları dahil etmek için Hata ayıklaması yapılabilir uygulamaları izle'nin seçildiğinden emin olun.

  4. İsteğe bağlı olarak, izlenecek sistem ve sensör çağrılarının kategorilerini belirleyin ve KB cinsinden bir CPU başına arabellek boyutu seçin. Bluetooth işlemlerini test etmek için Ses kategorisi veya yığın ayırmalar için Bellek kategorisi gibi test ettiğiniz kullanım alanına karşılık gelen kategorileri seçin.

  5. İsteğe bağlı olarak, cihaz depolama alanına sürekli olarak kaydedilen izleri etkinleştirmek için Uzun izler'i seçin. Bu seçenekte Maksimum uzun iz boyutu ve Maksimum uzun iz süresi sınırlarını belirleyin.

  6. Şekil 5'te vurgulanan Kayıt izleme anahtarını etkinleştirin. Kutu etkinleşir ve Şekil 3'te gösterildiği gibi sistemin bir iz kaydettiğini size bildiren kalıcı bir bildirim görünür.

    Şekil 5. Sistem İzleme ayarlarındaki Kayıt izleme anahtarı.
  7. Uygulamanızda sistemin denetlemesini istediğiniz işlemleri gerçekleştirin.

  8. İzlemeyi durdurmak için Kayıt izleme anahtarını devre dışı bırakın.

    Sistem, "İzleme kaydediliyor" mesajını içeren yeni bir bildirim gösterir. Kaydetme işlemi tamamlandığında sistem bildirimi kapatır ve üçüncü bir bildirim göstererek izininizin kaydedildiğini ve şekil 4'te gösterildiği gibi sistem izlemeyi paylaşmaya hazır olduğunuzu onaylar.

Sistem izlemeyi paylaş

Sistem İzleme uygulaması, sistem izleme sonuçlarını birkaç farklı iş akışının parçası olarak paylaşmanıza yardımcı olur. Android 10 (API düzeyi 29) veya sonraki sürümleri çalıştıran cihazlarda izleme dosyaları, .perfetto-trace dosya adı uzantısıyla kaydedilir ve Perfetto kullanıcı arayüzünde açılabilir. Android'in önceki bir sürümünü çalıştıran cihazlarda izleme dosyaları, Systrace biçimini ifade eden .ctrace dosya adı uzantısıyla kaydedilir.

Mesaj olarak paylaş

Sistem İzleme, topladığınız izleri cihazınızdaki diğer uygulamalarla paylaşmanıza olanak tanır. Geliştirme makinenize cihaz bağlamanıza gerek kalmadan bu izleri, e-posta veya hata izleme uygulaması aracılığıyla geliştirme ekibinize gönderebilirsiniz.

Bir sistem izlemeyi kaydettikten sonra, cihazda görünen bildirime (Şekil 4'te gösterilen gibi) dokunun. Platformun amaç seçici görünür. Bu şekilde, istediğiniz mesajlaşma uygulamasını kullanarak izlemenizi paylaşabilirsiniz.

Dosyalar uygulamasından paylaşma

Android 10 (API düzeyi 29) veya sonraki sürümleri çalıştıran cihazlarda izler Dosyalar uygulamasında gösterilir. Bu uygulamadan bir iz paylaşabilirsiniz.

ADB kullanarak rapor indirme

adb kullanarak bir cihazdan sistem izlemeyi çıkarma da mümkündür. İzi kaydetmek için kullanılan cihazı geliştirme makinenize bağlayın ve ardından bir terminal penceresinde aşağıdaki komutları çalıştırın:

cd /path-to-traces-on-my-dev-machine && \
  adb pull /data/local/traces/ .

İzleme biçimleri arasında dönüştürme yapma

Perfetto izleme dosyalarını Systrace biçimine dönüştürebilirsiniz. Daha fazla bilgi için İzleme biçimleri arasında dönüştürme bölümüne bakın.

HTML raporu oluşturma

İzlemenizi paylaşırken raporun kendisi, Android 10 veya sonraki sürümleri çalıştıran cihazlarda .perfetto-trace dosyası ya da diğer tüm sürümler için .ctrace dosyası olur.

Web tabanlı kullanıcı arayüzü kullanarak veya komut satırından izleme dosyasından bir HTML raporu oluşturun.

Web tabanlı kullanıcı arayüzü

İzleme dosyasını açmak ve raporu oluşturmak için Perfetto kullanıcı arayüzünü kullanın.

Perfetto dosyası için İzleme dosyasını aç'ı tıklayın. Systrace dosyası için Eski kullanıcı arayüzü ile aç'ı tıklayın. Eski kullanıcı arayüzü, Systrace raporu ile aynı görünüme ve tarza sahiptir.

Komut satırı

İzleme dosyasından HTML raporu oluşturmak için bir terminal penceresinde şu komutları çalıştırın:

cd /path-to-traces-on-my-dev-machine && \
  systrace --from-file trace-file-name{.ctrace | .perfetto-trace}

systrace komut satırı programınız yoksa GitHub'daki Catapult projesinden veya doğrudan Android Açık Kaynak Projesi'nden indirebilirsiniz.