cross-compile/appimage/README

   1 -------------------------------------------------------------------------------
   2 README
   3 -------------------------------------------------------------------------------
   4
   5 This is a small script for bundling PulseView/sigrok-cli and its dependencies
   6 for Linux systems as an AppImage.
   7
   8 AppImage is a bundle format for Linux applications that allows the user to
   9 download an application, make it executable, and run.
  10 No need to install. No system libraries or system preferences are altered.
  11
  12 For more information on AppImage, please see
  13 http://appimage.org/
  14
  15
  16 Status
  17 ------
  18
  19 Working, nightly AppImages are provided here:
  20 https://sigrok.org/jenkins/job/sigrok-native-appimage/
  21
  22
  23 Requirements
  24 ------------
  25
  26 The script assumes you have built all of the sigrok subprojects and
  27 installed them into $HOME/sr (e.g. via the sigrok-cross-linux script).
  28
  29 It also assumes you have built AppImageKit in $HOME. First, install all
  30 build requirements of AppImageKit (see AppImageKit docs or its
  31 install-build-deps.sh file). Then:
  32
  33  $ cd $HOME
  34  $ git clone https://github.com/AppImage/AppImageKit
  35  $ cd AppImageKit
  36  $ ./build.sh
  37
  38 Temporary workaround for an AppImageKit issue:
  39
  40  $ mkdir -p build/lib/appimagekit
  41  $ cp build/out/mksquashfs build/lib/appimagekit
  42
  43 The AppImages are tested to build fine on Ubuntu 14.04 (32bit and 64bit).
  44 These older distros are used for the build so that the generated AppImages
  45 can run on as many different systems as possible.
  46
  47
  48 Building
  49 --------
  50
  51 For PulseView:
  52
  53  $ ./sigrok-native-appimage
  54
  55 For sigrok-cli:
  56
  57  $ ./sigrok-native-appimage sigrok-cli
  58
  59 Per default the script will put the AppImages in:
  60
  61  ./out/*.AppImage
  62
  63 Please edit the script if you want to change any settings.