Maemo packaging - Revision history

imported_>amigadave: redirect to Packcaging after merge

2010-01-26T13:53:59Z

redirect to Packcaging after merge

← Older revision		Revision as of 13:53, 26 January 2010
Line 1:		Line 1:
	Maemo packaging is generally similar to Debian packaging, with a few small differences, this article aims to illustrate some of those differences and aggregate the various resources on Maemo packaging.		#REDIRECT [[Packaging]]

	~~== Packaging policy ==~~

	Most of the specifics for Maemo packaging are outlined in the [http://maemo.org/forrest-images/pdf/maemo-policy.pdf Maemo packaging policy]. The policy is still in the draft stage, though, so certain parts are still incomplete or not entirely up to date.

	~~== Sections ==~~
	This is the list used in Fremantle/Maemo5 and is the same as the [http://lists.maemo.org/pipermail//maemo-developers/2008-October/035437.html final] list for Diablo as [[Task:Package_categories\|discussed in the task]].

	~~{\| class="wikitable"~~
	~~! Key~~
	~~! Example English i18n~~
	~~! Example apps~~
	\|-
	~~\| user/desktop~~
	~~\| Desktop~~
	~~\| Home, statusbar and taskbar applets~~
	\|-
	~~\| user/development~~
	~~\| Programming~~
	~~\| py2deb~~
	\|-
	~~\| user/education~~
	~~\| Education~~
	~~\| Flashcard apps~~
	\|-
	~~\| user/games~~
	~~\| Games~~
	~~\| Doom, Duke Nukem 3D~~
	\|-
	~~\| user/graphics~~
	~~\| Graphics~~
	~~\| Photo apps, GIMP, Inkscape, fonts~~
	\|-
	~~\| user/multimedia~~
	~~\| Multimedia ''or'' Sound & Video~~
	~~\| Canola, mplayer, Kagu, UKMP, MediaBox~~
	\|-
	~~\| user/navigation~~
	~~\| (Location &) Navigation~~
	~~\| maemo-mapper, Navit~~
	\|-
	~~\| user/network~~
	~~\| Internet & Networking~~
	~~\| Web browsers, Samba clients, OpenAFS, Transmission~~
	\|-
	~~\| user/office~~
	~~\| Office~~
	~~\| GPE, Claws, AbiWord~~
	\|-
	~~\| user/science~~
	~~\| Science~~
	~~\| gnuplot, Octave~~
	\|-
	~~\| user/system~~
	~~\| System~~
	~~\| rotation-support, enhanced kernels, themes~~
	\|-
	~~\| user/utilities~~
	~~\| Utilities ''or'' Accessories~~
	~~\| Calculators, terminals, text editors~~
	\|-
	\|}

	~~If the package's section starts "user/", but is not any of the above, the ''Application Manager'' forces them into an "Other" section.~~

	~~== Maemo-specific fields ==~~

	There are a number of Maemo-specific package fields that are handled by Application manager. The Application manager documentation [http://hildon-app-mgr.garage.maemo.org/packaging-stable.html outlines] them.

	~~== Displaying an icon in the Application Manager next to your package ==~~

	~~Displaying an icon in the Application Manager next to your package makes it look pretty and makes your package stand out, and it is not that hard to do.~~

	~~# Make an image that is '''48x48'''. The image can be saved in any format that is supported by GdkPixbufLoader on Maemo, but PNG is commonly used and suffices fine.~~
	~~# base64 encode the image. This can be done in many ways, depending on the platform, but I'll assume you are in scratchbox.~~
	~~<pre>~~
	~~apt-get update~~
	~~apt-get install sharutils~~
	~~uuencode -m <name of 48x48 image> <name of 48x48 image> > <name of 48x48 image>.base64~~
	~~</pre>~~
	~~# Add the field ''XB-Maemo-Icon-26'' to your debian/control (in Maemo4 the size of the icons was 26x26, hence the name of the field, '''which has not changed''')~~
	~~# Open the base64 version of your image and copy from the line under ''begin-base64 644 <name of 48x48 image>'' to the line above the ''===''~~
	# ~~Add this to the ''XB-Maemo-Icon-26'' field.~~
	~~# Add a space in front of every line of the encoded icon.~~

	~~Here is an example of a properly formatted Maemo-Icon-26: (of wrong image size)~~
	~~<pre>~~
	~~Description: Chess...~~
	~~XB-Maemo-Icon-26:~~
	~~iVBORw0KGgoAAAANSUhEUgAAABoAAAAaCAYAAACpSkzOAAAABGdBTUEAAK/INwWK6QAAABl0~~
	~~RVh0U29mdHdhcmUAQWRvYmUgSW1hZ2VSZWFkeXHJZTwAAALxSURBVHja3FZNTBNREP669J/S~~
	~~XYxtKRWl1JOSFBIPhkitCQeNiaKBmzdj9Ggk0ZOBxHDWixcTjV6MF+WiIB40YEyMBMGYEqQK~~
	~~tLS2lG7pdre0pF3WtxslgJRuD2J0kpfdTN7O976Z782sRpIk7IZR2C2TGW1cv8xaY5WuXLy8~~
	~~iW5XV5fk8/kkr9e7ya/T6SSNRiOViikvbbmDDD590SusZBGYDiDwJbDud7vdvYIgIJfLYXV1~~
	~~tSwhrQrSfRX6/26N/j+gkjW6ce06HE4HGEctGuj9oEwUzFYz5ubmEA6HQVEUisUi8vn8b4rd~~
	~~zjRbNxCZrr+3t7XTzjrnvMfdxMi7xj6OIRaPIbWcQjabVdRWKBTkrX4SZ2SjvCtKXf+tkxxD~~
	~~M5MetwfHj/lwwueHy+WCVqvdehdHKq7R6JvbpfNMAGiGhs1mg9ls3sS+4hodbDqCwef9mA9P~~
	~~7vhhVVWV3BGUOomiaCSufEWMxNwimlweMFYbpoMfyp70J6t8xanLZgWs8Ak07N0Hau0P3qOs~~
	~~wIHnl5FJx2E1WlUFuXrzIS713KusRplMCoLAgl2O4N34ODQ4VRaot6cbUzMRNNQ/w/uJWXWM~~
	~~eH5JARkYHsLQMIe1NZEpB7Sn1uKFhkL3maO4cL5NHVAo+hkPnrzEq2HqQIf/3ICzvr7FXmeH~~
	~~3qBXlslkgtFoVBS3YfbcKRRFfJpagE6vUwd0//FbjI7mkcvnGoNfg51ORx3sNju+hWYxMxsk~~
	~~jHlF2jJgdXU1DAaDrDx/kQAVRREJlldXo8kJoPlQ8wHSevosFgs5MmE5H0IingDP8eAzPAQC~~
	~~tkJakDz05Hsks+poPzwg6+Luo9chVb2O3Hilv7V6W5nO02cVX3wxjsj3CMKRBUSjUcQWY0iy~~
	~~SQVoi6XJaiQxubKpI02yj2xk6BoaBr0BqXRKCZpYSiCZlIXCguM4pWtvY0ypyUtt87PSIj/t~~
	~~pJ/JICzLKiBLySTYVArpdFrp3DuMhRZVqfvnJ+wPAQYA1hdr5EDqltYAAAAASUVORK5CYII=~~
	~~</pre>~~

	[[~~Category:Development~~]]

91.8.141.116: changed image size from 26x26 to 48x48 everywhere but in the field names

2010-01-08T19:10:48Z

changed image size from 26x26 to 48x48 everywhere but in the field names

← Older revision		Revision as of 19:10, 8 January 2010
Line 73:		Line 73:
	Displaying an icon in the Application Manager next to your package makes it look pretty and makes your package stand out, and it is not that hard to do.		Displaying an icon in the Application Manager next to your package makes it look pretty and makes your package stand out, and it is not that hard to do.

	'''~~These instructions are for Maemo4. For Maemo5 (Fremantle), the icons should be~~ 48x48 ~~but the field name is still '~~'~~XB-Maemo-Icon-26~~''~~.'''~~		# Make an image that is '''48x48'''. The image can be saved in any format that is supported by GdkPixbufLoader on Maemo, but PNG is commonly used and suffices fine.

	~~# Make an image that is 26x26~~. The image can be saved in any format that is supported by GdkPixbufLoader on Maemo, but PNG is commonly used and suffices fine.
	# base64 encode the image. This can be done in many ways, depending on the platform, but I'll assume you are in scratchbox.		# base64 encode the image. This can be done in many ways, depending on the platform, but I'll assume you are in scratchbox.
	<pre>		<pre>
	apt-get update		apt-get update
	apt-get install sharutils		apt-get install sharutils
	uuencode -m <name of ~~26x26~~ image> <name of ~~26x26~~ image> > <name of ~~26x26~~ image>.base64		uuencode -m <name of 48x48 image> <name of 48x48 image> > <name of 48x48 image>.base64
	</pre>		</pre>
	# Add the field ''XB-Maemo-Icon-26'' to your debian/control		# Add the field ''XB-Maemo-Icon-26'' to your debian/control (in Maemo4 the size of the icons was 26x26, hence the name of the field, '''which has not changed''')
	# Open the base64 version of your image and copy from the line under ''begin-base64 644 <name of ~~26x26~~ image>'' to the line above the ''===''		# Open the base64 version of your image and copy from the line under ''begin-base64 644 <name of 48x48 image>'' to the line above the ''===''
	# Add this to the ''XB-Maemo-Icon-26'' field.		# Add this to the ''XB-Maemo-Icon-26'' field.
	# Add a space in front of every line of the encoded icon.		# Add a space in front of every line of the encoded icon.

	Here is an example of a properly formatted Maemo-Icon-26:		Here is an example of a properly formatted Maemo-Icon-26: (of wrong image size)
	<pre>		<pre>
	Description: Chess...		Description: Chess...

97.93.198.210: /* Displaying an icon in the Application Manager next to your package */

2009-12-23T01:24:03Z

Displaying an icon in the Application Manager next to your package

← Older revision		Revision as of 01:24, 23 December 2009
Line 90:		Line 90:
	<pre>		<pre>
	Description: Chess...		Description: Chess...
	Maemo-Icon-26:		XB-Maemo-Icon-26:
	iVBORw0KGgoAAAANSUhEUgAAABoAAAAaCAYAAACpSkzOAAAABGdBTUEAAK/INwWK6QAAABl0		iVBORw0KGgoAAAANSUhEUgAAABoAAAAaCAYAAACpSkzOAAAABGdBTUEAAK/INwWK6QAAABl0
	RVh0U29mdHdhcmUAQWRvYmUgSW1hZ2VSZWFkeXHJZTwAAALxSURBVHja3FZNTBNREP669J/S		RVh0U29mdHdhcmUAQWRvYmUgSW1hZ2VSZWFkeXHJZTwAAALxSURBVHja3FZNTBNREP669J/S

imported_>flandry: Seriously. LOL :P

2009-12-17T00:47:53Z

Seriously. LOL :P

← Older revision		Revision as of 00:47, 17 December 2009
Line 73:		Line 73:
	Displaying an icon in the Application Manager next to your package makes it look pretty and makes your package stand out, and it is not that hard to do.		Displaying an icon in the Application Manager next to your package makes it look pretty and makes your package stand out, and it is not that hard to do.

	These instructions are for Maemo4. For Maemo5 (Fremantle), the icons should be 48x48.		'''These instructions are for Maemo4. For Maemo5 (Fremantle), the icons should be 48x48 but the field name is still ''XB-Maemo-Icon-26''.'''

	# Make an image that is 26x26. The image can be saved in any format that is supported by GdkPixbufLoader on Maemo, but PNG is commonly used and suffices fine.		# Make an image that is 26x26. The image can be saved in any format that is supported by GdkPixbufLoader on Maemo, but PNG is commonly used and suffices fine.
Line 85:		Line 85:
	# Open the base64 version of your image and copy from the line under ''begin-base64 644 <name of 26x26 image>'' to the line above the ''===''		# Open the base64 version of your image and copy from the line under ''begin-base64 644 <name of 26x26 image>'' to the line above the ''===''
	# Add this to the ''XB-Maemo-Icon-26'' field.		# Add this to the ''XB-Maemo-Icon-26'' field.
			# Add a space in front of every line of the encoded icon.

	Here is an example of a properly formatted Maemo-Icon-26:		Here is an example of a properly formatted Maemo-Icon-26:

imported_>flandry: Maemo5 uses 48x48 icons

2009-12-17T00:34:34Z

Maemo5 uses 48x48 icons

← Older revision		Revision as of 00:34, 17 December 2009
Line 72:		Line 72:

	Displaying an icon in the Application Manager next to your package makes it look pretty and makes your package stand out, and it is not that hard to do.		Displaying an icon in the Application Manager next to your package makes it look pretty and makes your package stand out, and it is not that hard to do.

			These instructions are for Maemo4. For Maemo5 (Fremantle), the icons should be 48x48.

	# Make an image that is 26x26. The image can be saved in any format that is supported by GdkPixbufLoader on Maemo, but PNG is commonly used and suffices fine.		# Make an image that is 26x26. The image can be saved in any format that is supported by GdkPixbufLoader on Maemo, but PNG is commonly used and suffices fine.

imported_>twaelti: /* Sections */ updated with the final diablo/fremantle list

2009-10-19T19:56:26Z

Sections: updated with the final diablo/fremantle list

@@ Line 6: / Line 6: @@
 == Sections ==
-{{main|Task:Package categories}}
+This is the list used in Fremantle/Maemo5 and is the same as the [http://lists.maemo.org/pipermail//maemo-developers/2008-October/035437.html final] list for Diablo as [[Task:Package_categories|discussed in the task]].
-Package sections are still under discussion, a stable section list is expected for Fremantle.
 == Maemo-specific fields ==

imported_>generalantilles at 08:09, 18 April 2009

2009-04-18T08:09:01Z

← Older revision		Revision as of 08:09, 18 April 2009
Line 12:		Line 12:

	There are a number of Maemo-specific package fields that are handled by Application manager. The Application manager documentation [http://hildon-app-mgr.garage.maemo.org/packaging-stable.html outlines] them.		There are a number of Maemo-specific package fields that are handled by Application manager. The Application manager documentation [http://hildon-app-mgr.garage.maemo.org/packaging-stable.html outlines] them.


	== Displaying an icon in the Application Manager next to your package ==		== Displaying an icon in the Application Manager next to your package ==

imported_>qwerty12: Add icon section

2009-04-17T11:05:43Z

Add icon section

← Older revision		Revision as of 11:05, 17 April 2009
Line 13:		Line 13:
	There are a number of Maemo-specific package fields that are handled by Application manager. The Application manager documentation [http://hildon-app-mgr.garage.maemo.org/packaging-stable.html outlines] them.		There are a number of Maemo-specific package fields that are handled by Application manager. The Application manager documentation [http://hildon-app-mgr.garage.maemo.org/packaging-stable.html outlines] them.


			== Displaying an icon in the Application Manager next to your package ==

			Displaying an icon in the Application Manager next to your package makes it look pretty and makes your package stand out, and it is not that hard to do.

			# Make an image that is 26x26. The image can be saved in any format that is supported by GdkPixbufLoader on Maemo, but PNG is commonly used and suffices fine.
			# base64 encode the image. This can be done in many ways, depending on the platform, but I'll assume you are in scratchbox.
			<pre>
			apt-get update
			apt-get install sharutils
			uuencode -m <name of 26x26 image> <name of 26x26 image> > <name of 26x26 image>.base64
			</pre>
			# Add the field ''XB-Maemo-Icon-26'' to your debian/control
			# Open the base64 version of your image and copy from the line under ''begin-base64 644 <name of 26x26 image>'' to the line above the ''===''
			# Add this to the ''XB-Maemo-Icon-26'' field.

			Here is an example of a properly formatted Maemo-Icon-26:
			<pre>
			Description: Chess...
			Maemo-Icon-26:
			iVBORw0KGgoAAAANSUhEUgAAABoAAAAaCAYAAACpSkzOAAAABGdBTUEAAK/INwWK6QAAABl0
			RVh0U29mdHdhcmUAQWRvYmUgSW1hZ2VSZWFkeXHJZTwAAALxSURBVHja3FZNTBNREP669J/S
			XYxtKRWl1JOSFBIPhkitCQeNiaKBmzdj9Ggk0ZOBxHDWixcTjV6MF+WiIB40YEyMBMGYEqQK
			tLS2lG7pdre0pF3WtxslgJRuD2J0kpfdTN7O976Z782sRpIk7IZR2C2TGW1cv8xaY5WuXLy8
			iW5XV5fk8/kkr9e7ya/T6SSNRiOViikvbbmDDD590SusZBGYDiDwJbDud7vdvYIgIJfLYXV1
			tSwhrQrSfRX6/26N/j+gkjW6ce06HE4HGEctGuj9oEwUzFYz5ubmEA6HQVEUisUi8vn8b4rd
			zjRbNxCZrr+3t7XTzjrnvMfdxMi7xj6OIRaPIbWcQjabVdRWKBTkrX4SZ2SjvCtKXf+tkxxD
			M5MetwfHj/lwwueHy+WCVqvdehdHKq7R6JvbpfNMAGiGhs1mg9ls3sS+4hodbDqCwef9mA9P
			7vhhVVWV3BGUOomiaCSufEWMxNwimlweMFYbpoMfyp70J6t8xanLZgWs8Ak07N0Hau0P3qOs
			wIHnl5FJx2E1WlUFuXrzIS713KusRplMCoLAgl2O4N34ODQ4VRaot6cbUzMRNNQ/w/uJWXWM
			eH5JARkYHsLQMIe1NZEpB7Sn1uKFhkL3maO4cL5NHVAo+hkPnrzEq2HqQIf/3ICzvr7FXmeH
			3qBXlslkgtFoVBS3YfbcKRRFfJpagE6vUwd0//FbjI7mkcvnGoNfg51ORx3sNju+hWYxMxsk
			jHlF2jJgdXU1DAaDrDx/kQAVRREJlldXo8kJoPlQ8wHSevosFgs5MmE5H0IingDP8eAzPAQC
			tkJakDz05Hsks+poPzwg6+Luo9chVb2O3Hilv7V6W5nO02cVX3wxjsj3CMKRBUSjUcQWY0iy
			SQVoi6XJaiQxubKpI02yj2xk6BoaBr0BqXRKCZpYSiCZlIXCguM4pWtvY0ypyUtt87PSIj/t
			pJ/JICzLKiBLySTYVArpdFrp3DuMhRZVqfvnJ+wPAQYA1hdr5EDqltYAAAAASUVORK5CYII=
			</pre>

	[[Category:Development]]		[[Category:Development]]

imported_>generalantilles: Categorization

2008-10-28T05:03:45Z

Categorization

← Older revision		Revision as of 05:03, 28 October 2008
Line 12:		Line 12:

	There are a number of Maemo-specific package fields that are handled by Application manager. The Application manager documentation [http://hildon-app-mgr.garage.maemo.org/packaging-stable.html outlines] them.		There are a number of Maemo-specific package fields that are handled by Application manager. The Application manager documentation [http://hildon-app-mgr.garage.maemo.org/packaging-stable.html outlines] them.


			[[Category:Development]]

imported_>generalantilles: /* Sections */

2008-10-21T23:33:53Z

Sections

← Older revision		Revision as of 23:33, 21 October 2008
Line 7:		Line 7:
	== Sections ==		== Sections ==
	{{main\|Task:Package categories}}		{{main\|Task:Package categories}}

	Package sections are still under discussion, a stable section list is expected for Fremantle.		Package sections are still under discussion, a stable section list is expected for Fremantle.