Qt4 development - Revision history

imported_>harryf: /* Building Qt from Git repository */

2010-11-17T09:54:27Z

Building Qt from Git repository

← Older revision		Revision as of 09:54, 17 November 2010
Line 187:		Line 187:
	===Building Qt from Git repository===		===Building Qt from Git repository===

			# Make sure you have all the build dependencies:<br/><pre>fakeroot apt-get build-dep qt4-x11</pre>
	# Clone the repository:<br/><pre>git clone git://gitorious.org/+qt-developers/qt/x11-maemo.git qt-maemo</pre><br/>		# Clone the repository:<br/><pre>git clone git://gitorious.org/+qt-developers/qt/x11-maemo.git qt-maemo</pre><br/>
	# Change dir:<br/><pre>cd qt-maemo</pre>		# Change dir:<br/><pre>cd qt-maemo</pre>
	# Configure Qt:<br/><pre>./configure -maemo5</pre>		# Configure Qt:<br/>For x86 targets:<pre>./configure -maemo5</pre><br/>For ARM targets:<pre>./configure -maemo5 -opengl es2</pre>.
	# Build Qt:<br/><pre>make</pre>		# Build Qt:<br/><pre>make</pre>
	# Install Qt:<br/><pre>make install</pre>		# Install Qt:<br/><pre>make install</pre>

136.176.106.94: /* How to compile a Qt application in Scratchbox */

2010-11-03T23:39:32Z

How to compile a Qt application in Scratchbox

← Older revision		Revision as of 23:39, 3 November 2010
Line 23:		Line 23:
	===How to compile a Qt application in Scratchbox===		===How to compile a Qt application in Scratchbox===

	Qt applications are usually built using QMake. ~~Project~~ like KDE ~~instead replaced QMake with~~ CMake for more flexibility.		Qt applications are usually built using QMake. Some projects, like KDE, use CMake, for more flexibility.

	==== QMake ====		==== QMake ====

imported_>harryf: /* Scratchbox */

2010-09-02T15:08:12Z

Scratchbox

← Older revision		Revision as of 15:08, 2 September 2010
Line 59:		Line 59:
	Note: <code>run-standalone.sh</code> sets some variable needed by Qt to use the Hildon style.		Note: <code>run-standalone.sh</code> sets some variable needed by Qt to use the Hildon style.

	Hint: If you don't want to run run-standalone.sh all the time, you can also source it: <pre>source /usr/bin/run-standalone.sh</pre>. In that shell, you can then run Qt applications without calling run-standalone.sh on every start.		Hint: If you don't want to run run-standalone.sh all the time, you can also source it: <pre>source /usr/bin/run-standalone.sh</pre> In that shell, you can then run Qt applications without calling run-standalone.sh on every start.

	==== Device ====		==== Device ====

imported_>harryf at 15:07, 2 September 2010

2010-09-02T15:07:43Z

← Older revision		Revision as of 15:07, 2 September 2010
Line 59:		Line 59:
	Note: <code>run-standalone.sh</code> sets some variable needed by Qt to use the Hildon style.		Note: <code>run-standalone.sh</code> sets some variable needed by Qt to use the Hildon style.

	Hint: If you don't want to run ~~<pre>~~run-standalone.sh~~</pre>~~ all the time, you can also source it: <pre>source /usr/bin/run-standalone.sh</pre>. In that shell, you can then run Qt applications without calling ~~<pre>~~run-standalone.sh~~</pre>~~ on every start.		Hint: If you don't want to run run-standalone.sh all the time, you can also source it: <pre>source /usr/bin/run-standalone.sh</pre>. In that shell, you can then run Qt applications without calling run-standalone.sh on every start.

	==== Device ====		==== Device ====

imported_>harryf: Remove version tags to prepare for 4.7 release

2010-09-02T15:06:51Z

Remove version tags to prepare for 4.7 release

← Older revision		Revision as of 15:06, 2 September 2010
Line 12:		Line 12:
	To start to develop with Maemo Qt, we need to [[Documentation/Maemo_5_Final_SDK_Installation\|install the Maemo SDK]].		To start to develop with Maemo Qt, we need to [[Documentation/Maemo_5_Final_SDK_Installation\|install the Maemo SDK]].

	Qt ~~4.6~~ is available in public Fremantle repository since the release of [[Maemo 5/PR1.2\|PR1.2]]. To upgrade older Scratchbox targets to use the latest packages, execute the following commands (inside Scratchbox):		Qt is available in public Fremantle repository since the release of [[Maemo 5/PR1.2\|PR1.2]]. To upgrade older Scratchbox targets to use the latest packages, execute the following commands (inside Scratchbox):
	fakeroot apt-get update		fakeroot apt-get update
	fakeroot apt-get dist-upgrade		fakeroot apt-get dist-upgrade
