Re-add Linux AppImage support

Re-add AppImage support; build in CI

Author: docsteer

.github/workflows/build.yml

@@ -32,7 +32,9 @@ jobs:
             configure_preset_name: "linux-x64-release"
             build_preset_name: "linux-release"
             package_preset_name: "linux"
-            artifact: ./out/build/linux-x64-release/package/*
+            artifact: |
+              ./out/build/linux-x64-release/package/*
+              sACNView-x86_64.AppImage
 
           - os: windows-latest
             qt: '6.8.3'
@@ -97,6 +99,17 @@ jobs:
       if: matrix.package_preset_name
       run: cpack --preset ${{matrix.package_preset_name}}
 
+    - name: Install Linuxdeploy (Linux)
+      if: runner.os == 'linux'
+      uses: miurahr/install-linuxdeploy-action@v1.8.0
+      with:
+        dir: ${{ github.workspace }}
+        plugins: qt appimage
+
+    - name: Build AppImage (Linux)
+      if: runner.os == 'linux'
+      run: install/linux/build_appimage.sh
+
     - name: Upload Artifact(s)
       if: matrix.artifact
       uses: actions/upload-artifact@v4

.gitignore

@@ -67,6 +67,8 @@ ipch/
 #Build Output
 out/*
 build/*
+AppDir/*
+*.AppImage
 
 #macos
 .DS_Store

README.md

@@ -51,3 +51,32 @@ Once configuration is successful, you can run the build by navigating to the dir
 
 	cd out\build\windows-x64-release-installer
     cmake --build .
+
+## Linux
+
+Note that we use a newer version of Qt than is provided by many distributions, so recommend using the Qt installer tool to install a recent LTS version.
+
+Set an environment variable, QT_ROOT_DIR, pointing to the root directory of your Qt installation, including the version and compiler parts, for example:
+
+    export QT_ROOT_DIR=~/Qt/6.8.3/gcc_64
+
+Configure the application for the appropriate target using a CMake preset, e.g:
+
+    cmake --preset "linux-x64-release"
+
+Once configuration is successful, you can run the build by navigating to the directory in the out folder and running
+
+	cd out\build\linux-x64-release
+    cmake --build .
+
+The build can be packaged as either an AppImage or a DEB package:
+
+### AppImage
+
+To build an AppImage, you will need the linuxdeploy utility, which is itself an appimage. Obtain it and locate it in your path.
+
+Then from the root of the repository run the script `install/linux/build_appimage.sh`. This will run the build and then use the linuxdeploy tool to build the AppImage.
+
+### Debian Package (DEB)
+
+To build a DEB package, run the command `cpack --package "linux"`. This will generate the deb package under the output directory.

install/linux/build_appimage.sh

@@ -0,0 +1,13 @@
+#!/bin/bash
+# Generate the Appimage
+
+# Need qmake in path
+export PATH=$QT_ROOT_DIR/bin:$PATH
+cmake --build --preset "linux-release" --target install
+
+linuxdeploy-x86_64.AppImage --appdir AppDir \
+    --executable out/install/linux-x64-release/bin/sACNView \
+    --desktop-file install/linux/sacnview.desktop \
+    --icon-file install/linux/sacnview.png \
+    --plugin qt \
+    --output appimage

install/linux/opt/sacnview/.placeholder

@@ -1,8 +1,8 @@
 [Desktop Entry]
-Type=Application
-Name=sACNView 2
-Exec=/opt/sacnview/sACNView2.AppImage
+Name=sACNView
+Exec=sACNView
 Icon=sacnview
+Type=Application
 Comment=Streaming ACN Viewer mark2
 Categories=Network;
 Terminal=false