Changes between Version 60 and Version 61 of BuildAndDeploymentEnvironment

Timestamp:

Aug 31, 2022, 4:24:52 AM (21 months ago)

Author:

Andy Alt

Comment:

add section:how to create an appimage

BuildAndDeploymentEnvironment

@@ -141 +141 @@
 See BuildInstructions#OSX
 
+== Linux AppImage ==
+
+After you've built 0ad, you can use these steps to create an [https://appimage.org/ AppImage]:
+
+
+{{{
+#!/bin/sh
+set -ev # exit on error, be verbose
+
+#ABS_PATH_SRC_ROOT=/0ad
+
+if [ -z "${ABS_PATH_SRC_ROOT}" ]; then
+  echo "set the source root!"
+  exit 1
+fi
+
+cd $ABS_PATH_SRC_ROOT
+
+install -s binaries/system/pyrogenesis -Dt $HOME/AppRun/usr/bin
+install -s binaries/system/ActorEditor -Dt $HOME/AppRun/usr/bin
+
+# This loop uses 'patchelf', which may not be installed on some distros.
+
+# TODO: add code here to check for the existence of 'patchelf'
+
+cd $HOME/AppRun/usr/bin
+
+for lib in libmozjs78-ps-release.so \
+        libnvcore.so    \
+        libnvimage.so   \
+        libnvmath.so    \
+        libnvtt.so
+do
+  patchelf --set-rpath $lib:${ABS_PATH_SRC_ROOT}/binaries/system pyrogenesis
+done
+
+patchelf --set-rpath libAtlasUI.so:${ABS_PATH_SRC_ROOT}/binaries/system ActorEditor
+
+cd $ABS_PATH_SRC_ROOT
+
+install binaries/system/libCollada.so -Dt $HOME/AppRun/usr/lib
+install build/resources/0ad.appdata.xml -Dt $HOME/AppRun/usr/share/appdata
+install build/resources/0ad.desktop -Dt $HOME/AppRun/usr/share/applications
+install build/resources/0ad.png -Dt $HOME/AppRun/usr/share/pixmaps
+
+mkdir -p $HOME/AppRun/usr/data/config
+cp -a binaries/data/config/default.cfg $HOME/AppRun/usr/data/config
+
+cp -a binaries/data/l10n $HOME/AppRun/usr/data
+
+# IMPORTANT: If you're creating the image from a distribution archive, this should copy
+# 'binaries/data/mods/mod/mod.zip', 'binaries/data/mods/public/public.zip', and
+# 'binaries/data/mods/public/mod.json'
+# If you're using the svn/git version, you'll need to use the pyrogenesis
+# pyromod archive builder. It's recommended to create the two zip files
+# in a directory outside of the AppRun folder, in case you need to remove
+# the AppRun folder, and then copy them to $HOME/AppRun/usr/data
+# see https://trac.wildfiregames.com/wiki/Modding_Guide#Distributingyourmods
+#
+cp -a binaries/data/mods $HOME/AppRun/usr/data
+
+# Remove any symlinks to mods that may be in binaries/data/mods (this will cause 0ad to crash
+# when the appimage is run). If you're creating the image from a clean 0ad archive, then
+# there won't be any symlinks of course
+}}}
+
+Note that binaries/system{libmoz*,libnv*} will be moved into the AppRun folder automatically when linuxdeploy is run below.
+
+Change the Exec line in $HOME/AppRun/usr/share/applications/0ad.desktop to pyrogenesis and also change the Exec line for Atlas. 
+
+Get a copy of [https://github.com/linuxdeploy/linuxdeploy/releases linuxdeploy] (you can use `wget` to get the desired release/arch).
+
+{{{
+cd $HOME
+
+linuxdeploy -d AppRun/usr/share/applications/0ad.desktop \
+  --icon-file=AppRun/usr/share/pixmaps/0ad.png \
+  --icon-filename=0ad \
+  --executable AppRun/usr/bin/pyrogenesis \
+  --appdir AppRun \
+  --output appimage
+}}}
+
+Other Notes:
+
+To test any changes you might want to make to the appimage, or for debugging, after extraction you can move things around or do whatever, then cd back to the squashfs-root dir, and enter `./AppRun`.
+
+To use the --writableRoot option with the 0ad appimage, it must be extracted by providing the --appimage-extract option. Then cd into squashfs-root, and type in `./AppRun --writableRoot` 
+
 == *nix build ==
 Linux build process shouldn't change (much).