Linux zip now comes with an optional install.sh script

Author: agateau

.changes/unreleased/Added-20220210-180119.yaml

@@ -0,0 +1,3 @@
+kind: Added
+body: 'Linux: the archive now includes an `install.sh` script. This script can be used to install the game and setup a launcher icon for it. It is still possible to run the game without installation, though.'
+time: 2022-02-10T18:01:19.242789652+01:00

fastlane/metadata/android/en-US/images/icon.png

@@ -21,6 +21,7 @@
 GPLAY_ICON = REPO_DIR / "fastlane/metadata/android/en-US/images/icon.png"
 
 MACOS_ICON = REPO_DIR / "tools/packaging/macos/pixelwheels.icns"
+LINUX_ICON_DIR = REPO_DIR / "tools/packaging/linux/icons"
 
 APPWINDOW_ICON = ASSETS_DIR / "desktop-icon/desktop-icon.png"
 
@@ -34,6 +35,8 @@
 # Note: no 64x64 in the macOS icon
 MACOS_ICON_SIZES = [16, 32, 48, 128, 256, 512, 1024]
 
+LINUX_ICON_SIZES = SLICE_ICON_SIZES + SCALED_ICON_SIZES
+
 
 def run(*args):
     cmd = [str(x) for x in args]
@@ -98,6 +101,12 @@ def generate_android_tv_banner():
              "--save-as", RES_DIR / "drawable-xhdpi/tv_banner.png")
 
 
+def generate_linux_icons():
+    for size in LINUX_ICON_SIZES:
+        dst = LINUX_ICON_DIR / f"{size}-com.agateau.PixelWheels.png"
+        shutil.copy(work_icon(size), dst)
+
+
 def generate_appwindow_icon():
     shutil.copy(work_icon(128), APPWINDOW_ICON)
 

icon/export.py

@@ -28,7 +28,6 @@
   padding: 3px 6px;
   border-radius: 5px;
 }
-
 </style>
 
 </head>
@@ -39,6 +38,22 @@ <h1>Pixel Wheels</h1>
 
 <p>It works on Linux, Intel-based macOS, Windows and Android.</p>
 
+<h2>📦 Installation</h2>
+
+<p>You can start the game directly from this folder, but if you want to install it, here is how.
+
+<h3>Linux</h3>
+
+<p>Run the <code>install.sh</code> script to install it on your system. This will make the game available from your desktop menu.</p>
+
+<h3>macOS</h3>
+
+<p>Drag the "Pixel Wheels" bundle to your "Application" folder.</p>
+
+<h3>Windows</h3>
+
+<p>There is no automated installation procedure for now, but you can copy this folder in the folder of your choice and create a shortcut to the <code>pixelwheels.exe</code> executable.</p>
+
 <h2>🏎 Controls</h2>
 
 <p>The user interface and the vehicle can be controlled using either gamepads or keyboard.</p>

tools/packaging/common/README.html

@@ -29,6 +29,7 @@ DST_DESKTOP_JAR=$DIST_OUT_BASE_DIR/pixelwheels.jar
 PACKAGING_DIR=$PWD/tools/packaging
 PACKAGING_COMMON_DIR=$PACKAGING_DIR/common
 PACKAGING_MACOS_DIR=$PACKAGING_DIR/macos
+PACKAGING_LINUX_DIR=$PACKAGING_DIR/linux
 
 . tools/functions.sh
 
@@ -87,6 +88,15 @@ create_archive() {
     # *inside* the bundle
     cp $PACKAGING_COMMON_DIR/README.html "$DIST_OUT_BASE_DIR/$dist_name"
 
+    if [ "$platform" = "linux64" ] ; then
+        cp -a $PACKAGING_LINUX_DIR/* "$out_dir"
+    fi
+
+    echo "Make sure all files are writable"
+    # Packr generates some read-only files in the jre dir. This causes trouble
+    # when trying to replace them during upgrade.
+    chmod -R u+w $out_dir
+
     echo "Creating zip"
     (
         cd $DIST_OUT_BASE_DIR

tools/packaging/create-archives

@@ -0,0 +1,10 @@
+[Desktop Entry]
+Type=Application
+Version=1.0
+Name=Pixel Wheels
+Categories=Game;ArcadeGame;
+GenericName=Top-down retro racing game
+Comment=Race for the first place on various tracks. Pick up bonuses to boost your position or slow down competitors!
+Icon=com.agateau.PixelWheels
+Exec=pixelwheels
+Terminal=false