Add Debian package (.deb) build infrastructure for ARM AppImages

NicuS03 · NicuS03 · commit 26be42ec022b · 2026-03-18T15:42:47.000+02:00
Adds CI steps and packaging scripts to produce .deb packages from the ARM64/armhf AppImage builds, including debian control files, templates, configs, and a build script that repackages the AppImage into a proper Debian package.

Signed-off-by: Nicu Siderias &lt;nicu.siderias@analog.com&gt;
diff --git a/.github/workflows/appimage-arm64.yml b/.github/workflows/appimage-arm64.yml
@@ -60,5 +60,20 @@ jobs:
             name: scopy-arm64-appimage-${{ env.commit_sha }}
             path: ${{ github.workspace }}/Scopy-arm64.AppImage
 
+        - name: Build Debian package
+          shell: bash
+          run: |
+            sudo apt-get install -y dpkg-dev debhelper devscripts rsync crossbuild-essential-arm64
+            ./ci/packaging/scopy-deb-build.sh scopy64 $GITHUB_WORKSPACE/Scopy-arm64.AppImage
+
+        - uses: actions/upload-artifact@v4
+          with:
+            name: scopy-arm64-deb-${{ env.commit_sha }}
+            path: |
+              ${{ github.workspace }}/scopy_*_arm64.deb
+              ${{ github.workspace }}/scopy_*.dsc
+              ${{ github.workspace }}/scopy_*.orig.tar.gz
+              ${{ github.workspace }}/scopy_*.debian.tar.xz
+
         - name: check storage space
-          run: df -h
+          run: df -h
diff --git a/.github/workflows/appimage-armhf.yml b/.github/workflows/appimage-armhf.yml
@@ -60,5 +60,20 @@ jobs:
             name: scopy-armhf-appimage-${{ env.commit_sha }}
             path: ${{ github.workspace }}/Scopy-armhf.AppImage
 
+        - name: Build Debian package
+          shell: bash
+          run: |
+            sudo apt-get install -y dpkg-dev debhelper devscripts rsync crossbuild-essential-armhf
+            ./ci/packaging/scopy-deb-build.sh scopy32 $GITHUB_WORKSPACE/Scopy-armhf.AppImage
+
+        - uses: actions/upload-artifact@v4
+          with:
+            name: scopy-armhf-deb-${{ env.commit_sha }}
+            path: |
+              ${{ github.workspace }}/scopy_*_armhf.deb
+              ${{ github.workspace }}/scopy_*.dsc
+              ${{ github.workspace }}/scopy_*.orig.tar.gz
+              ${{ github.workspace }}/scopy_*.debian.tar.xz
+
         - name: check storage space
