注意:
- 本文在编译过程中所有准备的版本都是64位。
- 本文是在一台新安装的Ubuntu系统上进行编译(可以是实体机或虚拟机)。
- 本文gdal-2.1.4编译后的so文件必须运行在Android 5.0及以上,且CPU为ARM的Android设备上。
- 如需运行在低版本的Android上,可降低gdal的版本。
- 如需运行在CPU为x86的平台上,可设置编译采用x86。
- 编译出的so文件支持中文的读写(恭喜我吧,成功找到了方法)。
一、准备工作
- 1、Ubuntu 16.04 LTS
- 2、android-ndk-r14b
下载地址:
https://developer.android.com/ndk/downloads/index.html
- 3、gdal-2.1.4
下载地址:
https://trac.osgeo.org/gdal/wiki/DownloadSource
备注:原本想用2.2.2版本的,但是在交叉编译时报一个to_string方法未公开的错,因此选择了2.1.4这个版本。
二、编译环境搭建
- 1、安装 g++,swig, ant和openjdk
sudo apt-get update
sudo apt-get install g++
sudo apt-get install swig
sudo apt-get install ant
sudo apt-get install openjdk-8-jdk
- 2、NDK环境搭建
将下载好的NDK解压到某个路径下,并配置环境变量。本文通过修改/etc/profile文件来进行配置。
打开配置文件(后面不会再重复这步操作):
sudo gedit /etc/profile
末尾添加环境变量(具体的路径自行调整):
export NDK_HOME = /home/asen/Android/android-ndk-r14b
export PATH = $NDK_HOME:$PATH
执行下面的命令让环境变量立即生效(后面不会再重复这步操作):
source /etc/profile
测试环境变量,如果NDK的版本信息,就说明是配置正确:
ndk-build -v
- 3、交叉编译的环境搭建
注意:这个是编译的关键部分,如不配置交叉编译,后面的.a文件没法通过ndk-build。
新建如下Shell脚本,名为make_toolchain.sh:
#!/bin/bash
export NDK_HOME=/home/asen/Android/android-ndk-r14b
platform=android-21
shmake=$NDK_HOME/build/tools/make-standalone-toolchain.sh
archs=(
'arm'
'arm64'
'x86'
'x86_64'
'mips'
'mips64'
)
toolchains=(
'arm-linux-androideabi-4.9'
'aarch64-linux-android-4.9'
'x86-4.9'
'x86_64-4.9'
'mipsel-linux-android-4.9'
'mips64el-linux-android-4.9'
)
echo $NDK_HOME
num=${#archs[@]}
for ((i=0;i<$num;i++))
do
sh $shmake --arch=${archs[i]} --platform=$platform --install-dir=$HOME/Android/android-toolchain/${archs[i]} --toolchain=${toolchains[i]}
done
执行这个shell脚本,执行后会在$HOME/Android/android-toolchain路径下生成android-toolchain文件夹:
bash make_toolchain.sh
配置交叉编译的环境变量(此处先以arm进行编译,可自行更改为android-toolchain中的其他文件夹):
export TOOLCHAIN_HOME=/home/asen/Android/android-toolchain/arm
export PATH=$TOOLCHAIN_HOME/bin:$PATH
export LIBS="-lstdc++ -liconv -lgnustl_shared"
export CC=arm-linux-androideabi-gcc
export CXX=arm-linux-androideabi-g++
export CXXFLAGS="-march=armv7-a -mfloat-abi=softfp -mfpu=vfpv3-d16"
export CFLAGS="-march=armv7-a -mfloat-abi=softfp -mfpu=vfpv3-d16"
export LDFLAGS="-march=armv7-a -Wl,--fix-cortex-a8"
此处需要重启电脑后生效,测试如下:
arm-linux-androideabi-gcc -v
gcc version 4.9 20140827 (prerelease) (GCC)
当显示gcc version 4.9.x 20150123 (prerelease) (GCC)版本时,则为正确(PS:因为本文下载的是这个版本),如果不是,请确认下系统中是否存在多个arm-linux-androideabi-gcc版本,可能会影响到后面的编译过程。
- 4、将下载的gdal214.zip解压后待用
三、中文支持
此处需要修改gdal-2.1.4/ogr/ogrsf_frmts/shape/shape2ogr.cpp文件,这个问题我找了好多天了,网上没找到这方面的答案,最后只能去看源码。在此先为自己点个赞!
这可能不是最好的处理方式,如果谁发现了更好的解决方案的话,欢迎留言!
- 1、修改SHPReadOGRFeature方法
将方法中的
char *pszUTF8Field = CPLRecode( pszFieldVal, pszSHPEncoding, CPL_ENC_UTF8);
改成
char *pszUTF8Field = CPLRecode( pszFieldVal, CPL_ENC_UTF8, CPL_ENC_UTF8);
- 2、修改SHPWriteOGRFeature方法
将方法中的
pszEncoded = CPLRecode( pszStr, CPL_ENC_UTF8, pszSHPEncoding );
改成
pszEncoded = CPLRecode( pszStr, CPL_ENC_UTF8, CPL_ENC_UTF8 );
四、交叉编译
- 1、执行.configure命令
进入gdal的解压路径下,打开Terminal,执行如下命令:
CFLAGS="-mthumb" CXXFLAGS="-mthumb" LIBS="-lsupc++ -lstdc++" ./configure --host=arm-linux-androideabi --prefix=/home/asen/gdal/Android --without-gif --with-threads --with-ogr --with-geos --with-libz=internal
可以增加 --without内容来减少部分不需要的驱动,如下:
CFLAGS="-mthumb" CXXFLAGS="-mthumb" LIBS="-lsupc++ -lstdc++" ./configure --prefix=/home/asen/gdal/Android --host=arm-linux-androideabi --with-unix-stdio-64=no --with-ogr --with-geos --with-hide-internal-symbols --with-libz=internal --with-threads --without-bsb --without-cfitsio --without-cryptopp --without-curl --without-dwgdirect --without-ecw --without-expat --without-fme --without-freexl --without-gif --without-gif --without-gnm --without-grass --without-grib --without-hdf4 --without-hdf5 --without-idb --without-ingres --without-jasper --without-jp2mrsid --without-jpeg --without-kakadu --without-libgrass --without-libkml --without-libtool --without-mrf --without-mrsid --without-mysql --without-netcdf --without-odbc --without-ogdi --without-openjpeg --without-pcidsk --without-pcraster --without-pcre --without-perl --without-pg --without-php --without-png --without-python --without-qhull --without-sde --without-sqlite3 --without-webp --without-xerces --without-xml2
具体--without的内容可参考官网地址:
https://trac.osgeo.org/gdal/wiki/BuildingOnUnixWithMinimizedDrivers
执行后,一定要在打印的内容中看到checking whether we are cross compiling... yes,才算成功。
- 2、进行编译并安装,安装的路径在上面的--prefix=后面配置
make
make install
- 3、生成java文件和需要的c、c++文件
cd swig
make ANDROID=yes
cd java
make ANDROID=yes
在编译java中的命令时,会出现如下错误:
处理方法:删掉报错类中报错的地方,重新make ANDROID=yes。
五、编译Android能用的so文件
1、新建jni文件夹
2、拷贝源文件(注意:源文件的地址根据自己电脑的情况设置)
cd /home/asen/gdal/jni
# copy library bin and wrappers:
cp /home/asen/gdal/Android/lib/libgdal.a ./
mkdir -p gdal
cp -r /home/asen/gdal/Android/include gdal
#copy wrappers
cp /home/asen/gdal/gdal-2.1.4/swig/java/*_wrap.cpp ./
cp /home/asen/gdal/gdal-2.1.4/swig/java/gdalconst_wrap.c ./
# copy headers
cp -r /home/asen/gdal/gdal-2.1.4/swig/java/org ../jniwrap/
cp /home/asen/gdal/gdal-2.1.4/swig/java/gdal.jar ../jniwrap/
其中jniwrap为Java代码的源文件和jar包。
- 3、创建Android.mk文件,并写入下面的内容
LOCAL_PATH := $(call my-dir)
include $(CLEAR_VARS)
LOCAL_MODULE := gdal
LOCAL_EXPORT_C_INCLUDES := $(LOCAL_PATH)/gdal/include
LOCAL_SRC_FILES := libgdal.a
LOCAL_EXPORT_LDLIBS := -lz
include $(PREBUILT_STATIC_LIBRARY)
include $(CLEAR_VARS)
LOCAL_MODULE := gdaljni
LOCAL_SRC_FILES := gdal_wrap.cpp
LOCAL_STATIC_LIBRARIES := gdal
include $(BUILD_SHARED_LIBRARY)
include $(CLEAR_VARS)
LOCAL_MODULE := gdalconstjni
LOCAL_SRC_FILES := gdalconst_wrap.c
LOCAL_STATIC_LIBRARIES := gdal
include $(BUILD_SHARED_LIBRARY)
include $(CLEAR_VARS)
LOCAL_MODULE := ogrjni
LOCAL_SRC_FILES := ogr_wrap.cpp
LOCAL_STATIC_LIBRARIES := gdal
include $(BUILD_SHARED_LIBRARY)
include $(CLEAR_VARS)
LOCAL_MODULE := osrjni
LOCAL_SRC_FILES := osr_wrap.cpp
LOCAL_STATIC_LIBRARIES := gdal
include $(BUILD_SHARED_LIBRARY)
- 4、创建Application.mk文件,并写入下面的内容
APP_STL := gnustl_static
APP_CFLAGS := Android.mk
APP_ABI := armeabi-v7a
APP_PLATFORM := android-21
- 5、进行编译
ndk-build
- 6、编译成功
保存的路径在jni文件夹所在的路径。
六、Android Studio测试
- 1、新建Android项目,并拷贝编译好的文件
- 2、运行结果截图
- 3、QGIS中查看shp文件
首先需要将编码方式改成UTF-8。
七、Github地址
参考文章
https://github.com/nutiteq/gdal/wiki/AndroidHowto
http://www.c2001.net/uploads/9/9/0/8/9908187/gdal.pdf