Available Keys
This command will obtain all of the information that it needs from the Cargo.toml
file, so it is necessary to have filled out enough information in the file for the Debian binary package to be created. Cargo.toml
already features a number of fields that are immediately useful. These fields are name
, version
, license
, description
, homepage
, and repository
. However, as these fields are not enough, you must also define a new table, #[package.metadata.deb]
that will contain maintainer
, copyright
, license_file
, depends
, extended_description
, section
, priority
, and assets
.
Key Descriptions
- maintainer: The person maintaining the Debian packaging
- copyright: To whom and when the copyright of the software is granted
- license_file: The location of the license and the amount of lines to skip at the top
- depends: The runtime dependencies of the project, which are automatically generated with the
$auto
keyword.= - extended_description: An extended description of the project -- the more detailed the better
- section: The application category that the software belongs to
- priority: Defines if the package is required or optional
- assets: Any other files needed by the package and the permissions to assign them
- The first argument of each asset is the location of that asset in the Rust project.
- The second argument is where the file will be copied.
- If is argument ends with / it will be inferred that the target is the directory where the file will be copied.
- Otherwise, it will be inferred that the source argument will be renamed when copied.
- The third argument is the permissions to assign that file.
- features: List of Cargo features to use when building the package
- default-features: whether to use default crate features in addition to the
features
list (defaulttrue
)
Running cargo deb
Upon running cargo deb
from the base directory of your Rust project, a Debian package will be saved in the same
directory. If you would like to handle the build process yourself, you can use cargo deb --no-build
so that the
cargo-deb
command will not attempt to rebuild your project.
Cargo Deb Example
[]
= "Michael Aaron Murphy <mmstickman@gmail.com>"
= "2016, Michael Aaron Murphy <mmstickman@gmail.com>"
= ["LICENSE", "4"]
= """\
A simple subcommand for the Cargo package manager for \
building Debian packages from Rust projects."""
= "$auto"
= "utility"
= "optional"
= [
["target/release/cargo-deb", "usr/bin/", "755"],
["README.md", "usr/share/doc/cargo-deb/README", "644"],
]
Systemd Manager Example
[]
= "Michael Aaron Murphy <mmstickman@gmail.com>"
= "2015-2016, Michael Aaron Murphy <mmstickman@gmail.com>"
= ["LICENSE", "3"]
= "$auto"
= """\
Written safely in Rust, this systemd manager provides a simple GTK3 GUI interface \
that allows you to enable/disable/start/stop services, monitor service logs, and \
edit unit files without ever using the terminal."""
= "admin"
= "optional"
= [
["assets/org.freedesktop.policykit.systemd-manager.policy", "usr/share/polkit-1/actions/", "644"],
["assets/systemd-manager.desktop", "usr/share/applications/", "644"],
["assets/systemd-manager-pkexec", "usr/bin/", "755"],
["target/release/systemd-manager", "usr/bin/", "755"]
]