Support GitHub's Linux arm64 preview hosts

The action already worked without issue on Linux arm64, just the
tests needed to be updated to test the new architecture correctly.

Also included a handy `plugins.md` reference file, which is
intended as an internal reference only.

Squashed commit of the following:

commit 9c09bfc
Author: Paul Colby <[email protected]>
Date:   Fri Jan 17 13:11:51 2025 +1100

    Trim leading and trailing whitespace too

commit 33d80a5
Author: Paul Colby <[email protected]>
Date:   Fri Jan 17 13:05:59 2025 +1100

    Reduce runs of spaces to single spaces

commit 5f90ee3
Author: Paul Colby <[email protected]>
Date:   Fri Jan 17 13:01:36 2025 +1100

    Expect an appimage plugin for Linux arm64

    Even though we didn't request one. Because linuxdeploy supplies
    one itself.

commit 5ba3185
Author: Paul Colby <[email protected]>
Date:   Fri Jan 17 12:55:08 2025 +1100

    Show actual and expected plugins

commit b203e15
Author: Paul Colby <[email protected]>
Date:   Fri Jan 17 12:45:46 2025 +1100

    Formalise the workaround for Linux arm64 issue #25

    See actions/partner-runner-images#25

commit 839cdde
Author: Paul Colby <[email protected]>
Date:   Fri Jan 17 12:34:44 2025 +1100

    Strip erroneous `admin` from $PATH

    See actions/partner-runner-images#25

commit a6b63e5
Author: Paul Colby <[email protected]>
Date:   Fri Jan 17 12:18:58 2025 +1100

    Inspect the $PATH

commit ce2cae9
Author: Paul Colby <[email protected]>
Date:   Fri Jan 17 12:16:30 2025 +1100

    Drop version suffix from plugin names filter

commit dab148a
Author: Paul Colby <[email protected]>
Date:   Thu Jan 16 18:18:17 2025 +1100

    Filter plugins **not** supported for this arch

commit 03105ce
Author: Paul Colby <[email protected]>
Date:   Thu Jan 16 18:17:16 2025 +1100

    Filter plugins not supported for this arch

commit dde6cb7
Author: Paul Colby <[email protected]>
Date:   Thu Jan 16 18:15:09 2025 +1100

    Only install Python plugin for x86_64

commit b1c7826
Author: Paul Colby <[email protected]>
Date:   Thu Jan 16 18:12:59 2025 +1100

    Try installing ncurses and python plugins on all arch's

commit 51079c5
Author: Paul Colby <[email protected]>
Date:   Thu Jan 16 18:09:52 2025 +1100

    Use arm64 host for arm64, x86-64 hosts for the rest

commit 0075a95
Author: Paul Colby <[email protected]>
Date:   Thu Jan 16 18:05:30 2025 +1100

    Can execute on arm64 hosts now

commit 81f0f2f
Author: Paul Colby <[email protected]>
Date:   Thu Jan 16 18:03:53 2025 +1100

    Correct workflow syntax

commit bdf0037
Author: Paul Colby <[email protected]>
Date:   Thu Jan 16 18:03:32 2025 +1100

    Execute the correct binary for the current host arch

commit 584887d
Author: Paul Colby <[email protected]>
Date:   Thu Jan 16 18:00:00 2025 +1100

    Try out GitHub's new Linux arm64 runners

    Now in public preview:
    https://github.blog/changelog/2025-01-16-linux-arm64-hosted-runners-now-available-for-free-in-public-repositories-public-preview/

Author: pcolby

.github/workflows/ci.yaml

@@ -20,19 +20,31 @@ jobs:
   test-defaults:
     runs-on: ${{ matrix.os }}
     steps:
+      # \todo Remove this step when https://github.com/actions/partner-runner-images/issues/25 is resolved.
+      - name: Correct broken $PATH on Linux arm64 runners
+        if: endsWith(matrix.os, '-arm')
+        run: sed -Ee 's/^/PATH=/' -e 's/(runner)admin/\1/g' <<< "${PATH}" | tee -a "$GITHUB_ENV"
       - uses: actions/checkout@v4
       - uses: ./
