交叉编译OpenCV的Android版本
OpenCV作为一个强大的图像处理库,在Android上也有强大的应用。
OpenCV官网提供了SDK的下载,可以直接下载使用
OpenCV官网地址:https://opencv.org/
不过有时候也会有自定义编译的需求
下面来记录一下最近在交叉编译OpenCV所作的笔记
避免以后走弯路。
编译Host系统是Ubuntu 16.04
准备工作
下载opencv:
git clone git@github.com:opencv/opencv.git
git checkout 3.4
下载opencv依赖的库
git clone git@github.com:opencv/opencv_contrib.git
git checkout 3.4
这里我们使用的版本都是3.4。
配置环境:
1. 安装ant
编译Java代码需要用到ant或者gradle
但是我还没搞清楚怎么配置使用gradle编译
而且我这次是在服务器上工作,没有x11环境
没装Android Studio,所以,姑且使用ant编译Java。
修改opencv/CMakeLists.txt文件
激活ant编译
set(ANDROID_PROJECTS_SUPPORT_ANT ON)
sudo apt-get install ant
2. 安装ndk
安装ndk需要翻wall,请自备*
这里写了一个python程序,用于枚举NDK的版本,
然后手动输入选择下载对应的版本,
这里我下载的r17c版本NDK,下载完成之后配置NDK_ROOT环境变量
#!/usr/bin/env python import urllib2
import collections
import json
import os def init():
"""
Return name/link dict @return: name-to-link dict
"""
with open('table.json') as data_file:
url_table = json.load(data_file) if url_table is None or len(url_table) <= 0:
print('\033[91m' + ' There is no item in table.json ' + '\033[0m')
os.sys.exit(0) # Sort alphabetically
url_table = collections.OrderedDict(sorted(url_table.items()))
index = 0
for key in url_table:
index = index + 1
print str(index) + '] ' + key return url_table def getTargetLink(desired_index, url_table):
"""
Return download link @type desired_index: number
@param desired_index: Desired index
@type url_table: dict
@param url_table: name-to-link @return: Download link
"""
index = 0
for key in url_table:
index = index + 1
if desired_index == index:
return url_table[key]
return None def download(url):
if url == None:
return file_name = url.split('/')[-1]
u = urllib2.urlopen(url)
f = open(file_name, 'wb')
meta = u.info()
file_size = int(meta.getheaders("Content-Length")[0])
print "Downloading: %s Bytes: %s" % (file_name, file_size) file_size_dl = 0
block_sz = 8192
while True:
buffer = u.read(block_sz)
if not buffer:
break file_size_dl += len(buffer)
f.write(buffer)
status = r"%10d [%3.2f%%]" % (file_size_dl, file_size_dl * 100. / file_size)
status = status + chr(8)*(len(status)+1)
print status, f.close() if __name__ == '__main__':
url_table = init()
var = raw_input("Please enter the numer you want to download: ")
link = getTargetLink(int(var), url_table)
download(link)
3. 安装SDK
由于我们需要编译的android版本,需要用到SDK的build tools和sdk的platform版本库
这里使用SDK的build tools版本是24.0.3
往上的版本,Google去掉了aidl,会导致没法编译Java端的代码,也无法生成libopencv_java3.so
所以在下载的SDK版本中,build tools只能保留不高于24.0.3的版本
platform版本库使用android-21
下载SDK的方法:
找一台装有Android Studio的电脑,使用SDK Manager下载对应的版本即可
然后将SDK拷贝至交叉编译的电脑上,配置SDK环境变量
export NDK_ROOT=/path/to/android-ndk-r17c
export ANDROID_HOME=path/to/sdk
4. 配置SDK tools版本
在我们的SDK中,有个tools目录
具体的版本,是Android Studio在SDK Manager中配置的
但是OpenCV只能支持到tools_r25.2.5-linux.zip
所以需要手动下载tools_r25.2.5-linux.zip,解压替换SDK目录的tools
下载地址:https://dl.google.com/android/repository/tools_r25.2.5-linux.zip
5. 安装CMake和其它编译环境
sudo apt-get install cmake
sudo apt-get install build-essential make
开始交叉编译
由于OpenCV需要使用cmake编译
需要配置很多参数,所以使用bash脚本是最方便的方式
编译脚本放在opencv和opencv_contrib的同级目录
#!/bin/bash
NDK_ROOT="${1:-${NDK_ROOT}}" ### ABIs setup
#declare -a ANDROID_ABI_LIST=("armeabi-v7a with NEON")
declare -a ANDROID_ABI_LIST=("armeabi-v7a") ### path setup
SCRIPT=$(readlink -f $)
WD=`dirname $SCRIPT`
OPENCV_ROOT="${WD}/opencv"
N_JOBS=${N_JOBS:-} INSTALL_DIR="${WD}/opencv-build"
rm -rf "${INSTALL_DIR}/opencv" ### Make each ABI target iteratly and sequentially
for i in "${ANDROID_ABI_LIST[@]}"
do
ANDROID_ABI="${i}"
echo "Start building ${ANDROID_ABI} version" if [ "${ANDROID_ABI}" = "armeabi" ]; then
API_LEVEL=
else
API_LEVEL=
fi temp_build_dir="${OPENCV_ROOT}/platforms/build_android_${ANDROID_ABI}"
### Remove the build folder first, and create it
#-DANDROID_TOOLCHAIN_NAME=clang
#-DANDROID_TOOLCHAIN_NAME="arm-linux-androideabi-5" \
#-DANDROID_STL=gnustl_static \
rm -rf "${temp_build_dir}"
mkdir -p "${temp_build_dir}"
cd "${temp_build_dir}" cmake -DCMAKE_BUILD_WITH_INSTALL_RPATH=ON \
-DCMAKE_TOOLCHAIN_FILE="${OPENCV_ROOT}/platforms/android/android.toolchain.cmake" \
-DANDROID_NDK="${NDK_ROOT}" \
-DANDROID_NATIVE_API_LEVEL=${API_LEVEL} \
-DANDROID_ABI="${ANDROID_ABI}" \
-DANDROID_CPP_FEATURES="rtti exceptions" \
-DANDROID_ARM_NEON=TRUE \
-DANDROID_STL=gnustl_static \
-DCMAKE_BUILD_TYPE=Release \
-D BUILD_opencv_java=ON \
-D BUILD_ANDROID_PROJECTS=ON \
-D WITH_CUDA=OFF \
-D WITH_MATLAB=OFF \
-D BUILD_ANDROID_EXAMPLES=OFF \
-D BUILD_DOCS=OFF \
-D BUILD_PERF_TESTS=OFF \
-D BUILD_TESTS=OFF \
-DOPENCV_EXTRA_MODULES_PATH="${WD}/opencv_contrib/modules/" \
-DCMAKE_INSTALL_PREFIX="${INSTALL_DIR}/opencv" \
../..
# Build it
make -j${N_JOBS}
# Install it
make install/strip
### Remove temp build folder
cd "${WD}"
rm -rf "${temp_build_dir}"
echo "${temp_build_dir}"
echo "end building ${ANDROID_ABI} version"
done
这里只启用了armeabi-v7a编译目标
其它平台可根据需求添加
目前无法使用ANDROID_TOOLCHAIN_NAME来指定clang编译器
因为OpenCV的makefile在解析clang交叉编译工具链使用的代码没做匹配
而我也暂时没精力自己修改做匹配
有兴趣的同学,可以修改
${OPENCV_ROOT}/platforms/android/android.toolchain.cmake
来匹配clang编译器
STL链接使用的是gnu版本的
因为OpenCV用到了C++11
如果使用c++_static版本,因为Google没做后续支持维护
gcc在这个工具链上不支持很多C++和C++11特性
会导致编译失败,我尝试过使用CrystaX NDK
但是在configure阶段就失败了
只能无疾而终
其它编译选项顾名思义,不做过多解析。
备注:
如果需要使用C++14特性编译
需要修改opencv/CMakeList.txt文件
手动添加,pathch如下所示
--- a/CMakeLists.txt
+++ b/CMakeLists.txt
@@ -, +, @@ endif()
OCV_OPTION(ENABLE_CXX11 "Enable C++11 compilation mode" "${OPENCV_CXX11}")
include(cmake/OpenCVDetectCXXCompiler.cmake)
ocv_cmake_hook(POST_DETECT_COMPILER)
-
+set(CMAKE_CXX_STANDARD )
+set(CMAKE_CXX_STANDARD_REQUIRED ON)
+set(CMAKE_VERBOSE_MAKEFILE ON)
+set(ANDROID_PROJECTS_SUPPORT_ANT ON)
# Add these standard paths to the search paths for FIND_LIBRARY
# to find libraries from these locations first
if(UNIX AND NOT ANDROID)