Translation(s): none
Building with gem2deb
Note: Always verify the command has finished successfully and make sure there is no error before proceeding to next command.
Setup your environment
Add the following variables in your ~/.bashrc file. DEBEMAIL and DEBFULLNAME variables are used by debian tools to set your name and email.
export DEBEMAIL=your@email.domain export DEBFULLNAME='Your Name' alias lintian='lintian -iIEcv --pedantic --color auto' alias git-import-dsc='git-import-dsc --author-is-committer --pristine-tar' alias clean='fakeroot debian/rules clean'
Note: You can also use debclean command instead of setting alias for clean.
and update your current environment by running
$ source ~/.bashrc
Build the package
First you need install gem2deb
apt-get install gem2deb
Create a build directory and go there
mkdir -p ~/Build/ruby-packaging && cd $_
gem2deb devise
will run "gem fetch devise" to download the package.
If you get an error that the Test failed, see ruby tests for hints to solve it.
- If you see "unmet build dependencies" error, install the build dependencies. Install the build dependencies using apt and not using gem install.
Note: To fetch rails-assets-* gems, you need to provide a different gem source like this example
gem fetch --source https://rails-assets.org rails-assets-jquery
Once you have the .dsc file, create a git repo from the source package (.dsc, .orig.tar.* and .debian.tar.*)
gbp import-dsc --pristine-tar ruby-devise_<version>.dsc cd ruby-devise git tag -d debian/<version> # because the package is not ready yet
Now you have to edit files inside debian subdirectory like
- copyright
- control
- changelog
You will find such info at
rubygems (search for your gem and open the matching result) and the homepage of the package. The homepage you will find at rubygems too (right section). Usually there is a 'LICENSE' or 'COPYING' or README.{md,rdoc} file in the source which gives such information.
Note: Read http://www.debian.org/doc/manuals/maint-guide/dreq.en.html to learn more about each file.
Once that is done build the package with
dpkg-buildpackage
If you get an error that it could not be signed, ignore it for now.
And when it has finished check for lintian errors:
lintian
If you get errors, you have to correct them. Then run dpkg-buildpackage again and test with lintian again.
Make sure all copyright notices are added to debian/copyright file by running the following command. If it shows any mismatch, fix them by adding the missing copyright notices to debian/copyright. Note: You'll have to install license-reconcile package first.
license-reconcile
Note: There are two variants of MIT licenses (Expat or X11), use Expat when the text matches with that of license used in Expat project. See https://opensource.stackexchange.com/questions/8585/what-is-the-different-between-mit-and-x11-license-should-the-open-source-packag
Filing ITP bug
ITP stands for Intend to Package or telling the debian community that you are working on creating a new debian package for this software. See Teams/Ruby/Packaging/ITP for the steps.
Source Only Uploads
If your package got accepted in the archive (cleared NEW queue), you will need a SourceOnlyUpload to allow it to migrate to debian testing from debian unstable.
Rails engines
If your package has a app/assets or vendor/assets (if the gem name starts with rails-assets or ends at rails) then your package is very likely to be a rails engine. More about rails engines and Teams/Ruby/Packaging/RailsEngines has current recommended practices for packaging a rails engine.
The following steps are deprecated, add export DH_RUBY = --gem-install in debian/rules at the top instead
1 Install app or vendor in /usr/share/<package name> using debian/install
2 Set rails engine root with quilt to /usr/share/<package name>. Look for 'class Engine < ::Rails::Engine' in lib/<gem name>.rb or lib/<gem name>/engine.rb and add config.root = '/usr/share/<package name>' like this
if defined?(Rails) class Engine < ::Rails::Engine # Rails -> use app/assets directory. config.root = '/usr/share/ruby-rails-assets-jquery.slimscroll' end end
3 Add a smoke test like this
Javascripts should be packaged as libjs-<js library name> if it is not packaged already (create a new binary package in debian/control and add 'Section: web' and create libjs-<js library name>.install).
Declare dependency on libjs-<js library name> and create a <package name>.links file.
Refer to ruby-rails-assets-favico.js package for an example.