-      - run: linuxdeploy-x86_64.AppImage --list-plugins
+      - run: linuxdeploy-"${LINUXDEPLOY_ARCH}".AppImage --list-plugins
+        env:
+          LINUXDEPLOY_ARCH: ${{ endsWith(matrix.os, '-arm') && 'aarch64' || 'x86_64' }}
     strategy:
       matrix:
         os:
           - ubuntu-22.04
+          - ubuntu-22.04-arm
           - ubuntu-24.04
+          - ubuntu-24.04-arm
       fail-fast: false
 
   test-options:
     runs-on: ${{ matrix.os }}
     steps:
+      # \todo Remove this step when https://github.com/actions/partner-runner-images/issues/25 is resolved.
+      - name: Correct broken $PATH on Linux arm64 runners
+        if: endsWith(matrix.os, '-arm')
+        run: sed -Ee 's/^/PATH=/' -e 's/(runner)admin/\1/g' <<< "${PATH}" | tee -a "$GITHUB_ENV"
       - uses: actions/checkout@v4
       - name: Define test install dir
         run: tee -a "$GITHUB_ENV" <<< "INSTALL_DIR=${RUNNER_TEMP}/test/linuxdeploy/bin"
@@ -69,7 +81,9 @@ jobs:
       matrix:
         os:
           - ubuntu-22.04
+          - ubuntu-22.04-arm
           - ubuntu-24.04
+          - ubuntu-24.04-arm
       fail-fast: false
 
   test-plugins:
@@ -90,26 +104,45 @@ jobs:
         python
         qt
     steps:
+      # \todo Remove this step when https://github.com/actions/partner-runner-images/issues/25 is resolved.
+      - name: Correct broken $PATH on Linux arm64 runners
+        if: endsWith(matrix.os, '-arm')
+        run: sed -Ee 's/^/PATH=/' -e 's/(runner)admin/\1/g' <<< "${PATH}" | tee -a "$GITHUB_ENV"
       - uses: actions/checkout@v4
+      - name: Filter plugins not supported for this arch
+        run: |
+          [[ '${{ matrix.os }}' != *-arm ]] ||
+            PLUGINS=$(sed -Ee 's/(appimage|native_packages|python)//g' \
+                           -e 's/ +/ /g' -e 's/(^ )|( $)//' <<< "${PLUGINS}")
+          tee -a "$GITHUB_ENV" <<< "PLUGINS=${PLUGINS}"
       - name: Install linuxdeploy, and all supported plugins
         uses: ./
         with:
           plugins: ${{ env.PLUGINS }}
       - name: Check installed plugins
         run: |
           ls -l "${RUNNER_TEMP}/linuxdeploy"
-          linuxdeploy-x86_64.AppImage --list-plugins | tee "${RUNNER_TEMP}/plugins.txt"
+          linuxdeploy-"${LINUXDEPLOY_ARCH}".AppImage --list-plugins | tee "${RUNNER_TEMP}/plugins.txt"
           plugins=($(sed -Ee '0,/^Available plugins:/d' -e 's/:.*//' "${RUNNER_TEMP}/plugins.txt" | sort))
-          [[ "${plugins[@]}" = "${PLUGINS}" ]]
+          [[ '${{ matrix.os }}' != *-arm ]] || PLUGINS="appimage ${PLUGINS}" # linuxdeploy provides an appimage plugin.
+          [[ "${plugins[@]}" == "${PLUGINS}" ]] || {
+            echo "Expected: '${PLUGINS}'"
+            echo "Actual:   '${plugins[@]}'"
+            false
+          }
+        env:
+          LINUXDEPLOY_ARCH: ${{ endsWith(matrix.os, '-arm') && 'aarch64' || 'x86_64' }}
     strategy:
       matrix:
         os:
           - ubuntu-22.04
+          - ubuntu-22.04-arm
           - ubuntu-24.04
+          - ubuntu-24.04-arm
       fail-fast: false
 
   test-plugins-latest:
-    runs-on: ${{ matrix.os }}
+    runs-on: ${{ matrix.os }}${{ matrix.arch == 'aarch64' && '-arm' || '' }}
     env:
       # These should all be the latest official releases, however most (all?) plugins don't have official releases yet.
       PLUGINS: >-
