FreeBSD Porter 手册
上一页 | 第6章 　特殊情况 | 下一页

# 6.18 使用 wxWidgets

这一节介绍了在 ports tree 中的 wxWidgets 库的现状， 以及它与 ports 系统的集成。

## 6.18.1 介绍

许多不同版本的 wxWidgets 库之间是存在相互冲突的 (它们会安装同名的文件) 在 ports 系统中， 这一问题是通过将不同的版本以包含版本号后缀的名字安装来解决的。

这样做的一个最明显的缺点是， 应用程序必须进行修改， 才能找到所希望的版本。 幸运的是， 多数应用程序会调用 `wx-config` 脚本来确定需要的编译器和连接器选项。 这个脚本会随可用的版本不同而有不同的名字。 主要的应用程序都会尊重环境变量的配置， 或提供一个 configure 参数， 用以指定调用哪个 `wx-config`。 如果不是这样的话， 就需要对应用程序打补丁了。

## 6.18.2 版本的选择

为了让您的 port 使用指定版本的 wxWidgets， 可以定义两个变量 (如果只定义了一个， 则另一个会取默认值)：

表 6-24. 用于选择 wxWidgets 版本的变量

变量 | 说明 | 默认值
--- | --- | ---
`USE_WX` | 列出这个 port 能使用的版本 | 全部版本
`USE_WX_NOT` | 列出这个 port 不能使用的版本 | 无

下面是可用的 wxWidgets 版本， 以及对应的 ports：

表 6-25. 可用的 wxWidgets versions

版本 | Port
--- | ---
`2.4` | `x11-toolkits/wxgtk24`
`2.6` | `x11-toolkits/wxgtk26`
`2.8` | `x11-toolkits/wxgtk28`

> 注意: 从 `2.5` 版开始， 也提供了对应的 Unicode 版本， 这种版本可以通过 slave port 安装， 与普通版本相比， 它会多一个 `-unicode` 后缀， 不过这可以通过使用变量来处理 (请参见 第 6.18.4 节)。

在 表 6-24 中的变量， 可以设为下列值或由空格分隔的组合：

表 6-26. wxWidgets 版本

说明 | 例子
--- | ---
单个版本 | `2.4`
某版本以上版本 | `2.4+`
某版本以下版本 | `2.6-`
某段版本 (版本号较小的必须在前) | `2.4-2.6`

除此之外， 还有一些用以从可用的本那本中选择所希望的版本的变量。 这种变量也可以设为一组版本， 而靠前的版本的优先级更高。

表 6-27. 用于选择希望的版本的 wxWidgets versions

变量名 | 用于
--- | ---
`WANT_WX_VER` | port
`WITH_WX_VER` | 用户

## 6.18.3 选择组件

也有一些其他应用， 尽管它们本身并不是 wxWidgets 库， 但却与之相关。 这些应用程序可以在 `WX_COMPS` 变量中使用， 以下是可用的组件：

表 6-28. 可用的 wxWidgets 组件

名称 | 说明 | 版本限制
--- | --- | ---
`wx` | 主库 | 无
`contrib` | 第三方库 | `无`
`python` | wxPython (Python 绑定) | `2.4-2.6`
`mozilla` | wxMozilla | `2.4`
`svg` | wxSVG | `2.6`

您可以为每个依赖的组件， 通过冒号分隔的后缀指定其类型。 如果没有指定， 则会使用默认的依赖类型 (参见 表 6-30)。 下面是可用的类型：

表 6-29. 可用的 wxWidgets 依赖类型

名称 | 说明
--- | ---
`build` | 联编时需要该组件， 相当于 `BUILD_DEPENDS`
`run` | 运行时需要该组件， 相当于 `RUN_DEPENDS`
`lib` | 联编和运行时均需要该组件， 相当于 `LIB_DEPENDS`

组件的默认依赖关系类型， 如下表所示：

表 6-30. 默认的 wxWidgets 依赖关系类型

组件 | 依赖关系类型
--- | ---
`wx` | `lib`
`contrib` | `lib`
`python` | `run`
`mozilla` | `lib`
`svg` | `lib`

例 6-6. 选择 wxWidgets 组件

下面的片段展示了使用 wxWidgets 版本 `2.4` 及第三方库的方法。

    USE_WX=       2.4
    WX_COMPS=     wx contrib

## 6.18.4 Unicode

wxWidgets 库从其 `2.5` 版开始支持 Unicode 了。 在 ports 系统中， 这两种版本均有提供， 并可以通过下列变量来选择：

表 6-31. 用以在 Unicode 版本的 wxWidgets 的变量

