(注意:本文是 OpenCV4Android "Introduction into Android Development" 这篇文章的翻译,主要讲解使用 Eclipse IDE 作为开发工具,搭建 SDK 和 NDK 的开发环境。目前 Android 开发官方推荐使用 Android Studio 来代替 Eclipse,并且停止了对 Eclipse 的继续支持,所以这篇文章讲解的内容已经过时,对依旧使用 Eclipse 的开发者仍有参考价值 )
Android 开发
本指南旨在帮助您快速学习 Android 开发环境的搭建。虽然 Android SDK 可以在 Linux(Ubuntu),Mac OS X和任何其他操作系统上使用,但这里假设你用的 Windows 7。如果在遵循这些步骤后仍然遇到错误,请通过 OpenCV4Android 讨论组或 OpenCV QA 平台与我们联系。
前言
Android 是由 Google 领导的开放手机联盟开发的基于 Linux 的开源移动操作系统。有关详细信息,请参阅 Android 主页。Android 开发与其他平台开发有显著的不同。因此,在开始为 Android 编程之前,我们建议您确保对下面的关键知识点已经非常熟悉:
- Java 编程语言是 Android 平台的主要开发技术。您可以在 Oracle文档 上找到 Java 相关的资料。
- Java Native Interface (JNI)是一种在 Java 虚拟机中运行 Native 代码的技术。您可以在 Oracle文档 上找到有用资料
- Android Activity 及其生命周期,这是一个非常重要的 Android API 类
- OpenCV 开发还需要一些 Android Camera 相关的知识
Android 开发环境快速设置
如果你想要快速自动的搭建 Android 开发环境,你可以尝试由 NVIDIA 发布的 Tegra Android 开发包(TADP)。TADP 解压完成后,将自动配置所有环境设置,然后您就可以跳过本指南的其余部分直接开始开发了。如果你是一个 Android 开发初学者,我们建议你从 TADP 开始。
Android开发环境手动设置
️注意:Eclipse 已经过时,用 Android Studio 代替
Java 开发环境的配置
您需要安装以下软件才可以用 Java 来开发 Android 应用:
Eclipse 版本:
- Sun JDK 6(也可以是Sun JDK 7和8)
- Android SDK
- Android SDK components
- Eclipse IDE
- ADT plugin for Eclipse
Android Studio 版本:
- Sun JDK 6(也可以是Sun JDK 7和8)
- Android Studio
C++ Native 开发环境配置
您需要安装以下软件才可以用 C++ 来开发 Android 应用:
Eclipse 版本:
- Android NDK
- CDT plugin for Eclipse
Android Studio 版本:
- Android NDK
- LLDB
- CMake
Android 应用程序项目的结构
Eclipse 版本:
- rootfolderoftheproject/
- jni/
- libs/
- res/
- src/
- AndroidManifest.xml
- project.properties
- ...otherfiles...
- src 文件夹包含应用程序的Java代码
- res 文件夹包含应用程序的资源(图像,描述UI布局的xml文件等)
- libs 文件夹将在成功构建之后包含 native 库和 jar 包
- jni 文件夹包含 C / C++ 应用程序源代码和NDK的构建脚本 Android.mk 和Application.mk,这些将生成 Native 库
- AndroidManifest.xml 文件提供关于应用程序到 Android 系统的基本信息(应用程序名称,主应用程序包的名称,应用程序组件,所需的权限等)。它可以使用 Eclipse 向导或 Android SDK 中的 Android 工具创建。
- project.properties 是一个包含目标 Android 平台和其他构建详细信息的文本文件。此文件由 Eclipse 生成或可以使用 Android SDK 中包含的 Android 工具创建。
Android Studio 版本:
Android.mk 和 Application.mk 脚本
Android.mk 脚本文件通常如下面结构
LOCAL_PATH := $(call my-dir)
include $(CLEAR_VARS)
LOCAL_MODULE := <module_name>
LOCAL_SRC_FILES := <list of .c and .cpp project files>
<some variable name> := <some variable value>
...
<some variable name> := <some variable value>
include $(BUILD_SHARED_LIBRARY)
这是构建 android 应用 c++ 源码需要的最小的 Android.mk 文件,注意前两行和最后一行对于任何 Android.mk 都是必需的。
通常 Application.mk 文件是可选的,但是当在项目种使用了 OpenCV ,在 C++ 中使用 STL 和异常时,也应该创建它。文件 Application.mk 的示例:
APP_STL := gnustl_static
APP_CPPFLAGS := -frtti -fexceptions
APP_ABI := all
从命令行构建应用程序 Native 部分
下面是编译 Android 中 C++ 部分代码的标准方式
- 打开命令行,来到 Android 项目的根目录
cd <root folder of the project>/
- 运行下面命令
<path_where_NDK_is_placed>/ndk-build
- 执行上面的命令后 C++ 部分的源码就会被编译
从 Eclipse 构建应用程序 Native 部分(CDT Builder)
有许多种方式可以把 NDK 编译 Native C++ 代码的功能集成到 Eclipse 的构建器里面,我们推荐使用 EclipseCDT Builder。
定义 NDKROOT 环境变量包含 Android NDK 在系统中的路径(比如"X:\Apps\android-ndk-r8"or"/opt/android-ndk-r8" )
重启 Eclipse
打开 Eclipse ,加载 Android app 项目
-
通过 Eclipse 菜单
New -> Other -> C/C++ -> Convert to a C/C++ Project
给项目添加 c/c++ 性质
选中要转的项目,设置 Project type” =Makefileproject, “Toolchains” =OtherToolchain
- 打开
Project Properties -> C/C++ Build
,不要勾选Usedefaultbuildcommand
,在 Windows 上设置Build command
为 "${NDKROOT}/ndk-build.cmd",在 Linux 和 MacOS 上设置为 "${NDKROOT}/ndk-build"
- 打开 Behaviour 标签按下图设置“Workbench build type”
- 点击 ok 保存配置
- 如果你在 Eclipse 编辑器中打开 c/c++ 源码文件,你会看到很多语法错误通知,它们不是真正的错误,你还需要对 CDT 进行配置
- 打开"Project Properties -> C/C++ General -> Paths and Symbols",为 C++ 添加下列 path
# for NDK r8 and prior:
${NDKROOT}/platforms/android-9/arch-arm/usr/include
${NDKROOT}/sources/cxx-stl/gnu-libstdc++/include
${NDKROOT}/sources/cxx-stl/gnu-libstdc++/libs/armeabi-v7a/include
${ProjDirPath}/../../sdk/native/jni/include
# for NDK r8b and later:
${NDKROOT}/platforms/android-9/arch-arm/usr/include
${NDKROOT}/sources/cxx-stl/gnu-libstdc++/4.6/include
${NDKROOT}/sources/cxx-stl/gnu-libstdc++/4.6/libs/armeabi-v7a/include
${ProjDirPath}/../../sdk/native/jni/include
调试和测试
在本节中,我们将为您介绍如何设置 Android 模拟器或硬件设备,来测试和调试 Android 项目。
AVD
创建 Android 模拟器,省略......
硬件设备
如果您有 Android 设备,可以使用它来测试和调试应用程序。这种方式更加真实,虽然有点难以设置。您需要对 Windows 和 Linux 操作系统进行一些设置才能使用 Android设备。 Mac OS 不需要任何额外的操作。有关配置硬件设备的详细信息,请参阅下面的小节。
您还可以参考 Android 官方开发者网站的说明来获取更多信息。
Windows
windows 下 Android 设备驱动的安装,省略......
Linux
省略......
Mac OS
省略......