@@ -7,8 +7,9 @@ Please follow these steps to produce a new release of EchoSVG.
77- The [ Git version control system] ( https://git-scm.com/downloads ) is required to
88obtain the sources. Any recent version should suffice.
99
10- - Java 11 or later. You can install it from your favourite package manager or by
11- downloading from [ Adoptium] ( https://adoptium.net/ ) .
10+ - Java 11 to 25, which you can install from your favourite package manager or
11+ by downloading from [ Adoptium] ( https://adoptium.net/ ) . Generally, Java 21 is
12+ used for compiling releases.
1213
1314- The [ ` generate_directory_index_caddystyle.py ` ] ( https://gist.github.com/carlosame/bd5b68c4eb8e0817d9beb1dcfb4de43d )
1415script and a recent version of [ Python] ( https://www.python.org/ ) (required to
@@ -47,19 +48,19 @@ cd /path/to/echosvg
4748
48495 ) For convenience, now copy all the produced _ jar_ files into a new ` jar `
4950directory and create a Zip archive of them. For example if you are releasing
50- ` 1.2.2 ` :
51+ ` 1.2.5 ` :
5152
5253``` shell
5354./gradlew copyJars
54- mv jar echosvg-1.2.2 -bin
55- 7z a -mx7 echosvg-1.2.2 -binaries.zip echosvg-1.2.2 -bin
55+ mv jar echosvg-1.2.5 -bin
56+ 7z a -mx9 echosvg-1.2.5 -binaries.zip echosvg-1.2.5 -bin
5657```
5758
58596 ) Use ` changes.sh <new-version> ` to create a ` CHANGES.txt ` file for the new
5960version, with the changes from the latest tag:
6061
6162``` shell
62- ./changes.sh 1.2.2
63+ ./changes.sh 1.2.5
6364```
6465
6566Edit the resulting ` CHANGES.txt ` as convenient, to use it as the basis for the
@@ -99,9 +100,9 @@ archiver):
99100cd /path/to/echosvg
100101./gradlew modularJavadoc
101102cd echosvg-all/build/docs
102- mv modular echosvg-1.2.2 -modular-javadocs
103- 7z a echosvg-1.2.2 -modular-javadocs.7z echosvg-1.2.2 -modular-javadocs
104- 7z a -mx9 echosvg-1.2.2 -modular-javadocs.zip echosvg-1.2.2 -modular-javadocs
103+ mv modular echosvg-1.2.5 -modular-javadocs
104+ 7z a echosvg-1.2.5 -modular-javadocs.7z echosvg-1.2.5 -modular-javadocs
105+ 7z a -mx9 echosvg-1.2.5 -modular-javadocs.zip echosvg-1.2.5 -modular-javadocs
105106```
106107
107108The compressed archives will be part of the published release. Notice that the
@@ -114,8 +115,8 @@ Provided that you have the required credentials, you could update it via_ `rsync
114115
115116``` shell
116117cd /path/to/echosvg
117- git tag -s v1.2.2 -m " Release 1.2.2 "
118- git push origin v1.2.2
118+ git tag -s v1.2.5 -m " Release 1.2.5 "
119+ git push origin v1.2.5
119120```
120121
121122or ` git tag -a ` instead of ` -s ` if you do not plan to sign the tag. But it is
@@ -130,25 +131,35 @@ Summarize the most important changes in the release description, then create a
130131` ## Detail of changes ` section and paste the contents of the ` CHANGES.txt ` file
131132under it.
132133
133- Add to the Github release the ` echosvg-1.2.2 -bin.zip ` archive that you created,
134- the modular javadoc archives (` echosvg-1.2.2 -modular-javadocs.7z ` and
135- ` echosvg-1.2.2 -modular-javadocs.zip ` ), and the result of executing:
134+ Add to the Github release the ` echosvg-1.2.5 -bin.zip ` archive that you created,
135+ the modular javadoc archives (` echosvg-1.2.5 -modular-javadocs.7z ` and
136+ ` echosvg-1.2.5 -modular-javadocs.zip ` ), and the result of executing:
136137
137138``` shell
138139./gradlew uberjar
139140```
140- to be found at the ` echosvg-all/build/libs/echosvg-all-1.2.2 -alldeps.jar ` . Then execute:
141+ to be found at the ` echosvg-all/build/libs/echosvg-all-1.2.5 -alldeps.jar ` . Then execute:
141142
142143``` shell
144+ ./gradlew echosvg-codec-jar-with-deps
143145./gradlew echosvg-svggen-jar-with-deps
146+ ./gradlew echosvg-transcoder-jar-with-deps
147+ ./gradlew echosvg-transcoder-svg-jar-with-deps
148+ ./gradlew echosvg-transcoder-tosvg-jar-with-deps
149+ ./gradlew echosvg-transcoder-svg2svg-jar-with-deps
144150```
145- and add the archive at ` echosvg-svggen/build/libs/echosvg-svggen-1.2.2-with-deps.jar ` .
146- Finally run:
147151
148- ``` shell
149- ./gradlew echosvg-transcoder-jar-with-deps
152+ and add to the release the archives at
153+
154+ ```
155+ echosvg-codec/build/libs/echosvg-codec-1.2.5-with-deps.jar
156+ echosvg-svggen/build/libs/echosvg-svggen-1.2.5-with-deps.jar
157+ echosvg-transcoder/build/libs/echosvg-transcoder-1.2.5-with-deps.jar
158+ echosvg-transcoder-svg/build/libs/echosvg-transcoder-svg-1.2.5-with-deps.jar
159+ echosvg-transcoder-tosvg/build/libs/echosvg-transcoder-tosvg-1.2.5-with-deps.jar
160+ echosvg-transcoder-svg2svg/build/libs/echosvg-transcoder-svg2svg-1.2.5-with-deps.jar
150161```
151- to add the archive ` echosvg-transcoder/build/libs/echosvg-transcoder-1.2.2-with-deps.jar ` .
162+ Remember to not set it as the latest release, as it is a 1.x maintenance one .
152163
15316413 ) Verify that the new [ Github packages] ( https://github.com/orgs/css4j/packages?repo_name=echosvg )
154165were created successfully by the [ Gradle Package] ( https://github.com/css4j/echosvg/actions/workflows/gradle-publish.yml )
0 commit comments