v1.4.0

OpenccJava v1.4.0

This release provides multiple formats depending on how you want to use
OpenccJava.

---

1️⃣ Just run the CLI (Recommended)

Download:

• openccjavacli-1.4.0-all.jar

Run:

java -jar openccjavacli-1.4.0-all.jar --help

✔ Works on any system with Java 8+
✔ No native install required
✔ Easiest option

---

2️⃣ Native Executable (No Java Required)

Download the file matching your operating system:

• Linux arm64
  OpenccJavaCli-1.4.0-linux-arm64-native.zip

• Linux x86_64
  OpenccJavaCli-1.4.0-linux-x86_64-native.zip

• macOS Apple Silicon
  OpenccJavaCli-1.4.0-macos-arm64-native.zip

• macOS Intel
  OpenccJavaCli-1.4.0-macos-x86_64-native.zip

• Windows x86_64
  OpenccJavaCli-1.4.0-windows-x86_64-native.zip

After extracting:

• Linux / macOS: ./openccjavacli

• Windows: openccjavacli.exe

✔ Fully standalone
✔ No Java runtime required
✔ Fast startup

---

3️⃣ JVM Distribution Package

Download:

• OpenccJavaCli-1.4.0.jvm.zip
  OR
• OpenccJavaCli-1.4.0.jvm.tar

Extract and run:

bin/openccjavacli

✔ Includes launcher scripts
✔ Good for deployment environments

---

4️⃣ Use as a Java Library

Download:

• openccjava-1.4.0.jar

Optional (for development):

• openccjava-1.4.0-sources.jar
• openccjava-1.4.0-javadoc.jar

Add the JAR to your Java project as a dependency.

---

Quick Recommendation

If unsure what to download:

→ Most users should choose:

openccjavacli-1.4.0-all.jar

For maximum performance and zero Java dependency, use your platform's
native ZIP instead.

Full Changelog: v1.3.0...v1.4.0

v1.3.0

OpenccJava v1.3.0

This release provides multiple formats depending on how you want to use
OpenccJava.

---

1️⃣ Just run the CLI (Recommended)

Download:

• openccjavacli-1.3.0-all.jar

Run:

java -jar openccjavacli-1.3.0-all.jar --help

✔ Works on any system with Java 8+
✔ No native install required
✔ Easiest option

---

2️⃣ Native Executable (No Java Required)

Download the file matching your operating system:

• Linux arm64
  OpenccJavaCli-1.3.0-linux-arm64-native.zip

• Linux x86_64
  OpenccJavaCli-1.3.0-linux-x86_64-native.zip

• macOS Apple Silicon
  OpenccJavaCli-1.3.0-macos-arm64-native.zip

• macOS Intel
  OpenccJavaCli-1.3.0-macos-x86_64-native.zip

• Windows x86_64
  OpenccJavaCli-1.3.0-windows-x86_64-native.zip

After extracting:

• Linux / macOS: ./openccjavacli

• Windows: openccjavacli.exe

✔ Fully standalone
✔ No Java runtime required
✔ Fast startup

---

3️⃣ JVM Distribution Package

Download:

• OpenccJavaCli-1.3.0.jvm.zip
  OR
• OpenccJavaCli-1.3.0.jvm.tar

Extract and run:

bin/openccjavacli

✔ Includes launcher scripts
✔ Good for deployment environments

---

4️⃣ Use as a Java Library

Download:

• openccjava-1.3.0.jar

Optional (for development):

• openccjava-1.3.0-sources.jar
• openccjava-1.3.0-javadoc.jar

Add the JAR to your Java project as a dependency.

---

Quick Recommendation

If unsure what to download:

→ Most users should choose:

openccjavacli-1.3.0-all.jar

For maximum performance and zero Java dependency, use your platform's
native ZIP instead.

Full Changelog: v1.2.3...v1.3.0

v1.2.3

OpenccJava v1.2.3

This release provides multiple formats depending on how you want to use
OpenccJava.

---

1️⃣ Just run the CLI (Recommended)

Download:

• openccjavacli-1.2.3-all.jar

Run:

java -jar openccjavacli-1.2.3-all.jar --help

✔ Works on any system with Java 8+
✔ No native install required
✔ Easiest option

---

2️⃣ Native Executable (No Java Required)

Download the file matching your operating system:

• Linux arm64
  OpenccJavaCli-1.2.3-linux-arm64-native.zip

• Linux x86_64
  OpenccJavaCli-1.2.3-linux-x86_64-native.zip

• macOS Apple Silicon
  OpenccJavaCli-1.2.3-macos-arm64-native.zip

• macOS Intel
  OpenccJavaCli-1.2.3-macos-x86_64-native.zip

• Windows x86_64
  OpenccJavaCli-1.2.3-windows-x86_64-native.zip

After extracting:

• Linux / macOS: ./openccjavacli

• Windows: openccjavacli.exe

