如何在Swift中导入基于C++的GDAL .a静态库并解决导入异常问题

核心问题解决 #

Swift桥接文件不支持直接导入C头文件，modulemap导入失败通常是缺少C语言声明或者路径配置错误，优先采用Objective-C++封装的方案适配，步骤如下：

1. 新增Objective-C++封装层 #

新建两个文件，头文件后缀为.h（纯Objective-C语法，可直接加入桥接文件），实现文件后缀为.mm（支持Objective-C与C混编，可直接引用GDAL的C头文件）。

2. 项目配置修正 #

• 将编译生成的GDAL静态库（.a格式）加入项目Build Phases > Link Binary With Libraries列表
• 在Build Settings > Header Search Paths中添加GDAL头文件存放路径，权限设为递归
• 在Build Settings > Other Linker Flags中添加-lc++，链接C++标准库
• 如果仍要使用modulemap导入，需在modulemap中增加requires cplusplus声明，示例如下：

module GDAL {
    header "gdal.h"
    header "gdal_priv.h"
    // 追加所有需要引入的GDAL头文件
    requires cplusplus
    export *
}

同时在Build Settings > Import Paths中添加modulemap文件的存放路径。

3. 栅格坐标转换功能实现 #

封装层头文件 GDALHelper.h

#import <Foundation/Foundation.h>
#import <CoreLocation/CoreLocation.h>

@interface GDALHelper : NSObject
/// 栅格行列号转WGS84地理坐标
/// @param tifPath 本地栅格文件路径
/// @param col 栅格列号
/// @param row 栅格行号
/// @return 转换后的坐标，转换失败返回kCLLocationCoordinate2DInvalid
+ (CLLocationCoordinate2D)convertRasterPointToCoordinateWithTifPath:(NSString *)tifPath col:(int)col row:(int)row;
@end

封装层实现文件 GDALHelper.mm

#import "GDALHelper.h"
#include "gdal_priv.h"
#include "ogr_spatialref.h"

@implementation GDALHelper

+ (CLLocationCoordinate2D)convertRasterPointToCoordinateWithTifPath:(NSString *)tifPath col:(int)col row:(int)row {
    GDALAllRegister();
    GDALDataset *dataset = (GDALDataset *)GDALOpen([tifPath UTF8String], GA_ReadOnly);
    if (!dataset) return kCLLocationCoordinate2DInvalid;
    
    double geoTransform[6];
    if (dataset->GetGeoTransform(geoTransform) != CE_None) {
        GDALClose(dataset);
        return kCLLocationCoordinate2DInvalid;
    }
    
    // 栅格坐标转投影坐标
    double projX = geoTransform[0] + col * geoTransform[1] + row * geoTransform[2];
    double projY = geoTransform[3] + col * geoTransform[4] + row * geoTransform[5];
    
    // 投影坐标转WGS84坐标，可按需修改目标坐标系
    OGRSpatialReference srcSRS, targetSRS;
    srcSRS.importFromWkt(dataset->GetProjectionRef());
    targetSRS.SetWellKnownGeogCS("WGS84");
    
    OGRCoordinateTransformation *transform = OGRCoordinateTransformation::Create(&srcSRS, &targetSRS);
    if (!transform) {
        GDALClose(dataset);
        return kCLLocationCoordinate2DInvalid;
    }
    
    transform->Transform(1, &projX, &projY);
    OGRCoordinateTransformation::DestroyCT(transform);
    GDALClose(dataset);
    
    return CLLocationCoordinate2DMake(projY, projX);
}

@end

4. Swift调用说明 #

在项目的桥接文件中导入GDALHelper.h，即可直接在Swift代码中调用封装好的方法，示例：

let coordinate = GDALHelper.convertRasterPointToCoordinateWithTifPath("本地tif路径", col: 100, row: 200)
if CLLocationCoordinate2DIsValid(coordinate) {
    print("转换后的坐标：\(coordinate.latitude), \(coordinate.longitude)")
}

提示：无需modulemap配置，仅用OC++封装的方案兼容性更高，适配成本更低

内容的提问来源于stack exchange，提问作者Mayank Verma