Presents for building wxWidgets applications using Autoconf or GNU toosets.
See wx.bkl for platform-independent notes.
-Usage:
- Options WX_CPPFLAGS, WX_CFLAGS, WX_CXXFLAGS, WX_LIBS are defined.
-
-
Format-specific notes:
* autoconf:
- Beware that you have to use AM_OPTIONS_WXCONFIG and
- AM_PATH_WXCONFIG in your configure.in!
+ Beware that you have to use WX_CONFIG_OPTIONS and
+ WX_CONFIG_CHECK in your configure.in to get at least the
+ WX_CPPFLAGS, WX_CFLAGS, WX_CXXFLAGS, WX_LIBS option values defined.
+
+ To detect the WX_* option values typically you also want to use
+ the WX_STANDARD_OPTIONS, WX_CONVERT_STANDARD_OPTIONS_TO_WXCONFIG_FLAGS,
+ WX_CONFIG_CHECK and finally WX_DETECT_STANDARD_OPTION_VALUES macros
+ (see wxwin.m4 for more info).
-->
<makefile>
+
+
<!-- ============================================================== -->
<!-- Autoconf -->
<!-- ============================================================== -->
<if cond="FORMAT=='autoconf'">
- <!-- Autoconf backend is simplicity itself thanks to wx-config... -->
<option name="WX_CFLAGS"/>
<option name="WX_CXXFLAGS"/>
<option name="WX_CPPFLAGS"/>
<option name="WX_LIBS"/>
<option name="WX_RESCOMP"/>
+ <option name="WX_VERSION_MAJOR"/>
+ <option name="WX_VERSION_MINOR"/>
+ <option name="WX_PORT"/>
+
+ <!-- wxwin.m4 macros will detect all WX_* options defined above -->
+
+
+ <!-- VERY IMPORTANT: <wx-lib>base</wx-lib> must be the last wx-lib tag
+ in all your bakefiles !!
+ -->
+ <define-tag name="wx-lib" rules="exe,dll,module">
+ <if cond="value=='base'">
+ <!-- all wx-dependent libraries should have been already listed
+ thus we can now add WX_LIBS to the linker line -->
+ <ldlibs>$(WX_LIBS)</ldlibs>
+ </if>
+ <if cond="value not in WX_LIB_LIST.split()">
+ <error>Unknown wxWidgets library given in the wx-lib tag</error>
+ </if>
+ </define-tag>
</if>
+
<!-- ============================================================== -->
<!-- GNU makefiles for Unix -->
<!-- ============================================================== -->
<if cond="FORMAT=='gnu'">
+
+ <!-- remove those WX_* vars which were created just to avoid the definition
+ of the WX_* options in wx.bkl -->
+ <unset var="WX_SHARED"/>
+ <unset var="WX_UNICODE"/>
+ <unset var="WX_PORT"/>
+ <unset var="WX_VERSION"/>
+
<set var="WX_CONFIG_DEFAULT" overwrite="0">wx-config</set>
<option name="WX_CONFIG">
<default-value>$(WX_CONFIG_DEFAULT)</default-value>
<description>Location and arguments of wx-config script</description>
</option>
- <option name="WX_CFLAGS">
- <default-value>`$(DOLLAR)(WX_CONFIG) --cflags`</default-value>
- <description>C flags to use with wxWidgets code</description>
+
+ <set var="WX_PORT_DEFAULT" overwrite="0">
+ $(DOLLAR)(shell $(WX_CONFIG) --query-toolkit)
+ </set>
+ <option name="WX_PORT">
+ <values>gtk1,gtk2,msw,x11,motif,mgl,osx_cocoa,osx_carbon,dfb</values>
+ <default-value force="1">$(WX_PORT_DEFAULT)</default-value>
+ <description>
+ Port of the wx library to build against
+ </description>
</option>
- <option name="WX_CXXFLAGS">
- <default-value>`$(DOLLAR)(WX_CONFIG) --cxxflags`</default-value>
- <description>C++ flags to use with wxWidgets code</description>
+
+ <set var="WX_SHARED_DEFAULT" overwrite="0">
+ $(DOLLAR)(shell if test -z `$(WX_CONFIG) --query-linkage`; then echo 1; else echo 0; fi)
+ </set>
+ <option name="WX_SHARED">
+ <values>0,1</values>
+ <values-description>Static,DLL</values-description>
+ <default-value force="1">$(WX_SHARED_DEFAULT)</default-value>
+ <description>
+ Use DLL build of wx library to use?
+ </description>
</option>
- <option name="WX_CPPFLAGS">
- <default-value>`$(DOLLAR)(WX_CONFIG) --cppflags`</default-value>
- <description>C preprocessor flags to use with wxWidgets code</description>
+
+ <set var="WX_UNICODE_DEFAULT" overwrite="0">
+ $(DOLLAR)(shell $(WX_CONFIG) --query-chartype | sed 's/unicode/1/;s/ansi/0/')
+ </set>
+ <option name="WX_UNICODE">
+ <values>0,1</values>
+ <values-description>ANSI,Unicode</values-description>
+ <default-value force="1">$(WX_UNICODE_DEFAULT)</default-value>
+ <description>
+ Compile Unicode build of wxWidgets?
+ </description>
</option>
- <option name="WX_RESCOMP">
- <default-value>`$(DOLLAR)(WX_CONFIG) --rescomp`</default-value>
- <description>wxWidgets resource compiler and flags</description>
+
+ <set var="WX_VERSION_DEFAULT" overwrite="0">
+ $(DOLLAR)(shell $(WX_CONFIG) --query-version | sed -e 's/\([0-9]*\)\.\([0-9]*\)/\1\2/')
+ </set>
+ <option name="WX_VERSION">
+ <default-value>$(WX_VERSION_DEFAULT)</default-value>
+ <description>
+ Version of the wx library to build against.
+ </description>
</option>
- <!-- we need this but the trick used in default-values above
+ <!-- Get MAJOR and MINOR version numbers -->
+ <set var="WX_VERSION_MAJOR" make_var="1">
+ $(DOLLAR)(shell echo $(DOLLAR)(WX_VERSION) | cut -c1,1)
+ </set>
+ <set var="WX_VERSION_MINOR" make_var="1">
+ $(DOLLAR)(shell echo $(DOLLAR)(WX_VERSION) | cut -c2,2)
+ </set>
+
+
+ <!--
+ Using the GNU format creates a configurable makefile just like
+ a win32 makefile: i.e. a makefile where you can select the wanted
+ wxWidgets build using the WX_* options.
+
+ The difference with win32 makefiles is that WX_PORT, WX_UNICODE and
+ WX_SHARED options have a smart default value which is created using
+ the installed wx-config or the wx-config given using WX_CONFIG option
+ -->
+ <set var="WX_CONFIG_UNICODE_FLAG">
+ <if cond="WX_UNICODE=='0'">--unicode=no</if>
+ <if cond="WX_UNICODE=='1'">--unicode=yes</if>
+ </set>
+ <set var="WX_CONFIG_SHARED_FLAG">
+ <if cond="WX_SHARED=='0'">--static=yes</if>
+ <if cond="WX_SHARED=='1'">--static=no</if>
+ </set>
+ <set var="WX_CONFIG_PORT_FLAG">
+ --toolkit=$(WX_PORT)
+ </set>
+ <set var="WX_CONFIG_VERSION_FLAG">
+ --version=$(WX_VERSION_MAJOR).$(WX_VERSION_MINOR)
+ </set>
+
+ <set var="WX_CONFIG_FLAGS" make_var="1">
+ $(WX_CONFIG_UNICODE_FLAG) $(WX_CONFIG_SHARED_FLAG)
+ $(WX_CONFIG_PORT_FLAG) $(WX_CONFIG_VERSION_FLAG)
+ </set>
+
+ <set var="DEFAULT_CXX">`$(DOLLAR)(WX_CONFIG) --cxx`</set>
+ <set var="WX_CFLAGS">`$(DOLLAR)(WX_CONFIG) --cflags $(WX_CONFIG_FLAGS)`</set>
+ <set var="WX_CXXFLAGS">`$(DOLLAR)(WX_CONFIG) --cxxflags $(WX_CONFIG_FLAGS)`</set>
+ <set var="WX_CPPFLAGS">`$(DOLLAR)(WX_CONFIG) --cppflags $(WX_CONFIG_FLAGS)`</set>
+ <set var="WX_RESCOMP">`$(DOLLAR)(WX_CONFIG) --rescomp $(WX_CONFIG_FLAGS)`</set>
+
+ <!--
+ VERY IMPORTANT: before starting to build all targets of the generated makefile,
+ we need to check if the selected wxWidgets build exists; we do
+ that simply creating the following target; if it fails the make
+ program will halt with the wx-config error message...
+ -->
+ <if cond="WX_TEST_FOR_SELECTED_WXBUILD=='1'">
+ <action id="test_for_selected_wxbuild">
+ <dependency-of>all</dependency-of>
+
+ <!-- Use @ to hide to the user that we're running wx-config... -->
+ <command>@$(DOLLAR)(WX_CONFIG) $(WX_CONFIG_FLAGS)</command>
+ </action>
+ </if>
+
+ <!-- we need these vars but the trick used in the default values above
prevents bakefile from detecting it: -->
- <set var="FORMAT_OUTPUT_VARIABLES" append="1">WX_CONFIG</set>
+ <set var="FORMAT_OUTPUT_VARIABLES" append="1">WX_CONFIG WX_VERSION</set>
+
+
+ <!-- VERY IMPORTANT: <wx-lib>base</wx-lib> must be the last wx-lib tag
+ in all your bakefiles !!
+ -->
+ <define-tag name="wx-lib" rules="exe,dll,module">
+ <if cond="value=='base'">
+ <!-- all wx libraries should have been already specified, thus
+ $(__liblist) should contain the full list of required wxlibs... -->
+ <set var="__liblist" append="1">base</set>
+ <ldlibs>`$(WX_CONFIG) $(WX_CONFIG_FLAGS) --libs $(','.join(__liblist.split()))`</ldlibs>
+ </if>
+ <if cond="value!='base'">
+ <set var="__liblist" append="1">$(value)</set>
+ </if>
+ <if cond="value not in WX_LIB_LIST.split()">
+ <error>Unknown wxWidgets library given in the wx-lib tag</error>
+ </if>
+ </define-tag>
</if>
<!-- ============================================================== -->
</if>
<!--
- We need to re-define the resource compiler, used by bakefile when compiling
- resources, to the resource compiler returned by 'wx-config --rescomp' since
- 'wx-config --rescomp' returns both the name of the resource compiler to use
- and the flags required for that compiler (rcflags are rccompiler-specific
- and thus it would be wrong to use them with other resource compilers).
+ We need to re-define the WINDRES resource compiler name to the resource compiler
+ returned by 'wx-config - -rescomp' since this option returns both the name of the
+ resource compiler to use (windres) and the flags required for that compiler.
This line typically does something *only* when the Makefile.in generated
using this bakefile, is used on Windows with MSYS (when using Cygwin, resources
are not compiled at all).
-
- NOTE: overwriting the RESCOMP variable we modify the entire Bakefile behaviour
- for resource compilation; this could be a problem if the bakefile which
- includes this file needs the standard Bakefile resource compiler to
- build a non wx-based application.
+ Without this line, in fact, when compiling with MSYS on Windows, the - -include-dir
+ option which tells windres to look in wxWidgets\include folder would be missing and
+ then windres would fail to find the wxMSW resources.
+
+ NOTE: overwriting the WINDRES variable we add wxWidgets resource flags to
+ all targets which include this bakefile; this could be useless to those
+ targets which are not wx-based eventually present in that bakefile but
+ in any case it shouldn't do any harm.
-->
- <set var="RESCOMP">$(WX_RESCOMP)</set>
+ <set var="WINDRES">$(WX_RESCOMP)</set>
<template id="wx-lib">
<cxxflags>$(WX_CXXFLAGS)</cxxflags>
-->
</template>
- <!-- VERY IMPORTANT: <wx-lib>base</wx-lib> must be the last wx-lib tag
- in all your bakefiles !!
- -->
- <define-tag name="wx-lib" rules="exe,dll,module">
- <if cond="FORMAT=='autoconf' and value=='base'">
- <!-- all wx-dependent libraries should have been already listed
- thus we can now add WX_LIBS to the linker line -->
- <ldlibs>$(WX_LIBS)</ldlibs>
- </if>
- <if cond="FORMAT=='gnu' and value=='base'">
- <!-- all wx libraries should have been already specified, thus
- $(__liblist) should contain the full list... -->
- <set var="__liblist" append="1">base</set>
- <ldlibs>`$(WX_CONFIG) --libs $(','.join(__liblist.split()))`</ldlibs>
- </if>
- <if cond="FORMAT=='gnu' and value!='base'">
- <set var="__liblist" append="1">$(value)</set>
- </if>
- <if cond="value not in ALLLIB_LIST.split()">
- <error>Unknown wxWidgets library given in the wx-lib tag</error>
- </if>
- </define-tag>
-
</makefile>