Cargo AppImage

This a cargo program that allows you to convert your Rust programs into AppImages.

Installation

1. Make sure that appimagetool is in your path. It can be downloaded from here
2. Install this program with

shell cargo install cargo-appimage

1. cd inside of the root directory of your crate and create an icon called icon.png

   1. Note this can simply be an empty file for development. In fact an empty file is generated if you forget to make one.

2. (optional) create a section in your Cargo.toml similar to the following with any additional assets to add to the AppImg: toml [package.metadata.appimage] assets = ["images", "sounds"]

3. (optional) If you are using external crates that use other programs or are not written in pure rust, you may want to check if you need to embed some shared libraries into your AppImage:

   1. Running cargo appimage with this option in your Cargo.toml will automatically make a libs folder and put all of the shared objects your rust program uses in their respective directories.

   toml [package.metadata.appimage] auto_link = true

   1. AppImages aren't supposed to have EVERY library that your executable links to inside of the AppImage, so either:

      1. Manually delete the libraries from the libs folder that you expect will be on every linux system (libc, libgcc, libpthread, ld-linux, libdl, etc.), and then remove the auto_link option from Cargo.toml and rebuild. Then only the libraries remaining in the libs folder should be embedded in the Appimage.

      2. Or, use the auto_link_exclude_list option to specify a list of glob patterns to exclude. For example:

      ```toml [package.metadata.appimage] autolink = true autolinkexcludelist = [ "libc.so", "libdl.so", "libpthread.so*", ]

      ``` On the next build, only library files not matching the glob patterns will be embedded in the Appimage.

4. run this command

   shell cargo appimage

   1. Note all arguments passed into cargo-appimage are redirected to cargo

   shell cargo appimage --features=min

   Docker

Apparently this Dockerfile works ```dockerfile FROM rust:slim

RUN cargo install cargo-appimage

file package is required by appimagetool

RUN apt-get update && apt-get install -y --no-install-recommends file wget

Download appimagetool

RUN wget https://github.com/AppImage/AppImageKit/releases/download/continuous/appimagetool-$(uname -m).AppImage -O /usr/local/bin/appimagetool RUN chmod +x /usr/local/bin/appimagetool

Path appimagetool magic byte: https://github.com/AppImage/pkg2appimage/issues/373#issuecomment-495754112

RUN sed -i 's|AI\x02|\x00\x00\x00|' /usr/local/bin/appimagetool

Use appimagetool without fuse: https://github.com/AppImage/AppImageKit/wiki/FUSE#docker

RUN APPIMAGEEXTRACTAND_RUN=1 cargo appimage ```