【AR】开始使用Vuforia进行Android开发（3）

原

• 设置Android开发环境
• 安装Vuforia Android SDK
• 如何编译和运行Android示例
• 如何使用ADB安装APK

设置Android开发环境

支持的开发平台

Vuforia SDK正式支持Android OS 4.1及更高版本，以及OpenGL ES 2和3。
推荐的开发环境是Microsoft Windows 7或8 32/64位。
构建环境的组件（JDK，Android Studio，Android SDK / NDK）可用于多个平台。
注意：本安装指南是为Win7 32/64位平台编写的，其中包含针对其他操作系统的特殊注释。

脚步：

如果您已经设置了Android SDK和NDK，请直接安装Vuforia Android SDK

Vuforia SDK需要Android SDK和NDK。Android NDK是Android SDK的扩展，它允许Android开发人员使用本机代码构建其应用程序中性能至关重要的部分。SDK和NDK通过Java本地接口（JNI）进行通信。

要设置开发环境，请按以下顺序安装这些组件，并在Vuforia SDK中使用最新版本的工具：

1. JDK（Java SE）
2. Android Studio IDE
3. Android SDK包
4. Cygwin环境
5. Android NDK

JDK

---

Mac OSX： JDK已经集成到Mac OS X操作系统中。

从此站点下载Java SE开发工具包（JDK）：http : //www.oracle.com/technetwork/java/javase/downloads/
从“Java平台标准版”表中的JDK部分单击下载。
使用默认设置安装JDK环境。
有关详细的安装说明和系统要求，请访问：http : //www.oracle.com/technetwork/java/javase/index-137561.html

Android Studio

---

Android Studio提供了开始为Android开发应用程序所需的一切，包括Android Studio IDE和Android SDK工具。

从http://developer.android.com/sdk/index.html下载Android Studio安装程序
下载完成后，运行安装程序可执行文件并按照安装说明将IDE安装到您选择的目标目录中（例如C：\ Program Files \ Android \ Android Studio）; 特别要注意以下几个步骤：
在选择要安装的组件页面中，确保选择了Android SDK选项;
在安装向导的“配置设置安装位置”页面中，指定要安装Android SDK的位置; 我们建议将其设置为像C：\ Development \ Android \ android-sdk这样的位置，其中C：\ Development \ Android代表Android开发环境的基本目录; 这也是您要安装Android NDK的目录，这将在本指南后面讨论（注意：本指南的其余部分，我们将把这样的基本目录称为<DEVELOPMENT_ROOT>），

Android SDK包

---

通过安装Android Studio，您还安装了最新版本的Android SDK和相关的SDK工具。但是，SDK Manager允许您安装其他/可选的SDK组件，并将您的Android SDK和SDK工具更新为可用的最新修订版本; 因此您可能需要定期运行SDK管理器来检查最新的SDK修订版本，并在必要时更新它们。
我们还建议在安装Android Studio之后至少运行一次SDK Manager，以下载用于使用Vuforia进行开发的必要组件：

启动Android Studio
在Android Studio中，单击工具栏中的SDK Manager图标。

在打开的对话窗口中，点击启动独立SDK管理器
在SDK Manager独立窗口中，选择要安装的以下软件包：
工具：
Android SDK工具（最新版本）
Android SDK构建工具（最新版本）
Android SDK平台 - 工具（最新版本）
Android 6.0（API 23）：
SDK平台
Android SDK的文档
注意：这些项目应该在Android Studio安装期间已经安装（如果没有，只需选择它们进行安装）
Android 5.1.1（API 22）：
SDK平台
注意： Vuforia 5.0.x不完全支持Android 6.0（akas Android Marshmallow或Android M）; 因此我们建议安装Android 5.1.1（API 22）
附加功能：
Google USB Driver（仅限Windows）

一旦你选择了所有需要的软件包，继续安装：

点击“安装X包”
在下一个窗口中，双击左侧的每个软件包名称以接受每个软件包的许可协议。
点击安装。
下载进度显示在SDK Manager窗口的底部。不要退出SDK管理器，否则它将取消下载。

设置系统环境变量

---

将Android SDK工具和平台工具目录添加到Windows路径中：

