build/bakefiles/wxpresets/presets/wx.bkl

   1 <?xml version="1.0" ?>
   2
   3 <!--
   4     Presets for building wxWidgets applications.
   5
   6     These presets provide the following "public" interface:
   7
   8     OPTIONS:
   9
  10     - WX_* : used to let the user of the generated makefile choose a wxWidgets
  11              build among those available; you can use them in your project to
  12              e.g. build a target only if WX_SHARED is 0 or if WX_PORT is "msw".
  13
  14
  15     VARIABLES:
  16
  17     - WXLIBPOSTFIX: contains the [u][d] string which is typically useful when
  18                     defining names of directories/files which should coexist
  19                     with other builds using different wxWidgets configurations.
  20
  21
  22     TEMPLATES:
  23
  24     - wx, wx-lib: templates to be used respectively for <dll>/<exe> and <lib>
  25                   targets; they add all the wxWidgets-related settings (e.g. the
  26                   include and library search paths, the necessary preprocessor
  27                   symbols, etc).
  28
  29     - wxgui: to be used when building GUI-mode applications.
  30
  31     - wxconsole: to be used when building console-only applications
  32                  (NOTE: it doesn't add the wxUSE_GUI=0 define since you don't
  33                  need it when compiling wxBase-only code).
  34
  35     - wxlike: this template should be combined with "wx" or "wx-lib" and will
  36               make your project build with the same Unicode & shared
  37               config as the wxWidgets build selected using the WX_* options.
  38
  39
  40     TARGET TAGS:
  41
  42     - <wx-lib>: to define which wxWidgets libraries to link with;
  43                 please note that you should use them in the right order or
  44                 linking under Unix would result in errors, e.g.
  45
  46                     <wx-lib>core</wx-lib>
  47                     <wx-lib>base</wx-lib>
  48
  49                 is correct, but the reverse is not (if lib A depends on lib B, then
  50                 lib A must be listed before B). So <wx-lib>base</wx-lib>
  51                 (which must always be present) should be the last wx-lib tag.
  52
  53     - <wxlike-libname>,
  54       <wxlike-dllname>: useful if you want to have a build logic similar to the
  55                         wxWidgets build logic which allows different builds to
  56                         coexist without conflicts. These tags helps you to name
  57                         libraries using the same wxWidgets rules and thus avoid
  58                         conflicts between libraries compiled in e.g. Unicode,
  59                         shared mode and those compiled in ANSI, shared mode &c.
  60
  61     - <wxlike-lib>: if your library/application needs to link with both
  62                     wxWidgets and some other wx-based library, which in turn
  63                     follows the wxWidgets naming conventions, then this tag is
  64                     what you need to reference the wx-based additional library.
  65
  66     - <wxlike-dirname>: sets the output directory for the current target to $(value)
  67                         when on Unix and to e.g. $(value)/vc_lib when on Windows,
  68                         i.e. acts like <dirname> just following wxWidgets naming rules.
  69                         Useful to allow multiple builds of the
  70
  71     - <wxlike-paths>: if your library/application needs to compile & link with both
  72                       wxWidgets and some other wx-based library, which in turn
  73                       follows the wxWidgets naming conventions, then this tag is
  74                       what you need to add to the compiler and linker flags the paths
  75                       of the "include" and "lib" folders of the wx-based additional library.
  76
  77
  78     GLOBAL TAGS:
  79
  80     - <set-wxlike-builddir>: sets BUILDDIR using wxWidgets naming rules to help
  81                              to keep object files compiled with different
  82                              settings separate.
  83
  84     - <set-wxlike>: sets a variable with the name of a library named with the same
  85                     wxWidgets rules.
  86
  87
  88  NOTE: as a reference here is a list of all wxWidgets libraries satisfying
  89        the dependency constraints mentioned in <wx-lib> description:
  90
  91         <wx-lib>webview</wx-lib>
  92         <wx-lib>richtext</wx-lib>
  93         <wx-lib>aui</wx-lib>
  94         <wx-lib>ribbon</wx-lib>
  95         <wx-lib>propgrid</wx-lib>
  96         <wx-lib>stc</wx-lib>
  97         <wx-lib>qa</wx-lib>
  98         <wx-lib>gl</wx-lib>
  99         <wx-lib>xrc</wx-lib>
 100         <wx-lib>html</wx-lib>
 101         <wx-lib>media</wx-lib>
 102         <wx-lib>adv</wx-lib>
 103         <wx-lib>net</wx-lib>
 104         <wx-lib>xml</wx-lib>
 105         <wx-lib>core</wx-lib>
 106         <wx-lib>base</wx-lib>
 107
 108 -->
 109
 110
 111 <makefile>
 112
 113     <requires version="0.2.2"/>
 114
 115     <using module="wx_presets"/>
 116
 117     <!-- this variable identifies the version of the wx presets.
 118          this is changed only when major changes to wxpresets take place.
 119     -->
 120     <set var="WX_PRESETS_VERSION">4</set>
 121
 122     <!-- list of known libraries used by wx-lib tag defined in wx_unix.bkl and wx_win32.bkl
 123          VERY IMPORTANT: when updating this list also update the <wx-lib> and <wx-all-libs>
 124                          tag definitions.
 125     -->
 126     <set var="WX_LIB_LIST">
 127         base core net xml xrc html adv media gl qa aui ribbon propgrid richtext stc webview
 128     </set>
 129
 130     <!-- if you define this variable to 0 before including wx presets, the
 131          "test_for_selected_wxbuild" target which is added by default in win32 and GNU
 132          makefiles, won't be added.
 133          This is useful when e.g. you want to have wxWidgets as an optional
 134          dependency and thus you don't want to perform that check unconditionally.
 135     -->
 136     <set var="WX_TEST_FOR_SELECTED_WXBUILD" overwrite="0">
 137         1
 138     </set>
 139
 140     <!-- this is a temporary variable until there is non general    -->
 141     <!-- function in bakefiles for returning native markup for      -->
 142     <!-- reading envrionment variables                              -->
 143     <set var="ENV_VAR">
 144         <if cond="FORMAT=='watcom'">%</if>
 145         <if cond="FORMAT!='watcom'"></if>
 146     </set>
 147
 148
 149
 150     <!--                        OPTIONS                             -->
 151     <!--                                                            -->
 152     <!--    These are essentially the configurations you            -->
 153     <!--    want in bakefile.                                       -->
 154     <!--                                                            -->
 155     <!--    In MSVC these are the different build                   -->
 156     <!--    configurations you can have (in the build menu),        -->
 157     <!--    and in autoconf is enabled with enable-xxx=xx.          -->
 158     <!--    For other compilers a separate configuration            -->
 159     <!--    file is created (such as config.gcc on gcc)             -->
 160     <!--    which has several options a user can modify.            -->
 161     <!--                                                            -->
 162     <!--    Note that the above only happens if an option           -->
 163     <!--    is not constant, i.e. if it cannot be determined        -->
 164     <!--    by bakefile itself.                                     -->
 165     <!--    Also note that for 'autoconf' format these options      -->
 166     <!--    are only useful when used together with wxpresets.m4    -->
 167     <!--    macro file which contains macros for detecting the      -->
 168     <!--    option values for wx-based projects. See wxpresets.m4   -->
 169     <!--    comments for more info.                                 -->
 170
 171
 172     <!-- Presets for limited dmars make.exe format: -->
 173     <if cond="FORMAT=='dmars'">
 174         <set var="WX_UNICODE">1</set>
 175         <set var="WX_DEBUG">1</set>
 176         <set var="WX_SHARED">0</set>
 177     </if>
 178
 179     <!-- 'gnu' format needs to redefine the following options later in wx_unix.bkl -->
 180     <if cond="FORMAT=='gnu'">
 181         <set var="WX_UNICODE"/>
 182         <set var="WX_SHARED"/>
 183         <set var="WX_PORT"/>
 184         <set var="WX_VERSION"/>
 185     </if>
 186
 187
 188     <!--    This is a standard option that determines               -->
 189     <!--    whether the user wants to build this library as         -->
 190     <!--    a dll or as a static library.                           -->
 191     <if cond="not isdefined('WX_SHARED')">
 192         <set var="WX_SHARED_DEFAULT" overwrite="0">0</set>
 193         <option name="WX_SHARED">
 194             <values>0,1</values>
 195             <values-description>Static,DLL</values-description>
 196             <default-value>$(WX_SHARED_DEFAULT)</default-value>
 197             <description>
 198                 Use DLL build of wx library?
 199             </description>
 200         </option>
 201     </if>
 202
 203     <!-- Configuration for building the bakefile with               -->
 204     <!-- unicode strings or not (unicode or ansi).                  -->
 205     <if cond="not isdefined('WX_UNICODE')">
 206         <set var="WX_UNICODE_DEFAULT" overwrite="0">1</set>
 207         <option name="WX_UNICODE">
 208             <values>0,1</values>
 209             <values-description>ANSI,Unicode</values-description>
 210             <default-value>$(WX_UNICODE_DEFAULT)</default-value>
 211             <description>
 212                 Use Unicode build of wxWidgets?
 213             </description>
 214         </option>
 215     </if>
 216
 217     <if cond="not isdefined('WX_DEBUG')">
 218         <set var="WX_DEBUG_DEFAULT" overwrite="0">1</set>
 219         <option name="WX_DEBUG">
 220             <values>0,1</values>
 221             <values-description>Release,Debug</values-description>
 222             <default-value>$(WX_DEBUG_DEFAULT)</default-value>
 223             <description>
 224                 Use debug build of wxWidgets (linked with debug CRT)?
 225             </description>
 226         </option>
 227     </if>
 228
 229     <if cond="not isdefined('WX_VERSION')">
 230         <set var="WX_VERSION_DEFAULT" overwrite="0">29</set>
 231         <option name="WX_VERSION">
 232             <default-value>$(WX_VERSION_DEFAULT)</default-value>
 233             <description>
 234                 Version of the wx library to build against.
 235             </description>
 236         </option>
 237     </if>
 238
 239     <if cond="not isdefined('WX_MONOLITHIC')">
 240         <set var="WX_MONOLITHIC_DEFAULT" overwrite="0">0</set>
 241         <option name="WX_MONOLITHIC">
 242             <values>0,1</values>
 243             <values-description>Multilib,Monolithic</values-description>
 244             <default-value>$(WX_MONOLITHIC_DEFAULT)</default-value>
 245             <description>
 246                 Use monolithic build of wxWidgets?
 247             </description>
 248         </option>
 249     </if>
 250
 251     <!-- The directory where wxWidgets is installed: -->
 252     <if cond="not isdefined('WX_DIR')">
 253         <set var="WX_DIR_DEFAULT" overwrite="0">$(DOLLAR)($(ENV_VAR)WXWIN)</set>
 254         <option name="WX_DIR" category="path" never_empty="1">
 255             <default-value>$(WX_DIR_DEFAULT)</default-value>
 256             <description>
 257                 The directory where wxWidgets library is installed
 258             </description>
 259         </option>
 260     </if>
 261
 262
 263
 264     <!--                     HELPER VARIABLES                       -->
 265     <!--                                                            -->
 266
 267     <!--    These are handy ways of dealing with the                -->
 268     <!--    extensions in the library names of the                  -->
 269     <!--    wxWindows library.                                      -->
 270     <set var="WXLIBPOSTFIX">
 271         <if cond="WX_DEBUG=='1' and WX_UNICODE=='1'">ud</if>
 272         <if cond="WX_DEBUG=='1' and WX_UNICODE=='0'">d</if>
 273         <if cond="WX_DEBUG=='0' and WX_UNICODE=='1'">u</if>
 274     </set>
 275
 276     <if cond="FORMAT!='autoconf'">
 277         <set var="COMPILER_PREFIX" make_var="1">$(COMPILER)</set>
 278     </if>
 279
 280
 281
 282
 283     <!--                    REAL IMPLEMENTATION                     -->
 284     <!--                                                            -->
 285
 286     <set var="__wx_included_impl">0</set>
 287
 288     <if cond="FORMAT in ['autoconf','gnu']">
 289         <include file="wx_unix.bkl"/>
 290         <set var="__wx_included_impl">1</set>
 291     </if>
 292
 293     <if cond="FORMAT!='autoconf' and PLATFORM_WIN32=='1'">
 294         <include file="wx_win32.bkl"/>
 295         <set var="__wx_included_impl">1</set>
 296     </if>
 297
 298     <if cond="FORMAT=='xcode2'">
 299         <!-- xCode2 is an IDE and thus reuses almost nothing from unix part of wxpresets;
 300              better use the win32 part! -->
 301         <include file="wx_win32.bkl"/>
 302         <set var="__wx_included_impl">1</set>
 303     </if>
 304
 305     <if cond="__wx_included_impl=='0'">
 306         <error>This format is not (yet) supported by wx preset.</error>
 307     </if>
 308
 309
 310
 311
 312     <!--                     HIGH-LEVEL TEMPLATE                    -->
 313     <!--                                                            -->
 314
 315     <!-- Combine 'wxlike' with 'wx' or 'wx-lib' templates to have your
 316          project build in the same configuration used by the selected
 317          wxWidgets build -->
 318     <template id="wxlike">
 319         <!-- WX_DEBUG-dependent -->
 320         <set var="_OPT">
 321             <if cond="WX_DEBUG=='1'">off</if>
 322             <if cond="WX_DEBUG=='0'">speed</if>
 323         </set>
 324         <set var="_DEBUGINFO">
 325             <if cond="WX_DEBUG=='1'">on</if>
 326             <if cond="WX_DEBUG=='0'">off</if>
 327         </set>
 328
 329         <if cond="FORMAT!='autoconf'">
 330             <optimize>$(_OPT)</optimize>
 331             <debug-info>$(_DEBUGINFO)</debug-info>
 332         </if>
 333     </template>
 334
 335     <!-- Template for building wx-based GUI applications -->
 336     <template id="wxgui" template="wx">
 337         <app-type>gui</app-type>
 338     </template>
 339
 340     <!-- Template for building wx-based console applications -->
 341     <template id="wxconsole" template="wx">
 342         <app-type>console</app-type>
 343     </template>
 344
 345
 346
 347     <!--                       UTILITY TAGS                         -->
 348     <!--                                                            -->
 349
 350     <!-- private helper tag: does the same thing as for <set-wxlike> except that:
 351          - the variable created is always named "__temp"
 352          - can be used (only) inside targets as this is a non-global tag
 353     -->
 354     <define-tag name="__setlibname" rules="lib,dll,module,exe">
 355         <set var="__temp">
 356             <if cond="FORMAT!='autoconf' and FORMAT!='gnu'">
 357                 $(attributes['prefix'])_$(WX_PORT)$(WX_VERSION)$(WXLIBPOSTFIX)_$(value)
 358             </if>
 359             <if cond="FORMAT=='autoconf' or FORMAT=='gnu'">
 360                 $(attributes['prefix'])_$(WX_PORT)$(WXLIBPOSTFIX)_$(value)-$(WX_VERSION_MAJOR).$(WX_VERSION_MINOR)
 361             </if>
 362         </set>
 363     </define-tag>
 364
 365     <!-- A simple tag which helps you to define a library name using the same rules used
 366          by wxWidgets. Use the 'prefix' attribute to add your lib's prefix.
 367          E.g.:
 368              <wxlike-libname prefix='mylib'>module1</wxlike-libname>
 369              <wxlike-libname prefix='mylib'>module2</wxlike-libname>
 370     -->
 371     <define-tag name="wxlike-libname" rules="lib">
 372         <__setlibname prefix="$(attributes['prefix'])">$(value)</__setlibname>
 373         <libname>$(__temp)</libname>
 374     </define-tag>
 375
 376     <!-- exactly like <wxlike-libname> but this one sets the DLL name (and the DLL lib import name)
 377          and thus must be used only inside a <dll> target...
 378     -->
 379     <define-tag name="wxlike-dllname" rules="dll,module">
 380         <__setlibname prefix="$(attributes['prefix'])">$(value)</__setlibname>
 381         <libname>$(__temp)</libname>
 382         <dllname>$(__temp)</dllname>
 383     </define-tag>
 384
 385     <!-- Links against a library which uses the same wxWidgets conventions.
 386     -->
 387     <define-tag name="wxlike-lib" rules="exe,lib,dll,module">
 388         <__setlibname prefix="$(attributes['prefix'])">$(value)</__setlibname>
 389         <sys-lib>$(__temp)</sys-lib>
 390     </define-tag>
 391
 392     <!-- Sets as output folder for the current target a directory
 393          called "$(value)/$(COMPILER_PREFIX)_lib|dll", just like wxWidgets does.
 394          This makes it possible to keep separated the libraries/exes compiled with
 395          different compilers and with a different value for WX_SHARED.
 396     -->
 397     <define-tag name="wxlike-dirname" rules="lib,dll,exe,module">
 398         <if cond="FORMAT!='autoconf'">
 399             <set var="_DIRNAME_SHARED_SUFFIX">
 400                 <if cond="WX_SHARED=='0'">lib</if>
 401                 <if cond="WX_SHARED=='1'">dll</if>
 402             </set>
 403             <set var="_DIRNAME">
 404                 $(value)/$(COMPILER_PREFIX)_$(_DIRNAME_SHARED_SUFFIX)
 405             </set>
 406
 407             <dirname>$(_DIRNAME)</dirname>
 408
 409             <if cond="FORMAT_SUPPORTS_ACTIONS=='1'">
 410                 <set var="__mkdir_tgt">make_dir_$(id)</set>
 411
 412                 <add-target target="$(__mkdir_tgt)" type="action"/>
 413                 <modify-target target="$(__mkdir_tgt)">
 414                     <command cond="TOOLSET=='unix'">
 415                         @mkdir -p $(_DIRNAME)
 416                     </command>
 417                     <command cond="TOOLSET in ['win32','os2','dos']">
 418                         if not exist $(nativePaths(_DIRNAME)) mkdir $(nativePaths(_DIRNAME))
 419                     </command>
 420                 </modify-target>
 421
 422                 <!-- the following code is mostly equivalent to a:
 423                           <dependency-of>$(id)</dependency-of>
 424                      put into the __mkdir_tgt target, except that it does _prepend_
 425                      the __mkdir_tgt dependency instead of appending it.
 426
 427                      This is required because some compilers (e.g. MSVC) need to store in the
 428                      output folder some files (e.g. the PDB file) while compiling and thus
 429                      the library output folder must have been created before _any_ source file
 430                      is compiled, not just before the library is linked.
 431                 -->
 432                 <modify-target target="$(id)">
 433                     <set var="__deps" prepend="1">
 434                         $(substitute(__mkdir_tgt, lambda x: ref('__depname', x), 'DEP'))
 435                     </set>
 436                 </modify-target>
 437             </if>
 438         </if>
 439         <if cond="FORMAT=='autoconf'">
 440             <set var="_DIRNAME">$(value)</set>
 441             <dirname>$(_DIRNAME)</dirname>
 442         </if>
 443     </define-tag>
 444
 445     <!-- Adds to the compiler & linker flags the path for the "include" and the
 446          "lib" folders of a library following wxWidgets conventions which is
 447          located in $(value).
 448     -->
 449     <define-tag name="wxlike-paths" rules="exe,lib,dll,module">
 450         <if cond="FORMAT!='autoconf' and FORMAT!='gnu'">
 451             <!-- WXLIBPATH is a path like "/lib/vc_lib"
 452                  NOTE: even if this template is going to be used for a "lib"
 453                        target (which does not uses lib-paths at all), we can still
 454                        use the <lib-path> target: it will just be discarded
 455              -->
 456             <lib-path>$(value)$(WXLIBPATH)</lib-path>
 457
 458             <!-- no special include paths for a lib following wxWidgets naming
 459                  conventions -->
 460             <include>$(value)/include</include>
 461         </if>
 462
 463         <!-- for autoconf format the user should use CPPFLAGS and LDFLAGS to
 464              specify non-system paths since the wx-based library should have
 465              been installed in standard paths
 466         -->
 467     </define-tag>
 468
 469
 470
 471     <!--                   UTILITY GLOBAL TAGS                      -->
 472     <!--                                                            -->
 473
 474     <!-- Sets the BUILDDIR variable using the same rules used by wxWidgets itself.
 475          This makes it possible to keep separated the object files compiled with
 476          different configuration settings.
 477     -->
 478     <define-global-tag name="set-wxlike-builddir">
 479         <!-- note that the builddir for autoconf should always be '.' -->
 480         <if cond="FORMAT!='autoconf'">
 481             <set var="_BUILDDIR_SHARED_SUFFIX">
 482                 <if cond="WX_SHARED=='0'"></if>
 483                 <if cond="WX_SHARED=='1'">_dll</if>
 484             </set>
 485
 486             <set var="BUILDDIR">
 487                 $(COMPILER_PREFIX)$(WX_PORT)$(WXLIBPOSTFIX)$(_BUILDDIR_SHARED_SUFFIX)
 488             </set>
 489         </if>
 490     </define-global-tag>
 491
 492     <!-- Sets a variable with the name of the 'var' attribute value using the
 493          same rules used for wxWidgets library naming.
 494          E.g.
 495
 496             <set-wxlike var='MYMODULE_LIBNAME' prefix='mylib'>
 497                 mymodule
 498             </set-wxlike>
 499
 500          This tag also supports a 'cond' attribute making it very powerful
 501          for conditional linking a wx-based library:
 502
 503             <option name="USE_MYMODULE">
 504                 <values>0,1</values>
 505             </option>
 506             <set-wxlike var='MYMODULE_DEP'
 507                         prefix='mylib'
 508                         cond="USE_MYMODULE=='1'">
 509                 mymodule
 510             </set-wxlike>
 511             ...
 512             <exe id="myexe">
 513                 <sys-lib>$(MYMODULE_DEP)</sys-lib>
 514             </exe>
 515     -->
 516     <define-global-tag name="set-wxlike">
 517         <if cond="FORMAT!='autoconf' and FORMAT!='gnu'">
 518             <if cond="'cond' not in attributes">
 519                 <set var="$(attributes['var'])">
 520                     $(attributes['prefix'])_$(WX_PORT)$(WX_VERSION)$(WXLIBPOSTFIX)_$(value)
 521                 </set>
 522             </if>
 523             <if cond="'cond' in attributes">
 524                 <set var="$(attributes['var'])">
 525                     <if cond="$(attributes['cond'])">
 526                         $(attributes['prefix'])_$(WX_PORT)$(WX_VERSION)$(WXLIBPOSTFIX)_$(value)
 527                     </if>
 528                 </set>
 529             </if>
 530         </if>
 531
 532         <if cond="FORMAT=='autoconf' or FORMAT=='gnu'">
 533             <if cond="'cond' not in attributes">
 534                 <set var="$(attributes['var'])">
 535                     $(attributes['prefix'])_$(WX_PORT)$(WXLIBPOSTFIX)_$(value)-$(WX_VERSION_MAJOR).$(WX_VERSION_MINOR)
 536                 </set>
 537             </if>
 538             <if cond="'cond' in attributes">
 539                 <set var="$(attributes['var'])">
 540                     <if cond="$(attributes['cond'])">
 541                         $(attributes['prefix'])_$(WX_PORT)$(WXLIBPOSTFIX)_$(value)-$(WX_VERSION_MAJOR).$(WX_VERSION_MINOR)
 542                     </if>
 543                 </set>
 544             </if>
 545         </if>
 546     </define-global-tag>
 547
 548
 549     <include file="wx_xrc.bkl"/>
 550
 551 </makefile>