Documentation/Maemo 5 Developer Guide/Development Environment/Maemo SDK - Revision history

46.28.100.195: /* Maemo Software Development Kit */ kinks -> links

2015-06-07T10:38:16Z

Maemo Software Development Kit: kinks -> links

← Older revision		Revision as of 10:38, 7 June 2015
Line 13:		Line 13:
	== Maemo Software Development Kit ==		== Maemo Software Development Kit ==

	The Maemo SDK creates a sandboxed Maemo development environment on a GNU/Linux desktop system largely built on a tool called [http://scratchbox.org/ Scratchbox]. In most ways, this environment behaves like the operating system on the device, but with added development tools. This means that the development process is very similar to a normal desktop GNU/Linux, and the ~~kinks~~ of embedded development, such as cross-compiling, are handled transparently by Scratchbox.		The Maemo SDK creates a sandboxed Maemo development environment on a GNU/Linux desktop system largely built on a tool called [http://scratchbox.org/ Scratchbox]. In most ways, this environment behaves like the operating system on the device, but with added development tools. This means that the development process is very similar to a normal desktop GNU/Linux, and the links of embedded development, such as cross-compiling, are handled transparently by Scratchbox.

	=== Hardware architectures ===		=== Hardware architectures ===

imported_>wikiwide: -Development; Scratchbox is already in Development, avoid Duplication

2014-12-16T02:45:34Z

-Development; Scratchbox is already in Development, avoid Duplication

← Older revision		Revision as of 02:45, 16 December 2014
Line 484:		Line 484:
	The screen is still a bit off (there are no borders around the main <code>GtkLabel</code> widget), but already looks better. The text is scaled to be more in sync with the other text sizes and the color is also in sync with the platform color (it is not gray anymore).		The screen is still a bit off (there are no borders around the main <code>GtkLabel</code> widget), but already looks better. The text is scaled to be more in sync with the other text sizes and the color is also in sync with the platform color (it is not gray anymore).

	~~[[Category:Development]]~~
	[[Category:Documentation]]		[[Category:Documentation]]
	[[Category:Fremantle]]		[[Category:Fremantle]]
	[[Category:Scratchbox]]		[[Category:Scratchbox]]

imported_>sixwheeledbeast: /* Directing Client to Virtual Server */

2013-01-21T16:41:02Z

Directing Client to Virtual Server

← Older revision		Revision as of 16:41, 21 January 2013
Line 442:		Line 442:
	[sbox-FREMANTLE_X86: ~] > ./gtk_helloworld-1		[sbox-FREMANTLE_X86: ~] > ./gtk_helloworld-1
	main: calling gtk_main		main: calling gtk_main
	[[Ctrl+c]]		[Ctrl+c]

	Use Ctrl+C to terminate the program because it does not implement any graphical methods for closing.		Use Ctrl+C to terminate the program because it does not implement any graphical methods for closing.

imported_>amigadave: /* Testing SDK Installation */ reformat images

2010-11-26T15:00:16Z

Testing SDK Installation: reformat images

← Older revision		Revision as of 15:00, 26 November 2010
Line 462:		Line 462:
	The start and stop parameters are used to start and stop the graphical environment. If everything works, it should show a screen resembling this one:		The start and stop parameters are used to start and stop the graphical environment. If everything works, it should show a screen resembling this one:

			[[Image:UI-startup.png\|frame\|center\|alt=Screenshot of SDK user interface\|SDK UI]]
	[[Image:UI-startup.png\|~~400px~~]]

	=== Running Hello World in Application Framework ===		=== Running Hello World in Application Framework ===
Line 471:		Line 470:
	[sbox-FREMANTLE_X86: ~] >./gtk_helloworld-1		[sbox-FREMANTLE_X86: ~] >./gtk_helloworld-1

	[[Image:helloworld-without-theme.png\|~~400px~~]]		[[Image:helloworld-without-theme.png\|frame\|center\|alt=Screenshot of test application showing ‘Hello World!’ in the centre of an unthemed window\|Hello world]]

	Because there now is a window manager running, the client gets much larger window to draw in. GTK+ scales the widget accordingly (there is only one widget in the program).		Because there now is a window manager running, the client gets much larger window to draw in. GTK+ scales the widget accordingly (there is only one widget in the program).
Line 481:		Line 480:
	[sbox-FREMANTLE_X86: ~] >run-standalone.sh ./gtk_helloworld-1		[sbox-FREMANTLE_X86: ~] >run-standalone.sh ./gtk_helloworld-1

	[[Image:helloworld-with-theme.png\|~~400px~~]]		[[Image:helloworld-with-theme.png\|frame\|center\|alt=Screenshot of test application showing ‘Hello World!’ in the centre of a themed window\|Themed Hello world]]

	The screen is still a bit off (there are no borders around the main <code>GtkLabel</code> widget), but already looks better. The text is scaled to be more in sync with the other text sizes and the color is also in sync with the platform color (it is not gray anymore).		The screen is still a bit off (there are no borders around the main <code>GtkLabel</code> widget), but already looks better. The text is scaled to be more in sync with the other text sizes and the color is also in sync with the platform color (it is not gray anymore).

85.183.40.96: /* Testing Scratchbox */

2010-08-31T18:08:18Z

Testing Scratchbox

← Older revision		Revision as of 18:08, 31 August 2010
Line 184:		Line 184:
	N.B. The <code>linux-gate.so.1</code> library is a so-called hack to support a certain way of doing system calls on the X86 architecture, and is not always present on newer systems.		N.B. The <code>linux-gate.so.1</code> library is a so-called hack to support a certain way of doing system calls on the X86 architecture, and is not always present on newer systems.

	When comparing the version of libc used on the real system with <~~ocde~~>ls -l</code>, it will probably show a difference (in version numbers). This means that the executables that were built inside Scratchbox use libraries that are also inside Scratchbox. This also means we have a stable development platform, which is very important, especially when working on a team where each member has their own Linux installation which they may or may not have customized. This might not seem very important at this stage, but when encountering all the different tools that are used in free software development, this feature of Scratchbox will come in handy.		When comparing the version of libc used on the real system with <code>ls -l</code>, it will probably show a difference (in version numbers). This means that the executables that were built inside Scratchbox use libraries that are also inside Scratchbox. This also means we have a stable development platform, which is very important, especially when working on a team where each member has their own Linux installation which they may or may not have customized. This might not seem very important at this stage, but when encountering all the different tools that are used in free software development, this feature of Scratchbox will come in handy.

	Scratchbox does not contain any logic to emulate the kernel (or to use a different kernel for running programs inside Scratchbox). The only easy possibility for this is using the sbrsh CPU-transparency option.		Scratchbox does not contain any logic to emulate the kernel (or to use a different kernel for running programs inside Scratchbox). The only easy possibility for this is using the sbrsh CPU-transparency option.

imported_>amigadave: use and `, tidy, wikify slightly`


2010-08-12T07:01:37Z
use <source> and <code>, tidy, wikify slightly
Show changes



imported_>amigadave: /* Installing SDK */ links
2010-04-08T13:02:23Z
Installing SDK:  links

				
				
				
				
				
				← Older revision
				Revision as of 13:02, 8 April 2010
				
Line 84:
Line 84:
= Installing SDK = = Installing SDK =



Before continuing, review the [http://wiki.maemo.org/Documentation/Maemo5_Final_Installation installation instructions] of the Maemo SDK. Before continuing, review the [[Documentation/Maemo_5_Final_SDK_Installation|installation instructions]] of the Maemo SDK.



The kernel must support binfmt_misc-feature in order for the instruction emulator in Scratchbox to work properly. Because it is usually built as a module, verify that the module is loaded in Linux (no root access needed): The kernel must support binfmt_misc-feature in order for the instruction emulator in Scratchbox to work properly. Because it is usually built as a module, verify that the module is loaded in Linux (no root access needed):
Line 102:
Line 102:
* Verify installation status by issuing the command 'dpkg -l | grep xephyr' (as non-root). * Verify installation status by issuing the command 'dpkg -l | grep xephyr' (as non-root).



As mentioned before, Maemo SDK uses Scratchbox as the cross-compilation environment. Therefore, you must install Scratchbox first before attempting to install the SDK. The preferred way to install scratchbox and SDK is to use the automated installation scripts though manual installation steps are also provided. Detailed instructions are found [http://maemo.org/development/sdks/maemo_5_beta_2_sdk_installation/ here]. As mentioned before, Maemo SDK uses Scratchbox as the cross-compilation environment. Therefore, you must install Scratchbox first before attempting to install the SDK. The preferred way to install scratchbox and SDK is to use the automated installation scripts though manual installation steps are also provided. Detailed instructions are found [[Documentation/Maemo_5_Final_SDK_Installation|on the maemo.org wiki]].



= Testing SDK Installation = = Testing SDK Installation =



imported_>amigadave: /* Writing GUI Hello World */ remove obsolete paragraph
2010-03-31T10:04:13Z
Writing GUI Hello World:  remove obsolete paragraph

				
				
				
				
				
				← Older revision
				Revision as of 10:04, 31 March 2010
				
Line 373:
Line 373:
  [sbox-FREMANTLE_X86: ~] &gt;   [sbox-FREMANTLE_X86: ~] &gt;




The order and placement of the pkg-config commands above is important: you must place the cflags as early as feasible and ensure that the libs must come last (this does matter in some problematic linking scenarios). 



The next step is to repeat the basic commands that you used before with the non-GUI hello world:   The next step is to repeat the basic commands that you used before with the non-GUI hello world:  



imported_>amigadave: /* Writing GUI Hello World */ fix silly double-invocation of pkg-config
2010-03-31T08:10:26Z
Writing GUI Hello World:  fix silly double-invocation of pkg-config

				
				
				
				
				
				← Older revision
				Revision as of 08:10, 31 March 2010
				
Line 370:
Line 370:
       
  [sbox-FREMANTLE_X86: ~] &gt; gcc -Wall -g gtk_helloworld-1.c  \   [sbox-FREMANTLE_X86: ~] &gt; gcc -Wall -g gtk_helloworld-1.c  \
   `pkg-config --cflags gtk+-2.0` -o gtk_helloworld-1  \    `pkg-config --cflags --libs gtk+-2.0` -o gtk_helloworld-1
  `pkg-config --libs gtk+-2.0` 
  [sbox-FREMANTLE_X86: ~] &gt;   [sbox-FREMANTLE_X86: ~] &gt;






imported_>amigadave: Category:Scratchbox
2010-02-12T16:38:46Z
Category:Scratchbox

				
				
				
				
				
				← Older revision
				Revision as of 16:38, 12 February 2010
				
Line 499:
Line 499:
[[Category:Documentation]] [[Category:Documentation]]
[[Category:Fremantle]] [[Category:Fremantle]]
[[Category:Scratchbox]]

← Older revision		Revision as of 13:02, 8 April 2010
Line 84:		Line 84:
	= Installing SDK =		= Installing SDK =

	Before continuing, review the [~~http://wiki.maemo.org/~~Documentation/~~Maemo5_Final_Installation~~ installation instructions] of the Maemo SDK.		Before continuing, review the [[Documentation/Maemo_5_Final_SDK_Installation\|installation instructions]] of the Maemo SDK.

	The kernel must support binfmt_misc-feature in order for the instruction emulator in Scratchbox to work properly. Because it is usually built as a module, verify that the module is loaded in Linux (no root access needed):		The kernel must support binfmt_misc-feature in order for the instruction emulator in Scratchbox to work properly. Because it is usually built as a module, verify that the module is loaded in Linux (no root access needed):
Line 102:		Line 102:
	* Verify installation status by issuing the command 'dpkg -l \| grep xephyr' (as non-root).		* Verify installation status by issuing the command 'dpkg -l \| grep xephyr' (as non-root).

	As mentioned before, Maemo SDK uses Scratchbox as the cross-compilation environment. Therefore, you must install Scratchbox first before attempting to install the SDK. The preferred way to install scratchbox and SDK is to use the automated installation scripts though manual installation steps are also provided. Detailed instructions are found [~~http:/~~/maemo.org~~/development/sdks/maemo_5_beta_2_sdk_installation/ here~~].		As mentioned before, Maemo SDK uses Scratchbox as the cross-compilation environment. Therefore, you must install Scratchbox first before attempting to install the SDK. The preferred way to install scratchbox and SDK is to use the automated installation scripts though manual installation steps are also provided. Detailed instructions are found [[Documentation/Maemo_5_Final_SDK_Installation\|on the maemo.org wiki]].

	= Testing SDK Installation =		= Testing SDK Installation =

← Older revision		Revision as of 10:04, 31 March 2010
Line 373:		Line 373:
	[sbox-FREMANTLE_X86: ~] >		[sbox-FREMANTLE_X86: ~] >


	The order and placement of the pkg-config commands above is important: you must place the cflags as early as feasible and ensure that the libs must come last (this does matter in some problematic linking scenarios).

	The next step is to repeat the basic commands that you used before with the non-GUI hello world:		The next step is to repeat the basic commands that you used before with the non-GUI hello world:

← Older revision		Revision as of 08:10, 31 March 2010
Line 370:		Line 370:

	[sbox-FREMANTLE_X86: ~] > gcc -Wall -g gtk_helloworld-1.c \		[sbox-FREMANTLE_X86: ~] > gcc -Wall -g gtk_helloworld-1.c \
	`pkg-config --cflags gtk+-2.0` -o gtk_helloworld-1 \		`pkg-config --cflags --libs gtk+-2.0` -o gtk_helloworld-1
	~~`pkg-config --libs gtk+-2.0`~~
	[sbox-FREMANTLE_X86: ~] >		[sbox-FREMANTLE_X86: ~] >

← Older revision		Revision as of 16:38, 12 February 2010
Line 499:		Line 499:
	[[Category:Documentation]]		[[Category:Documentation]]
	[[Category:Fremantle]]		[[Category:Fremantle]]
			[[Category:Scratchbox]]

Documentation/Maemo 5 Developer Guide/Development Environment/Maemo SDK - Revision history

46.28.100.195: /* Maemo Software Development Kit */ kinks -> links

imported_>wikiwide: -Development; Scratchbox is already in Development, avoid Duplication

imported_>sixwheeledbeast: /* Directing Client to Virtual Server */

imported_>amigadave: /* Testing SDK Installation */ reformat images

85.183.40.96: /* Testing Scratchbox */

imported_>amigadave: use and , tidy, wikify slightly

imported_>amigadave: /* Installing SDK */ links

imported_>amigadave: /* Writing GUI Hello World */ remove obsolete paragraph

imported_>amigadave: /* Writing GUI Hello World */ fix silly double-invocation of pkg-config

imported_>amigadave: Category:Scratchbox

imported_>amigadave: use and `, tidy, wikify slightly`