右键单击桌面上的我的电脑，然后选择属性。
点击高级系统设置按钮ab打开系统属性窗口
在Advanced选项卡下，选择Environment Variables并在System variables窗口中查找Variable Path。
按Edit之后，滚动到变量值的末尾：并将目录的完整路径添加到路径的末尾，用分号从前一路径分隔。在上面的例子中，你可以添加：

C:\Development\Android\android-sdk\tools\;C:\Development\Android\android-sdk\platform-tools\

注：必须包含Path变量末尾的最后一个“\”。

Mac OSX：更新PATH变量以指向/etc/rc.common文件或〜/ .bash_profile中的Android SDK Platform-tools目录：

 PATH=/bin:/sbin:/usr/bin:/usr/sbin:/usr/libexec:/System/Library/CoreServices:/Developer/usr/bin:~/Development/Android/android-sdk/tools:~/Development/Android/android-sdk/platform-tools:export PATH

Linux：更新PATH以指向Android SDK平台工具目录。如果您使用bash shell，请将以下内容添加到〜/ .bashrc中：

export PATH=/opt/android-sdk/tools/:/opt/android-sdk/platform-tools/:

Cygwin环境

---

Linux：本节与安装了GNU make并处于路径中的Linux用户无关。
Mac OSX：此部分与安装了Apple Developer Tools（XCode）的Mac用户无关。如有必要，请从http://developer.apple.com/xcode/安装XCode。

用于Android平台的Vuforia SDK包括Java API和C ++ API。Java API支持全套Vuforia特性和功能，并允许开发人员构建Android应用程序，而无需编写本机C ++代码。

C ++ API旨在供具有非常高级/特定要求的开发人员使用，如集成基于C ++的第三方库或自定义C ++软件组件的能力。如果不需要，通常建议使用Java API。

如果您希望需要C ++本地API，您将需要一个C ++ GNU编译器，如以下段落中所述; 否则，对于基于Java的纯Java开发，您可以跳过本节。

需要GNU编译器才能将动态应用程序编译为Android NDK的共享库。Android makefiles被设计为使用gcc4运行。在Windows上，为此准备完整环境的一种便捷方式是安装Cygwin。

Cygwin使用安装助手来管理安装过程。

去http://www.cygwin.com，下载并运行安装程序（setup.exe）
选择“从Internet安装！” 在安装程序中的“选择下载源”时出现提示。我们建议不要在下一个窗口中更改根目录，并将其保留在“C：\ cygwin”中。“本地软件包目录”包含下载的软件包。您可能希望将它们与下载的Setup.exe文件放在同一个目录中，以便拥有Cygwin安装程序目录。选择一个已知快速连接的下载站点。
下载软件包信息时，您将看到一个分层浏览器来选择软件包。

1. 从层次结构中选择下列软件包进行下载：All - > Devel - >“make：'make'实用程序的GNU版本”
2. 选择单词skip将其更改为将要安装的实际版本号
3. 点击下一步完成安装。
   您的Cygwin环境已完全设置为可与Vuforia SDK配合使用。如果您安装了其他类似的环境，请确保将Windows路径变量设置为“C：\ cygwin \ bin”，以便bash使用此版本的GNU make.exe。

Android NDK

---

Android NDK是Android SDK的扩展，可让Android开发人员使用本机代码构建其应用程序中性能至关重要的部分。
如果您需要使用Vuforia SDK的C ++ API，则还需要安装Android NDK，以便在Android上进行本机C ++编程。如果您打算只使用Java API，则可以跳过本节。

1. 从http://developer.android.com/sdk/ndk/index.html下载NDK软件包
2. 解压缩存档，并将内容复制到目录中。为了与我们以前的设置保持一致，我们建议将内容放在“C：\ Development \ Android \ android-ndk-rxy \”中。因此，Android SDK和Android NDK共享相同的父目录。稍后，我们将添加Vuforia SDK和您的项目文件。NDK要求将上述目录添加到Windows路径中。
3. 右键单击桌面上的我的电脑，然后选择属性。
4. 点击高级系统设置按钮打开系统属性窗口
5. 在Advanced选项卡下，选择Environment Variables并在System variables窗口中查找Variable Path。
6. 按Edit之后，滚动到变量值的末尾：并将目录的完整路径添加到路径的末尾，用分号从前一路径分隔。在上面的例子中，你可以添加：

