gdal-sys

为Rust提供的低级GDAL绑定。构建脚本会尝试自动检测已安装的GDAL版本。

包含

• 数据类型映射
• 栅格（GDAL）和矢量（OGR）操作
• 错误处理
• 空间参考操作

构建

构建脚本应在Linux和Windows系统上正常工作。它可以配置一些环境变量

• 如果定义了 GDAL_INCLUDE_DIR 或 GDAL_LIB_DIR，则将使用它们。您还应设置 GDAL_VERSION 为 X.Y.Z
• 否则，如果定义了 GDAL_HOME，构建脚本会查找 GDAL_HOME/include，GDAL_HOME/lib 和 GDAL_HOME/bin
• 最后，通过查询 pkg-config 来确定 GDAL 位置
• 您可以定义 GDAL_STATIC 以静态链接 GDAL

包含目录仅在您选择在构建时生成绑定时使用。

在Linux上，构建应该会自动完成。

在Windows上，最简单的解决方案是将环境变量 GDAL_HOME 指向 GDAL 文件夹。

• windows-msvc 需要 gdal_i.lib 被找到在 %GDAL_HOME%\lib 中。
• windows-gnu 需要 %GDAL_HOME%\lib 中的 gdal_i.lib 或者 gdal{version}.dll 在 %GDAL_HOME%\bin 中。

生成的绑定

默认情况下，gdal-sys 将检测您已安装的 libgdal 版本，并尝试使用对应版本的预构建绑定。或者，您可以通过指定 bindgen 功能从您的 libgdal 安装中生成自己的绑定。

创建预构建绑定

如果发布了 GDAL 的新版本，您（作为 gdal 贡献者）可以通过使用 bindgen 功能构建并复制生成的文件来生成新绑定，并将其包含在 gdal-sys 源分发中。例如（哈希值在您的构建中会有所不同）

$ cargo build --features bindgen
$ cp target/debug/build/gdal-sys-db833e3088b78e57/out/bindings.rs gdal-sys/prebuilt-bindings/gdal_3.6.rs