Skip to content

appimage

Build your Flutter app as a Linux AppImage — a portable application format that runs on most Linux distributions without installation. AppImages bundle the application and its dependencies into a single executable file, providing a "download and run" experience.

Requirements

  • Linux system with FUSE support

  • locate utility for dependency detection

    On Ubuntu/Debian based Linux, run:

    bash
    sudo apt install locate
  • appimagetool

    To install appimagetool, run:

    bash
    wget -O appimagetool "https://github.com/AppImage/appimagetool/releases/download/continuous/appimagetool-x86_64.AppImage"
    chmod +x appimagetool
    mv appimagetool /usr/local/bin/

    The last command may require sudo privileges

Usage

Add make_config.yaml to your project linux/packaging/appimage directory.

yaml
display_name: Hello World

icon: assets/logo.png

keywords:
  - Hello
  - World
  - Test
  - Application

generic_name: Cool Application

actions:
  - name: Say Hi
    label: say-hi
    arguments:
      - --say
      - hi
  - name: Say Bye
    label: say-bye
    arguments:
      - --say
      - bye

categories:
  - Music

startup_notify: true

# You can specify the shared libraries that you want to bundle with your app
#
# fastforge automatically detects the shared libraries that your app
# depends on, but you can also specify them manually here.
#
# The following example shows how to bundle the libcurl library with your app.
#
# include:
#   - libcurl.so.4
include: []
# You can also specify [metainfo](https://www.freedesktop.org/software/appstream/metainfocreator/#/) file
# which contains metadata of the app.
# metainfo: linux/packaging/myappid.appdata.xml

Run:

bash
fastforge package --platform linux --targets appimage

Released under the MIT License.