Q&A Porting to Fremantle - Revision history

imported_>dneary: Redirecting to Developer FAQ#Porting to Fremantle

2009-11-11T17:53:06Z

Redirecting to Developer FAQ#Porting to Fremantle

← Older revision		Revision as of 17:53, 11 November 2009
Line 1:		Line 1:
	#REDIRECT [[Developer FAQ]]		#REDIRECT [[Developer FAQ#Porting_to_Fremantle]]

imported_>dneary: Redirecting to Developer FAQ

2009-11-11T17:50:57Z

Redirecting to Developer FAQ

← Older revision		Revision as of 17:50, 11 November 2009
Line 1:		Line 1:
	[[~~Category:Development]][[Category:Fremantle]]~~		#REDIRECT [[Developer FAQ]]


	~~This page is intended to consolidate the common errors that occur while trying to port Diablo applications to Fremantle. Feel free to improve this page and/or add additional information.~~

	~~==maemo-select-menu-location: command not found==~~

	~~'''Typical error message'''~~
	~~scratchbox/tools/bin/sh: line 1: /usr/sbin/dpkg-preconfigure: No such file or directory~~
	~~Setting up leafpad (0.8.16le-0maemo2) ...~~
	~~gtk-update-icon-cache: Cache file created successfully.~~
	~~/var/lib/dpkg/info/leafpad.postinst: line 7: maemo-select-menu-location: command not found~~
	~~dpkg: error processing leafpad (--configure): subprocess post-installation script returned error exit status 127~~

	~~'''Reason'''~~

	~~maemo-select-menu-location is obsolete.~~
	~~In Fremantle, there is no submenu like, "Utility", "Extra", "Settings" etc. All installed 3rd party software will be visible under "Applications" by default.~~

	~~'''Action'''~~
	~~Remove the instance from the post installation script. It is not needed.~~


	~~==Missing dependency: maemo-installer-utils==~~
	~~'''Reason'''~~

	The package hildon-application-manager no longer "provides" ''maemo-installer-utils''. The commands ''maemo-confirm-text'', ''maemo-application-running'', ''maemo-list-user-packages'' are still available.

	~~'''Action'''~~

	~~Replace the dependency with hildon-application-manager.~~


	~~==Missing dependency: libhildonhelp0==~~
	~~'''Reason'''~~

	~~libhildonhelp is dropped.~~

	~~'''Action'''~~

	~~Remove the dependency and calls to the help APIs.~~


	~~==Limitation of Home Area applets==~~
	~~Unlike Diablo in Fremantle these applets don't support text input, pannable areas, resizing nor scrolling.~~

	~~'''Reason'''~~

	~~Framework limitations.~~

	~~'''Action'''~~

	Replace text input fields with dialogs. Use buttons for scrolling. Add resizing options in the settings dialog or adapt the UI of the applet regarding to that. For further information on how to develop those applets, please check the [http://wiki.maemo.org/Documentation/Maemo_5_Developer_Guide/Application_Development/Writing_Desktop_Widgets documentation].


	~~==What icon size should be used?==~~
	~~With Fremantle the size specifications of the icons are different from Diablo:~~

	~~'''Application Manager'''~~
	* Icon size: HILDON_ICON_SIZE_FINGER.
	* In Gimp or Photoshop: 48x48 pixels

	~~'''Task Launcher'''~~
	* Icon size: HILDON_ICON_SIZE_THUMB.
	* In Gimp or Photoshop: 64x64 pixels


	~~Using icons for the task launcher, please remember to run the following in your postinst file:~~

	~~gtk-update-icon-cache -f /usr/share/icons/hicolor~~

	~~==Text and icons in dialogs==~~

	~~'''Problem'''~~

	~~The text in dialog boxes is not formatted correctly (truncated on the right size), when a icon is in place.~~

	~~'''Action'''~~

	~~In general icons should not be used in dialogs in Fremantle. Remove the icon and the text will be formatted correctly.~~

	~~==Initialisation scripts==~~

	~~'''Problem'''~~

	~~Initialisation scripts don't work any more.~~

	~~'''Reason'''~~

	~~Fremantle has switched to using '''upstart''' for system initialisation.~~

	~~'''Action'''~~

	Create '''upstart''' job definitions instead of init scripts. Information on writing these can be found on http://upstart.ubuntu.com/getting-started.html. However, be aware that the directory used on Maemo 5 is ''/etc/event.d''.

	The job script should be placed in /etc/event,d/''package''. And the package postinst, prerm and postrm should use the ''start --quiet'' and ''stop --quiet'' commands to start and stop the service. Unfortunately there is no debhelper tool to assist with this.

	~~== What can I do if my question is not mentioned here? ==~~

	~~# Look if it is discussed already in one of the mailing lists or in [http://talk.maemo.org talk.maemo.org~~]
	~~# If not post your question in the developer mailing list or in talk~~
	~~# If you find the answer and you think it could be interesting for others as well post it here, so that we just have to point on this page in the future if the question pops up again.~~

imported_>danielwilms: /* What icon size should be used? */

2009-09-25T07:18:16Z

What icon size should be used?

← Older revision		Revision as of 07:18, 25 September 2009
Line 65:		Line 65:
	* In Gimp or Photoshop: 64x64 pixels		* In Gimp or Photoshop: 64x64 pixels


			Using icons for the task launcher, please remember to run the following in your postinst file:

			gtk-update-icon-cache -f /usr/share/icons/hicolor

	==Text and icons in dialogs==		==Text and icons in dialogs==

imported_>andre: /* Text and icons in dialogs */

2009-09-21T08:18:46Z

Text and icons in dialogs

← Older revision		Revision as of 08:18, 21 September 2009
Line 70:		Line 70:
	'''Problem'''		'''Problem'''

	The text in dialog boxes is not formatted correctly, when a icon is in place.		The text in dialog boxes is not formatted correctly (truncated on the right size), when a icon is in place.

	'''Action'''		'''Action'''

	In general icons should not be used in dialogs in Fremantle. Remove the icon and the text will be formatted correctly.		In general icons should not be used in dialogs in Fremantle. Remove the icon and the text will be formatted correctly.



	==Initialisation scripts==		==Initialisation scripts==

imported_>danielwilms at 07:38, 21 September 2009

2009-09-21T07:38:13Z

@@ Line 64: / Line 64: @@
 * Icon size: HILDON_ICON_SIZE_THUMB.
 * In Gimp or Photoshop: 64x64 pixels
 ==Initialisation scripts==

imported_>gcobb: Add upstart info

2009-09-15T19:55:30Z

Add upstart info

@@ Line 64: / Line 64: @@
 * Icon size: HILDON_ICON_SIZE_THUMB.
 * In Gimp or Photoshop: 64x64 pixels
 == What can I do if my question is not mentioned here? ==

imported_>danielwilms: /* What icon size should be used? */

2009-08-31T15:43:27Z

What icon size should be used?

← Older revision		Revision as of 15:43, 31 August 2009
Line 61:		Line 61:
	* In Gimp or Photoshop: 48x48 pixels		* In Gimp or Photoshop: 48x48 pixels

			'''Task Launcher'''
			* Icon size: HILDON_ICON_SIZE_THUMB.
			* In Gimp or Photoshop: 64x64 pixels

	== What can I do if my question is not mentioned here? ==		== What can I do if my question is not mentioned here? ==

imported_>danielwilms at 15:38, 31 August 2009

2009-08-31T15:38:50Z

← Older revision		Revision as of 15:38, 31 August 2009
Line 52:		Line 52:

	Replace text input fields with dialogs. Use buttons for scrolling. Add resizing options in the settings dialog or adapt the UI of the applet regarding to that. For further information on how to develop those applets, please check the [http://wiki.maemo.org/Documentation/Maemo_5_Developer_Guide/Application_Development/Writing_Desktop_Widgets documentation].		Replace text input fields with dialogs. Use buttons for scrolling. Add resizing options in the settings dialog or adapt the UI of the applet regarding to that. For further information on how to develop those applets, please check the [http://wiki.maemo.org/Documentation/Maemo_5_Developer_Guide/Application_Development/Writing_Desktop_Widgets documentation].


			==What icon size should be used?==
			With Fremantle the size specifications of the icons are different from Diablo:

			'''Application Manager'''
			* Icon size: HILDON_ICON_SIZE_FINGER.
			* In Gimp or Photoshop: 48x48 pixels


	== What can I do if my question is not mentioned here? ==		== What can I do if my question is not mentioned here? ==

imported_>danielwilms: /* Limitation of Home Area applets */

2009-08-07T10:54:56Z

Limitation of Home Area applets

← Older revision		Revision as of 10:54, 7 August 2009
Line 43:		Line 43:

	==Limitation of Home Area applets==		==Limitation of Home Area applets==
	Unlike Diablo in Fremantle these applets don't support text input, pannable areas or scrolling.		Unlike Diablo in Fremantle these applets don't support text input, pannable areas, resizing nor scrolling.

	'''Reason'''		'''Reason'''
Line 51:		Line 51:
	'''Action'''		'''Action'''

	Replace text input fields with dialogs. Use buttons for scrolling. For further information on how to develop those applets, please check the [http://wiki.maemo.org/Documentation/Maemo_5_Developer_Guide/Application_Development/Writing_Desktop_Widgets documentation].		Replace text input fields with dialogs. Use buttons for scrolling. Add resizing options in the settings dialog or adapt the UI of the applet regarding to that. For further information on how to develop those applets, please check the [http://wiki.maemo.org/Documentation/Maemo_5_Developer_Guide/Application_Development/Writing_Desktop_Widgets documentation].



	== What can I do if my question is not mentioned here? ==		== What can I do if my question is not mentioned here? ==

imported_>danielwilms at 10:06, 7 August 2009

2009-08-07T10:06:11Z

← Older revision		Revision as of 10:06, 7 August 2009
Line 40:		Line 40:

	Remove the dependency and calls to the help APIs.		Remove the dependency and calls to the help APIs.


			==Limitation of Home Area applets==
			Unlike Diablo in Fremantle these applets don't support text input, pannable areas or scrolling.

			'''Reason'''

			Framework limitations.

			'''Action'''

			Replace text input fields with dialogs. Use buttons for scrolling. For further information on how to develop those applets, please check the [http://wiki.maemo.org/Documentation/Maemo_5_Developer_Guide/Application_Development/Writing_Desktop_Widgets documentation].