Byte Buddy is a code generation and manipulation library for creating and
modifying Java classes during the runtime of a Java application and without the
help of a compiler. Other than the code generation utilities that ship with the
Java Class Library, Byte Buddy allows the creation of arbitrary classes and is
not limited to implementing interfaces for the creation of runtime proxies.
Furthermore, Byte Buddy offers a convenient API for changing classes either
manually, using a Java agent or during a build.
Provides
Requires
License
Apache-2.0
Changelog
* Mon Jun 23 2025 fstrba@suse.com
- Fix build with maven 4
* Mon Jun 16 2025 shvetz.anton@gmail.com
- Update to v1.17.6
* Changes of v1.17.6
+ Add convenience wrapper for ResettableClassFileTransformer
that implicitly delegates to correct transformer method.
+ Add filter for deduplicate fields and methods in class file.
+ Add missing static requirement of Spotbugs annotations to
module descriptors.
+ Add LazinessMode for TypePool and add convenience support to
AgentBuilder.
+ Fix source jars for multi-version release to contain
duplicated source.
* Wed Apr 02 2025 shvetz.anton@gmail.com
- Update to v1.17.5
* Changes of v1.17.5
+ Update ASM to version 9.8 to support Java 25 using ASM reader
and writer.
+ Include AnnotationRemoval visitor for removing or replacing
annotations.
* Mon Mar 24 2025 shvetz.anton@gmail.com
- Update to v1.17.4
* Changes of v1.17.4
+ Add SafeVarargs plugin.
+ Fix OSGi declaration for byte-buddy-agent.
* Sat Mar 22 2025 shvetz.anton@gmail.com
- Update to v1.17.3
* Changes of v1.17.3
+ Fix bug in ASM to Class File API bridge handling tableswitch
instructions.
+ Add plugin for adding SafeVarargs annotations.
+ Further generify MemberSubstitution API.
* Tue Mar 04 2025 shvetz.anton@gmail.com
- Update to v1.17.2
* Changes of v1.17.2
+ Update Class File API integration to include support for
several omitted byte codes.
+ Adjust attach API emulation for OpenJ9 to not create
subfolder if temporary folder is set explicitly.
* Fri Feb 14 2025 shvetz.anton@gmail.com
- Update to v1.17.1
* Changes of v1.17.1
+ Fix bug in MemberSubstitution were argument indices were
resolved by one digit off.
+ Update Class File API integration to avoid that parameter
annotations are lost.
* Wed Jan 29 2025 shvetz.anton@gmail.com
- Update to v1.17.0
* Changes of v1.17.0
+ Assure that implicit choice for class reader and class writer
are always symmetric with regard to internal representation.
+ Retrofit MemberSubstitution to also allow for intercepting
invokedynamic instructions.
+ Introduce @Handle annotations to allow for injecting constant
pool-stored method handle in Advice, MemberSubstitution and
MethodDelegation.
+ Introduce @DynamicConstant annotations to allow for injecting
constant pool-stored dynamic constants in Advice,
MemberSubstitution and MethodDelegation.
* Sun Jan 19 2025 shvetz.anton@gmail.com
- Update to v1.16.1
* Changes of v1.16.1
+ Correct reflective activation of Class File API.
+ Reject array descriptors that are not well-formed in
TypePool.
* Sat Jan 18 2025 shvetz.anton@gmail.com
- Update to v1.16.0
* Changes of v1.16.0
+ Allow for erasure of types of bootstrapped methods in Advice
within instrumented class.
+ Rework Advice post-processing to allow for erasure of
bootstrapped methods.
+ Fix missing application of hashCode/equals plugin for Java 8
code.
+ Include support for JDK Class File API.
+ Allow Plugin.Engine to retain folders.
- Rebase/update patch:
* 0001-Avoid-bundling-asm.patch
* Sun Dec 15 2024 shvetz.anton@gmail.com
- Update to v1.15.11
* Changes of v1.15.11
+ Avoid dependency of CachedReturnPlugin on precompiled class
files.
+ Add NOP instruction when Advice is used on void methods as
those might be empty which results on a frame being written
to the same offset, causing an exception.
+ Allow Plugin.Enging to link files instead of copying.
+ Adjust validator code to avoid compiler bug that was reported
by multiple users.
+ Allow injection of class path as File[] to Plugin
constructors.
+ Allow for configuring variants when using the Android Gradle
plugin.
* Sun Nov 03 2024 shvetz.anton@gmail.com
- Update to v1.15.10
* Changes of v1.15.10
+ Fix Java 8 patterns for multi-release jars to avoid that
inner classes are excluded.
* Changes of v1.15.9
+ Additional release after time out during previous Gradle
plugin release.
* Sat Nov 02 2024 shvetz.anton@gmail.com
- Update to v1.15.8
* Changes of v1.15.8
+ Extend ClassInjector API to support lazy resolution of class
files.
+ Extend DynamicType API to support lazy resolution of
auxiliary types.
+ Extend AgentBuilder.Transformer.ForAdvice to support
injection of new classes by their name.
* Wed Oct 23 2024 shvetz.anton@gmail.com
- Update to v1.15.7
* Changes of v1.15.7
+ Additional release after time out during previous Gradle
plugin release.
* Changes of v1.15.6
+ Add ConstructorResolver to Super annotation for
MethodDelegation to allow for dynamic constructor resolution.
+ Add Java 8 versions of shaded ASM to allow for faster class
file validation and CDS support.
* Thu Oct 17 2024 shvetz.anton@gmail.com
- Update to v1.15.5
* Changes of v1.15.5
+ Publish Byte Buddy and Byte Buddy agent artifacts as
multi-release jars to support CDS and faster validation.
- Remove Windows-specific resources
* Sat Oct 12 2024 shvetz.anton@gmail.com
- Update to v1.15.4
* Add non-experimental support for Java 24.
* Thu Sep 26 2024 shvetz.anton@gmail.com
- Update to v1.15.3
* Changes of v1.15.3
+ Treat multi-release class files that are newer than the
supported version as regular resources.
+ Allow overriding the multi-release class file version from
Maven and Gradle plugin.
+ Correctly resolve multi-release class files in Android.
* Wed Sep 25 2024 shvetz.anton@gmail.com
- Update to v1.15.2
* Changes of v1.15.2
+ Add support for multi-release JAR files in ClassFileLocators
and Plugin.Engine.Default.
+ Add Gradle task for transforming multiple jar files with
ByteBuddyJarsTask.
+ Avoid validation of JarFile when extracting individual
entries.
+ Rework discovery in ByteBuddyMojo.
* Sun Sep 01 2024 shvetz.anton@gmail.com
- Update to v1.15.1
* Changes of v1.15.1
+ Revert default EntryPoint for Android Gradle plugin to use
DECORATE unless explicitly specified due to many generic type
errors in Kotlin classes.
* Changes of v1.15.0
+ Introduce AsmClassWriter and AsmClassReader abstractions that
allow for plugging different implementations of readers and
writers.
+ Add configuration extension to the Android Gradle plugin and
make it behave like regular Gradle plugin with standard
configuration.
+ Throw TypeNotPresentException upon discovering undeclared
type variables as it was recently fixed on the JVM.
* Changes of v1.14.19
+ Add Maven Mojo for transforming jars and for transforming
dependencies folder.
+ Better error handling for unresolved type variables.
+ Allow loading arguments of the instrumented method in
MemberSubstitution.
+ Fix checks for method visibility.
* Mon Jul 08 2024 shvetz.anton@gmail.com
- Update to v1.14.18
* Changes of v1.14.18
+ Avoid verification error if constructor advice meats dropped
implicit this frame and throw exception during
instrumentation instead.
+ Add support to resolve ByteBuddyAgent from non-obfuscated
name if obfuscation is used.
+ Make sure CircularityLock implementations never load classes
during locking.
+ Offer use of istat if stat command is not available for
emulated attachment.
+ Avoid locking entire