变量 | 说明 | 作用
--- | --- | ---
`WX_UNICODE` | 该 port 只能 配合 Unicode 版本使用 | port
`WANT_UNICODE` | port 能够与两种版本配合使用， 但希望使用 Unicode 版本 | port
`WITH_UNICODE` | 令 port 使用 Unicode 版本 | 用户
`WITHOUT_UNICODE` | 令 port 使用普通版本， 如果支持的话 (即未定义 `WX_UNICODE`) | 用户

> 警告: 如果 port 同时支持 Unicode 和普通版本， 请不要使用 `WX_UNICODE`。 如果希望默认启用 Unicode， 应定义 `WANT_UNICODE`。

## 6.18.5 检测已安装的版本

要检测系统中安装的版本， 就需要定义 `WANT_WX`。 如果没有将其设置为特定的版本， 则组件将包含版本后缀。 `HAVE_WX` 变量在检测完成后会自动填入内容。

例 6-7. 检测已安装的 wxWidgets 版本和组件

下面的片段可以在安装 wxWidgets 的系统中令 port 使用它， 反之则作为一项选项提供。

    WANT_WX=        yes

    .include <bsd.port.pre.mk>

    .if defined(WITH_WX) || ${HAVE_WX:Mwx-2.4} != ""
    USE_WX=         2.4
    CONFIGURE_ARGS+=--enable-wx
    .endif

下面的片段在系统中有安装过时启用 wxPython 支持， 或在没有安装时作为选项提供； 对 wxWidgets 也是如此办理， 版本皆为 `2.6`。

    USE_WX=         2.6
    WX_COMPS=       wx
    WANT_WX=        2.6

    .include <bsd.port.pre.mk>

    .if defined(WITH_WXPYTHON) || ${HAVE_WX:Mpython} != ""
    WX_COMPS+=      python
    CONFIGURE_ARGS+=--enable-wxpython
    .endif

## 6.18.6 定义的变量

以下是一些可以在 port 中使用的变量 (这之前需要定义 表 6-24 中的至少一个变量)。

表 6-32. 为使用 wxWidgets 的 port 定义的变量

变量名 | 说明
--- | ---
`WX_CONFIG` | 到 wxWidgets `wx-config` 脚本的路径 (名字会随版本不同而不同)
`WXRC_CMD` | 到 wxWidgets `wxrc` 程序的路径 (名字会随版本不同而不同)
`WX_VERSION` | 将要用到的 wxWidgets 版本 (例如， `2.6`)
`WX_UNICODE` | 如果没有定义， 而将会使用 Unicode 时， 系统将自动定义此变量。

## 6.18.7 在 `bsd.port.pre.mk` 中进行处理

如果您需要在引用了 `bsd.port.pre.mk` 之后立即对一些变量进行处理， 则需要定义 `WX_PREMK`。

> 重要: 如果定义了 `WX_PREMK`， 则在此 之后 定义的依赖关系、 组件和变量将不会生效， 您在引用 `bsd.port.pre.mk` 之前的 wxWidgets port 变量将直接起作用。

例 6-8. 在命令中使用 wxWidgets 变量

下面的片段以执行 `wx-config` 脚本来得到完整的版本号， 将其赋值到变量中， 并传递给一个程序举例说明了 `WX_PREMK` 的用法。

    USE_WX=         2.4
    WX_PREMK=       yes

    .include <bsd.port.pre.mk>

    .if exists(${WX_CONFIG})
    VER_STR!=       ${WX_CONFIG} --release

    PLIST_SUB+=     VERSION="${VER_STR}"
    .endif

> 注意: 在 target 中的 wxWidgets 变量可以直接使用， 而无需 `WX_PREMK` 的参与。

## 6.18.8 额外的 `configure` 参数

某些 GNU `configure` 脚本在只设置了 `WX_CONFIG` 环境变量时， 无法自动找到 wxWidgets， 而需要使用额外的参数来加以指定。 您可以使用 `WX_CONF_ARGS` 变量来给出这些参数。

表 6-33. 可用于 `WX_CONF_ARGS` 的值

可用值 | 结果
--- | ---
`absolute` | `--with-wx-config=${WX_CONFIG}`
`relative` | `--with-wx=${LOCALBASE} --with-wx-config=${WX_CONFIG:T}`

上一页 | 起始页 | 下一页
使用 SDL | 上一级 | 使用 Lua

若您有关于 FreeBSD ports 系统的问题， 请发送电子邮件至 <ports@FreeBSD.org>。
关于此文档的任何问题， 请致函 <doc@FreeBSD.org>。