|
|
| (534 intermediate revisions by 75 users not shown) |
| Line 1: |
Line 1: |
| == Creating Package HOWTO == | | {{autolang|base=yes}} |
|
| |
|
| This page describes the mechanics of how to create an RPM package for Fedora, and in particular,
| | {{admon/important|deprecated|As part of documentation move to docs.fp.o, this page has moved to https://docs.fedoraproject.org/en-US/quick-docs/creating-rpm-packages}} |
| how to create a .spec file. It also gives some practical warnings about stuff that will or won't work,
| |
| which may save you hours of time later.
| |
| | |
| Nearly all Linux distributions can install and uninstall programs as "packages".
| |
| Fedora, and many other Linux distributions, use the "RPM" format for packages.
| |
| There are tools that make it easy to create RPM packages; the key is to write
| |
| a ".spec" file that explains to RPM how to build and install the program.
| |
| | |
| == Setting up ==
| |
| | |
| Before you create RPM packages on Fedora, you need to install some core
| |
| development tools and set up the account(s) you will use. As root:
| |
| # yum groupinstall "Development Tools"
| |
| # yum install rpmdevtools
| |
| | |
| It's strongly recommended that you create a new "dummy user" specifically for
| |
| creating rpm packages. That way, if something goes terribly wrong, the
| |
| program or build process can't trash your files, or
| |
| send your private files/keys to the world. At the very least,
| |
| you should normally ''not'' create your packages as user root.
| |
| You can create a new user named "makerpm" quickly by doing:
| |
| # /usr/sbin/useradd makerpm
| |
| | |
| Then log in as that special dummy user (makerpm).
| |
| | |
| Once you're logged in as the user who is creating packages,
| |
| you then can then create the directory structure in your home directory
| |
| by executing:
| |
| $ rpmdev-setuptree
| |
| | |
| The "rpmdev-setuptree" program will create an "rpmbuild" directory in your $HOME
| |
| directory. Underneath "rpmbuild" are a set of subdirectories
| |
| (such as SPECS and BUILD), which you will use for creating your packages.
| |
| | |
| One you've set up your system and user account, you won't normally need
| |
| to do these again. | |
| | |
| == Creating a spec file ==
| |
| | |
| == Creating a RPMs from the spec file ==
| |
| | |
| Once you've create a spec file, say "program.spec", you can create
| |
| source and binary RPMs by simply running this:
| |
| $ rpmbuild -ba myprogram.spec
| |
| | |
| If this is successful, you'll find your binary RPM(s) in the "~/rpmbuild/RPMS/"
| |
| subdirectory, and the source RPM in "~/rpmbuild/SRPMS".
| |
| | |
| | |
| == For more information ==
| |
| | |
| This page only discusses the mechanics of creating a package.
| |
| For more information about packaging, see
| |
| [[PackageMaintainers|Package Maintainers]] page, especially the
| |
| [[Packaging/Guidelines|Packaging Guidelines]] and
| |
| [[PackageMaintainers/Join| How to join the Fedora Package Collection Maintainers]]
| |
| (which explains how to become a package maintainer).
| |
| The [[PackageMaintainers/UpdatingPackageHowTo|Updating Package HOWTO]] describes how to update
| |
| an existing package you maintain in Fedora.
| |
| [[Packaging/ScriptletSnippets Scriptlet Snippets]] has some useful examples of scriptlets.
| |
| | |
| For more information see:
| |
| * [http://www.g-loaded.eu/2006/04/05/how-to-build-rpm-packages-on-fedora/ How to build RPM packages on Fedora] - quick run-through
| |
| * [http://www.redhatmagazine.com/2008/02/28/when-sally-met-eddie-the-fedora-package-story/ When Sally met Eddie]
| |
| * [http://rpm.org/max-rpm-snapshot/ Maximum RPM Book]
| |
| * [http://docs.fedoraproject.org/drafts/rpm-guide-en/ch-creating-rpms.html RPM Guide, section on creating RPMs]
| |
| * [http://docs.fedoraproject.org/developers-guide/ch-rpm-building.html Developer's guide, section on building RPMs]
| |