C:\Development\Android\android-ndk-rxy\

注意：路径在开始处有一个分号。不要使用带空格的路径名。或者，您可以使用名称Path来设置User变量，但仅对当前用户有效。必须包含Path变量末尾的最后一个“\”。

要测试您的安装，请编译任何NDK示例应用程序。使用Cygwin bash shell，导航到任何演示应用程序的根目录（例如，不带上述安装路径的'san-angeles'示例应用程序）：

cd /cygdrive/c/Development/Android/android-ndk-rxy/samples/san-angeles
ndk-build 

编译器应该生成一个动态链接库libsanangeles.so并将其写入应用程序目录中的/ libs / armeabi。NDK包含对不同体系结构的支持，因此您可能会在/ libs中找到不同的子目录。
现在您的开发环境已准备好承载Vuforia SDK相关内容。

Mac OSX：更新PATH变量以指向/etc/rc.common文件或〜/ .bash_profile中的Android NDK目录：

PATH=/bin:/sbin:/usr/bin:/usr/sbin:/usr/libexec:/System/Library/CoreServices:/Developer/usr/bin:~/Development/Android/android-sdk-macosx/tools:~/Development/Android/android-sdk-macosx/platform-tools:~/Development/Android/android-ndk-rxy:export PATH

Linux：更新您的PATH以指向Android NDK平台目录。如果您使用bash shell，请将以下内容添加到〜/ .bashrc文件中：

export PATH=~/bin:/opt/android-sdk-linux_x86/tools/:/opt/android-ndk-rxy:

安装Vuforia Android SDK

安装Vuforia Android SDK

---

干净的安装
Vuforia SDK以下列平台的ZIP软件包形式发布：

• Windows 7或8 32/64位
• Mac OS X
  开始使用Vuforia SDK进行开发：
• 下载Vuforia Android SDK
• 提取SDK ZIP归档文件的内容，将其放置在Android开发根文件夹中（例如Windows上的C：\ Development \ Android或OSX上的/ Users / [account] / Development / Android）
  提取SDK将为Android开发环境创建一个目录结构。这种结构确保Vuforia示例应用程序可以使用Android SDK，Android NDK和Android Studio开发环境轻松构建和部署。

从以前的版本升级
请参阅如何迁移Android项目 API更改和迁移说明。
产生的目录结构
为了简化开发，我们定义了一个目录结构，将Vuforia SDK和您的应用程序维护在单独的目录树中。这使得SDK无需修改源代码树即可进行更新。

作为一个惯例，我们将参考你的Vuforia Android开发环境的根目录

<DEVELOPMENT_ROOT>

提取的SDK存档将在vuforia-sdk-android- [ xx-yy-zz ]文件夹中创建以下目录结构。模式xx-yy-zz代表Vuforia SDK的版本号。

<DEVELOPMENT_ROOT>\

android-ndk-rxy\

android-sdk\

vuforia-sdk-android-xx-yy-zz\

  build\                  Vuforia Augmented Reality SDK         

  licenses\               License Agreements

  samples\                Sample applications with full source code

  assets\                 Additional assets required to use Vuforia SDK

  readme.txt              Starting read-me document

安装Vuforia SDK

---

下载
Vuforia SDK通过Developer Portal分发。

注意：虽然我们为以下列出的平台分发Vuforia SDK，但对开发的支持仅限于Win 7 32/64位平台。

从下载页面下载存档文件。
提取存档的内容并将其存储在<DEVELOPMENT_ROOT>下。
准备用于开发的测试设备
设备上的开发人员设置
Android设备需要特殊的开发设置。

您需要：

启用从未知来源安装应用程序
在设备上，转至设置>安全性，然后选择未知来源。此设置允许从Eclipse内直接安装未签名的APK。

启用USB调试
转至设置>开发人员选项并启用USB调试 并保持清醒的选择。

用户添加的图像

请注意，USB调试是强制性的，保持清醒设置是一种有助于开发的便利。

