Home · All Classes · Annotated · Functions

Configure Options

Configure Options

Basic Options
Complete Options List

Usage Combinations

Qtopia configure allows a number of command line options to customize Qtopia for your device. To support building VoIP-only phones, that is, phones that do not have GSM functionality, the -no-modem option is required. This options turns off both cellular functionality and AT-based modems as Qtopia only supports AT-modems for cellular functionality at this time.

If you are new to Qtopia, Table 1 lists some basic options to get you started.

Table 2 lists all available used options and Table 3 lists usage combinations.

Configure Options

configure usage is as follows:

    configure [options]

For a complete and up-to-date list of options, run configure using:

     configure -help -verbose

Basic Options

Table 1: Basic Options
Option	Description
-edition <edn>	Build Qtopia edn Edition. Default: phone
-debug	Create a debug build.
* -clean	Clean the build tree.
-no-clean	Do not clean the build tree.
-profile	Create a build with profiling.
* -modem	Enable Modem communication.
-no-modem	Disable Modem communication.
* -voip	Enable VoIP (Voice over IP) communication.
-no-voip	Disable VoIP communication.

Complete Options List

Table 2: Complete Options List
Option	Description
Note: The asterisk `*` indicates default options
-help	Print help and usage information.
-verbose	Print out extra information while configuring.
* -release	Create a release build.
-debug	Create a debug build.
-I <dir>	Add an explicit include path.
-L <dir>	Add Add an explicit library path.
-l <lib>	Add Add an explicit library.
-R <dir>	Add an explicit dynamic library runtime search path.
-D <def>	Add an explicit define to the build. Use `-D "FOO=bar"` to give it a value.
-device <device>	Configure for a particular device using the configuration files in `<qtopia-root-dir>/devices/<device>` Using -device will cause many defaults to change.
-edition <edn>	Build Qtopia <edn> Edition Default <edn>: phone
-qtopiadesktop	Build Qtopia Desktop.
-platform <host>	The host platform that you are compiling on. If not specified, configure will attempt to autodetect the host.
-xplatform <target>	The target platform that you are compiling for. If not specified, configure will attempt to autodetect the target based on the host.
-arch <architecture>	The CPU family you are building for.
-defaultbuttons arg	Use `defaultbuttons-arg.conf`
-prefix <dir>	Set the runtime location of Qtopia to <dir>. Default: <qtopia-root-dir>/image/opt/ Qtopia Note: The default value will not be useful when building for a device.
* -qvfb	Enable QVfb support.
-no-qvfb	Disable QVfb support.
* -quicklaunch	Use the `quicklaunch` method of speeding up application loading. Applications that allow it are built as plug-ins.
-no-quicklaunch	Do not use the `quicklaunch` method of application loading.
-quicklaunch2	Use the `quicklaunch2` method of speeding up application loading. Applications that allow it are built as plug-ins.
* -no-quicklaunch2	Do not use the `quicklaunch2` method of application loading.
-singleexec	Qtopia is compiled into a single binary that contains all libraries, plug-ins and applications. This implies `-no-sxe`.
* -shared	Qtopia is compiled as a collection of libraries, plug-ins and applications.
-languages <lang>	Resources (translations, dictionary files, icons) <lang> are updated/installed for the specified languages. Default: en_US en_SU
-iconsizes <size>	Icons are installed at the requested sizes. Sizes <size> can be a single number (for square sizes) or WxH. Default: 14 16 22
-displaysize WxH[-WxH]	Resources (images) suitable for the requested size are installed. Size can be a single width and height or a minimum and maximum width and height. Default: 160-240
-displayrot <angle>	Resources (fonts) are installed for the requested <angle> rotations. Angle can be one or more of the following values separated by a space: 0 90 180 270 Default: 0
-fontsizes <size>	Fonts are installed that match the requested sizes <size> Sizes are expressed as: 180 for 18 point fonts. Use all to install all available sizes. Default: 80 100 120 140 180
-fontfamilies "family ... family"	Fonts are installed that match the requested families. Default: helvetica fixed
-fontstyles "style ... style"	Fonts are installed that match the requested styles. The styles are as follows: 50 = normal 75 = bold i = italic Note:Italic can be applied to normal or bold (eg. 50i, 75i). Default: 50 50i 75 75i Unless you have changed the Qtopia Core configuration, fonts must be in `.qpf` format. Fonts are searched for in `<qtopia-root-dir>/qtopiacore/qt/dist/embedded/lib/fonts`. One file is installed for each combination of family, size, style and rotation.
-make makecmd	Use `makecmd` when building. Default: `make`
-build <dir>	Add directory <dir> to the Qtopia build system. For example, `-build /path/to/myapp` will add `/path/to/myapp` to the build system.
-run-qdoc	Run `qdoc` at make time to provide documentation warnings and errors.
* -no-run-qdoc	Do not run `qdoc` at make time.
* -qtmail-ssl	Enable SSL and SMTP authentication support in messages.
-no-qtmail-ssl	Disable SSL and SMTP authentication support in messages.
-sxe	Enable the Safe Execution Environment so that native third party applications can run safely.
* -no-sxe	Disable the Safe Execution Environment.
* -sxe-discovery	Turn on support for SXE discovery mode so that new policy rules can be tested. To utilize SXE discovery mode you must set the `SXE_DISCOVERY_MODE` environment variable to 1. WARNING: This option creates a security hole and should only be used when creating new policy rules.
-no-sxe-discovery	Turn off support for SXE discovery mode.
* -bluetooth	Enable Bluetooth.
-no-bluetooth	Disable Bluetooth.
* -drm	Enable support for DRM (Using the Beep Science DRM Agent v2.3).
-no-drm	Disable support for DRM.
* -modem	Enable Modem communication.
-no-modem	Disable Modem communication.
* -voip	Enable VoIP (Voice over IP) communication.
-no-voip	Disable VoIP communication. Modem and VoIP communication are not exclusive or mandatory. You can enable one, both or none.
* -helix	Enable the Helix media player.
-no-helix	Disable the Helix media player.
-helix-system-id	Use `SYSTEM_ID` when building Helix. For further information refer to: Qtopia Helix Integration.
-helix-output ss	Force the use of ALSA or OSS when building Helix. This might be needed if your toolchain has ALSA but your kernel does not.
* -ifaddrs	Enable the use of `ifaddr` header.
-no-ifaddrs	Disable `ifaddr` header usage. Using this option means parts of the network code are not IPv6 aware.
-error	Treat warnings as errors when compiling Qtopia. Note: Except for code in `/src/3rdparty`.
* -no-error	Do not treate warnings as errors.
-enable-kde	Enable KDE 3.x integration. This requires KDE 3.x headers and libraries to be installed.
* -disable-kde	Disable KDE 3.x integration.
-qtopiacore-config <arg>	Override the Qt/Embedded `configure` command line
-extra-qtopiacore-config <arg>	Add to the Qt/Embedded configure command line
-qt-config <arg>	Override the Qt configure command line
-extra-qt-config <arg>	Add something to the Qt configure command line
-with-module	Build module. Available modules: libamr gif
-without-module	Do not build module.

