Skip to content

Version 0.4 - Native Windows Installer & Portable ZIP

Choose a tag to compare

@karlkauc karlkauc released this 19 Nov 09:48
· 33 commits to master since this release

πŸŽ‰ Highlights

This release introduces native Windows installers and a portable ZIP version - no installation required!

πŸ“¦ Download Options

Windows MSI Installer (Recommended)

  • Full installation with Start Menu integration
  • Desktop shortcuts
  • Bundled Java runtime
  • No Admin Rights Required - Per-user installation

Portable ZIP Version (NEW!)

  • πŸ“¦ No Installation Needed - Just extract and run
  • πŸ’Ύ Fully Portable - Run from USB stick or any folder
  • πŸš€ Quick Start - Extract ZIP, run OeKBVisualClient.exe
  • βœ… No Admin Rights - Works anywhere

✨ New Features

Distribution Improvements

  • πŸͺŸ Windows MSI Installer with bundled Java runtime
  • πŸ“¦ Portable ZIP Package - Extract and run, no installation
  • πŸ”“ No Admin Rights Required - Both versions work without admin
  • 🎯 Start Menu & Desktop Shortcuts - MSI installer only
  • βš™οΈ Custom Install Directory - Choose where to install

Build System Enhancements

  • πŸ”§ Native jlink - Direct command-line calls without plugins
  • πŸ“¦ Native jpackage - Full control over packaging parameters
  • πŸ€– GitHub Actions Workflow - Automatic builds on release
  • πŸš€ New Gradle Tasks:
    • prepareDependencies - Prepares JARs for packaging
    • jlink - Creates custom runtime image
    • jpackage - Creates MSI installer
    • jpackageImage - Creates portable app image
    • createPortableZip - Creates portable ZIP
    • buildDistribution - Builds everything

🎨 UI/UX Improvements

Interface Enhancements

  • πŸ–₯️ Maximized Startup - Application now starts fullscreen
  • πŸ“ Compact Menu - 20-25% smaller sidebar (200px β†’ 160px)
  • 🎯 Smaller Icons - Optimized icon sizes (20px β†’ 16px)
  • πŸ“± Better Responsiveness - Improved layout for various screen sizes

User Experience

  • ⚠️ Better Error Messages - User-friendly error notifications
  • 🌐 Network Error Handling - Clear messages for connection issues
  • πŸ” Proxy Detection - Better handling of proxy/network problems
  • πŸ“Š Status Indicators - Visual feedback for data loading

πŸ› Bug Fixes

  • βœ… Fixed CSS warnings (border-radius, dropshadow syntax)
  • βœ… Fixed FXML loading errors (pageDataUpload, pageOFI)
  • βœ… Fixed JavaFX native-access warning
  • βœ… Fixed type mismatch in AccessRightsReceived (BorderPane β†’ VBox)
  • βœ… Improved XML parsing with validation for empty/invalid responses
  • βœ… Fixed jlink build errors - using native tools instead of plugins

πŸ”§ Technical Improvements

Build System

  • Native jlink/jpackage: Direct command-line invocation
  • No plugin dependencies: Eliminates plugin conflicts
  • Liberica JDK+FX: Optimized for JavaFX applications
  • Full control: Direct access to all jlink/jpackage parameters

Error Handling

  • AccesRights.java: Validates XML before parsing, handles empty responses
  • OeKBHTTP.java: Detailed exception handling (UnknownHost, ConnectException, SSLException, etc.)
  • Controllers: Display user-friendly messages when data unavailable

Code Quality

  • πŸ“ Comprehensive Documentation - BUILD.md, RELEASE.md, updated CLAUDE.md
  • 🧹 Code Cleanup - Removed 35 unused images (200KB+ saved)
  • πŸ—οΈ Better Architecture - Improved separation of concerns
  • ⚑ Optimized Build - Native tools for better performance

πŸ“š Documentation

  • BUILD.md - Detailed build instructions for Windows packages
  • RELEASE.md - Step-by-step release process guide
  • CLAUDE.md - Updated developer guide with new build commands

πŸ”„ Breaking Changes

None - This is a backwards-compatible release.

πŸ“¦ Installation

Option 1: MSI Installer (Recommended for permanent installation)

  1. Download OeKBVisualClient-0.4.msi
  2. Double-click to install
  3. Follow installation wizard
  4. Launch from Start Menu or Desktop

Option 2: Portable ZIP (Recommended for portable use)

  1. Download OeKBVisualClient-0.4-windows-x64.zip
  2. Extract to any folder (e.g., Desktop, USB stick)
  3. Open extracted folder
  4. Run OeKBVisualClient\OeKBVisualClient.exe
  5. Done! No installation needed

Manual Build from Source

git clone https://github.com/karlkauc/OeKBVisualClient.git
cd OeKBVisualClient
./gradlew run

πŸ™ Credits

Generated with Claude Code - AI-assisted development

πŸ”— Links