Cihazda sistem izlemeyi yakalama

Android 9 (API düzeyi 28) veya sonraki sürümlerin yüklü olduğu cihazlarda Sistem İzleme adlı sistem düzeyinde bir uygulama bulunur. Bu uygulama, systrace komut satırı yardımcı programına benzer ancak cihazı prize takıp adb üzerinden bağlamanıza gerek kalmadan doğrudan test cihazından iz kaydetmenize olanak tanır. Ardından, bu izlemelerden elde edilen sonuçları geliştirme ekibinizle paylaşmak için uygulamayı kullanabilirsiniz.

Android 10 ve sonraki sürümlerin yüklü olduğu cihazlar, izlerini Perfetto biçiminde kaydederken önceki cihazlar bunları Systrace biçiminde kaydeder. Her iki biçimi de açıp daha sonra izlemeleri analiz etmek için Perfetto izleme görüntüleyicisini kullanmanızı öneririz.

Uygulamanızdaki yavaş başlatma, yavaş geçiş veya kullanıcı arayüzü duraklaması gibi performansla ilgili hataları giderirken izlemeleri kaydetmenize yardımcı olur.

Sistem izleme kaydı oluşturma

Sistem İzleme uygulaması, Hızlı Ayarlar kartını veya uygulamanın içindeki bir menüyü kullanarak sistem izleme kaydetmenize olanak tanır. Aşağıdaki bölümlerde, bu arayüzleri kullanarak kayıt sürecinin nasıl tamamlanacağı açıklanmaktadır.

Hızlı Ayarlar kutusunu kullanarak kayıt yapma

Hızlı Ayarlar kartını kullanmak, cihaz üzerinde sistem izleme sürecini tamamlamanın genellikle daha kolay bir yoludur.

Döşeme oluşturma

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

  1. Geliştirici seçeneklerini etkinleştirin.
  2. Geliştirici Seçenekleri ayar 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ü gösterilir.
  4. Uygulama menüsünden, 1. resimde gösterildiği gibi Hızlı Ayarlar kartını göster'i etkinleştirin. Sistem, Sistem İzleme kutusunu Hızlı Ayarlar paneline ekler (Şekil 2'de gösterildiği gibi):

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

    Not: Sistem varsayılan olarak Hızlı Ayarlar panelinde ilk kart olarak Sistem İzleme kartını ekler. Kartın farklı bir konumda görünmesini istiyorsanız panelin düzenleme modunu kullanarak kartın yerini değiştirin.

Sistem izleme kaydını tamamlama

Hızlı Ayarlar panelini kullanarak sistem izleme kaydı oluşturmak için aşağıdaki adımları uygulayın:

  1. Kayıt izleme etiketine sahip Sistem İzleme kartına dokunun. Kart etkinleştirilir ve sistem bir izleme kaydettiğini size bildirmek için kalıcı bir bildirim gösterilir (Şekil 3'te gösterildiği gibi):

    "Takip kaydı alınıyor" mesajını içeren bildirim. İzlemeyi durdurmak için dokunun.'
    Şekil 3. Cihaz üzerinde sistem izleme 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 Sistem İzleme kartına veya Sistem İzleme bildirimine dokunarak izlemeyi durdurun.

    Sistem, "İz kaydediliyor" mesajını içeren yeni bir bildirim gösterir. Kaydetme işlemi tamamlandığında sistem, bildirimi kapatır ve üçüncü bir bildirim gösterir. Bu bildirimde, izlemenizin kaydedildiği ve sistem izlemesini paylaşmaya hazır olduğunuz onaylanır (Şekil 4).

    "İzleme kaydedildi. İzinizi paylaşmak için dokunun.'
    Şekil 4. Sistem, kaydedilen bir izlemeyi kaydetmeyi tamamladıktan sonra görünen kalıcı bildirim.

Uygulama menüsünü kullanarak kayıt yapma

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 uygulaması menüsünü kullanarak sistem izleme kaydı yapmak için aşağıdaki adımları uygulayın:

  1. Geliştirici seçeneklerini etkinleştirin.
  2. Geliştirici Seçenekleri ayar 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 kartını ayarladıysanız kartı basılı tutarak Sistem İzleme uygulamasına girebilirsiniz.

  3. Sistem izlemede hata ayıklama özelliğinin etkin olduğu uygulamaları dahil etmek için Hata ayıklanabilir uygulamaları izle'nin seçili olduğundan emin olun.

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

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

  6. Şekil 5'te vurgulanan İzleme kaydet anahtarını etkinleştirin. Kart etkinleştirilir ve sistem bir izleme kaydettiğini size bildirmek için Şekil 3'te gösterildiği gibi kalıcı bir bildirim gösterilir.

    Şekil 5. Sistem İzleme ayarlarındaki İzleme kaydet düğmesi.
  7. Uygulamanızda, sistemin denetlemesini istediğiniz işlemleri gerçekleştirin.

  8. İzleme kaydet anahtarını devre dışı bırakarak izlemeyi durdurun.

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

Sistem izlemeyi paylaşma

Sistem İzleme uygulaması, sistem izleme sonuçlarını çeşitli farklı iş akışları kapsamında paylaşmanıza yardımcı olur. Android 10 (API düzeyi 29) veya sonraki sürümleri çalıştıran bir cihazda izleme dosyaları .perfetto-trace dosya 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 belirten .ctrace dosya uzantısıyla kaydedilir.

Mesaj olarak paylaşma

Sistem İzleme, toplanan izlemenizi cihazınızdaki diğer uygulamalarla paylaşmanıza olanak tanır. Geliştirme makinenize cihaz bağlamak zorunda kalmadan, izlemeyi bir e-posta veya hata izleme uygulaması aracılığıyla geliştirme ekibinize gönderebilirsiniz.

Sistem izlemesi kaydettikten sonra, cihazda görünen bildirime (şekil 4'te gösterilen gibi) dokunun. Platformun intent seçicisi görünür. Bu seçici, izlemenizi istediğiniz mesajlaşma uygulamasını kullanarak paylaşmanıza olanak tanır.

Files uygulamasından paylaşma

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

ADB'yi kullanarak raporu indirme

adb kullanarak bir cihazdan sistem izlemesi de ayıklayabilirsiniz. İzlemeyi kaydetmek için kullanılan cihazı geliştirme makinenize bağlayın, 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

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 başlıklı makaleyi inceleyin.

HTML raporu oluşturma

İzinizi paylaşırken raporun kendisi, Android 10 veya sonraki sürümleri çalıştıran cihazlarda .perfetto-trace dosyası, diğer tüm sürümlerde ise .ctrace dosyasında bulunur.

Web tabanlı kullanıcı arayüzünü veya komut satırını kullanarak izleme dosyasından 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üyle aç'ı tıklayın. Eski kullanıcı arayüzü, Systrace raporu ile aynı görünüme ve stile sahiptir.

Komut satırı

İzleme dosyasından HTML raporu oluşturmak için terminal penceresinde aşağıdaki 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.