Di Chrome Dev Summit 2020, kami mendemonstrasikan dukungan proses debug Chrome untuk aplikasi WebAssembly di web untuk pertama kalinya. Sejak saat itu, tim telah menginvestasikan banyak energi guna membuat skala pengalaman developer untuk aplikasi besar maupun besar. Dalam postingan ini, kami akan menunjukkan kenop yang telah kami tambahkan (atau buat) di berbagai alat dan cara menggunakannya.
Proses debug skalabel
Mari kita lanjutkan pembahasan terakhir kita di postingan tahun 2020 ini. Berikut adalah contoh yang kami lihat saat itu:
#include <SDL2/SDL.h>
#include <complex>
int main() {
// Init SDL.
int width = 600, height = 600;
SDL_Init(SDL_INIT_VIDEO);
SDL_Window* window;
SDL_Renderer* renderer;
SDL_CreateWindowAndRenderer(width, height, SDL_WINDOW_OPENGL, &window,
&renderer);
// Generate a palette with random colors.
enum { MAX_ITER_COUNT = 256 };
SDL_Color palette[MAX_ITER_COUNT];
srand(time(0));
for (int i = 0; i < MAX_ITER_COUNT; ++i) {
palette[i] = {
.r = (uint8_t)rand(),
.g = (uint8_t)rand(),
.b = (uint8_t)rand(),
.a = 255,
};
}
// Calculate and draw the Mandelbrot set.
std::complex<double> center(0.5, 0.5);
double scale = 4.0;
for (int y = 0; y < height; y++) {
for (int x = 0; x < width; x++) {
std::complex<double> point((double)x / width, (double)y / height);
std::complex<double> c = (point - center) * scale;
std::complex<double> z(0, 0);
int i = 0;
for (; i < MAX_ITER_COUNT - 1; i++) {
z = z * z + c;
if (abs(z) > 2.0)
break;
}
SDL_Color color = palette[i];
SDL_SetRenderDrawColor(renderer, color.r, color.g, color.b, color.a);
SDL_RenderDrawPoint(renderer, x, y);
}
}
// Render everything we've drawn to the canvas.
SDL_RenderPresent(renderer);
// SDL_Quit();
}
Ini masih merupakan contoh yang cukup kecil dan Anda mungkin tidak akan melihat masalah nyata yang akan Anda lihat di aplikasi yang sangat besar, tetapi kami masih dapat menunjukkan apa saja fitur barunya. Cepat dan mudah disiapkan serta dicoba sendiri.
Dalam postingan terakhir, kita membahas cara mengompilasi dan men-debug contoh ini. Mari kita lakukan lagi, tetapi mari kita lihat //performance//:
$ emcc -sUSE_SDL=2 -g -O0 -o mandelbrot.html mandelbrot.cc -sALLOW_MEMORY_GROWTH
Perintah ini menghasilkan biner wasm 3 MB. Dan sebagian besar dari itu, seperti yang mungkin Anda duga, adalah informasi debug. Anda dapat memverifikasinya dengan alat llvm-objdump
[1], misalnya:
$ llvm-objdump -h mandelbrot.wasm
mandelbrot.wasm: file format wasm
Sections:
Idx Name Size VMA Type
0 TYPE 0000026f 00000000
1 IMPORT 00001f03 00000000
2 FUNCTION 0000043e 00000000
3 TABLE 00000007 00000000
4 MEMORY 00000007 00000000
5 GLOBAL 00000021 00000000
6 EXPORT 0000014a 00000000
7 ELEM 00000457 00000000
8 CODE 0009308a 00000000 TEXT
9 DATA 0000e4cc 00000000 DATA
10 name 00007e58 00000000
11 .debug_info 000bb1c9 00000000
12 .debug_loc 0009b407 00000000
13 .debug_ranges 0000ad90 00000000
14 .debug_abbrev 000136e8 00000000
15 .debug_line 000bb3ab 00000000
16 .debug_str 000209bd 00000000
Output ini menampilkan semua bagian yang ada di file wasm yang dihasilkan. Sebagian besar adalah bagian WebAssembly standar, tetapi ada juga beberapa bagian kustom yang namanya diawali dengan .debug_
. Di situlah biner berisi informasi debug kita. Jika kita menjumlahkan semua ukuran, kita melihat bahwa info {i>debug<i} mencapai sekitar 2,3 MB dari file 3 MB kita. Jika kita juga melakukan time
perintah emcc
, kita akan melihat bahwa diperlukan waktu sekitar 1,5 detik di mesin untuk menjalankannya. Angka-angka ini merupakan dasar yang bagus, tetapi angkanya sangat kecil dan mungkin tidak akan ada yang mengkhawatirkannya. Namun, dalam aplikasi nyata, biner debug dapat dengan mudah mencapai ukuran dalam GB dan membutuhkan waktu beberapa menit untuk membangun!
Melewati Biner
Saat membuat aplikasi wasm dengan Emscripten, salah satu langkah build akhirnya adalah menjalankan pengoptimal Binaryen. Biner adalah toolkit compiler yang mengoptimalkan dan melegalkan biner WebAssembly(-like). Operasi Binaryen sebagai bagian dari build cukup mahal, tetapi hanya diperlukan dalam kondisi tertentu. Untuk build debug, kita dapat mempercepat waktu build secara signifikan jika menghindari kebutuhan akan penerusan Biner. Binaryen pass paling umum yang diperlukan adalah untuk melegalkan tanda tangan fungsi yang melibatkan nilai integer 64 bit. Dengan ikut serta dalam integrasi WebAssembly BigInt menggunakan -sWASM_BIGINT
, kita dapat menghindari hal ini.
$ emcc -sUSE_SDL=2 -g -O0 -o mandelbrot.html mandelbrot.cc -sALLOW_MEMORY_GROWTH -sWASM_BIGINT -sERROR_ON_WASM_CHANGES_AFTER_LINK
Kami telah menampilkan flag -sERROR_ON_WASM_CHANGES_AFTER_LINK
untuk tindakan yang baik. Alat ini membantu mendeteksi kapan Binaryen berjalan dan menulis ulang biner secara tidak terduga. Dengan cara ini, kita dapat memastikan bahwa
kita tetap berada di jalur yang cepat.
Meskipun contoh kita cukup kecil, kita masih dapat melihat efek melewati Binaryen. Menurut time
, perintah ini berjalan kurang dari 1 dtk, jadi setengah detik lebih cepat dari sebelumnya.
Penyesuaian lanjutan
Melewati pemindaian file input
Biasanya saat menautkan project Emscripten, emcc
akan memindai semua file dan library objek input. Hal ini dilakukan untuk menerapkan dependensi yang tepat antara fungsi library JavaScript dan simbol native dalam program Anda. Untuk project yang lebih besar, pemindaian tambahan pada file input ini (menggunakan llvm-nm
) dapat menambah waktu penautan secara signifikan.
Anda dapat menjalankan dengan -sREVERSE_DEPS=all
yang memberi tahu emcc
untuk menyertakan semua kemungkinan dependensi native fungsi JavaScript. Versi ini memiliki overhead ukuran kode yang kecil, tetapi dapat mempercepat waktu link dan dapat berguna untuk build debug.
Untuk proyek sekecil contoh kami, hal ini tidak akan menimbulkan perbedaan nyata. Namun, jika Anda memiliki ratusan atau bahkan ribuan file objek dalam project Anda, hal ini dapat meningkatkan waktu link secara signifikan.
Menghapus bagian “name”
Dalam project besar, terutama project dengan banyak penggunaan template C++, bagian "name" WebAssembly bisa menjadi sangat besar. Dalam contoh kita, ini hanya sebagian kecil dari ukuran file secara keseluruhan (lihat output llvm-objdump
di atas), tetapi dalam beberapa kasus, ukurannya bisa sangat signifikan. Jika bagian "name" pada aplikasi Anda sangat besar, dan informasi debug dwarf sudah cukup untuk kebutuhan proses debug Anda, mungkin akan berguna untuk menghapus bagian "name":
$ emstrip --no-strip-all --remove-section=name mandelbrot.wasm
Tindakan ini akan menghapus bagian “nama” WebAssembly sekaligus mempertahankan bagian debug DWARF.
Fisi debug
Biner yang memiliki banyak data debug tidak hanya memberikan tekanan pada waktu build, tetapi juga pada waktu proses debug. Debugger perlu memuat data dan perlu membuat indeks untuk data tersebut, agar dapat merespons kueri dengan cepat, seperti "Apa jenis variabel lokal x?".
Fission debug memungkinkan kita membagi informasi debug untuk biner menjadi dua bagian: satu, yang tetap berada dalam biner, dan satu lagi, yang terdapat dalam file terpisah yang disebut objek DWARF (.dwo
). Fungsi ini dapat diaktifkan dengan meneruskan tanda -gsplit-dwarf
ke Emscripten:
$ emcc -sUSE_SDL=2 -g -gsplit-dwarf -gdwarf-5 -O0 -o mandelbrot.html mandelbrot.cc -sALLOW_MEMORY_GROWTH -sWASM_BIGINT -sERROR_ON_WASM_CHANGES_AFTER_LINK
Di bawah ini, kami menampilkan perintah yang berbeda dan file yang dihasilkan dengan mengompilasi tanpa data debug, dengan data debug, dan terakhir dengan data debug dan fisi debug.
Saat membagi data DWARF, sebagian data debug berada bersama biner, sedangkan sebagian besar dimasukkan ke dalam file mandelbrot.dwo
(seperti yang diilustrasikan di atas).
Untuk mandelbrot
, kita hanya memiliki satu file sumber, tetapi umumnya project lebih besar dari ini dan menyertakan lebih dari satu file. Fission debug menghasilkan file .dwo
untuk setiap komponen tersebut. Agar debugger versi beta saat ini (0.1.6.1615) dapat memuat informasi debug pemisahan ini, kita perlu memaketkan semua itu menjadi satu paket DWARF (.dwp
) seperti ini:
$ emdwp -e mandelbrot.wasm -o mandelbrot.dwp
Membuat paket DWARF dari setiap objek memiliki keuntungan karena Anda hanya perlu menyajikan satu file tambahan! Saat ini kami sedang berupaya memuat semua objek individual dalam rilis mendatang.
Ada apa dengan DWARF 5?
Anda mungkin telah mengetahui bahwa kami menyelipkan flag lain ke dalam perintah emcc
di atas, -gdwarf-5
. Mengaktifkan simbol DWARF versi 5, yang saat ini bukan merupakan default, merupakan trik lain untuk membantu kami memulai proses debug dengan lebih cepat. Dengannya, informasi tertentu disimpan dalam biner utama yang tidak diikutkan dalam versi {i>default<i} 4. Secara khusus, kita dapat menentukan kumpulan lengkap file sumber hanya dari biner utama. Hal ini memungkinkan debugger melakukan tindakan dasar seperti menampilkan hierarki sumber lengkap dan menyetel titik henti sementara tanpa memuat dan mengurai data simbol lengkap. Hal ini membuat proses debug dengan simbol pemisahan jauh lebih cepat, sehingga kita selalu menggunakan tanda command line -gsplit-dwarf
dan -gdwarf-5
secara bersamaan.
Dengan format debug DWARF5, kami juga mendapatkan akses ke fitur lain yang berguna. Tutorial ini memperkenalkan indeks nama dalam data debug yang akan dibuat saat meneruskan flag -gpubnames
:
$ emcc -sUSE_SDL=2 -g -gdwarf-5 -gsplit-dwarf -gpubnames -O0 -o mandelbrot.html mandelbrot.cc -sALLOW_MEMORY_GROWTH -sWASM_BIGINT -sERROR_ON_WASM_CHANGES_AFTER_LINK
Selama sesi proses debug, pencarian simbol sering terjadi dengan menelusuri entitas berdasarkan nama, misalnya, saat mencari variabel atau jenis. Indeks nama mempercepat penelusuran ini dengan mengarahkan langsung ke unit kompilasi yang menentukan nama tersebut. Tanpa indeks nama, penelusuran menyeluruh seluruh data debug akan diperlukan untuk menemukan unit kompilasi yang tepat yang mendefinisikan entitas bernama yang kita cari.
Untuk yang ingin tahu: Melihat data debug
Anda dapat menggunakan llvm-dwarfdump
untuk mengintip data DWARF. Mari kita coba:
llvm-dwarfdump mandelbrot.wasm
Ini memberi kita ringkasan tentang "Unit kompilasi" (kira-kira, file sumber) yang informasi debugnya kita miliki. Dalam contoh ini, kita hanya memiliki info debug untuk mandelbrot.cc
. Dengan info umum, kita akan tahu bahwa kita memiliki unit kerangka, yang artinya kita memiliki data yang tidak lengkap pada file ini, dan bahwa ada file .dwo
terpisah yang berisi info debug yang tersisa:
Anda juga dapat melihat tabel lain dalam file ini, misalnya di tabel baris yang menunjukkan pemetaan bytecode wasm ke baris C++ (coba gunakan llvm-dwarfdump -debug-line
).
Kita juga dapat melihat info debug yang terdapat dalam file .dwo
terpisah:
llvm-dwarfdump mandelbrot.dwo
TL;DR: Apa keuntungan menggunakan proses debug fisi?
Ada beberapa keuntungan memisahkan informasi debug jika bekerja dengan aplikasi besar:
Penautan yang lebih cepat: Penaut tidak perlu lagi menguraikan seluruh informasi debug. Penaut biasanya perlu mengurai seluruh data DWARF yang ada dalam biner. Dengan menghilangkan sebagian besar informasi debug ke dalam file terpisah, penaut menangani biner yang lebih kecil, sehingga menghasilkan waktu penautan yang lebih cepat (terutama berlaku untuk aplikasi besar).
Proses debug yang lebih cepat: Debugger dapat melewati penguraian simbol tambahan dalam file
.dwo
/.dwp
untuk beberapa pencarian simbol. Untuk beberapa pencarian (seperti permintaan pada pemetaan baris file wasm-ke-C++), kita tidak perlu melihat data debug tambahan. Ini akan menghemat waktu kami, tidak perlu memuat dan mengurai data debug tambahan.
1: Jika tidak memiliki versi terbaru llvm-objdump
di sistem, dan menggunakan emsdk
, Anda dapat menemukannya di direktori emsdk/upstream/bin
.
Mendownload saluran pratinjau
Pertimbangkan untuk menggunakan Chrome Canary, Dev, atau Beta sebagai browser pengembangan default Anda. Saluran pratinjau ini memberi Anda akses ke fitur DevTools terbaru, menguji API platform web mutakhir, dan menemukan masalah di situs Anda sebelum pengguna melakukannya.
Menghubungi tim Chrome DevTools
Gunakan opsi berikut untuk membahas fitur dan perubahan baru dalam postingan, atau hal lain yang terkait dengan DevTools.
- Kirim saran atau masukan kepada kami melalui crbug.com.
- Laporkan masalah DevTools menggunakan Opsi lainnya > Bantuan > Laporkan masalah DevTools di DevTools.
- Tweet di @ChromeDevTools.
- Tulis komentar di Video YouTube yang baru di DevTools atau Tips DevTools Video YouTube.