-          run: df -h
+          run: df -h
diff --git a/ci/packaging/configs/scopy32.conf b/ci/packaging/configs/scopy32.conf
@@ -0,0 +1,8 @@
+# Package metadata
+PACKAGE=scopy
+ARCHITECTURE=armhf
+DEPENDS="libfuse2t64, libxcb-icccm4, libxcb-image0, libxcb-keysyms1, libxcb-render-util0, libxcb-xinerama0, libxkbcommon-x11-0, libxcb-xkb1"
+MAINTAINER="Adrian Suciu <adrian.suciu@analog.com>"
+HOMEPAGE="https://github.com/analogdevicesinc/scopy"
+DESCRIPTION="Scopy for 32-bit architecture"
+LONG_DESCRIPTION="This package contains the Scopy software oscilloscope and signal analysis toolset from Analog Devices for 32-bit architecture."
diff --git a/ci/packaging/configs/scopy64.conf b/ci/packaging/configs/scopy64.conf
@@ -0,0 +1,8 @@
+# Package metadata
+PACKAGE=scopy
+ARCHITECTURE=arm64
+DEPENDS="libfuse2t64, libxcb-icccm4, libxcb-image0, libxcb-keysyms1, libxcb-render-util0, libxcb-xinerama0, libxkbcommon-x11-0, libxcb-xkb1"
+MAINTAINER="Adrian Suciu <adrian.suciu@analog.com>"
+HOMEPAGE="https://github.com/analogdevicesinc/scopy"
+DESCRIPTION="Scopy for 64-bit architecture"
+LONG_DESCRIPTION="This package contains the Scopy software oscilloscope and signal analysis toolset from Analog Devices for 64-bit architecture."
diff --git a/ci/packaging/debian/changelog.template b/ci/packaging/debian/changelog.template
@@ -0,0 +1,5 @@
+${PACKAGE} (${VERSION}-1) stable; urgency=medium
+
+${RELEASE_NOTES}
+
+ -- ${MAINTAINER}  ${DATE}
diff --git a/ci/packaging/debian/control.template b/ci/packaging/debian/control.template
@@ -0,0 +1,13 @@
+Source: ${PACKAGE}
+Section: science
+Priority: optional
+Maintainer: ${MAINTAINER}
+Build-Depends: debhelper-compat (= 13), wget, unzip
+Standards-Version: 4.6.2
+Homepage: ${HOMEPAGE}
+
+Package: ${PACKAGE}
+Architecture: any
+Depends: ${shlibs:Depends}, ${misc:Depends}, ${DEPENDS}
+Description: ${DESCRIPTION}
+ ${LONG_DESCRIPTION}
diff --git a/ci/packaging/debian/copyright b/ci/packaging/debian/copyright
diff --git a/ci/packaging/debian/links b/ci/packaging/debian/links
@@ -0,0 +1,2 @@
+usr/bin/Scopy.AppImage usr/bin/scopy
+usr/bin/Scopy.AppImage usr/bin/Scopy
diff --git a/ci/packaging/debian/postinst b/ci/packaging/debian/postinst
@@ -0,0 +1,8 @@
+#!/bin/bash -e
+
+# Update desktop database
+if command -v update-desktop-database >/dev/null 2>&1; then
+    update-desktop-database /usr/share/applications/
+fi
+
+exit 0
diff --git a/ci/packaging/debian/postrm b/ci/packaging/debian/postrm
@@ -0,0 +1,14 @@
+#!/bin/bash -e
+
+case "$1" in
+    remove|purge)
+        # Update desktop database
+        if command -v update-desktop-database >/dev/null 2>&1; then
+            update-desktop-database /usr/share/applications/
+        fi
+        ;;
+    *)
+        ;;
+esac
+
+exit 0
diff --git a/ci/packaging/debian/rules b/ci/packaging/debian/rules
@@ -0,0 +1,49 @@
+#!/usr/bin/make -f
+
+# Package variables - will be set by environment from build script
+SCOPY ?= Scopy.AppImage
+PACKAGE ?= scopy
+VERSION ?= 1.0.0
+RELEASE ?= v1.0.0
+ARCHITECTURE ?= arm64
+
+export DH_VERBOSE = 1
+
+%:
+	dh $@
+
+override_dh_auto_clean:
+	rm -f $(SCOPY)
+
+override_dh_auto_configure:
+	# No configuration needed for AppImage repackaging
+
+override_dh_auto_build:
+	# Copy the already-built AppImage from the provided path
+	cp $(APPIMAGE_PATH) $(SCOPY)
+	chmod +x $(SCOPY)
+
+override_dh_auto_install:
+	# Install AppImage to /usr/bin
+	install -D -m 0755 $(SCOPY) debian/$(PACKAGE)/usr/bin/$(SCOPY)
+
+	# Install desktop file
+	install -D -m 0644 debian/scopy.desktop debian/$(PACKAGE)/usr/share/applications/scopy.desktop
+
+	# Install icon from source tree
+	install -D -m 0644 gui/res/scopy.png debian/$(PACKAGE)/usr/share/scopy/icons/scopy.png
+
+	# Install copyright
+	install -D -m 0644 debian/copyright debian/$(PACKAGE)/usr/share/doc/$(PACKAGE)/copyright
+
+override_dh_auto_test:
+	# No tests for AppImage repackaging
+	:
+
+override_dh_shlibdeps:
+	# Skip dependency analysis - AppImage is self-contained
+	:
+
+override_dh_strip:
+	# Skip stripping - AppImage is already compiled
+	:
diff --git a/ci/packaging/debian/scopy.desktop.template b/ci/packaging/debian/scopy.desktop.template
@@ -0,0 +1,10 @@
+[Desktop Entry]
+Version=1.0
+Name=Scopy
+GenericName=Oscilloscope
+Comment=A software oscilloscope and signal analysis toolset
+Exec=/usr/bin/${SCOPY}
+Icon=/usr/share/scopy/icons/scopy.png
+Terminal=false
+Type=Application
+Categories=Science;
diff --git a/ci/packaging/debian/source/format b/ci/packaging/debian/source/format
@@ -0,0 +1 @@
+3.0 (quilt)
diff --git a/ci/packaging/scopy-deb-build.sh b/ci/packaging/scopy-deb-build.sh
@@ -0,0 +1,99 @@
+#!/bin/bash -e
+
+# Script that generates Scopy .deb package and source files using debhelper
+# Usage: ./scopy-deb-build.sh <config> <appimage_path>
+#   config:        Configuration file name (scopy32 or scopy64)
+#   appimage_path: Path to the already-built AppImage
+
+SCRIPT_DIR=$(dirname "$(readlink -f "$0")")
+CONFIG=$1
+APPIMAGE_PATH=$2
+
+if [ -z "$CONFIG" ] || [ -z "$APPIMAGE_PATH" ]; then
+    echo "Usage: $0 <config> <appimage_path>"
+    echo "  config:        Configuration file (scopy32 or scopy64)"
+    echo "  appimage_path: Path to the already-built Scopy AppImage"
+    exit 1
+fi
+
+if [ ! -f "$APPIMAGE_PATH" ]; then
+    echo "Error: AppImage not found at ${APPIMAGE_PATH}"
+    exit 1
+fi
+
+# Find the repo root
+REPO_ROOT=$(git -C "${SCRIPT_DIR}" rev-parse --show-toplevel)
+
+# Extract SCOPY_VERSION from CMakeLists.txt by resolving its components
+PROJECT_VERSION=$(grep -oP 'project\(scopy VERSION \K[0-9.]+' "${REPO_ROOT}/CMakeLists.txt")
+RELEASE_PHASE=$(grep -oP 'set\(SCOPY_RELEASE_PHASE \K[^)]+' "${REPO_ROOT}/CMakeLists.txt" || true)
+VERSION="${PROJECT_VERSION}${RELEASE_PHASE}"
+RELEASE="v${VERSION}"
+
+echo "Scopy version: ${VERSION}"
+
+# Source the config file corresponding to the .deb package
+set -a
+source "${SCRIPT_DIR}/configs/${CONFIG}.conf"
+set +a
+
+export SCOPY=Scopy.AppImage
+export APPIMAGE_PATH=$(readlink -f "$APPIMAGE_PATH")
+
+WORK_DIR="${PACKAGE}-${VERSION}"
+
+# Create working directory from local checkout (excluding .git)
+echo "Creating working directory from local checkout..."
+rsync -a --exclude='.git' --exclude='ci/arm/staging' --exclude='build*' "${REPO_ROOT}/" "${WORK_DIR}/"
+
+# Create .orig.tar.gz for Debian source package
+tar czf ${PACKAGE}_${VERSION}.orig.tar.gz ${WORK_DIR}
+
+# Copy debian directory into the working directory
+cp -r "${SCRIPT_DIR}/debian" ${WORK_DIR}/
+
+cd ${WORK_DIR}
+
+# Export all variables for envsubst and debian/rules
+export VERSION ARCHITECTURE DEPENDS MAINTAINER HOMEPAGE DESCRIPTION LONG_DESCRIPTION SCOPY PACKAGE RELEASE
+export DATE=$(date -R)
+
+# Fetch release notes from GitHub
+echo "Fetching release notes from GitHub..."
+RELEASE_NOTES=$(curl -s https://api.github.com/repos/analogdevicesinc/scopy/releases/tags/${RELEASE} \
+  | jq -r '.body // "No release notes available"' \
+  | sed '/^[#]*[[:space:]]*Installer Artifacts/,$d' \
+  | sed 's/^/  * /')
+
+# If release notes are empty or error occurred, use default
+if [ -z "$RELEASE_NOTES" ]; then
+    RELEASE_NOTES="  * New upstream release ${VERSION}"
+fi
+
+export RELEASE_NOTES
+
+# Substitute templates
+envsubst < debian/control.template > debian/control
+envsubst < debian/changelog.template > debian/changelog
+envsubst < debian/scopy.desktop.template > debian/scopy.desktop
+
+# Remove template files
+rm debian/*.template
+
+# Make sure debian/rules is executable
+chmod +x debian/rules
+
+# Build package using debhelper (builds both binary and source packages)
+echo "Building packages..."
+dpkg-buildpackage -us -uc -a ${ARCHITECTURE}
+
+cd ..
+
+echo ""
+echo "Build complete! Generated files:"
+echo "  - ${PACKAGE}_${VERSION}.orig.tar.gz (upstream source)"
+echo "  - ${PACKAGE}_${VERSION}-1.debian.tar.xz (debian files)"
+echo "  - ${PACKAGE}_${VERSION}-1.dsc (source descriptor)"
+echo "  - ${PACKAGE}_${VERSION}-1_${ARCHITECTURE}.deb (binary package)"
+echo "  - ${PACKAGE}_${VERSION}-1_${ARCHITECTURE}.buildinfo"
+echo "  - ${PACKAGE}_${VERSION}-1_${ARCHITECTURE}.changes"

Original file line number	Diff line number	Diff line change
`@@ -0,0 +1,2 @@`
	`1`	`+usr/bin/Scopy.AppImage usr/bin/scopy`
	`2`	`+usr/bin/Scopy.AppImage usr/bin/Scopy`