備注:本文是在實(shí)際編譯過程中進(jìn)行編寫的,中間包含了錯(cuò)誤的操作與過程浅侨,且在操作后面?zhèn)渥⒂小翱刹贿M(jìn)行”字樣。
該文章不進(jìn)行維護(hù),請(qǐng)查看:
http://www.reibang.com/p/b6899345d18e
1沉填、準(zhǔn)備工作
下載gdal,官方下載地址佑笋,本文采用的是2.1.4這個(gè)版本(源碼直接編譯翼闹,未進(jìn)行修改;2.2.2版本里面貌似有個(gè)BUG蒋纬,交叉編譯時(shí)報(bào)to_String方法未定義):
http://trac.osgeo.org/gdal/wiki/DownloadSource
Linux編譯環(huán)境猎荠,本次采用ubuntu 16.04 LTS版本
Android NDK環(huán)境:android-ndk-r14b(在Android官網(wǎng)上下載的)
https://developer.android.com/ndk/downloads/index.html?hl=zh-cn
Android開發(fā)環(huán)境,本文采用Android Studio 2.3.3蜀备,環(huán)境的搭建可參考Android官網(wǎng)
https://developer.android.com/studio/index.html
參考文檔(感謝前輩們的貢獻(xiàn)):
https://github.com/nutiteq/gdal/wiki/AndroidHowto
http://www.c2001.net/uploads/9/9/0/8/9908187/gdal.pdf
http://www.reibang.com/p/07e3af759c86
2关摇、進(jìn)行編譯(注意需要進(jìn)行交叉編譯,先看第三節(jié)內(nèi)容)
2.1 第一次嘗試(后面編譯Android so文件時(shí)用到碾阁,可不進(jìn)行)
在下載好的gdal路徑下打開Terminal拒垃,執(zhí)行如下命令。
cd ci/travis/android/
執(zhí)行sh文件瓷蛙,進(jìn)行安裝前的準(zhǔn)備工作悼瓮。
./before_install.sh
執(zhí)行sh文件,進(jìn)行安裝艰猬。
./install.sh
2.2 第二次嘗試(可不進(jìn)行)
在下載好的gdal路徑下打開Terminal横堡,執(zhí)行如下命令。
cd ci/travis/ubuntu_1604/
執(zhí)行sh文件冠桃,進(jìn)行安裝前的準(zhǔn)備工作命贴。
./before_install.sh
執(zhí)行sh文件,進(jìn)行安裝食听。
./install.sh
2.3 安裝完 g++胸蛛,swig, ant和Java環(huán)境
注意:
- g++在Ubuntu當(dāng)前版本中默認(rèn)有安裝
- 請(qǐng)不要使用openjdk樱报,去oracle官網(wǎng)下載JDK8(當(dāng)前最新的是這個(gè)版本)葬项,具體原因詳見2.9
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
sudo apt-get install build-essential(可不進(jìn)行,無用)
sudo apt-get install libhdf4-dev(可不進(jìn)行迹蛤,無用)
sudo apt-get install python-dev(可不進(jìn)行民珍,無用)
2.4 編譯gdal
./configure
make
此時(shí)出現(xiàn)了如下錯(cuò)誤信息:
......
/usr/bin/ld: ./ogr/.libs/gml2ogrgeometry.o: Relocations in generic ELF (EM: 40)
/usr/bin/ld: ./ogr/.libs/gml2ogrgeometry.o: Relocations in generic ELF (EM: 40)
/usr/bin/ld: ./ogr/.libs/gml2ogrgeometry.o: Relocations in generic ELF (EM: 40)
./ogr/.libs/gml2ogrgeometry.o: error adding symbols: File in wrong format
collect2: error: ld returned 1 exit status
GNUmakefile:55: recipe for target 'libgdal.la' failed
make[1]: *** [libgdal.la] Error 1
make[1]: Leaving directory '/home/asen/gdal-2.2.2'
GNUmakefile:64: recipe for target 'check-lib' failed
make: *** [check-lib] Error 2
由于之前進(jìn)行了錯(cuò)誤的操作,所以造成了報(bào)錯(cuò)盗飒,此處直接跳轉(zhuǎn)到 2.6 繼續(xù)進(jìn)行嚷量。
2.5 繼續(xù)進(jìn)入"ubuntu_1604"路徑下進(jìn)行“./install.sh ”,執(zhí)行時(shí)逆趣,缺少“fossil”(可不進(jìn)行)
sudo apt-get install fossil
2.6 進(jìn)入gdal主目錄蝶溶,直接make clean后重新make,然后漫長的等待宣渗。
make clean
make
2.7 生成 GDAL 的 Java binding(包含jar包和.so文件)
cd swig/java
make
2.8 編譯報(bào)如下錯(cuò)誤
gdalconst_wrap.c:152:17: fatal error: jni.h: No such file or directory
compilation terminated.
GNUmakefile:114: recipe for target 'gdalconst_wrap.lo' failed
make: *** [gdalconst_wrap.lo] Error 1
缺少jni類庫抖所,執(zhí)行如下命令(可不進(jìn)行)
sudo apt-get install openjdk-8-jdk openjdk-8-jre-lib
猜測可能是jdk問題,因?yàn)橹坝玫氖莖penJDK落包,卸載openJDK部蛇。
sudo apt-get purge openjdk*
從orcale官網(wǎng)下載目前最新的jdk8。
http://www.oracle.com/technetwork/java/javase/downloads/jdk8-downloads-2133151.html
下載后解壓到指定文件夾下咐蝇,并配置ubuntu的環(huán)境變量涯鲁。
sudo gedit ~/.bashrc
可以在此文件末尾加入PATH的設(shè)置如下(其中jni.h在include中):
export PATH="$PATH:/home/asen/jdk1.8.0_144/include:/home/asen/jdk1.8.0_144/bin"
重新在“swig/java”文件夾中打開Terminal,進(jìn)行make(貌似make成功一次有序,下次clean之后再make又不行了抹腿,而且沒找到.so文件)。
2.9 繼續(xù)查找原因旭寿,可以通過“java.opt”來配置Java環(huán)境(配置文件在swig/java路徑下)警绩。
修改成如下內(nèi)容(修改了第一句的路徑,其他不變):
JAVA_HOME = /home/asen/jdk1.8.0_144
JAVADOC=$(JAVA_HOME)/bin/javadoc
JAVAC=$(JAVA_HOME)/bin/javac
JAVA=$(JAVA_HOME)/bin/java
JAR=$(JAVA_HOME)/bin/jar
JAVA_INCLUDE=-I$(JAVA_HOME)/include -I$(JAVA_HOME)/include/linux
重新make盅称。
2.10 繼續(xù)報(bào)錯(cuò)肩祥。
BUILD FAILED
/home/asen/gdal-2.2.2/swig/java/build.xml:22: Unable to find a javac compiler;
com.sun.tools.javac.Main is not on the classpath.
Perhaps JAVA_HOME does not point to the JDK.
It is currently set to "/usr/lib/jvm/java-8-openjdk-amd64/jre"
Total time: 0 seconds
GNUmakefile:58: recipe for target 'build' failed
make: *** [build] Error 1
猜測原因是一開始裝過java-8-openjdk的問題后室,而且看swig文件夾下,已經(jīng)能看到.so文件了混狠。
此處重新安裝openjdk岸霹,并進(jìn)行make,哈哈成功将饺。
2.11 拷貝成果
swig文件夾下自動(dòng)生成了.lib文件夾(.so文件在這里)和gdal.jar(Jar包的源碼在org文件夾中贡避,也是自動(dòng)生成出來的)
2.12 生成32位so文件(可不執(zhí)行,只要在64上操作即可)
未找到配置成32位進(jìn)行編譯的地方予弧,本文是又以32位操作系統(tǒng)刮吧,重復(fù)了上述步驟生成的。
2.13 so文件很小的問題
按照上述步驟雖然能生成so文件掖蛤,但so文件較小杀捻。
繼續(xù)完成下面的步驟:
- 進(jìn)入自己的 gdal-2.2.2 根路徑
sudo make install
cd swig
make ANDROID=yes
cd java
make ANDROID=yes
make clean
make
- 下載ndk-build,gdal已經(jīng)提供了下載的方式
注意:如果是32位的ubuntu坠七,請(qǐng)自行修改before_install.sh中的下載文件的地址(不要在32位系統(tǒng)上下載64位的ndk-build)水醋。
cd ../../ (目的為了返回gdal的根路徑)
cd ci/travis/android/
./before_install.sh (下載后的文件在當(dāng)前文件夾下)
- 配置環(huán)境變量中增加ndk的路徑地址
export PATH="$PATH:/home/asenj/android-8-toolchain/bin:/home/asenj/android-ndk-r9d:/home/asenj/jdk1.8.0_144/include:/home/asenj/jdk1.8.0_144/bin"
- 新建一個(gè)ndk-build項(xiàng)目
通過Eclipse的ADT環(huán)境新建的項(xiàng)目(由于AndroidStudio默認(rèn)是采用CMake,而gdal需要采用ndk-build)彪置。
項(xiàng)目的Github地址在文章的末尾拄踪。
- 進(jìn)入gdal根路徑下執(zhí)行命令
make lib-target
sudo make install-lib
- 拷貝源文件,首先ndk-build項(xiàng)目的根路徑打開Terminal
注意:通過上一步操作生成的源文件拳魁,默認(rèn)在usr/local中惶桐。
cd jni
# copy library bin and wrappers(從usr/local):
cp /usr/local/lib/libgdal.a ./
mkdir -p gdal/include
cp -r /usr/local/include gdal/include
#copy wrappers(從gdal中)
cp /home/asenj/gdal-2.2.2/swig/java/gdal_wrap.cpp ./
cp /home/asenj/gdal-2.2.2/swig/java/gnm_wrap.cpp ./
cp /home/asenj/gdal-2.2.2/swig/java/ogr_wrap.cpp ./
cp /home/asenj/gdal-2.2.2/swig/java/osr_wrap.cpp ./
cp /home/asenj/gdal-2.2.2/swig/java/gdalconst_wrap.c ./
# copy headers
mkdir ../jniwrap/
cp -r /home/asenj/gdal-2.2.2/swig/java/org ../jniwrap/
- 創(chuàng)建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)
- 創(chuàng)建Application.mk,目的是為了引用STLport 運(yùn)行時(shí)
APP_STL := stlport_static
APP_CFLAGS := Android.mk
APP_ABI := all
- 執(zhí)行ndk-build
ndk-build
- 編譯gdal程序出現(xiàn)以下問題:
libgdal.a(contour.o): incompatible target
......
undefined reference to ‘GDALAllRegister’
undefined reference to ‘GDALOpen’
......
因?yàn)閘inux 自帶的GCC編譯出來的是X86架構(gòu)的潘懊,我們需要ARM架構(gòu)的庫姚糊。
3、GDAL-Android交叉編譯配置
3.1 命令行找到NDK下面build/tool/make-standalone-toolchain.sh
./make-standalone-toolchain.sh --toolchain=arm-linux-androideabi-4.9 --arch=arm --platform=android-15 --install-dir=/home/asen/android-toolchain-15-armv7
也可以在通過shell腳本來執(zhí)行(注意是bash授舟,因?yàn)槟J(rèn)的sh是用的dash救恨,不支持?jǐn)?shù)組),如下:
#!/bin/bash
export NDK_HOME=/home/asen/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-toolchain/${archs[i]} --toolchain=${toolchains[i]}
done
執(zhí)行這個(gè)shell腳本
bash make_toolchain.sh
這個(gè)腳本執(zhí)行后的toolchain會(huì)在home路徑下生成释树。
3.2 配置環(huán)境變量
下面是我的配置肠槽,自行修改路徑地址,注意奢啥,一定要改成將$PATH放到末尾秸仙。
export PATH="/home/asen/android-toolchain/arm/bin:/home/asen/android-ndk-r14b:/home/asen/jdk1.8.0_144/include:/home/asen/jdk1.8.0_144/bin:$PATH"
export PATH="/home/asen/android-ndk-r14b/platforms/android-19/arch-arm:$PATH"
export LIBS="-lstdc++ -liconv -lgnustl_shared"
export CC=/home/asen/android-toolchain/arm/bin/arm-linux-androideabi-gcc
export CXX=/home/asen/android-toolchain/arm/bin/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"
3.3 進(jìn)入gdal根路徑下執(zhí)行./configure命令
下面是我的配置命令,注意去掉換行符桩盲〖偶停可參考地址:http://www.reibang.com/p/07e3af759c86
CFLAGS="-mthumb" CXXFLAGS="-mthumb" LIBS="-lsupc++ -lstdc++" ./configure --host=arm-linux-androideabi --prefix=/home/asen/gdalAndroid --without-gif --with-threads --with-ogr --with-geos --with-libz=internal
可以增加 --without內(nèi)容來減少部分不需要的驅(qū)動(dòng)。
CFLAGS="-mthumb" CXXFLAGS="-mthumb" LIBS="-lsupc++ -lstdc++" ./configure --prefix=/home/asen/gdalAndroid --host=arm-linux-androideabi --with-unix-stdio-64=no --with-ogr --with-geos --with-geotiff=internal --with-hide-internal-symbols --with-libtiff=internal --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
官網(wǎng)地址:https://trac.osgeo.org/gdal/wiki/BuildingOnUnixWithMinimizedDrivers
執(zhí)行后,一定要在打印的內(nèi)容中出現(xiàn)checking whether we are cross compiling... yes捞蛋,才算成功孝冒。
3.4 進(jìn)行編譯
make clean
make
make install
make lib-target
make install-lib
3.5 更改成gdal-2.1.4進(jìn)行編譯
gdal-2.2.2 在交叉編譯時(shí),報(bào)一個(gè)to_string方法未公開的錯(cuò)拟杉,可能是gdal的一個(gè)bug吧迈倍。
3.6 生成swig綁定和包裝
cd swig
make ANDROID=yes
cd java
make ANDROID=yes
make ANDROID=yes時(shí),會(huì)出現(xiàn)如下錯(cuò)誤捣域,去對(duì)應(yīng)的Java文件中,刪掉未找到的方法(不知道會(huì)不會(huì)有隱藏錯(cuò)誤)宴合。
3.6 拷貝源文件
參考2.13中的拷貝源文件焕梅。
3.7 編譯Android
ndk-build
編譯成功的效果如圖:
4、Android上測試成果
4.1 從ubuntu中拷貝數(shù)據(jù)
拷貝數(shù)據(jù)的過程中卦洽,遇到一個(gè)問題贞言,當(dāng)拷貝.so文件時(shí),出現(xiàn)如下錯(cuò)誤阀蒂。
4.2 通過U盤拷貝數(shù)據(jù)
4.3 構(gòu)建Android項(xiàng)目(不做大篇幅講解)
新建Project该窗,然后拷貝對(duì)應(yīng)的jar包和so文件,最終項(xiàng)目結(jié)構(gòu)圖如下蚤霞。
4.4 運(yùn)行結(jié)果
此項(xiàng)目為shp文件的簡單讀寫操作酗失,生成的shp文件通過QGIS Desktop查看如下:
4.5 shp文件對(duì)中文的支持
5 Github地址
ndk-build項(xiàng)目地址:
測試的studio項(xiàng)目地址: