Commit b3117ee4 authored by Nicolas Bruguier's avatar Nicolas Bruguier

Initial commit.

parents
This folder contains Debian packaging template.
It will allow you to set up daily builds of your plug in Launchpad, as well as
build your plug into an installable .deb package directly
It also builds a package with debugging symbols for your plug, so your users can
use a debugger with your plug (after they install the -dbg package).
However, you'll still have to fill in some fields manually to use it.
### MAKING THIS THING WORK ###
First of all, replace the template plug name with the name of your plug:
$ cd debian; sed -i s/switchboard-plug-template/switchboard-plug-<your-plug-name-here>/g *
Without the <brackets>, of course. It will replace the name in all files.
If it complains about source not being a usual file, it's OK.
Then, open the file named "control". Replace the description templates with
actual description of your plug; don't forget to intend the long description
with space (you can already see the indentation in the template)
Finally, the hardest part: you have to specify build dependencies for your plug.
You've already specified the required libraries in CMakeLists.txt (didn't you?),
now you have to specify the Debian/Ubuntu packages that ship development files
for those libraries.
Of course, there are several ways to do it, but the easiest way (if you're on
Debian/Ubuntu) is to run the following:
$ dpkg -S /usr/lib/pkgconfig/<library-pkg-config-name>.pc
Substitute <library-pkg-config-name> with the library name you specified in
CMakeLists.txt, and the command will return the appropriate Debian package name.
Add package names for all your libs to the "Build-Depends" field in control file,
separating library names with commas.
Viola! You're done!
Oh, wait, you'll have to update copyright file too. But after all that hard work
it's a pleasure, isn't it?
### ??? PROFIT ###
To check if the packaging worked, and if you can really actually build
installable .deb files, cd to the source code directory and run
$ debuild
If it aborts with "running debsign failed" error, it means that you probably*
did everything right, and you can start reaping the benefit of having Debian
packaging.
First, you can build code into installable .deb packages right away,
which probably will save you some hassle installing/uninstalling your plug and
make installation cleaner.
Second, you can send the package over to your not-that-geeky friends and they'll
enjoy your plug too.
Third, you can set up daily builds in Launchpad using Recipes. The easiest way
is to bug somebody in #elemntary-dev on FreeNode or ask a question in
pantheon-plugs project and ask to include your plug in elementary daily builds.
* Nobody can tell if you've specified the build dependencies correctly until
you try to build the package in a build farm or installing it on a clean system
without any extra libraries installed. If you make a recipe in Launchpad and
it fails to build, you probably forgot some build dependency. Examine the build
log, it holds the key.
### WHEN ALL ELSE FAILS ###
If you have trouble using this thing, come bug me in #elementary-dev on FreeNode
-- Sergey "Shnatsel" Davidoff
switchboard-plug-pantheon-shell (0.2.1) trusty; urgency=medium
* New upstream release.
-- Cody Garver <cody@elementary.io> Tue, 01 Sep 2015 10:10:21 -0500
switchboard-plug-pantheon-shell (0.2.0.3) trusty; urgency=medium
* New translations.
-- Cody Garver <cody@elementary.io> Sun, 02 Aug 2015 19:00:29 -0500
switchboard-plug-pantheon-shell (0.2.0.2) trusty; urgency=medium
* New upstream release.
-- Cody Garver <cody@elementary.io> Tue, 14 Jul 2015 17:40:16 -0500
switchboard-plug-pantheon-shell (0.2.0.1) trusty; urgency=medium
* Adapt to Plank's "Monitor" settings change
-- Cody Garver <cody@elementaryos.org> Wed, 08 Apr 2015 19:05:22 -0500
switchboard-plug-pantheon-shell (0.2.0) trusty; urgency=medium
* New upstream release.
-- Cody Garver <cody@elementaryos.org> Mon, 06 Apr 2015 20:24:06 -0500
switchboard-plug-pantheon-shell (0.1.3) trusty; urgency=low
* New upstream release.
-- Corentin Noël <tintou@mailoo.org> Mon, 14 Apr 2014 21:56:22 +0200
switchboard-plug-pantheon-shell (0.1.2) precise; urgency=low
* New upstream release.
-- Cody Garver <cody@elementaryos.org> Sat, 10 Aug 2013 23:55:23 -0500
switchboard-plug-pantheon-shell (0.1.1) precise; urgency=low
* New upstream release.
-- Cody Garver <cody@elementaryos.org> Sun, 09 Jun 2013 19:35:39 -0500
switchboard-plug-pantheon-shell (0.1) unstable; urgency=low
* Initial Release.
-- Sergey "Shnatsel" Davidoff <shnatsel@gmail.com> Sun, 11 Dec 2011 02:45:48 +0300
9
\ No newline at end of file
Source: switchboard-plug-pantheon-shell
Section: x11
Priority: optional
Maintainer: Sergey "Shnatsel" Davidoff <shnatsel@gmail.com>
Build-Depends: cmake (>= 2.8),
debhelper (>= 9),
libgnome-desktop-3-dev,
libgranite-dev,
libgtk-3-dev (>= 3.14),
libplank-dev,
libswitchboard-2.0-dev,
valac (>= 0.26)
Standards-Version: 3.9.5
Homepage: https://launchpad.net/pantheon-plugs
Package: switchboard-plug-pantheon-shell
Architecture: any
Depends: gala, slingshot-launcher, ${misc:Depends}, ${shlibs:Depends}
Pre-Depends: dpkg (>= 1.15.6)
Recommends: plank
Enhances: switchboard
Conflicts: switchboard-plug-wallpaper
Replaces: switchboard-plug-wallpaper
Description: Change desktop settings
Switchboard plug for controlling Pantheon Shell.
Package: switchboard-plug-pantheon-shell-dbg
Architecture: any
Section: debug
Priority: extra
Depends: switchboard-plug-pantheon-shell (= ${binary:Version}), ${misc:Depends}
Pre-Depends: dpkg (>= 1.15.6)
Enhances: switchboard-plug-pantheon-shell
Description: Change desktop settings (debugging symbols)
Switchboard plug for controlling Pantheon Shell.
.
This package contains debugging symbols for switchboard-plug-template.
Format: http://dep.debian.net/deps/dep5
Upstream-Name: switchboard-plug-pantheon-shell
Source: https://launchpad.net/switchboard-plug-pantheon-shell
Files: *
Copyright: 2011-2014 elementary LLC.
License: GPL-3.0
This program is free software; you can redistribute it and/or modify it under
the terms of the GNU General Public License as published by the Free Software
Foundation, either version 3 of the License, or (at your option) any later
version.
.
This program is distributed in the hope that it will be useful, but WITHOUT ANY
WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A
PARTICULAR PURPOSE. See the GNU General Public License for more details.
.
You should have received a copy of the GNU General Public License along with
this program. If not, see .
.
On Debian systems, the complete text of the GNU General
Public License can be found in `/usr/share/common-licenses/GPL-3'.
Files: debian/*
Copyright: 2012 Sergey "Shnatsel" Davidoff <shnatsel@gmail.com>
License: GPL-2.0+
This program is free software; you can redistribute it
and/or modify it under the terms of the GNU General Public
License as published by the Free Software Foundation; either
version 2 of the License, or (at your option) any later
version.
.
This program is distributed in the hope that it will be
useful, but WITHOUT ANY WARRANTY; without even the implied
warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR
PURPOSE. See the GNU General Public License for more
details.
.
You should have received a copy of the GNU General Public
License along with this package; if not, write to the Free
Software Foundation, Inc., 51 Franklin St, Fifth Floor,
Boston, MA 02110-1301 USA
.
On Debian systems, the full text of the GNU General Public
License version 2 can be found in the file
`/usr/share/common-licenses/GPL-2'.
#!/usr/bin/make -f
# -*- makefile -*-
# Sample debian/rules that uses debhelper.
# This file was originally written by Joey Hess and Craig Small.
# As a special exception, when this file is copied by dh-make into a
# dh-make output file, you may use that output file without restriction.
# This special exception was added by Craig Small in version 0.37 of dh-make.
# Uncomment this to turn on verbose mode.
#export DH_VERBOSE=1
%:
dh $@
override_dh_strip:
dh_strip --dbg-package=switchboard-plug-pantheon-shell-dbg
override_dh_builddeb:
dh_builddeb -- -Zxz
\ No newline at end of file
Markdown is supported
0% or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment