Skip to content

Document the io.quarkus.DEBUG_GENERATED_CLASSES_DIR property, #1078 #1152

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 1 commit into from
Mar 2, 2019
Merged

Document the io.quarkus.DEBUG_GENERATED_CLASSES_DIR property, #1078 #1152

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
13 changes: 13 additions & 0 deletions docs/src/main/asciidoc/extension-authors-guide.adoc
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -548,3 +548,16 @@ The only particular aspect of writing {project-name} extensions in Eclipse is th
- Install `m2e-apt` from https://marketplace.eclipse.org/content/m2e-apt
- Define this property in your `pom.xml`: `<m2e.apt.activation>jdt_apt</m2e.apt.activation>`, although if you rely on `io.quarkus:quarkus-build-parent` you will get it for free.
- If you have the `io.quarkus:quarkus-extension-processor` open at the same time in your IDE (for example, if you have the {project-name} sources checked out and open in your IDE) you will need to close that project. Otherwise, Eclipse will not invoke the APT plugin that it contains.

== Troubleshooting / Debugging Tips

=== Saving Application Generated Classes to Disk

The class augmentation step of {project-name} generates classes for various purposes. Sometimes you need to view these
classes/bytecode to debug or understand an issue. Classes that are related to application augmentation are currently held in
memory in a runtime class loader. To have these classes written out to disk for inspection, specify the
`io.quarkus.DEBUG_GENERATED_CLASSES_DIR` system property, for example:
[code,bash]
----
mvn clean install -Dio.quarkus.DEBUG_GENERATED_CLASSES_DIR=./target/app-generated-classes
----