✔ Fully standalone
✔ No Java runtime required
✔ Fast startup

---

3️⃣ JVM Distribution Package

Download:

• OpenccJavaCli-1.2.3.jvm.zip
  OR
• OpenccJavaCli-1.2.3.jvm.tar

Extract and run:

bin/openccjavacli

✔ Includes launcher scripts
✔ Good for deployment environments

---

4️⃣ Use as a Java Library

Download:

• openccjava-1.2.3.jar

Optional (for development):

• openccjava-1.2.3-sources.jar
• openccjava-1.2.3-javadoc.jar

Add the JAR to your Java project as a dependency.

---

Quick Recommendation

If unsure what to download:

→ Most users should choose:

openccjavacli-1.2.3-all.jar

For maximum performance and zero Java dependency, use your platform's
native ZIP instead.

Full Changelog: v1.2.2...v1.2.3

v1.2.2

OpenccJava v1.2.2

This release provides multiple formats depending on how you want to use
OpenccJava.

---

1️⃣ Just run the CLI (Recommended)

Download:

• openccjavacli-1.2.2-all.jar

Run:

java -jar openccjavacli-1.2.2-all.jar --help

✔ Works on any system with Java 8+
✔ No native install required
✔ Easiest option

---

2️⃣ Native Executable (No Java Required)

Download the file matching your operating system:

• Linux arm64
  OpenccJavaCli-1.2.2-linux-arm64-native.zip

• Linux x86_64
  OpenccJavaCli-1.2.2-linux-x86_64-native.zip

• macOS Apple Silicon
  OpenccJavaCli-1.2.2-macos-arm64-native.zip

• macOS Intel
  OpenccJavaCli-1.2.2-macos-x86_64-native.zip

• Windows x86_64
  OpenccJavaCli-1.2.2-windows-x86_64-native.zip

After extracting:

• Linux / macOS: ./openccjavacli

• Windows: openccjavacli.exe

✔ Fully standalone
✔ No Java runtime required
✔ Fast startup

---

3️⃣ JVM Distribution Package

Download:

• OpenccJavaCli-1.2.2.jvm.zip
  OR
• OpenccJavaCli-1.2.2.jvm.tar

Extract and run:

bin/openccjavacli

✔ Includes launcher scripts
✔ Good for deployment environments

---

4️⃣ Use as a Java Library

Download:

• openccjava-1.2.2.jar

Optional (for development):

• openccjava-1.2.2-sources.jar
• openccjava-1.2.2-javadoc.jar

Add the JAR to your Java project as a dependency.

---

Quick Recommendation

If unsure what to download:

→ Most users should choose:

openccjavacli-1.2.2-all.jar

For maximum performance and zero Java dependency, use your platform's
native ZIP instead.

Full Changelog: v1.2.1...v1.2.2

v1.2.1

OpenccJava v1.2.1

This release provides multiple formats depending on how you want to use
OpenccJava.

---

1️⃣ Just run the CLI (Recommended)

Download:

• openccjavacli-1.2.1-all.jar

Run:

java -jar openccjavacli-1.2.1-all.jar --help

✔ Works on any system with Java 8+
✔ No native install required
✔ Easiest option

---

2️⃣ Native Executable (No Java Required)

Download the file matching your operating system:

• Linux arm64
  OpenccJavaCli-1.2.1-linux-arm64-native.zip

• Linux x86_64
  OpenccJavaCli-1.2.1-linux-x86_64-native.zip

• macOS Apple Silicon
  OpenccJavaCli-1.2.1-macos-arm64-native.zip

• macOS Intel
  OpenccJavaCli-1.2.1-macos-x86_64-native.zip

• Windows x86_64
  OpenccJavaCli-1.2.1-windows-x86_64-native.zip

After extracting:

• Linux / macOS: ./openccjavacli

• Windows: openccjavacli.exe

✔ Fully standalone
✔ No Java runtime required
✔ Fast startup

---

3️⃣ JVM Distribution Package

Download:

• OpenccJavaCli-1.2.1.jvm.zip
  OR
• OpenccJavaCli-1.2.1.jvm.tar

Extract and run:

bin/openccjavacli

✔ Includes launcher scripts
✔ Good for deployment environments

---

4️⃣ Use as a Java Library

Download:

• openccjava-1.2.1.jar

Optional (for development):

• openccjava-1.2.1-sources.jar
• openccjava-1.2.1-javadoc.jar

Add the JAR to your Java project as a dependency.

---

Quick Recommendation

If unsure what to download:

→ Most users should choose:

openccjavacli-1.2.1-all.jar

For maximum performance and zero Java dependency, use your platform's
native ZIP instead.

Full Changelog: v1.2.0...v1.2.1

v1.2.0

OpenccJava v1.2.0

This release provides multiple formats depending on how you want to use
OpenccJava.

---

1️⃣ Just run the CLI (Recommended)

Download:

