appimage support

Author: nesbox

.github/workflows/build.yml

@@ -121,6 +121,11 @@ jobs:
           cmake -DCMAKE_BUILD_TYPE=Release -DBUILD_IPO=ON -DBUILD_WITH_ALL=ON ..
           cmake --build . --parallel
 
+      - name: Build AppImage
+        run: |
+          chmod +x build-appimage.sh
+          ./build-appimage.sh
+
       - name: Deploy
         uses: actions/upload-artifact@v4
         with:
@@ -129,6 +134,12 @@ jobs:
             build/bin/tic80
             build/bin/*.so
 
+      - name: Deploy AppImage
+        uses: actions/upload-artifact@v4
+        with:
+          name: "tic80-appimage"
+          path: TIC-80.AppImage
+
       - name: Build Pro
         run: |
           cd build

README-AppImage.md

@@ -0,0 +1,61 @@
+# TIC-80 AppImage Build Instructions
+
+This document describes how to build a TIC-80 AppImage for Linux distribution.
+
+## Prerequisites
+
+- Linux system (Ubuntu, Fedora, etc.)
+- TIC-80 must be already built (binary at `build/bin/tic80`)
+
+## Building TIC-80 First
+
+```bash
+mkdir build
+cd build
+cmake .. -DBUILD_SOKOL=ON -DBUILD_WITH_ALL=ON
+make -j$(nproc)
+cd ..
+```
+
+## Building the AppImage
+
+```bash
+./build-appimage.sh
+```
+
+This script will:
+1. Verify the TIC-80 binary exists
+2. Create the AppDir structure
+3. Copy the tic80 binary, desktop files, and icons
+4. Download appimagetool if needed
+5. Generate the TIC-80.AppImage file
+
+## What the AppImage contains
+
+The AppImage includes:
+- TIC-80 executable (tic80 binary)
+- Desktop integration files (.desktop, icon, metainfo)
+- AppRun script for proper execution
+
+## Distribution
+
+The resulting `TIC-80.AppImage` file can be distributed and run on any Linux system without installation. Users just need to:
+
+```bash
+chmod +x TIC-80.AppImage
+./TIC-80.AppImage
+```
+
+## CI/CD Integration
+
+The AppImage is automatically built and deployed via GitHub Actions:
+
+- **Workflow**: `.github/workflows/build.yml`
+- **Job**: `linux-gcc12` (Ubuntu build)
+- **Artifact**: `tic80-appimage` - downloadable from GitHub Actions runs
+
+## Notes
+
+- TIC-80 is designed to be statically linked, so the AppImage should not require external libraries
+- Desktop integration works automatically when the AppImage is run
+- For development tools and demo assets, users should download the full TIC-80 distribution

build-appimage.sh

@@ -0,0 +1,69 @@
+#!/bin/bash
+
+# Build TIC-80 AppImage for Linux
+
+set -e
+
+# Check if we're on Linux
+if [[ "$OSTYPE" != "linux-gnu"* ]]; then
+    echo "This script must be run on Linux to build AppImage"
+    exit 1
+fi
+
+# Check if tic80 binary exists
+if [ ! -f "build/bin/tic80" ]; then
+    echo "Error: TIC-80 binary not found at build/bin/tic80"
+    echo "Please build TIC-80 first with: mkdir build && cd build && cmake .. && make"
+    exit 1
+fi
+
+# Create AppDir structure
+APPDIR="TIC-80.AppDir"
+rm -rf "$APPDIR"
+mkdir -p "$APPDIR/usr/bin"
+mkdir -p "$APPDIR/usr/lib"
+mkdir -p "$APPDIR/usr/share/applications"
+mkdir -p "$APPDIR/usr/share/icons/hicolor/256x256/apps"
+mkdir -p "$APPDIR/usr/share/metainfo"
+
+# Copy binary
+cp build/bin/tic80 "$APPDIR/usr/bin/"
+
+# Copy desktop file
+sed 's|Icon=tic80|Icon=tic80.png|' build/linux/tic80.desktop.in > "$APPDIR/usr/share/applications/tic80.desktop"
+
+# Copy icon
+cp build/linux/tic80.png "$APPDIR/usr/share/icons/hicolor/256x256/apps/"
+
+# Configure and copy metainfo
+sed -e "s/@PROJECT_VERSION@/$(grep VERSION_MAJOR cmake/version.cmake | cut -d'"' -f2).$(grep VERSION_MINOR cmake/version.cmake | cut -d'"' -f2).$(grep VERSION_REVISION cmake/version.cmake | cut -d'"' -f2)/g" \
+    -e "s/@VERSION_YEAR@/$(date +%Y)/g" \
+    -e "s/@VERSION_MONTH@/$(date +%m)/g" \
+    -e "s/@VERSION_DAY@/$(date +%d)/g" \
+    build/linux/com.tic80.TIC_80.metainfo.xml.in > "$APPDIR/usr/share/metainfo/com.tic80.TIC_80.metainfo.xml"
+
+# Create AppRun script
+cat > "$APPDIR/AppRun" << 'EOF'
+#!/bin/bash
+HERE="$(dirname "$(readlink -f "${0}")")"
+export PATH="${HERE}/usr/bin:${PATH}"
+export LD_LIBRARY_PATH="${HERE}/usr/lib:${LD_LIBRARY_PATH}"
+exec "${HERE}/usr/bin/tic80" "$@"
+EOF
+chmod +x "$APPDIR/AppRun"
+
+# Copy required libraries (if any - TIC-80 should be statically linked)
+# ldd build/bin/tic80 | grep "=>" | awk '{print $3}' | xargs -I {} cp {} "$APPDIR/usr/lib/" 2>/dev/null || true
+
+# Download appimagetool if not present
+if [ ! -f "appimagetool.AppImage" ]; then
+    echo "Downloading appimagetool..."
+    wget -O appimagetool.AppImage https://github.com/AppImage/AppImageKit/releases/download/continuous/appimagetool-x86_64.AppImage
+    chmod +x appimagetool.AppImage
+fi
+
+# Create AppImage
+echo "Creating AppImage..."
+./appimagetool.AppImage "$APPDIR" TIC-80.AppImage
+
+echo "AppImage created: TIC-80.AppImage"