19.5 在 Linux 下创建应用程序

使用 HALCON 算子的 C 程序必须包含 HalconC.h 文件，该文件包含所有与用户相关的 HALCON 系统定义以及 C 接口所需的声明。为此，请在 C 文件顶部添加以下命令：

  #include "HalconC.h"

使用这种语法，编译器只能在当前目录下查找 HalconC.h。或者，您也可以使用 -I<pathname> 命令行标志来表示包含文件的目录，从而告诉编译器在哪里可以找到该文件。

要创建应用程序，需要将两个库链接到程序中：libhalconc.so 库包含 HALCON/C 接口的各种组件。 libhalconc.so 是 HALCON 库。

HALCON XL 应用：  ! 
请注意 ，只有在需要 HALCON XL 功能时才使用。

如果要使用 HALCON XL，则必须链接 libhalconcxl.so 和 libhalconxl.so 库。

要在 Linux 下链接和运行应用程序，请确保系统变量 LD_LIBRARY_PATH 包含 HALCON 库路径 $HALCONROOT/lib/$HALCONARCH。

在 Linux 下使用 CMake 构建 HALCON 示例

您可以在 $HALCONEXAMPLES/c 下面的目录中找到展示各种 HALCON 用例以及如何用 C 实现这些用例的示例。您可以使用提供的 CMakeLists.txt 文件用 CMake 构建这些示例。

要使用 CMake 生成示例程序，请执行以下操作：

1. 如有需要，请从 CMake 网站 下载 CMake（3.7.1 或更高版本）并安装。
2. 创建构建目录，然后运行 cmake 配置构建并创建应用程序：

     mkdir build
     cd build
     cmake $HALCONEXAMPLES/c
     cmake --build .
   

   要进行配置，CMake 需要知道 HALCON 安装的位置、示例文件的位置以及要使用的 HALCON 架构：

   • 通过 HALCON_DIR CMake 选项指定 HALCON 的安装位置，如果未设置该选项，则通过 $HALCONROOT 环境变量指定。
   • 通过 $HALCONEXAMPLES 环境变量指定 HALCON 示例文件的位置。
   • 使用 HALCON_ARCHITECTURE CMake 选项或 $HALCONARCH 环境变量指定 HALCON 架构。如果既未设置选项也未设置环境变量，CMake 将尝试根据主机构建系统来猜测架构。

   有关如何使用 CMake 的一般信息，请参阅 CMake 文档 。

   HALCON XL 应用：默认情况下，示例将使用标准版本的 HALCON 构建。如果要使用 HALCON XL 构建，请在 CMake 配置时将选项 HALCON_XL 设为 ON 或 1。

3. 作为选项，您可以使用 -G 选项指定新构建树的生成器。
   有关 CMake 生成器的更多信息，请参阅 CMake 文档 。