feat(packaging): add Windows EXE jpackage script, Launch4j wrapper script, and Gradle packaging tasks (EXE/MSI/DMG/DEB); update README with one-command usage and size notes

Author: mauriciomenon

README.md

@@ -187,8 +187,15 @@ Notas importantes:
   - Compilar: `gradle clean build`
   - Executar: `gradle run` ou `java -jar build\libs\BiByte-<versao>.jar`
   - Empacotar (opcional):
-    - `jpackage --type msi --name BiByte --app-version <versao> --input build\libs --main-jar BiByte-<versao>.jar --main-class bitbyte.MyJFrame --dest out\win --icon process-icon1.ico`
-    - Alternativa (legado): Launch4j com `bitbyte_Launch4j.xml` (hoje preferimos `jpackage`).
+    - Gradle (um comando):
+      - `gradle packageWinExe` (gera EXE auto-contido em `out\win`) — maior (inclui runtime)
+      - `gradle packageWinMsi` (gera MSI auto-contido em `out\win`) — maior (inclui runtime)
+    - Scripts (PowerShell):
+      - EXE: `$env:VERSION="<versao>"; ./scripts/jpackage-win-exe.ps1`
+      - MSI: `$env:VERSION="<versao>"; ./scripts/jpackage-win.ps1`
+    - Alternativa enxuta (depende de Java instalado):
+      - Launch4j: `./scripts/launch4j-win.ps1` (gera .exe pequeno; requer JRE instalado no sistema ou apontar JRE embarcado no XML)
+    - Observação: jpackage cria instaladores auto-contidos (sem depender de Java instalado), porém com tamanho maior.
 
 ### Observações sobre Arquitetura (arm64 vs amd64)
 - O JAR (bytecode Java) é multiplataforma. O mesmo artefato roda em qualquer SO/arquitetura com JVM compatível.

build.gradle

@@ -44,6 +44,63 @@ jar {
     }
 }
 
+// Packaging helpers using jpackage (requires JDK with jpackage on PATH)
+def appName = 'BiByte'
+def mainClassFqn = 'bitbyte.MyJFrame'
+def jarFile = { "${appName}-${project.version}.jar" }
+
+tasks.register('packageWinExe', Exec) {
+    dependsOn(tasks.named('build'))
+    commandLine 'jpackage',
+        '--type', 'exe',
+        '--name', appName,
+        '--app-version', project.version,
+        '--input', 'build/libs',
+        '--main-jar', jarFile(),
+        '--main-class', mainClassFqn,
+        '--dest', 'out/win',
+        '--icon', 'process-icon1.ico'
+}
+
+tasks.register('packageWinMsi', Exec) {
+    dependsOn(tasks.named('build'))
+    commandLine 'jpackage',
+        '--type', 'msi',
+        '--name', appName,
+        '--app-version', project.version,
+        '--input', 'build/libs',
+        '--main-jar', jarFile(),
+        '--main-class', mainClassFqn,
+        '--dest', 'out/win',
+        '--icon', 'process-icon1.ico'
+}
+
+tasks.register('packageMacDmg', Exec) {
+    dependsOn(tasks.named('build'))
+    commandLine 'jpackage',
+        '--type', 'dmg',
+        '--name', appName,
+        '--app-version', project.version,
+        '--input', 'build/libs',
+        '--main-jar', jarFile(),
+        '--main-class', mainClassFqn,
+        '--dest', 'out/mac',
+        '--icon', 'process-icon1.ico'
+}
+
+tasks.register('packageDeb', Exec) {
+    dependsOn(tasks.named('build'))
+    commandLine 'jpackage',
+        '--type', 'deb',
+        '--name', appName,
+        '--app-version', project.version,
+        '--input', 'build/libs',
+        '--main-jar', jarFile(),
+        '--main-class', mainClassFqn,
+        '--dest', 'out/deb',
+        '--icon', 'process-icon1.ico'
+}
+
 sourceSets {
     main {
         java {

scripts/jpackage-win-exe.ps1

@@ -0,0 +1,26 @@
+# Windows EXE packaging using jpackage.
+# Usage (PowerShell): $env:VERSION="2.0.2"; ./scripts/jpackage-win-exe.ps1
+
+$ErrorActionPreference = 'Stop'
+
+$VERSION = if ($env:VERSION) { $env:VERSION } else { 'dev' }
+$APP_NAME = 'BiByte'
+$MAIN_CLASS = 'bitbyte.MyJFrame'
+$JAR_DIR = 'build\libs'
+$ICON = 'process-icon1.ico'
+$DEST = 'out\win'
+
+New-Item -ItemType Directory -Force -Path $DEST | Out-Null
+
+& jpackage `
+  --type exe `
+  --name $APP_NAME `
+  --app-version $VERSION `
+  --input $JAR_DIR `
+  --main-jar "$APP_NAME-$VERSION.jar" `
+  --main-class $MAIN_CLASS `
+  --dest $DEST `
+  --icon $ICON
+
+Write-Host "EXE created in $DEST"
+

scripts/launch4j-win.ps1

@@ -0,0 +1,24 @@
+# Build a small Windows .exe wrapper using Launch4j.
+# Requires Launch4j installed (e.g., `choco install launch4j`) and bitbyte_Launch4j.xml in repo root.
+
+$ErrorActionPreference = 'Stop'
+
+$LAUNCH4J = ${env:LAUNCH4J_EXE}
+if (-not $LAUNCH4J) {
+  # Common default install path
+  $LAUNCH4J = "C:\Program Files (x86)\Launch4j\launch4jc.exe"
+}
+
+if (-not (Test-Path $LAUNCH4J)) {
+  Write-Error "Launch4j not found. Set LAUNCH4J_EXE env var or install via Chocolatey."
+}
+
+$CONFIG = "bitbyte_Launch4j.xml"
+if (-not (Test-Path $CONFIG)) {
+  Write-Error "Missing $CONFIG in repo root."
+}
+
+& "$LAUNCH4J" "$CONFIG"
+
+Write-Host "Launch4j .exe generated per $CONFIG"
+