27 Mart 2025'ten itibaren AOSP'yi derlemek ve AOSP'ye katkıda bulunmak için aosp-main yerine android-latest-release kullanmanızı öneririz. Daha fazla bilgi için AOSP'de yapılan değişiklikler başlıklı makaleyi inceleyin.
Yerel geliştirme ve hata ayıklama için Winscope'u kullanarak izlemeler yakalayabilirsiniz.
Winscope, USB veya kablosuz ağ üzerinden cihaz bağlantısını destekleyen adb'yi kullanır.
Winscope Proxy veya Web Cihaz Proxy'si'ni kullanarak Winscope'ta cihaz bağlayabilirsiniz.
Winscope ana sayfasında varsayılan olarak Winscope Proxy bağlantı kurulumu kullanıcı arayüzü gösterilir.
İzler yakalamaya başlamak için aşağıdaki cihaz bağlantı mekanizmalarından birini seçin.
Winscope Proxy kurulumu
Winscope Proxy'yi ayarlamak için aşağıdaki adımları uygulayın:
Ana sayfadaki İzleri Topla bölümünde, Bağlantı türünü seçin açılır menüsünden Winscope Proxy'yi seçin:
Şekil 1. Winscope Proxy'yi kullanarak izlemeleri yakalama
Aşağıdaki komutu çalıştırarak doğrudan tarayıcınızdan izlemeleri yakalamak için Winscope ADB Connect proxy'sini başlatın:
Yürütme işleminden sonra terminalde görüntülenen Winscope proxy jetonunu not edin.
Winscope ADB Connect proxy'sini başlattıktan sonra ekran aşağıdaki gibi değişir. Proxy'ye ilk bağlantıyı kurmak için 3. adımdaki Winscope proxy jetonunu girin ve Bağlan'ı tıklayın.
Şekil 2. Winscope Proxy'ye bağlanın.
Web Device Proxy kurulumu
Web cihaz proxy'sini ayarlamak için aşağıdaki adımları uygulayın:
Ana sayfadaki İzleri topla bölümünde, Bağlantı türünü seçin açılır listesinde Web cihazı proxy'si'ni seçin:
Şekil 3. Web cihaz proxy'sini kullanarak izlemeler yapın.
Makinenizde Web Cihaz Proxy'si daemon'u yoksa Yükle'yi tıklayın veya yükleyiciyi çalıştırın.
İletişim kutusunu kullanarak kaynağın Web Cihaz Proxy'sine erişimini onaylayın.
Şekil 4. Kaynağı yetkilendirin.
Her yeni cihaza ilk kez bağlandığınızda erişimi onaylayın.
İletişim kutusu otomatik olarak görünmüyorsa cihazın yanındaki lock_open simgesini tıklayın:
Şekil 5. Cihazı yetkilendirin.
İzler
İzler toplamak için aşağıdaki adımları uygulayın:
Bağlıyken yakalama işlemini başlatmak için hedefleri seçin ve ayarları yapılandırın. Ardından, yakalamayı başlatmak için İzlemeye başla'yı tıklayın:
Şekil 6. Winscope'ta iz toplayın.
Kaydı durdurmak için İzleme işlemini sonlandır'ı tıklayın:
Şekil 7. Winscope'ta izlemeyi sonlandırın.
İzleme seçenekleri
Bu bölümde, her bir izleme türüne ait seçenekler açıklanmaktadır.
Ekran kaydı
Winscope ile birden fazla ekranın ekranını kaydedebilirsiniz. Ekran kaydı yapmak için menüden bir ekran seçin. Bir seçim yapmazsanız Winscope varsayılan olarak etkin ekranı kaydeder.
SurfaceFlinger
Arabellek boyutu: SurfaceFlinger izlemesi için bellek içi halka arabelleğinin boyutunu ayarlar. Daha büyük bir arabellek daha fazla veri toplamayı sağlar ancak bellek kullanımını artırır.
Giriş: Yüzey giriş verileri içeriyorsa giriş penceresinin özelliklerini izler.
Yapı: Yapı türünü ve görünür bölgeyi izler.
Meta veriler: Ekran dışı katmanlar da dahil olmak üzere ek yüzey meta verilerini izler.
HWC: Ek yapılandırılmamış donanım derleyici meta verilerini izler.
Arabellekleri izle: SurfaceFlinger'ı, yüzeydeki tüm arabellek değişikliklerini izlemek için yapılandırır. SurfaceFlinger, varsayılan olarak yalnızca geometri değiştiğinde yeni bir durumu izler.
Sanal ekranlar: İzlemede sanal ekran katmanlarını içerir.
WindowManager
Arabellek boyutu: WindowManager izlemesi için bellek içi halka arabelleğinin boyutunu ayarlar. Daha büyük bir arabellek daha fazla veri toplamayı sağlar ancak bellek kullanımını artırır.
İzleme türü: Durumları toplama sıklığı seçeneklerini tanımlar:
frame: Bu modda WindowManager, yalnızca geçerli WindowManager durumlarının yakalanmasını sağlayarak her kare için tek bir durum döker. Bu mod, en düşük performans yüküne sahiptir.
transaction: Bu mod, bir işlem her işlendiğinde bir WindowManager durumunu kaydeder. Bir kare içinde birden fazla işlem yapabilirsiniz. Bu sayede, bir kare sırasında ara WindowManager durumlarında hata ayıklama yapabilirsiniz. Ancak bu mod, çerçeve moduna kıyasla daha yüksek performans yükü oluşturur.
ayrıntılı: Tüm pencereleri ve her pencerenin yapılandırma bilgilerini içerir. Bu mod, en yüksek bellek ve performans yükü oluşturur.
debug: Tüm pencerelerle ilgili bilgileri içerir ancak istenen bir geçersiz kılma yapılandırması içeriyorsa yalnızca pencere yapılandırmasını günlüğe kaydeder.
kritik: Hata ayıklama moduyla aynı bilgileri içerir ancak yalnızca görünür pencereleri içerir. Bu mod, en az bellek ve performans yükü oluşturur.
Dökümler
Winscope'u kullanarak durum dökümü almak için ana sayfadaki İzleme Toplama bölümünde Döküm sekmesini seçin ve ardından Durum dökümü'nü tıklayın:
Şekil 8. Winscope'ta durumu dökün.
Ekran görüntüsü yapılandırması
Winscope, birden fazla ekranın ekran görüntüsünü almanıza olanak tanır. Ekran görüntüsü almak için menüden bir ekran seçin. Hiçbir seçim yapılmazsa etkin ekran için ekran görüntüsü toplanır.
Bu sayfadaki içerik ve kod örnekleri, İçerik Lisansı sayfasında açıklanan lisanslara tabidir. Java ve OpenJDK, Oracle ve/veya satış ortaklarının tescilli ticari markasıdır.
Son güncelleme tarihi: 2025-07-27 UTC.
[[["Anlaması kolay","easyToUnderstand","thumb-up"],["Sorunumu çözdü","solvedMyProblem","thumb-up"],["Diğer","otherUp","thumb-up"]],[["İhtiyacım olan bilgiler yok","missingTheInformationINeed","thumb-down"],["Çok karmaşık / çok fazla adım var","tooComplicatedTooManySteps","thumb-down"],["Güncel değil","outOfDate","thumb-down"],["Çeviri sorunu","translationIssue","thumb-down"],["Örnek veya kod sorunu","samplesCodeIssue","thumb-down"],["Diğer","otherDown","thumb-down"]],["Son güncelleme tarihi: 2025-07-27 UTC."],[],[],null,["# Capture traces with Winscope\n\n[Run Winscope](/docs/core/graphics/winscope/run) locally or access it\nfrom a web server.\n\nYou can capture traces using Winscope for local development and debugging.\nWinscope uses [adb](https://developer.android.com/tools/adb), which supports\ndevice connection over USB or Wi-Fi.\n\nThe **Collect Traces** screen is displayed on launching Winscope.\n\nDevice connection\n-----------------\n\nYou can connect devices in Winscope using\n[Winscope Proxy](#winscope-proxy-setup)\nor\n[Web Device Proxy](#web-device-proxy-setup).\nBy default, the Winscope homepage shows the **Winscope Proxy** connection setup\nUI.\n\nTo start capturing traces, choose one of the following device connection\nmechanisms.\n\n### Winscope Proxy setup\n\nFollow these steps to set up Winscope Proxy:\n\n1. Under **Collect Traces** on the homepage, choose **Winscope Proxy** in the\n **Select connection type** drop-down:\n\n **Figure 1.** Capture traces using Winscope Proxy.\n2. Launch the Winscope ADB Connect proxy to capture traces directly from your\n browser, by running the following command:\n\n python3 $ANDROID_BUILD_TOP/development/tools/winscope/src/adb/winscope_proxy.py\n\n | **Note:** Python 3.10+ and adb are required.\n3. Note the Winscope proxy token displayed on the terminal after execution.\n\n4. After you launch the Winscope ADB Connect proxy, the screen changes as\n follows. To establish the initial connection to the proxy, input the\n Winscope proxy token from step 3 and click **Connect**.\n\n **Figure 2.** Connect to Winscope Proxy.\n\n### Web Device Proxy setup\n\nFollow these steps to set up Web Device Proxy:\n\n1. Under **Collect Traces** on the homepage, choose **Web Device Proxy** in the\n **Select connection type** drop-down:\n\n **Figure 3.** Capture traces using Web Device Proxy.\n2. If you don't have the Web Device Proxy daemon on your machine, click\n **Install** or run the\n [installer](https://tools.google.com/dlpage/android_web_device_proxy).\n\n | **Note:** Web Device Proxy is not yet supported on Mac.\n3. Approve origin access to Web Device Proxy through the dialog.\n\n **Figure 4.** Authorize origin.\n4. Approve access for each new device the first time you connect to the device.\n If the dialog does not automatically appear, click the `lock_open` icon next\n to the device:\n\n **Figure 5.** Authorize device.\n\nTraces\n------\n\nFollow these steps to collect traces:\n\n1. When connected, to initiate the capture process, select the targets and\n configure the settings. Then click **Start trace** to begin the capture:\n\n **Figure 6.** Collect traces in Winscope.\n2. To stop the capture, click **End trace**:\n\n **Figure 7.** End trace in Winscope.\n\nTrace options\n-------------\n\nThis section describes the options for each trace type.\n\n### Screen recording\n\nWith Winscope, you can record the screen of multiple displays. Choose a display\nfrom the menu to screen record. If you don't make a selection, Winscope records\nthe active display by default.\n| **Note:** Multi-display selection is available only with adb `screenrecord` v1.4 and higher, that is builds from September 2024 on. Single display selection is available for any version earlier than that.\n\n### SurfaceFlinger\n\n- **Buffer size:** Adjusts the size of the in-memory ring buffer for the\n SurfaceFlinger trace. A larger buffer enables the collection of more data\n but increases memory usage.\n\n | **Note:** Buffer size is deprecated starting in Android 15.\n- **Input:** If the surface contains input data, tracks the specifics of\n the input window.\n\n- **Composition:** Traces the composition type and visible region.\n\n- **Metadata:** Traces additional surface metadata, including offscreen\n layers.\n\n | **Warning:** Metadata is highly verbose and requires a large amount of memory.\n- **HWC:** Traces additional unstructured hardware composer metadata.\n\n | **Warning:** HWC is highly verbose and requires a large amount of memory.\n- **Trace buffers:** Configures SurfaceFlinger to trace all buffer changes on\n the surface. By default, SurfaceFlinger traces a new state only when the\n geometry is altered.\n\n- **Virtual displays:** Includes virtual display layers in the trace.\n\n### WindowManager\n\n- **Buffer size:** Adjusts the size of the in-memory ring buffer for the WindowManager trace. A larger buffer enables the collection of more data but increases memory usage.\n- **Tracing type:** Defines the frequency options for collecting states:\n\n - *frame:* In this mode, the WindowManager dumps a single state per frame, ensuring that only valid WindowManager states are captured. This mode has the lowest performance overhead.\n - *transaction:* This mode records a WindowManager state whenever a transaction is committed. You can commit multiple transactions within a frame, so this allows for debugging intermediate WindowManager states during a frame. However, this mode has a higher performance overhead compared to the frame mode.\n- **Tracing level:** Determines the verbosity of the WindowManager traces:\n\n - *verbose:* Includes all windows and configuration information for each window. This mode has the highest memory and performance overhead.\n - *debug:* Includes information about all windows, but logs only the window configuration if it contains a requested override configuration.\n - *critical:* Includes the same information as Debug mode, but includes only visible windows. This mode has the smallest memory and performance overhead.\n\nDumps\n-----\n\nTo take a state dump using Winscope, under **Collect Traces** on the homepage\nselect the **Dump** tab and then click **Dump state**:\n\n**Figure 8.** Dump state in Winscope.\n\n### Screenshot configuration\n\nWinscope allows taking a screenshot for multiple displays. Choose a display from\nthe menu to screenshot. If no selection is made, a screenshot is collected for\nthe active display."]]
