QuicklyTips

Differences between revisions 4 and 5
Revision 4 as of 2012-04-14 09:22:02
Size: 1536
Editor: 140
Comment:
Revision 5 as of 2012-05-03 18:03:48
Size: 3788
Editor: static-50-53-5-218
Comment:
Deletions are marked like this. Additions are marked like this.
Line 15: Line 15:
=== myapp.desktop.in ===

Change the file path for Exec, by adding "/opt/extras.ubuntu.com/myapp/" before the app binary.

=== debian/changelog ===

Quickly will make a number of entries in this file. For release, these need to be collapsed down into one entry. Add the string "-0extras12.04.1" to the version number, and make sure the target is the current release, "precise". The file will look something like this:

{{{
myapp (0.1-0extras12.04.1) precise; urgency=low

  * New release.

 -- My Name <myname@example.com> Sun, 01 Apr 2012 21:26:25 +0530
}}}

=== debian/compat ===

This file contains a single number, change it from "6" to "8".

=== debian/control ===

Update the debhelper version in Build-Depends to "8". Remove cdbs and python-support from Build-Depends. (You can see http://wiki.debian.org/Python/TransitionToDHPython2 for more details on why python-support is no longer used.) Update the Standards-Version to 3.9.3. Remove the lines for XS-Python-Version and XB-Python-Version. Add the required metadata for the Software Center: XB-AppName, XB-Icon, XB-Screenshot-URL, and XB-Category (see the [[AppReviewBoard/Submissions/PackageQuickStart#control_file|packaging quick start guide]] for more details on these)
Line 21: Line 45:
Delete the two extra `Copyright:` lines (they have random extra text at the end of the line that looks like "</property>"). Add angle brackets around the email address in the remaining `Copyright:` line. Delete the extra `Copyright:` lines, leaving only one. It should show the years, your name, and your email address.
Line 24: Line 48:

The final file should look something like this example:
Line 39: Line 65:
=== debian/changelog === === debian/rules ===

Completely replace the contents of the debian/rules file. The new file will look like this example:

{{{
#!/usr/bin/make -f

PKGDIR=opt/extras.ubuntu.com/myapp

 %:
        dh $@

 override_dh_auto_install:
        dh_auto_install -- --install-lib=/$(PKGDIR)/ --install-scripts=/$(PKGDIR)/bin/ --install-data=/$(PKGDIR)/

 override_dh_gencontrol:
        dh_gencontrol
        cp data/media/myapp.png ../myapp.png
        dpkg-distaddfile myapp.png raw-meta-data -
}}}

You can see the [[https://wiki.ubuntu.com/AppReviewBoard/Submissions/PackageQuickStart#rules_file| packaging quick start guide]] for more details on the contents of the debian/rules file.

=== debian/source/format ===

Add a directory named "source" in the debian/ directory, and add a single text file in the directory. The text in the file is the simple string "3.0 (native)".

=== data/media ===

You need to add a PNG formatted icon for the Software Center to this directory. You can use the one you submitted to MyApps.

Quickly is a tool for creating new applications from scratch. For more information, see the Quickly guide.

If your app is written in Quickly, run:

quickly tutorial ubuntu-application

for details on how to release to your PPA with a single command.

Fixes for Extras Apps

Currently, apps packaged with Quickly need several changes before the ARB can publish them. Quickly is a little behind the current ARB requirements, but will be updated in future releases. These are the files that need to be edited:

myapp.desktop.in

Change the file path for Exec, by adding "/opt/extras.ubuntu.com/myapp/" before the app binary.

debian/changelog

Quickly will make a number of entries in this file. For release, these need to be collapsed down into one entry. Add the string "-0extras12.04.1" to the version number, and make sure the target is the current release, "precise". The file will look something like this:

myapp (0.1-0extras12.04.1) precise; urgency=low

  * New release.

 -- My Name <myname@example.com>  Sun, 01 Apr 2012 21:26:25 +0530

debian/compat

This file contains a single number, change it from "6" to "8".

debian/control

Update the debhelper version in Build-Depends to "8". Remove cdbs and python-support from Build-Depends. (You can see http://wiki.debian.org/Python/TransitionToDHPython2 for more details on why python-support is no longer used.) Update the Standards-Version to 3.9.3. Remove the lines for XS-Python-Version and XB-Python-Version. Add the required metadata for the Software Center: XB-AppName, XB-Icon, XB-Screenshot-URL, and XB-Category (see the packaging quick start guide for more details on these)

debian/copyright

Change Format-Specification: to Format: and update the URL to the current version of the spec "http://www.debian.org/doc/packaging-manuals/copyright-format/1.0/"

Change Name: to Upstream-Name:. Change Maintainer: to Upstream-Contact:.

Delete the extra Copyright: lines, leaving only one. It should show the years, your name, and your email address.

Duplicate the License: line, with an extra line between the two.

The final file should look something like this example:

Format: http://www.debian.org/doc/packaging-manuals/copyright-format/1.0/
Upstream-Name: myapp
Upstream-Contact: My Name <myname@example.com>
Source: https://code.launchpad.net/~myname/+junk/extras-myapp-oneiric

Files: *
Copyright: 2011-2012 My Name <myname@example.com>
License: GPL-3.0+

License: GPL-3.0+
 This program is free software...

debian/rules

Completely replace the contents of the debian/rules file. The new file will look like this example:

PKGDIR=opt/extras.ubuntu.com/myapp

 %:
        dh $@

 override_dh_auto_install:
        dh_auto_install -- --install-lib=/$(PKGDIR)/ --install-scripts=/$(PKGDIR)/bin/ --install-data=/$(PKGDIR)/

 override_dh_gencontrol:
        dh_gencontrol
        cp data/media/myapp.png ../myapp.png
        dpkg-distaddfile myapp.png raw-meta-data -

You can see the packaging quick start guide for more details on the contents of the debian/rules file.

debian/source/format

Add a directory named "source" in the debian/ directory, and add a single text file in the directory. The text in the file is the simple string "3.0 (native)".

data/media

You need to add a PNG formatted icon for the Software Center to this directory. You can use the one you submitted to MyApps.

AppReviewBoard/Submissions/QuicklyTips (last edited 2012-07-07 07:17:24 by dpm)