Skip to content

Commit fa59532

Browse files
melixmelix
committed
Update release notes
1 parent 46524af commit fa59532

File tree

3 files changed

+150
-57
lines changed

3 files changed

+150
-57
lines changed

‎docs/src/docs/asciidoc/gradle-plugin.adoc‎

Lines changed: 1 addition & 57 deletions
Original file line numberDiff line numberDiff line change
@@ -249,6 +249,7 @@ graalvmNative {
249249

250250
NOTE: For options that can be set using command-line, if both DSL and command-line options are present, command-line options take precedence.
251251

252+
[[long_classpath_and_fat_jar_support]]
252253
==== Long classpath and fat jar support
253254

254255
Under Windows, https://github.com/graalvm/native-build-tools/issues/85[it is possible that the length of the classpath exceeds what the operating system supports] when invoking the CLI to build a native image.
@@ -326,60 +327,3 @@ The generated configuration files will be found in the `${buildDir}/native/agent
326327
== Javadocs
327328

328329
In addition, you can consult the link:javadocs/native-gradle-plugin/index.html[Javadocs of the plugin].
329-
330-
[[changelog]]
331-
== Changelog
332-
333-
=== Release 0.9.3
334-
335-
In preparation for supporting more images:
336-
337-
- The `nativeBuild` and `nativeTest` extensions are now deprecated. A top-level container for configuring native images has been introduced. Instead of:
338-
339-
```groovy
340-
nativeBuild {
341-
verbose = true
342-
}
343-
```
344-
345-
you need to use:
346-
347-
```groovy
348-
graalvmNative {
349-
binaries {
350-
main {
351-
verbose = true
352-
}
353-
}
354-
}
355-
```
356-
357-
and instead of:
358-
359-
```groovy
360-
nativeTest {
361-
buildArgs("...")
362-
}
363-
```
364-
365-
you need to use:
366-
367-
```groovy
368-
graalvmNative {
369-
binaries {
370-
test {
371-
verbose = true
372-
}
373-
}
374-
}
375-
```
376-
377-
- The `nativeBuild` task has been renamed to `nativeCompile`.
378-
- The `nativeTestBuild` task has been renamed to `nativeTestCompile`.
379-
380-
Both `nativeBuild` and `nativeTestBuild` task invocations are still supported but deprecated and will be removed in a future release.
381-
382-
== Release 0.9.2
383-
384-
- Added support for resources detection
385-
- Fixed a number of regressions

‎docs/src/docs/asciidoc/index.adoc‎

Lines changed: 148 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -11,3 +11,151 @@ Please refer to the following pages for build tool specific documentation:
1111
- The <<maven-plugin.adoc#,Maven plugin documentation>>
1212
1313
If you are interested in contributing, please refer to our https://github.com/graalvm/native-build-tools[Git repository].
14+
15+
[[changelog]]
16+
== Changelog
17+
18+
=== Release 0.9.5
19+
20+
This release contains, in preparation for supporting more images in the Gradle plugin:
21+
22+
- The `nativeBuild` and `nativeTest` extensions are now deprecated. A top-level container for configuring native images has been introduced. Instead of:
23+
24+
[source,groovy]
25+
----
26+
nativeBuild {
27+
verbose = true
28+
}
29+
----
30+
31+
you need to use:
32+
33+
[source,groovy]
34+
----
35+
graalvmNative {
36+
binaries {
37+
main {
38+
verbose = true
39+
}
40+
}
41+
}
42+
----
43+
44+
and instead of:
45+
46+
[source,groovy]
47+
----
48+
nativeTest {
49+
buildArgs("...")
50+
}
51+
----
52+
53+
you need to use:
54+
55+
[source,groovy]
56+
----
57+
graalvmNative {
58+
binaries {
59+
test {
60+
verbose = true
61+
}
62+
}
63+
}
64+
----
65+
66+
- The `nativeBuild` task has been renamed to `nativeCompile`.
67+
- The `nativeTestBuild` task has been renamed to `nativeTestCompile`.
68+
69+
Both `nativeBuild` and `nativeTestBuild` task invocations are still supported but deprecated and will be removed in a future release.
70+
71+
=== Release 0.9.4
72+
73+
This release works around a limitation for Windows users who encounter an issue with long classpath entries on CLI: the Gradle plugin will now automatically handle this problem by creating a fat jar instead of passing all entries on classpath (this behavior can be <<gradle-plugin.adoc#long_classpath_and_fat_jar_support, disabled>>) if needed).
74+
Maven users will have to <<maven-plugin.adoc#long_classpath_and_shading_support, configure their build differently>> to use shading.
75+
76+
In addition to this, we're now publishing development snapshots of this plugin. For Gradle, you will need to declare this repository in your settings.gradle(.kts) file:
77+
78+
[source,groovy]
79+
----
80+
pluginManagement {
81+
plugins {
82+
id 'org.graalvm.buildtools.native' version '0.9.5-SNAPSHOT'
83+
}
84+
repositories {
85+
maven {
86+
url "https://raw.githubusercontent.com/graalvm/native-build-tools/snapshots"
87+
}
88+
gradlePluginPortal()
89+
}
90+
}
91+
----
92+
93+
For Maven, you need to use this repository configuration:
94+
95+
[source,xml]
96+
----
97+
<pluginRepositories>
98+
<pluginRepository>
99+
<id>graalvm-native-build-tools-snapshots</id>
100+
<name>GraalVM native-build-tools Snapshots</name>
101+
<url>https://raw.githubusercontent.com/graalvm/native-build-tools/snapshots</url>
102+
<releases>
103+
<enabled>false</enabled>
104+
</releases>
105+
<snapshots>
106+
<enabled>true</enabled>
107+
</snapshots>
108+
</pluginRepository>
109+
</pluginRepositories>
110+
----
111+
112+
=== Release 0.9.3
113+
114+
This release contains:
115+
116+
- Fix for mainClass not being optional (Gradle plugin)
117+
- Fix for Gradle < 7 failing to determine GraalVM toolchain
118+
- Gradle plugin now registers proper groups
119+
- Automatic native-image tool fetching via gu (Gradle plugin)
120+
- FIxed issue where nativeTest would fail when tests are annotated with Timeout
121+
- Added a sharedLibrary configuration option for Gradle plugin
122+
- Removed broken server configuration option from Gradle plugin
123+
- Added a documentation website with proper CI integration
124+
125+
In addition to those improvements, several behind-the-scenes changes were made:
126+
127+
- Introduced "Dockerless" Maven plugin functional testing
128+
- Parallelized Gradle testing in CI
129+
- Replaced groovy-json with jackson-databind for JSON handling
130+
- Fixed Github Actions syntax to enable manual workflow invoking
131+
132+
=== Release 0.9.2
133+
134+
This release contains:
135+
136+
- Revamped Gradle plugin that is now a lot more idiomatic.
137+
- Fixes for several issues regarding JUnit testing.
138+
- Removal of Test Discovery mode from the Maven plugin.
139+
- Fix for Maven creating empty test images when no tests are present.
140+
- Added support for Kotlin tests in Gradle.
141+
142+
In addition to those improvements, several behind-the-scenes changes were made in order to ensure better compatibility moving forward:
143+
144+
- Test coverage has been greatly improved for all subprojects.
145+
- Build tooling for this repository has been improved significantly.
146+
147+
Note that there has been a breaking change in the Gradle plugin - `persistConfig` configuration option was removed.
148+
Using said option will cause existing builds to break, so users are advised to remove it from their configuration prior to upgrading.
149+
System property `-DpersistConfig` will have no effect going forward.
150+
151+
=== Release 0.9.1
152+
153+
This release contains:
154+
155+
- Fixes for most of the known issues regarding Gradle and Maven plugins
156+
- Massively improved automatic JUnit support as well as initial JUnit Vintage support
157+
- Improved JavaDoc and tests for the Gradle plugin
158+
159+
=== Release 0.9.0
160+
161+
Initial release

‎docs/src/docs/asciidoc/maven-plugin.adoc‎

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -170,6 +170,7 @@ This step won't be needed as of JUnit 5.8 with a future release of native-maven-
170170

171171
Running `mvn -Pnative -Dskip test` will then build and run native tests.
172172

173+
[[long_classpath_and_shading_support]]
173174
== Long classpath and shading support
174175

175176
Under Windows, https://github.com/graalvm/native-build-tools/issues/85[it is possible that the length of the classpath exceeds what the operating system supports] when invoking the CLI to build a native image.

0 commit comments

Comments
 (0)