2020-08-14 07:44:14 +02:00
|
|
|
## Build and Test
|
|
|
|
|
|
|
|
```shell
|
|
|
|
meson build
|
|
|
|
ninja -Cbuild
|
|
|
|
meson test -Cbuild
|
|
|
|
```
|
|
|
|
|
|
|
|
### Debug with GDB
|
|
|
|
|
|
|
|
```shell
|
|
|
|
meson test -Cbuild --gdb testname
|
|
|
|
```
|
|
|
|
|
|
|
|
## Build and Run
|
2019-05-08 18:42:35 +02:00
|
|
|
|
|
|
|
Depending on what area you are working in change or add `HB_DEBUG_<whatever>`.
|
|
|
|
Values defined in `hb-debug.hh`.
|
|
|
|
|
|
|
|
```shell
|
2020-08-14 07:44:14 +02:00
|
|
|
CPPFLAGS='-DHB_DEBUG_SUBSET=100' meson setup build --reconfigure
|
2020-07-30 12:50:17 +02:00
|
|
|
meson test -C build
|
2019-05-08 18:42:35 +02:00
|
|
|
```
|
|
|
|
|
2019-05-11 01:52:43 +02:00
|
|
|
### Run tests with asan
|
|
|
|
|
|
|
|
```shell
|
2020-08-14 07:44:14 +02:00
|
|
|
meson setup build -Db_sanitize=address --reconfigure
|
2020-07-30 12:50:17 +02:00
|
|
|
meson compile -C build
|
2020-08-04 14:19:27 +02:00
|
|
|
meson test -C build
|
2019-05-11 01:52:43 +02:00
|
|
|
```
|
|
|
|
|
2019-05-08 18:42:35 +02:00
|
|
|
### Enable Debug Logging
|
|
|
|
|
|
|
|
```shell
|
2020-08-14 07:44:14 +02:00
|
|
|
CPPFLAGS=-DHB_DEBUG_SUBSET=100 meson build --reconfigure
|
2020-07-30 12:50:17 +02:00
|
|
|
ninja -C build
|
2019-05-08 18:42:35 +02:00
|
|
|
```
|
|
|
|
|
2019-05-08 18:47:34 +02:00
|
|
|
## Test with the Fuzzer
|
|
|
|
|
|
|
|
```shell
|
2020-08-14 07:49:33 +02:00
|
|
|
CXXFLAGS="-fsanitize=address,fuzzer-no-link" meson fuzzbuild --default-library=static -Dfuzzer_ldflags="-fsanitize=address,fuzzer" -Dexperimental_api=true
|
|
|
|
ninja -Cfuzzbuild test/fuzzing/hb-{shape,draw,subset,set}-fuzzer
|
|
|
|
fuzzbuild/test/fuzzing/hb-subset-fuzzer test/fuzzing/fonts
|
2019-05-08 18:47:34 +02:00
|
|
|
```
|
2019-09-27 18:55:17 +02:00
|
|
|
|
|
|
|
## Profiling
|
|
|
|
|
2022-06-04 14:01:17 +02:00
|
|
|
For profiling, see `perf/README.md`.
|
2019-09-27 18:55:17 +02:00
|
|
|
|