refactor: pin linuxdeploy in make/yarn build process instead of github workflow

- pulls fix for janhq#5463 out of the github release workflow and into
  the make/yarn build process
- implements a wrapper script that pins linuxdeploy and injects
  a new location for XDG_CACHE_HOME into the build pipeline,
  allowing manipulating .cache/tauri without tainting the hosts
  .cache
- adds ./.cache (project_root/.cache) to make clean and mise clean
  task
- remove .devcontainer/buildAppImage.sh, obsolete now that extra
  build steps have been removed from the github workflow and
  incorporated in the normal build process

Author: DistractionRectangle

.devcontainer/buildAppImage.sh

@@ -145,12 +145,6 @@ jobs:
           fi
       - name: Build app
         run: |
-          # Pin linuxdeploy version to prevent @tauri-apps/cli-linux-x64-gnu from pulling in an outdated version
-          TAURI_TOOLKIT_PATH="${XDG_CACHE_HOME:-$HOME/.cache}/tauri"
-          mkdir -p "$TAURI_TOOLKIT_PATH"
-          wget https://github.com/linuxdeploy/linuxdeploy/releases/download/1-alpha-20250213-2/linuxdeploy-x86_64.AppImage -O "$TAURI_TOOLKIT_PATH/linuxdeploy-x86_64.AppImage"
-          chmod +x "$TAURI_TOOLKIT_PATH/linuxdeploy-x86_64.AppImage"
-
           make build-tauri
 
           APP_IMAGE=./src-tauri/target/release/bundle/appimage/$(ls ./src-tauri/target/release/bundle/appimage/ | grep AppImage | head -1)

.github/workflows/template-tauri-build-linux-x64.yml

@@ -82,6 +82,7 @@ else ifeq ($(shell uname -s),Linux)
 	rm -rf ./src-tauri/target
 	rm -rf "~/jan/extensions"
 	rm -rf "~/.cache/jan*"
+	rm -rf "./.cache"
 else
 	find . -name "node_modules" -type d -prune -exec rm -rf '{}' +
 	find . -name ".next" -type d -exec rm -rf '{}' +

Makefile

@@ -164,6 +164,7 @@ elif [[ "$OSTYPE" == "linux-gnu"* ]]; then
   rm -rf ./src-tauri/target 2>/dev/null || true
   rm -rf ~/jan/extensions 2>/dev/null || true
   rm -rf "~/.cache/jan*" 2>/dev/null || true
+  rm -rf "./.cache" 2>/dev/null || true
 else
   # macOS cleanup (matches Makefile)
   find . -name "node_modules" -type d -prune -exec rm -rf '{}' + 2>/dev/null || true

mise.toml

@@ -34,7 +34,7 @@
     "copy:lib:darwin": "mkdir -p \"./src-tauri/resources/lib/\"",
     "download:bin": "node ./scripts/download-bin.mjs",
     "build:tauri:win32": "yarn download:bin && yarn tauri build",
-    "build:tauri:linux": "yarn download:bin && yarn tauri build && ./src-tauri/build-utils/buildAppImage.sh",
+    "build:tauri:linux": "yarn download:bin && ./src-tauri/build-utils/shim-linuxdeploy.sh yarn tauri build && ./src-tauri/build-utils/buildAppImage.sh",
     "build:tauri:darwin": "yarn tauri build --target universal-apple-darwin",
     "build:tauri": "yarn install:cortex && yarn build:icon && yarn copy:assets:tauri && run-script-os",
     "build:icon": "tauri icon ./src-tauri/icons/icon.png",

package.json

@@ -0,0 +1,30 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+# wrapper script to pin linuxdeploy version and inject environment variables into the 
+# build process. While yarn supports injecting environment vairables via env files,
+# this applies to all yarn scripts. Using a wrapper allows granular control over
+# when environment variables are injected, and avoids tainting the system .cache
+
+# avoid redownloading corepack if possible
+export COREPACK_HOME=${COREPACK_HOME:-${XDG_CACHE_HOME:-$HOME/.cache}/node/corepack}
+# move cache home to <project root>/.cache
+export XDG_CACHE_HOME=${PWD}/.cache
+
+LINUXDEPLOY_VER="1-alpha-20250213-2"
+LINUXDEPLOY="$XDG_CACHE_HOME/tauri/linuxdeploy-$LINUXDEPLOY_VER-x86_64.AppImage"
+SYMLINK="$XDG_CACHE_HOME/tauri/linuxdeploy-x86_64.AppImage"
+
+mkdir -p "$XDG_CACHE_HOME/tauri"
+
+if [ ! -f "$LINUXDEPLOY" ]; then
+  GLOB_PATTERN="$XDG_CACHE_HOME/tauri/linuxdeploy-*-x86_64.AppImage"
+  rm -f $GLOB_PATTERN
+  wget "https://github.com/linuxdeploy/linuxdeploy/releases/download/$LINUXDEPLOY_VER/linuxdeploy-x86_64.AppImage" -O "$LINUXDEPLOY"
+  chmod a+x "$LINUXDEPLOY"
+fi
+
+rm -f "$SYMLINK"
+ln -s "$LINUXDEPLOY" "$SYMLINK"
+
+"$@"