1FLATPAK BUILD-INIT(1) flatpak build-init FLATPAK BUILD-INIT(1)
2
3
4
6 flatpak-build-init - Initialize a build directory
7
9 flatpak build-init [OPTION...] DIRECTORY APPNAME SDK RUNTIME [BRANCH]
10
12 Initializes a directory for building an application. DIRECTORY is the
13 name of the directory. APPNAME is the application id of the app that
14 will be built. SDK and RUNTIME specify the sdk and runtime that the
15 application should be built against and run in.
16
17 The result of this command is that a metadata file is created inside
18 the given directory. Additionally, empty files and var subdirectories
19 are created.
20
21 It is an error to run build-init on a directory that has already been
22 initialized as a build directory.
23
25 The following options are understood:
26
27 -h, --help
28 Show help options and exit.
29
30 --arch=ARCH
31 The architecture to use. See flatpak --supported-arches for
32 architectures supported by the host.
33
34 -v, --var=RUNTIME
35 Initialize var from the named runtime.
36
37 -w, --writable-sdk
38 Initialize /usr with a copy of the sdk, which is writable during
39 flatpak build. This can be used if you need to install build tools
40 in /usr during the build. This is stored in the usr subdirectory of
41 the app dir, but will not be part of the final app.
42
43 --tag=TAG
44 Add a tag to the metadata file. This option can be used multiple
45 times.
46
47 --sdk-extension=EXTENSION
48 When using --writable-sdk, in addition to the sdk, also install the
49 specified extension. This option can be used multiple times.
50
51 --extension=NAME=VARIABLE[=VALUE]
52 Add extension point info.
53
54 --sdk-dir
55 Specify a custom subdirectory to use instead of usr for
56 --writable-sdk.
57
58 --update
59 Re-initialize the sdk and var, don't fail if already initialized.
60
61 --base=APP
62 Initialize the application with files from another specified
63 application.
64
65 --base-version=VERSION
66 Specify the version to use for --base. If not specified, will
67 default to "master".
68
69 --base-extension=EXTENSION
70 When using --base, also install the specified extension from the
71 app. This option can be used multiple times.
72
73 --type=TYPE
74 This can be used to build different types of things. The default is
75 "app" which is a regular app, but "runtime" creates a runtime based
76 on an existing runtime, and "extension" creates an extension for an
77 app or runtime.
78
79 --extension-tag=EXTENSION_TAG
80 If building an extension, the tag to use when searching for the
81 mount point of the extension.
82
83 --verbose
84 Print debug information during command processing.
85
86 --ostree-verbose
87 Print OSTree debug information during command processing.
88
90 $ flatpak build-init /build/my-app org.gnome.Sdk org.gnome.Platform
91 3.16
92
94 flatpak(1), flatpak-build(1), flatpak-build-finish(1), flatpak-build-
95 export(1)
96
97
98
99flatpak FLATPAK BUILD-INIT(1)