lqml/examples/debug-ui/readme.md
2025-10-20 10:04:24 +02:00

39 lines
987 B
Markdown

Prepare
-------
Please copy the app template files first:
```
$ cd ..
$ ./copy.sh debug-ui
```
Info
----
This is a debug dialog (taken from example cl-repl) to be integrated in your
app.
So, if you merge this example with your app, the mobile app will not crash on
an eventual runtime error: an interactive debug dialog will be shown instead.
This is especially helpful on android, where Lisp issues are hard to debug once
the app is installed.
Howto
-----
* extract `local-projects/lqml-debug.tgz` under `~/quicklisp/local-projects/`
* add `lqml-debug` as your very first dependency in your `app.asd`
* modify your `main.qml` as can be seen in [examples](./examples/)
* comment out evtl. present `eval.lisp` (used in simple repl) and `Ext.Repl {}`
Important note
--------------
You can't have both this **debug-ui** and the simple **repl** (`Repl.qml`) in
the same app, because `Repl.qml` depends on `eval.lisp` which would replace
the stream/buffer setup of **debug-ui**.