@@ -127,20 +160,24 @@ jobs:
         python@continuous
         [email protected]
     steps:
+      # \todo Remove this step when https://github.com/actions/partner-runner-images/issues/25 is resolved.
+      - name: Correct broken $PATH on Linux arm64 runners
+        if: matrix.arch == 'aarch64'
+        run: sed -Ee 's/^/PATH=/' -e 's/(runner)admin/\1/g' <<< "${PATH}" | tee -a "$GITHUB_ENV"
       - uses: actions/checkout@v4
       - name: Filter plugins not supported for this arch
         run: |
           [[ '${{ matrix.arch }}' =~ ^(i386|x86_64)$ ]] ||
             PLUGINS=$(sed -Ee 's/appimage@[^ ]+//g' <<< "${PLUGINS}")
           [[ '${{ matrix.arch }}' == 'x86_64' ]] ||
-            PLUGINS=$(sed -Ee 's/(native_packages|ncurses|python)@[^ ]+//g' <<< "${PLUGINS}")
+            PLUGINS=$(sed -Ee 's/(native_packages|python)@[^ ]+//g' <<< "${PLUGINS}")
           tee -a "$GITHUB_ENV" <<< "PLUGINS=${PLUGINS}"
       - name: Install linuxdeploy, and all supported plugins
         uses: ./
         with:
           arch: ${{ matrix.arch }}
           plugins: ${{ env.PLUGINS }}
-      - if: endsWith(matrix.arch, 'x86_64')
+      - if: matrix.arch == 'aarch64' || endsWith(matrix.arch, 'x86_64')
         run: linuxdeploy-${{ matrix.arch }}.AppImage --list-plugins
     strategy:
       matrix:

.github/workflows/plugins.md

@@ -0,0 +1,39 @@
+# Supported [linuxdeploy] Plugins
+
+Just a convenient list for CI development.
+
+| Plugin | Architecture/s |
+|--------|----------------|
+| *Official Plugins* ||
+| [appimage]        | `i386`, `x86_64` |
+| [conda]           | *all* (`.sh`) |
+| [gstreamer]       | *all* (`.sh`) |
+| [gtk]             | *all* (`.sh`) |
+| [native_packages] |`x86_64` |
+| [ncurses]         | *all* (`.sh`) |
+| [qt]              | `aarch64`, `armhf`, `i386`, `static-x86_64`, `x86_64` |
+| *Official Misc Plugins* ||
+| [demo]      | *all* (`.sh`) |
+| [gdb]       | *all* (`.sh`) |
+| [gettext]   | *all* (`.sh`) |
+| [grantlee5] | *all* (`.sh`) |
+| *Third-party Plugins* | |
+| [checkrt] | *all* (`.sh`) |
+| [python]  | `x86_64` |
+
+[linuxdeploy]:     https://github.com/linuxdeploy/linuxdeploy
+[appimage]:        https://github.com/linuxdeploy/linuxdeploy-plugin-appimage
+[conda]:           https://github.com/linuxdeploy/linuxdeploy-plugin-conda
+[gstreamer]:       https://github.com/linuxdeploy/linuxdeploy-plugin-gstreamer
+[gtk]:             https://github.com/linuxdeploy/linuxdeploy-plugin-gtk
+[native_packages]: https://github.com/linuxdeploy/linuxdeploy-plugin-native_packages
+[ncurses]:         https://github.com/linuxdeploy/linuxdeploy-plugin-ncurses
+[qt]:              https://github.com/linuxdeploy/linuxdeploy-plugin-qt
+
+[demo]:      https://github.com/linuxdeploy/misc-plugins/tree/master/demo
+[gdb]:       https://github.com/linuxdeploy/misc-plugins/tree/master/gdb
+[gettext]:   https://github.com/linuxdeploy/misc-plugins/tree/master/gettext
+[grantlee5]: https://github.com/linuxdeploy/misc-plugins/tree/master/grantlee5
+
+[checkrt]: https://github.com/darealshinji/linuxdeploy-plugin-checkrt
+[python]:  https://github.com/niess/linuxdeploy-plugin-python