安装USB驱动程序（仅限Windows）
使用USB电缆将您的设备连接到开发PC。
在初始连接时，Windows会识别新设备并尝试查找兼容的驱动程序。Android SDK已经包含了一些USB驱动程序，其他的可以直接从设备制造商处获得。

SDK预包装的驱动程序可以位于以下目录中：

<DEVELOPMENT_ROOT>\android-sdk\extras\google\usb_driver

设备驱动程序安装完成后，您的设备就可以使用了。

如何编译和运行Android示例

用于Android平台的Vuforia SDK包括Java API和C ++ API。Java示例演示了Vuforia SDK的所有主要功能; 此外，还有一个名为ImageTargetsNative-xyz的Image Targets功能的C ++示例实现，它演示了如何使用C ++ native API：

Vuforia示例可以从https://developer.vuforia.com/downloads/samples下载
一旦下载，提取ZIP压缩包示例并将它们复制到Vuforia SDK安装目录（例如，C：\ Development \ Android \ vuforia-sdk-android-xx-yy-zz \ samples \）下的samples文件夹中。
VuforiaSamples-xyz应用程序是开始学习SDK的好地方，因为它在单个应用程序中显示了SDK的主要功能。本节介绍如何使用Android Studio构建Java源代码并创建可部署到设备的APK包。

构建示例

要为Android平台构建Vuforia示例，请按照以下步骤操作：

1.启动Android Studio
2.从文件菜单中选择打开>文件或项目，或从快速启动启动页面选择打开一个现有的Android Studio项目

3.浏览到<DEVELOPMENT_ROOT> \ vuforia-sdk-android-xx-yy-zz \ samples \ VuforiaSamples-xyz目录并单击确定以打开它

4.首次打开一个示例项目时，Android Studio可能会提示一个对话框，询问您是否要为该项目创建一个Gradle Wrapper; 您可以通过单击确定按钮来回答是：

5.项目加载后，打开Build菜单并选择Make Project来编译应用程序。这也将创建用于部署的APK包; 生成的APK文件由Android Studio存储在示例项目的app / build / outputs /子目录中。

或者，您可以单击“重建项目”以触发清理并完全重建应用程序。

运行Vuforia示例应用程序
如果您单击工具栏中的“运行”菜单项或应用程序菜单按钮旁边的小箭头图标，该应用程序将在目标设备上编译，安装并启动。

在启动Vuforia示例应用程序后，会显示一个主菜单，您可以从中选择一个特定的示例功能：

故障排除
如果您在安装时遇到问题，请检查准备测试设备以进行开发中的设备连接设置。在Android Studio中，您可以通过Android Device Monitor查看设备是否连接正确，您可以通过单击工具栏中的Android图标打开该设备。该设备必须列在设备下。

该设备必须列在设备下，并且应显示在线状态。

或者，打开一个Cygwin bash shell并执行：

adb devices

输出应显示以下连接的设备：

$ adb devices

List of devices attached HT012P123456 device

*连接的设备ID将反映连接到您的ADB主机的设备的型号ID。

如果设备列表为空，或者没有列出给定设备，请通过执行以下命令来终止ADB服务器：

adb kill-server

再次执行'adb设备'以重新启动服务器并重新检测设备。

如何使用ADB安装APK

您可以使用USB线将设备连接到PC，然后使用Android调试桥连接到设备，从而将APK安装到Android设备上（ADB）。1.使用USB电缆将设备连接到开发人员桌面环境。
2.打开Cygwin bash shell或Windows命令行并执行：

adb devices

输出应显示连接的设备：

$ adb devices

List of devices attached HT012P123456 device

3.要安装应用程序，请导航至包含已下载的APK的文件夹。在我们的示例C：\ Temp中，使用adb安装APK。

$ cd /cygdrive/c/temp
$ adb install thisIsTheAPKName.apk

4.如果设备列表为空，或者没有列出给定设备，请通过执行以下命令来终止ADB服务器：

adb kill-server

5.再次执行adb设备以重新启动服务器，重新检测设备并重试。

联系我

QQ:94297366
微信打赏：https://pan.baidu.com/s/1dSBXk3eFZu3mAMkw3xu9KQ

公众号推荐：