From 7713ecbe1dc588f7db1d306b1cc8567060c97dc2 Mon Sep 17 00:00:00 2001
From: Tobias Nett <skaldarnar@googlemail.com>
Date: Sat, 21 Mar 2020 18:20:49 +0100
Subject: [PATCH] feat: Platform-specific distribution packages (#516)

* feat(gradle): Bundle platform-spec. `.exe` files
* feat(gradle): bundle `TerasologyLauncher.app` for Mac distribution
* feat: add launch script for linux to top-level

* chore: clean up `jre.gradle`
* chore: rearrange build resources into `buildres` directory
* chore: delete `bundles` folder and unused gradle file

* fix: set fixed name for JAR for Windows `.exe`s to work

Co-authored-by: Niruandaleth <jd.rueckert@googlemail.com>
---
 .gitignore                                    |   2 +-
 build.gradle                                  |   4 +-
 buildres/linux/TerasologyLauncher.run         |   3 +
 {bundles/macosx => buildres/mac}/Info.plist   |   2 +-
 .../mac}/Resources/terasology.icns            | Bin
 .../windows32}/TerasologyLauncher.x86.exe     | Bin
 .../windows64}/TerasologyLauncher.x64.exe     | Bin
 bundles/linux/run_linux.sh                    |   4 -
 .../macosx/MacOS/terasologylauncher.command   |   3 -
 config/gradle/bundles.gradle                  |  93 ----------------
 config/gradle/jre.gradle                      | 100 ++++++++++--------
 src/dist/TerasologyLauncher.exe               | Bin 30208 -> 0 bytes
 12 files changed, 64 insertions(+), 147 deletions(-)
 create mode 100755 buildres/linux/TerasologyLauncher.run
 rename {bundles/macosx => buildres/mac}/Info.plist (88%)
 rename {bundles/macosx => buildres/mac}/Resources/terasology.icns (100%)
 rename {src/dist => buildres/windows32}/TerasologyLauncher.x86.exe (100%)
 rename {src/dist => buildres/windows64}/TerasologyLauncher.x64.exe (100%)
 delete mode 100644 bundles/linux/run_linux.sh
 delete mode 100644 bundles/macosx/MacOS/terasologylauncher.command
 delete mode 100644 config/gradle/bundles.gradle
 delete mode 100644 src/dist/TerasologyLauncher.exe

diff --git a/.gitignore b/.gitignore
index 76c56349a..9e6e14aaa 100644
--- a/.gitignore
+++ b/.gitignore
@@ -49,7 +49,7 @@ certum.jks
 /src/main/resources/org/terasology/launcher/icons/
 
 # Ignore version info file(s)
-src/main/resources/org/terasology/launcher/version/
+/src/main/resources/org/terasology/launcher/version/
 
 # Ignore generated Web API sources
 web-api-client/
diff --git a/build.gradle b/build.gradle
index 83d54d2e9..f86ef4e4e 100644
--- a/build.gradle
+++ b/build.gradle
@@ -46,8 +46,6 @@ plugins {
 }
 
 apply from: "./config/gradle/jre.gradle"
-// TODO salvage useful bits and remove this
-//apply from: "./config/gradle/bundles.gradle"
 apply from: "./config/gradle/quality.gradle"
 apply from: "./config/gradle/swagger.gradle"
 
