projects / sigrok-util.git / blame
| Commit | Line | Data |
|---|---|---|
| ddc7a838 | 1 | ------------------------------------------------------------------------------- |
| 2 | README | |
| 3 | ------------------------------------------------------------------------------- | |
| 4 | ||
| ea193494 | 5 | This is a small script for bundling PulseView/sigrok-cli and its dependencies |
| ddc7a838 | 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 | ||
| ddc7a838 | 15 | |
| 16 | Status | |
| 17 | ------ | |
| 18 | ||
| f4b6ec06 UH |
19 | Working AppImages (stable releases and nightly builds) are provided here: |
| 20 | https://sigrok.org/wiki/Downloads | |
| ddc7a838 | 21 | |
| 22 | ||
| 23 | Requirements | |
| 24 | ------------ | |
| 25 | ||
| d9f89f29 UH |
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 | ||
| c8f1a10f UH |
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 | |
| c5aaf334 UH |
36 | |
| 37 | Apply chdir.patch (required to fix sigrok bug #1300), then build: | |
| 38 | ||
| 39 | $ patch -p1 < chdir.patch | |
| c8f1a10f UH |
40 | $ ./build.sh |
| 41 | ||
| 42 | Temporary workaround for an AppImageKit issue: | |
| 43 | ||
| 44 | $ mkdir -p build/lib/appimagekit | |
| 45 | $ cp build/out/mksquashfs build/lib/appimagekit | |
| 46 | ||
| bb8e5714 | 47 | The AppImages are tested to build fine on Ubuntu 16.04 (32bit and 64bit). |
| d9f89f29 UH |
48 | These older distros are used for the build so that the generated AppImages |
| 49 | can run on as many different systems as possible. | |
| ddc7a838 | 50 | |
| 51 | ||
| 52 | Building | |
| 53 | -------- | |
| 54 | ||
| ea193494 UH |
55 | For PulseView: |
| 56 | ||
| b24da7c1 | 57 | $ ./sigrok-native-appimage |
| ddc7a838 | 58 | |
| ea193494 UH |
59 | For sigrok-cli: |
| 60 | ||
| 61 | $ ./sigrok-native-appimage sigrok-cli | |
| 62 | ||
| 63 | Per default the script will put the AppImages in: | |
| ddc7a838 | 64 | |
| 65 | ./out/*.AppImage | |
| 66 | ||
| 67 | Please edit the script if you want to change any settings. |