Usage Combinations

Configure Usage
Usage: configure	[ -help ] [ -verbose ] [ -release \| -debug ]
	[ -I dir ] [ -L dir ] [ -l lib ] [ -R dir ] [ -D def ]
	[ -device device ]
	[ -edition edn ] [ -qtopiadesktop ]
	[ -platform host ] [ -xplatform target ]
	[ -arch architecture ] [ -defaultbuttons arg ]
	[ -prefix dir ]
	[ -qvfb \| -no-qvfb ] [ -quicklaunch \| -no-quicklaunch ]
	[ -quicklaunch2 \| -no-quicklaunch2 ]
	[ -singleexec \| -shared ] [ -languages "lang ... lang" ]
	[ -iconsizes "size ... size" ] [ -displaysize WxH[-WxH] ]
	[ -displayrot "angle ... angle" ]
	[ -fontsizes "size ... size" ]
	[ -fontfamilies "family ... family" ]
	[ -fontstyles "style ... style" ]
	[ -make makecmd ] [ -build dir ]
	[ -run-qdoc \| -no-run-qdoc ]
	[ -qtmail-ssl \| -no-qtmail-ssl ] [ -sxe \| -no-sxe ]
	[ -sxe-discovery \| -no-sxe-discovery ]
	[ -bluetooth \| -no-bluetooth ] [ -drm \| -no-drm ]
	[ -modem \| -no-modem ] [ -voip \| -no-voip ]
	[ -helix \| -no-helix ] [ -helix-system-id SYSTEM_ID ]
	[ -helix-output ss ] [ -ifaddrs \| -no-ifaddrs ]
	[ -enable-kde \| -disable-kde ]
	[ -qtopiacore-config arg ] [ -extra-qtopiacore-config arg ]
	[ -qt-config arg ] [ -extra-qt-config arg ]
	[ -with-module \| -without-module ]

Trademarks

Qtopia 4.1.7