Men-debug kode platform

Android Studio untuk Platform (ASfP) menyediakan debugger canggih yang memungkinkan Anda:

  • Pilih perangkat untuk men-debug.
  • Menetapkan titik henti sementara dalam kode Java, Kotlin, C/C++, dan Rust.
  • Memeriksa variabel dan mengevaluasi ekspresi pada waktu proses.

Sebelum menggunakan debugger, Anda harus mem-flash build ke perangkat atau emulator.

Proses aplikasi (Java/Kotlin) debugging

Untuk men-debug proses aplikasi Java atau Kotlin:

  1. Menetapkan titik henti sementara dalam kode Java atau Kotlin di dalam ASfP.

  2. Pilih Run > Attach Debugger to Android Process dari menu.

  3. Pada dialog Choose Process, pastikan Debug type disetel ke Java Only.

  4. Pilih perangkat Anda dari daftar.

  5. Pilih proses aplikasi tertentu yang ingin Anda debug.

  6. Klik OK.

  7. Berinteraksi dengan aplikasi di perangkat Anda untuk mencapai titik henti.

Proses sistem (C/C++) debugging

Untuk men-debug proses sistem yang ditulis dalam C atau C++:

  1. Pastikan Anda hanya menjalankan satu perangkat atau emulator.

  2. Buka terminal dan jalankan adb root dari root checkout AOSP Anda: bash adb root

  1. Tetapkan titik henti sementara dalam kode C/C++ Anda di dalam ASfP.

  2. Pilih Run > Attach Debugger to Android Process dari menu.

  3. Pada dialog Choose Process, ubah Debug type menjadi Native Only atau Dual (Java + Native).

  4. Centang kotak Tampilkan semua proses untuk melihat proses sistem.

  5. Pilih perangkat Anda dari daftar.

  6. Pilih proses sistem tertentu yang ingin Anda debug (seperti surfaceflinger atau system_server).

  7. Klik OK.

  8. Berinteraksi dengan perangkat untuk mencapai titik henti sementara.

Proses debug Rust

ASfP mendukung proses debug Rust menggunakan Debug Adapter Protocol (DAP) dengan LLDB. Bagian ini menguraikan cara menyiapkan CodeLLDB sebagai Server Adaptor Debug dan men-debug kode Rust di host dan di perangkat Android.

Menyiapkan CodeLLDB sebagai Server Adaptor Debug

  1. Membuat konfigurasi Run/Debug Debug Adapter Protocol baru:

    1. Pilih Run > Edit Configurations dari menu.
    2. Klik tombol +.
    3. Pilih Debug Adapter Protocol.

  2. Di tab server, klik create a new server.

  3. Pada dialog yang baru dibuka, klik Choose template, lalu pilih CodeLLDB dari daftar.

  4. Setelah memilih template CodeLLDB, server baru akan ditambahkan dengan konfigurasi yang telah ditentukan sebelumnya.

    1. Aktifkan pelacakan verbose dengan memilih Verbose di dropdown Trace.
    2. Tambahkan variabel lingkungan yang menentukan jalur ke lldb-server di prebuilt sumber Android Anda:
        LLDB_DEBUGSERVER_PATH=REPO_ROOT/prebuilts/clang/host/linux-x86/CLANG_VERSION/runtimes_ndk_cxx/x86_64/lldb-server
    ```

Replace `REPO_ROOT` with the absolute path to your Android source checkout.
To find `CLANG_VERSION`, run the `get_clang_version.py` script from the root of
your Android source tree:

```bash
    ./build/soong/scripts/get_clang_version.py
    1. Jangan mengubah bagian <<insert base directory>>.

Men-debug biner Rust di host

  1. Buka tab Configuration di konfigurasi Run/Debug Debug Adapter Protocol Anda.
  2. Pilih Luncurkan sebagai Mode Debug.
  3. Perbarui Working directory dan pilih Binary file yang ingin Anda debug.
  4. Klik OK untuk menyimpan konfigurasi.
  5. Mulai sesi proses debug dengan mengklik ikon Debug di samping konfigurasi.

Saat pertama kali Anda menjalankannya, CodeLLDB akan didownload. Anda akan melihat rekaman aktivitas DAP di konsol. Titik henti sementara yang ditetapkan dalam kode Rust Anda akan tercapai seperti yang diharapkan.

Men-debug biner Rust di perangkat Android (Mode lampirkan)

  1. Temukan PID: Identifikasi ID Proses (PID) aplikasi yang ingin Anda debug di perangkat Android.

  2. Mulai lldb-server di perangkat: Dari checkout hierarki sumber Android Anda, jalankan skrip lldbclient.py, ganti <PID> dengan ID proses:

    lldbclient.py --setup-forwarding vscode-lldb -p <PID>

    Skrip ini mengirimkan lldb-server yang benar ke perangkat, memulainya, menyiapkan penerusan port (port host 5039 ke perangkat), dan menghasilkan konfigurasi JSON DAP yang diperlukan untuk langkah berikutnya. Biarkan terminal ini tetap terbuka.

  3. Mulai Adaptor Debug CodeLLDB di host:

    • Buka direktori ekstensi CodeLLDB (default: ~/.lsp4ij/dap/codelldb/extension/adapter).
    • Tetapkan variabel lingkungan yang diperlukan dan mulai server adapter, dengan mengganti REPO_ROOT dan CLANG_VERSION sebagaimana ditentukan dalam penyiapan server:
        # Sets PYTHONHOME env variable
    export PYTHONHOME=REPO_ROOT/prebuilts/clang/host/linux-x86/CLANG_VERSION/python3

    # Tell the dynamic linker where to find python libs
    export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:REPO_ROOT/prebuilts/clang/host/linux-x86/CLANG_VERSION/python3/lib

    # Starts the CodeLLDB Debugger Adapter server on port 1234
    ./codelldb --liblldb REPO_ROOT/prebuilts/clang/host/linux-x86/CLANG_VERSION/lib/liblldb.so --port 1234

  4. Konfigurasi Klien DAP ASfP:

    1. Kembali ke konfigurasi Run/Debug Debug Adapter Protocol di ASfP.
    2. Pilih tab Configuration.
    3. Setel Debug Mode ke Attach.
    4. Tetapkan Alamat ke localhost.
    5. Tetapkan Port ke 1234.
    6. Tempelkan output JSON dari perintah lldbclient.py (Langkah 2) ke kolom Parameter DAP (JSON).

  5. Klik Debug untuk memulai sesi proses debug.

Pemecahan masalah

  • Jika Anda melihat error error: Connection shut down by remote side while waiting for reply to initial handshake packet, akhiri sesi debug saat ini, lalu mulai ulang lldb-server di perangkat dan adaptor CodeLLDB di host.