Line 19:		Line 19:
	fakeroot apt-get install libqt4-dev		fakeroot apt-get install libqt4-dev

	'''GIANT WARNING''': Your device might not be running Qt 4.6, but your Scratchbox probably is. Make sure that your N900 has the PR1.2 update by checking the software version (found in Settings->About product. PR1.2 is version 10.2010.19-1.		'''GIANT WARNING''': Your device might not be running Qt 4.6, but your Scratchbox probably is. Make sure that your N900 has at least the PR1.2 update by checking the software version (found in Settings->About product. PR1.2 is version 10.2010.19-1).

	===How to compile a Qt application in Scratchbox===		===How to compile a Qt application in Scratchbox===
Line 26:		Line 26:

	==== QMake ====		==== QMake ====
	[http://doc.trolltech.com/qt-maemo-4.6/qmake-manual.html QMake] is a tool ~~from Trolltech~~ that helps simplify the build process for development project across different platforms		[http://doc.trolltech.com/qt-maemo-4.6/qmake-manual.html QMake] is a tool that helps simplify the build process for development project across different platforms

	You can build your Maemo Qt application in 3 simple steps:		You can build your Maemo Qt application in 3 simple steps:
Line 52:		Line 52:
	First step to run a Qt application is starting the SDK UI:		First step to run a Qt application is starting the SDK UI:

	# Run Xephyr. It is able to run a [[:wikipedia:X_Window_System\|X Server]] inside another X Server.<pre>Xephyr :2 -host-cursor -screen 800x480x16 -dpi 96 -ac -kb</pre>		# Run Xephyr on your host (not in Xephyr!). It is able to run a [[:wikipedia:X_Window_System\|X Server]] inside another X Server.<pre>Xephyr :2 -host-cursor -screen 800x480x16 -dpi 96 -ac -kb</pre>
	# ~~Set~~ display for ~~application that runs inside Scratchbox~~:<pre>export DISPLAY=:2</pre>		# Inside Scratchbox, set the display for applications:<pre>export DISPLAY=:2</pre>
	# You can now run the SDK UI. A Diablo or Fremantle desktop will appear in your Xephyr window:<pre>af-sb-init.sh start</pre>		# You can now run the SDK UI. A Diablo or Fremantle desktop will appear in your Xephyr window:<pre>af-sb-init.sh start</pre>
	# Now you are ready to run any Maemo or Maemo Qt application with:<pre>run-standalone.sh ./qtapps</pre>		# Now you are ready to run any Maemo or Maemo Qt application with:<pre>run-standalone.sh ./qtapps</pre>

	Note: <code>run-standalone.sh</code> sets some variable needed by Qt to use the Hildon style.		Note: <code>run-standalone.sh</code> sets some variable needed by Qt to use the Hildon style.

			Hint: If you don't want to run <pre>run-standalone.sh</pre> all the time, you can also source it: <pre>source /usr/bin/run-standalone.sh</pre>. In that shell, you can then run Qt applications without calling <pre>run-standalone.sh</pre> on every start.

	==== Device ====		==== Device ====
	Maemo Qt applications are Linux binaries. They can run on the device without any problem if you copy them to "partitions" mounted with exec flag. (for example, <code>/home/user</code> or <code>/opt</code> in Fremantle).		Maemo Qt applications are Linux binaries. They can run on the device without any problem if you copy them to "partitions" mounted with exec flag. (for example, <code>/home/user</code> or <code>/opt</code> in Fremantle).

	~~Fore~~ example, if we want to run quassel (Qt IRC Client) we have to launch it with:		For example, if we want to run quassel (Qt IRC Client), we have to launch it with:
	su -c ./quassel user		su -c ./quassel user

Line 144:		Line 146:
	Maemo Qt is based on Qt for X11. It shares same APIs avoiding API breaks. In this way every Qt application that runs in other platforms (Windows, Mac OS X, Linux, S60, etc.) can run in Maemo devices as well. To Develop a Qt application you can use the [http://qt.nokia.com/doc/qt-maemo-4.6 Official Qt 4.6 for Maemo API documentation] and the list below to see what are the Maemo changes.		Maemo Qt is based on Qt for X11. It shares same APIs avoiding API breaks. In this way every Qt application that runs in other platforms (Windows, Mac OS X, Linux, S60, etc.) can run in Maemo devices as well. To Develop a Qt application you can use the [http://qt.nokia.com/doc/qt-maemo-4.6 Official Qt 4.6 for Maemo API documentation] and the list below to see what are the Maemo changes.

	Here are examples that show several Maemo 5 Qt widgets in Qt ~~4.6~~.		Here are examples that show several Maemo 5 Qt widgets in Qt.

	* http://qt.nokia.com/doc/qt-maemo-4.6/examples-maemo5.html		* http://qt.nokia.com/doc/qt-maemo-4.6/examples-maemo5.html
Line 151:		Line 153:
	===Maemo5 Readme file===		===Maemo5 Readme file===

	There is a [http://qt.gitorious.org/+qt-developers/qt/x11-maemo/blobs/4.6-fremantle/README.maemo5 README file in Qt ~~4.6~~ source tree].		There is a [http://qt.gitorious.org/+qt-developers/qt/x11-maemo/blobs/4.6-fremantle/README.maemo5 README file in Qt source tree].

	== Contributing to the Maemo Qt Project ==		== Contributing to the Maemo Qt Project ==

imported_>harryf at 14:33, 1 September 2010

2010-09-01T14:33:36Z

← Older revision		Revision as of 14:33, 1 September 2010
Line 1:		Line 1:
	'''IMPORTANT: This page is for Fremantle PR 1.2 using Qt 4.6.'''		'''IMPORTANT: This page is for Fremantle PR 1.2 using Qt 4.6 or higher.'''
	'''If you want to develop for Diablo or use Qt 4.5 please have a look at the [[Qt4_Hildon_Legacy\|Qt4 Hildon Legacy Page]].'''		'''If you want to develop for Diablo or use Qt 4.5 please have a look at the [[Qt4_Hildon_Legacy\|Qt4 Hildon Legacy Page]].'''

imported_>amigadave: /* Using the Kinetic Finger Scrolling (cf Gtk's PannableArea) */ cut section

2010-08-12T14:08:19Z

Using the Kinetic Finger Scrolling (cf Gtk's PannableArea): cut section

← Older revision		Revision as of 14:08, 12 August 2010
Line 89:		Line 89:
	You can show it again by using method <code>statusBar()->show()</code> in your class derived from <code>QMainWindow</code>.		You can show it again by using method <code>statusBar()->show()</code> in your class derived from <code>QMainWindow</code>.

	~~====Using the Kinetic Finger Scrolling (cf Gtk's PannableArea)====~~

	~~See [[Qt/Finger Scrolling\|Finger Scrolling]]~~

	===Adding Maemo changes to a Qt Application===		===Adding Maemo changes to a Qt Application===

imported_>amigadave: tidy

2010-06-17T13:20:31Z

tidy

Show changes

imported_>lbt: Add links to official docs

2010-06-07T07:41:48Z

Add links to official docs

← Older revision		Revision as of 07:41, 7 June 2010
Line 5:		Line 5:

	To develop with [[Qt-Maemo\|Qt for Maemo]], a working SDK installation is required. There are [[Documentation/Maemo_5_Final_SDK_Installation\|instructions on how to install the Maemo SDK]], and you can [http://www.youtube.com/watch?v=c8myh_iBy8k watch the Maemo SDK in action]. Alternatively, you may want to try [[MADDE]], a cross-platform Maemo development tool, available as a technology preview.		To develop with [[Qt-Maemo\|Qt for Maemo]], a working SDK installation is required. There are [[Documentation/Maemo_5_Final_SDK_Installation\|instructions on how to install the Maemo SDK]], and you can [http://www.youtube.com/watch?v=c8myh_iBy8k watch the Maemo SDK in action]. Alternatively, you may want to try [[MADDE]], a cross-platform Maemo development tool, available as a technology preview.

			Maemo5 has [http://doc.qt.nokia.com/qt-maemo-4.6/index.html official Qt docs] - especially see [http://doc.qt.nokia.com/qt-maemo-4.6/examples-maemo5.html the Maemo5 Qt examples page].

	= Getting started =		= Getting started =

imported_>amigadave: /* Adding Maemo changes to a Qt Application */ use and

2010-06-02T13:30:15Z

Adding Maemo changes to a Qt Application: use <source> and <pre>

← Older revision		Revision as of 13:30, 2 June 2010
Line 95:		Line 95:
	In the source code:		In the source code:

	#ifdef Q_WS_MAEMO_5		<source lang="cpp">
	//specific hildon/maemo5 code here		#ifdef Q_WS_MAEMO_5
	#endif		//specific hildon/maemo5 code here
			#endif
			</source>

	In the project file:		In the project file:

	maemo5 {		<pre>
	message("Hello Hildon")		maemo5 {
	SOURCE += hildon.cpp		message("Hello Hildon")
	HEADER += hildon.h		SOURCE += hildon.cpp
	FORMS += hildon.ui		HEADER += hildon.h
	}		FORMS += hildon.ui
			}
			</pre>

	== Home widget interaction ==		== Home widget interaction ==