SYNOPSIS
- flatpak build [OPTION...] DIRECTORY [COMMAND [ARG...]]
DESCRIPTION
The sdk that is specified in the metadata file in the directory is mounted at /usr and the files and var subdirectories are mounted at /app and /var, respectively. They are writable, and their contents are preserved between build commands, to allow accumulating build artifacts there.
OPTIONS
The following options are understood:
-h, --help
- Show help options and exit.
-v, --verbose
- Print debug information during command processing.
--version
- Print version information and exit.
-r, --runtime
- Use the non-devel runtime that is specified in the application metadata instead of the devel runtime.
--bind-mount=DEST=SOURCE
- Add a custom bind mount in the build namespace. Can be specified multiple times.
--build-dir=PATH
- Start the build in this directory (default is in the current directory).
--share=SUBSYSTEM
- Share a subsystem with the host session. This overrides the Context section from the application metadata. SUBSYSTEM must be one of: network, ipc. This option can be used multiple times.
--unshare=SUBSYSTEM
- Don't share a subsystem with the host session. This overrides the Context section from the application metadata. SUBSYSTEM must be one of: network, ipc. This option can be used multiple times.
--socket=SOCKET
- Expose a well-known socket to the application. This overrides to the Context section from the application metadata. SOCKET must be one of: x11, wayland, pulseaudio, system-bus, session-bus. This option can be used multiple times.
--nosocket=SOCKET
- Don't expose a well-known socket to the application. This overrides to the Context section from the application metadata. SOCKET must be one of: x11, wayland, pulseaudio, system-bus, session-bus. This option can be used multiple times.
--device=DEVICE
- Expose a device to the application. This overrides to the Context section from the application metadata. DEVICE must be one of: dri, all. This option can be used multiple times.
--nodevice=DEVICE
- Don't expose a device to the application. This overrides to the Context section from the application metadata. DEVICE must be one of: dri, all. This option can be used multiple times.
--filesystem=FILESYSTEM[:ro]
- Allow the application access to a subset of the filesystem. This overrides to the Context section from the application metadata. FILESYSTEM can be one of: home, host, xdg-desktop, xdg-documents, xdg-download xdg-music, xdg-pictures, xdg-public-share, xdg-templates, xdg-videos, an absolute path, or a homedir-relative path like ~/dir. The optional :ro suffix indicates that the location will be read-only. This option can be used multiple times.
--nofilesystem=FILESYSTEM
- Remove access to the specified subset of the filesystem from the application. This overrides to the Context section from the application metadata. FILESYSTEM can be one of: home, host, xdg-desktop, xdg-documents, xdg-download xdg-music, xdg-pictures, xdg-public-share, xdg-templates, xdg-videos, an absolute path, or a homedir-relative path like ~/dir. This option can be used multiple times.
--env=VAR=VALUE
- Set an environment variable in the application. This overrides to the Context section from the application metadata. This option can be used multiple times.
--own-name=NAME
- Allow the application to own the well-known name NAME on the session bus. This overrides to the Context section from the application metadata. This option can be used multiple times.
--talk-name=NAME
- Allow the application to talk to the well-known name NAME on the session bus. This overrides to the Context section from the application metadata. This option can be used multiple times.
--system-own-name=NAME
- Allow the application to own the well-known name NAME on the system bus. This overrides to the Context section from the application metadata. This option can be used multiple times.
--system-talk-name=NAME
- Allow the application to talk to the well-known name NAME on the system bus. This overrides to the Context section from the application metadata. This option can be used multiple times.
--persist=FILENAME
- If the application doesn't have access to the real homedir, make the (homedir-relative) path FILENAME a bind mount to the corresponding path in the per-application directory, allowing that location to be used for persistent data. This overrides to the Context section from the application metadata. This option can be used multiple times.
EXAMPLES
$ flatpak build /build/my-app rpmbuild my-app.src.rpm