When building a snap and constructing a part, you commonly need to specify build and staging dependencies. These dependencies are listed in snapcraft.yaml within a part definition as either package names, or snap names, with the following metadata:
For packages:
build-packages
: packages required for the part to buildstage-packages
: packages required to run the partFor snaps:
build-snaps
: snaps required for the part to build.stage-snaps
: snaps required to run the partSnaps are downloaded from the Snap Store and unpacked into the snap being built. If a specific channel is required, the syntax is of the form <snap-name>/<channel>
(see Channels for more details on the syntax).
For staged snaps, the meta
and snap
directories from the snap will be available as meta.<snap-name>
and snap.<snap-name>
for cases where assets from those locations are desired for reuse.
The following is a typical example of a part’s build- and stage- sections for a command tool line thats interacts with git:
build-packages:
- pkg-config
- libreadline-dev
- libncurses5-dev
build-snaps:
- go
stage-snaps:
- ffmpeg/latest/edge
stage-packages:
- git
Package dependencies are listed as package names for the snap’s build environment.
For a default Snapcraft installation running Multipass, the build environment is invariably Ubuntu 18.04 LTS (Bionic Beaver). Consequently, dependencies are listed using their apt package names.
It’s also feasible to have a build environment built on Fedora for example, using Fedora packages, or those of your own host environment.
The packages you need are likely to be identical to those you need to either build your project (build-packages
) or install your project (stage-packages
). You’ll often find them listed in a project’s README.md, or alongside any build instructions.
Working out your project’s dependencies can be an iterative process, much like compiling a third-party package:
snapcraft --debug
until you hit an errorSee Iterating over a build for build and testing best-practices, and Troubleshoot snap building for help with resolving build errors.
Last updated 9 months ago. Help improve this document in the forum.