• openccjavacli-1.2.0-all.jar

Run:

java -jar openccjavacli-1.2.0-all.jar --help

✔ Works on any system with Java 8+
✔ No native install required
✔ Easiest option

---

2️⃣ Native Executable (No Java Required)

Download the file matching your operating system:

• Linux x86_64
  OpenccJavaCli-1.2.0-linux-x86_64-native.zip

• macOS Apple Silicon
  OpenccJavaCli-1.2.0-macos-arm64-native.zip

• macOS Intel
  OpenccJavaCli-1.2.0-macos-x86_64-native.zip

• Windows x86_64
  OpenccJavaCli-1.2.0-windows-x86_64-native.zip

After extracting:

• Linux / macOS: ./openccjavacli

• Windows: openccjavacli.exe

✔ Fully standalone
✔ No Java runtime required
✔ Fast startup

---

3️⃣ JVM Distribution Package

Download:

• OpenccJavaCli-1.2.0.jvm.zip
  OR
• OpenccJavaCli-1.2.0.jvm.tar

Extract and run:

bin/openccjavacli

✔ Includes launcher scripts
✔ Good for deployment environments

---

4️⃣ Use as a Java Library

Download:

• openccjava-1.2.0.jar

Optional (for development):

• openccjava-1.2.0-sources.jar
• openccjava-1.2.0-javadoc.jar

Add the JAR to your Java project as a dependency.

---

Quick Recommendation

If unsure what to download:

→ Most users should choose:

openccjavacli-1.2.0-all.jar

For maximum performance and zero Java dependency, use your platform's
native ZIP instead.

Full Changelog: v1.1.1...v1.2.0

v1.1.1

OpenccJava CLI Release v1.1.1

Prebuilt JVM + GraalVM native binaries for openccjavacli.

Artifacts included (matching version 1.1.1 only):

• JVM fat JAR (Java 8 target)
• JVM ZIP distribution (*-jvm.zip)
• Native Windows ZIP
• Native Linux ZIP
• Native macOS ZIP

All files are sourced from the install/ directory and filtered by version.

Changelog

[1.1.1] - 2025-11-25

Changed

• Refactored OfficeHelper to include a core byte[]-based convert() API for in-memory document processing.
• Updated conversion result handling: introduced unified abstract Result base class with concrete FileResult and MemoryResult subtypes.
• Ensured backward compatibility: legacy Result return type remains valid and unchanged for existing users.

Full Changelog: v1.0.3...v1.1.0

---

Requires:

• Native build: Self-contained, just unzip and run.
• JVM build: Java Runtime 1.8+ (JDK or JRE)

v1.1.0

OpenccJava CLI Release v1.1.0

[1.1.0] - 2025-10-10

Added

• Introduced StarterIndex and UnionCache to speed up conversion.
• Added OpenCC.setVerboseLogging(boolean) to enable or disable runtime logging.
  • When enabled, informational messages about dictionary loading, fallbacks, and diagnostics are printed to the
    console.
  • By default, logging is disabled to keep GUI and CLI outputs clean.

Changed

• Static dictionary implementation:
  Dictionaries are now loaded once per JVM (lazy-loaded via DictionaryHolder) and shared by all OpenCC instances.

  • Improves startup performance and reduces memory usage for GUI apps (e.g. JavaFX) and helper classes (e.g.
    OfficeHelper).
  • Log messages are emitted on first load:
    • INFO when loaded from file system or embedded resource.
    • WARNING when falling back to plain-text dictionary sources.

• OpenCC.zhoCheck(String) is now a static method for clarity and consistency.
  Existing instance calls myOpenCC.zhoCheck(text) will no longer compile.
  Use one of:

  • OpenCC.zhoCheck(text) – preferred static usage.
  • myOpenCC.zhoCheckInstance(text) – for backward-compatible instance style.

• Added Starter Length Mask for faster dictionary lookup and reduced branching.

Full Changelog: v1.0.3...v1.1.0

---

Requires:

• Native build: Self-contained, just unzip and run.
• JVM build: Java Runtime 1.8+ (JDK or JRE)

v1.0.3

OpenccJava CLI v1.0.3

[1.0.3] - 2025-10-02

Changed

• Update dictionaries
• DictionaryMaxlength: computes and stores minLength.
• JSON writer now emits [map,max,min]
• Performance: bitset isDelimiter(); faster getSplitRanges().
• No public API breaks.

Announced

• New JSON blocks: st_punctuations, ts_punctuations ([ {dict}, maxLength, minLength ]).
• These are reserved for the next major and not used by runtime conversion yet.
• translatePunctuation() is deprecated and will be removed in v1.1.0.
• zhoCheck() will be changed from instance to static function in next major version (v1.1.0).

Full Changelog: v1.0.2...v1.0.3

---

Requires:

• Native build: Self-contained, just unzip and run.
• JVM build: Java Runtime 1.8+ (JDK or JRE)