@@ -164,6 +162,8 @@ task createVersionInfoFile {
 processResources.dependsOn createVersionInfoFile
 
 jar {
+    //TODO we only use this name because the `.exe` start scripts require the JAR to be named 'TerasologyLauncher.jar'
+    jar.archiveFileName = "${project.name}.jar"
     // replace development "logback.xml" with productive "logback_jar.xml"
     exclude "logback.xml"
     rename('logback_jar.xml', 'logback.xml')
diff --git a/buildres/linux/TerasologyLauncher.run b/buildres/linux/TerasologyLauncher.run
new file mode 100755
index 000000000..472d3c6a6
--- /dev/null
+++ b/buildres/linux/TerasologyLauncher.run
@@ -0,0 +1,3 @@
+#!/usr/bin/env sh
+echo "Starting TerasologyLauncher from './bin/TerasologyLauncher'"
+sh ./bin/TerasologyLauncher
diff --git a/bundles/macosx/Info.plist b/buildres/mac/Info.plist
similarity index 88%
rename from bundles/macosx/Info.plist
rename to buildres/mac/Info.plist
index 40255db5f..0360450ef 100644
--- a/bundles/macosx/Info.plist
+++ b/buildres/mac/Info.plist
@@ -5,7 +5,7 @@
 	<key>CFBundleDisplayName</key>
 	<string>Terasology</string>
 	<key>CFBundleExecutable</key>
-	<string>terasologylauncher.command</string>
+	<string>TerasologyLauncher</string>
 	<key>CFBundleIconFile</key>
 	<string>terasology.icns</string>
 </dict>
diff --git a/bundles/macosx/Resources/terasology.icns b/buildres/mac/Resources/terasology.icns
similarity index 100%
rename from bundles/macosx/Resources/terasology.icns
rename to buildres/mac/Resources/terasology.icns
diff --git a/src/dist/TerasologyLauncher.x86.exe b/buildres/windows32/TerasologyLauncher.x86.exe
similarity index 100%
rename from src/dist/TerasologyLauncher.x86.exe
rename to buildres/windows32/TerasologyLauncher.x86.exe
diff --git a/src/dist/TerasologyLauncher.x64.exe b/buildres/windows64/TerasologyLauncher.x64.exe
similarity index 100%
rename from src/dist/TerasologyLauncher.x64.exe
rename to buildres/windows64/TerasologyLauncher.x64.exe
diff --git a/bundles/linux/run_linux.sh b/bundles/linux/run_linux.sh
deleted file mode 100644
index 1bf7c2eb0..000000000
--- a/bundles/linux/run_linux.sh
+++ /dev/null
@@ -1,4 +0,0 @@
-#!/bin/bash
-cd "$(dirname "$0")"
-jre/bin/java -Xms128m -Xmx512m -jar lib/TerasologyLauncher.jar
-
diff --git a/bundles/macosx/MacOS/terasologylauncher.command b/bundles/macosx/MacOS/terasologylauncher.command
deleted file mode 100644
index 16b271db0..000000000
--- a/bundles/macosx/MacOS/terasologylauncher.command
+++ /dev/null
@@ -1,3 +0,0 @@
-#!/bin/bash
-cd "$(dirname "$0")/../Resources/"
-jre/bin/java -Xms128m -Xmx512m -jar lib/TerasologyLauncher.jar
diff --git a/config/gradle/bundles.gradle b/config/gradle/bundles.gradle
deleted file mode 100644
index 2686c0517..000000000
--- a/config/gradle/bundles.gradle
+++ /dev/null
@@ -1,93 +0,0 @@
-/*
- * Copyright 2016 MovingBlocks
- *
- * Licensed under the Apache License, Version 2.0 (the "License");
- * you may not use this file except in compliance with the License.
- * You may obtain a copy of the License at
- *
- *      http://www.apache.org/licenses/LICENSE-2.0
- *
- * Unless required by applicable law or agreed to in writing, software
- * distributed under the License is distributed on an "AS IS" BASIS,
- * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
- * See the License for the specific language governing permissions and
- * limitations under the License.
- */
-
-enum Bundle {
-    win32,
-    win64,
-    linux32,
-    linux64,
-    macosx;
-
-    File jreArchive
-}
-
-task buildBundles {}
-
-task unzipBundle(type: Copy) {
-    destinationDir buildDir
-    from (zipTree("${projectDir}/build/distributions/TerasologyLauncher.zip"))
-}
-
-def launcherDir = "${buildDir}/TerasologyLauncher/"
-
-Bundle.each { arch ->
-    arch.jreArchive = new File("${projectDir}/jres/${arch}.zip")
-
-    def zipBase = ""
-    // Rebase everything in the zip file for MacOS X
-    if (arch == Bundle.macosx) {
-        zipBase = "TerasologyLauncher.app/Contents/Resources/"
-    }
-
-    def buildBundleTask = task("zip" + arch.name().capitalize(), type: Zip) {
-        dependsOn unzipBundle
-        archiveName "TerasologyLauncher-${arch}.zip"
-        destinationDir new File("${buildDir}/bundles/")
-        from(zipTree(arch.jreArchive)) {
-            into "${zipBase}jre"
-        }
-        from(launcherDir) {
-            // Platform independent files
-            exclude "*.exe"
-            exclude "bin"
-            into zipBase
-        }
-        /*
-            Copy only the files relevant to the platform we are bundling the JRE for.
-            I.e only copy 32-bit natives for windows if we bundle the 32-bit JRE.
-         */
-        if (arch == Bundle.win32) {
-            from (launcherDir) {
-                include "TerasologyLauncher.x86.exe"
-                rename { "TerasologyLauncher.exe" }
-            }
-        } else if (arch == Bundle.win64) {
-            from (launcherDir) {
-                include "TerasologyLauncher.x64.exe"
-                rename { "TerasologyLauncher.exe" }
-            }
-        } else if (arch == Bundle.linux32) {
-            from ("bundles/linux") {
-                include "run_linux.sh"
-                rename { "terasology_launcher.sh" }
-                fileMode 755
-            }
-        } else if (arch == Bundle.linux64) {
-            from ("bundles/launchers") {
-                include "run_linux.sh"
-                rename { "terasology_launcher.sh" }
-                fileMode 755
-            }
-        } else if (arch == Bundle.macosx) {
-            from ("bundles/macosx") {
-                include "**/*"
-                into "TerasologyLauncher.app/Contents"
-            }
-        }
-    }
-
-    buildBundles.dependsOn buildBundleTask
-}
diff --git a/config/gradle/jre.gradle b/config/gradle/jre.gradle
index 67d32ce1a..30d5a1736 100644
--- a/config/gradle/jre.gradle
+++ b/config/gradle/jre.gradle
@@ -16,7 +16,7 @@
 
 // Uses Bellsoft Liberica JRE
 def jreVersion = '8u212'
-def jreUrlBase = "https://download.bell-sw.com/java/$jreVersion/bellsoft-jre$jreVersion"
+def jreUrlBase = "https://download.bell-sw.com/java/${jreVersion}/bellsoft-jre${jreVersion}"
 def jreUrlFilenames = [
         Linux64   : 'linux-amd64.tar.gz',
         Linux32   : 'linux-i586.tar.gz',
@@ -36,67 +36,81 @@ task createRelease() {
 }
 
 task downloadJreAll {
-    group 'Download'
-    description 'Downloads JRE for all platforms'
+    group 'JRE'
+    description 'Downloads JREs for all platforms'
+}
+
+task unpackJreAll {
+    group 'JRE'
+    description 'Unpack JREs for all platforms'
+}
+
+def unpack(file) {
+    copySpec {
+        from((file.name.endsWith(".zip")) ? zipTree(file) : tarTree(file) ) {
+           eachFile { fcd ->
+                fcd.relativePath = new RelativePath(
+                        true, fcd.relativePath.segments.drop(1))
+            }
+            includeEmptyDirs = false 
+        }
+    }
 }
 
 jreUrlFilenames.each { os, file ->
-    def packedJre = new File("$projectDir/jre/$file")
-    def unpackedJre = new File("$buildDir/jre/$os")
 
-    def downloadTask = task("downloadJre$os") {
-        group 'Download'
+    def downloadTask = task "downloadJre${os}"(type: Download) {
+        group 'JRE'
         description "Downloads JRE for $os"
 
-        doFirst {
-            download {
-                src "$jreUrlBase-$file"
-                dest packedJre
-                overwrite false
-            }
-        }
+        src "${jreUrlBase}-${file}"
+        dest "${projectDir}/jre/${file}"
+        overwrite false
+    }
 
-        doLast {
-            // Unpack the JRE
-            if (!unpackedJre.exists()) {
-                unpackedJre.mkdirs()
-                copy {
-                    from(file.endsWith("zip")
-                            ? zipTree(packedJre)
-                            : tarTree(packedJre)) {
-                        eachFile { fcd ->
-                            fcd.relativePath = new RelativePath(
-                                    true, fcd.relativePath.segments.drop(1))
-                        }
-                        includeEmptyDirs = false
-                    }
-                    into unpackedJre
-                }
-            }
-        }
+    def unpackTask = task "unpackJre${os}"(type: Copy) {
+        group 'JRE'
+        description "Unpack JRE for ${os} to distribution sources"
+        dependsOn downloadTask
+
+        with unpack(downloadTask.dest)
+        into "${buildDir}/jre/${os}"
     }
 
-    def distName = os.toLowerCase()
     distributions {
-        "$distName" {
+        def distName = os.toLowerCase()
+        def distBase = distName.replaceAll("\\d", "") // drop '32' or '64'
+
+        "${distName}" {
             contents {
                 with distributions.main.contents
+
                 into('jre') {
-                    from unpackedJre
+                    from unpackTask
                 }
+
+                from("${projectDir}/buildres/${distBase}")
+                from("${projectDir}/buildres/${distName}")
             }
         }
     }
 
-    def zipTask = tasks.named("${distName}DistZip").get()
-    def tarTask = tasks.named("${distName}DistTar").get()
-
     downloadJreAll.dependsOn downloadTask
-    zipTask.dependsOn downloadTask
-    zipTask.description "Bundles the project with a JRE for $os"
-    tarTask.dependsOn downloadTask
-    tarTask.description "Bundles the project with a JRE for $os"
-    createRelease.dependsOn zipTask
+    unpackJreAll.dependsOn unpackTask
+
+    createRelease.dependsOn "assemble${os}Dist"
+}
+
+distributions {
+    mac {
+        contents {
+            into 'TerasologyLauncher.app/Contents'
+            exclude '**/*.bat'
+            eachFile { details ->
+                details.path = details.path.toString().replaceAll("(Contents)/bin/(.+)", "\$1/MacOS/\$2")
+            }
+        }
+    }
 }
 
 /**
diff --git a/src/dist/TerasologyLauncher.exe b/src/dist/TerasologyLauncher.exe
deleted file mode 100644
index 5d40d8d1b0df1a15f4c8bc8d2dc4eb428c54a805..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001

literal 30208
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