|
Home · Reference · User Guide · Internals | |
The authorative source of the available configure options (and defaults) is the script itself. Here is the output of configure -help as it was when the documentation was built.
Note that some configure options will change the default value of other options. You can run configure -some -options -help to see the effect of this.
For suitable values to pass to -extra-qt-config see configure Options (Qt).
For suitable values to pass to -extra-qtopiacore-config see configure Options (Qtopia Core).
Usage: configure [options]
The defaults (*) are usually acceptable. A plus (+) denotes a default
value that needs to be evaluated. If the evaluation succeeds, the
feature is included. Here is a short explanation of each option:
-help .................. Print help and usage information.
-verbose ............... Print out extra information while configuring.
-silent ................ Hide compiler commandlines.
* -no-silent ............. Show compiler commandlines.
* -release ............... Create a release build.
-debug ................. Create a debug build.
-separate-debug-info ... Separate debug info into a .debug file.
* -no-separate-debug-info Do not separate debug info into a .debug file.
* -clean ................. Clean the build tree.
-no-clean .............. Do not clean the build tree.
-profile ............... Create a build with profiling.
* -no-profile ............ Create a build without profiling.
-reduce-exports arg .... Reduce symbol exports in Qt/Qtopia Core/Qtopia
(requires GCC 4).
Available: auto, yes, no
Default: auto
-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.
* -rpath ................. Set an automatic RPATH (so LD_LIBRARY_PATH is not
required to run Qtopia).
-no-rpath .............. Do not set an automatic RPATH.
* -posix-locks ........... Use POSIX file locking.
-flock-locks ........... Use flock() for file locking.
-error ................. Treat warnings as errors when compiling Qtopia
(except for code in src/3rdparty).
* -no-error .............. Do not treat warnings as errors.
-device device ......... Build using a device profile.
Available: example, gcc411, greenphone, min_voip,
omap730, pxa27x, s3c24a0, zylonite
Using -device may cause many defaults to change.
-edition edn ........... Build Qtopia <edn> Edition.
Available: platform, phone
Default: phone
-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 <arg> (if you pass a complete path) or
$QTOPIA_DEPOT_PATH/etc/defaultbuttons-<arg>.conf
(if you do not pass a complete path).
-sdk dir ............... Set the SDK location to <dir>. Note that you
cannot run 'make sdk' with -sdk
/usr/local/qtopia/qtopia-phone-4.2.5.
Default: /usr/local/qtopia/qtopia-phone-4.2.5
-image dir ............. Set the Qtopia install location to <dir>.
Default: /usr/local/qtopia/qtopia-phone-4.2.5/imag
e
-prefix dir ............ Set the runtime location of Qtopia to <dir>.
Default: /usr/local/qtopia/qtopia-phone-4.2.5/imag
e
* -qvfb .................. Enable QVfb support.
-no-qvfb ............... Disable QVfb support.
-launch-method method .. Launch applications using the selected method.
Please see the documentation for a description of
each launch method.
Available: normal, quicklaunch, quicklaunchforked
Default: quicklaunch
-force-quicklaunch ..... Force apps using QTOPIA_MAIN to be quicklaunched.
This results in larger binaries but faster
launching.
* -no-force-quicklaunch .. Do not force apps using QTOPIA_MAIN to be
quicklaunched.
-singleexec ............ Qtopia is compiled into a single binary that
contains all the libraries, plug-ins and
applications. This implies -no-sxe.
* -shared ................ Qtopia is compiled as a collection of libraries,
plug-ins and applications.
-languages lang,lang ... Resources (translations, dictionary files, icons)
are updated/installed for the specified languages.
Available: en_US
Default: en_US
-iconsize size ......... Non-scalable icons are installed at the requested
size. Can be a single number (for square icons) or
WxH. Images will be scaled from one of the
available sizes.
Available: 14, 16, 22
Default: 22
-image-extension-order An image may exist with multiple extensions but
ext,ext only 1 of these will be installed. This list
determines the priority of extensions. An image
with multiple extensions, none of which appear in
this list will have the first (as determined by
perl's glob("$file.*");) extension chosen.
Available: png, gif, xpm
Default: png,gif,xpm
You CANNOT force extensions other than .svg to have the highest
priority with -image-extension-order.
-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,angle Enables the display to be rotated by the requested
<angle> rotations and installs the required fonts.
Available: 0, 90, 180, 270
Default: 0
* -auto-i18n-fonts ....... Allow automatic installation of i18n fonts based
on the configured language (needed when using
-font).
-no-auto-i18n-fonts .... Do not automatically install i18n fonts.
-font fontspec ......... Install font <fontspec> (defined as
"family:sizes:styles"). Pass -font multiple times
to install multiple fonts.
family is the name of the font.
sizes is a list or range. For example, '80,100,120', '80-120', '*'.
styles is a list of weights. For example: '50,50i,80', '*'.
-font is provided to allow finegrained control over the fonts that are
installed. Using it means that -fontsizes, -fontfamilies and
-fontstyles options are ignored. This can have severe consequences for
i18n
-fontsizes size,size ... Fonts are installed that match the requested
sizes. Use 'all' to install all available sizes.
Available: 40, 70, 80, 90, 100, 110, 120, 130,
140, 150, 160, 170, 180, 190, 200, 210, 220, 230,
240, 250, 260, 270, 280, 290, 300, 310, 320, 330,
340, 350, 360
Default: 40,70,80,90,100,110,120,130,140,150,160,1
70,180,190,200,210,220,230,240,250,260,270,280,290
,300,310,320,330,340,350,360
-fontfamilies Fonts are installed that match the requested
family,family families.
Available: dejavu, dejavu-mono, fixed, helvetica,
japanese, micro, unifont, wenquanyi
-fontstyles style,style Fonts are installed that match the requested
styles. The styles are as follows: 50 = normal, 75
= bold, i = italic. Italic can be applied to
normal or bold (eg. 50i, 75i).
Available: 50, 50i, 75, 75i, 80, 80i
Default: 50,50i,75,75i,80,80i
Unless you have changed the Qtopia Core configuration, fonts must be in
.qpf format and are searched for in
/usr/local/qtopia/qtopia-phone-4.2.5/qtopiacore/qt/dist/embedded/lib/fo
nts and /usr/local/qtopia/qtopia-phone-4.2.5/dist/fonts. One file is
installed for each combination of family, size, style and rotation.
Note that fonts may not be available in all styles and sizes.
-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.
-ssl ................... Enable the use of OpenSSL. This lets qtmail
connect over SSL and use SMTP authentication. It
also allows communication with Google services.
* -no-ssl ................ Disable the use of OpenSSL.
-ssl-ciphers Use additional ciphers when building OpenSSL.
cipher,cipher WARNING: These ciphers are patented and should
only be enabled if a suitable licensing agreement
is in place.
Available: dsa, idea, mdc2, rc5
-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 utilise 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.
* -infrared .............. Enable Infrared.
-no-infrared ........... Disable Infrared.
-dbus .................. Enable DBUS support.
* -no-dbus ............... Disable DBUS support.
-dbuspath dir .......... Locate the DBUS build.
Default: /usr
* -drm ................... Enable support for DRM (Using the Beep Science DRM
Agent v2.3).
-no-drm ................ Disable support for DRM.
-sound-system ss ....... Select the sound system to use. You might need to
force OSS if your toolchain has ALSA but your
kernel does not.
Available: alsa, oss
Default: alsa
* -modem ................. Enable Modem communication.
-no-modem .............. Disable Modem communication.
-phonevendors Build and install phonevendor plugins.
plugin,plugin
Available: ericsson, wavecom
-multiplexers Build and install multiplexer plugins.
plugin,plugin
Available: wavecom
-voip .................. Enable VoIP (Voice over IP) communication. Note
that the reference SIP agent will not build in
singleexec mode.
* -no-voip ............... Disable VoIP communication.
Modem and VoIP communication are not exclusive or mandatory. You can
enable one, both or none.
-sipagent-socket ....... Enable socket-based sipagent implementation.
* -no-sipagent-socket .... Disable socket-based sipagent implementation.
-vpn ................... Enable VPN (Virtual Private Network) support.
* -no-vpn ................ Disable VPN.
* -helix ................. Enable the Helix media player. Please read the
documentation for instructions on how to enable
Helix.
-no-helix .............. Disable the Helix media player.
-helix-system-id Use SYSTEM_ID when building Helix.
SYSTEM_ID
Available: See
/usr/local/qtopia/qtopia-phone-4.2.5/src/3rdparty/
libraries/helix/src/build/umakecf or
/usr/local/qtopia/qtopia-phone-4.2.5/src/3rdparty/
libraries/helix/trolltech/src/build/umakecf for
suitable values.
* -libamr ................ Enable libamr.
-no-libamr ............. Disable libamr.
Qtopia should not be configured with -test for a final release as it
creates a potential security hole.
* -enable-samples ........ Enable server widget samples.
-no-samples ............ Disable server widget samples.
* -gif ................... Enable GIF support.
-no-gif ................ Disable GIF support.
-extra-qtopiacore-config Add something to the Qt/Embedded configure
"-option arg" commandline.
-extra-qt-config "-option Add something to the Qt configure commandline.
arg"
| Copyright © 2007 Trolltech | Qtopia Build System Documentation |