Vuforia Engine Android开发入门

设置Android开发环境

支持的开发平台

注意：本安装指南是为Windows 10 64位平台编写的，并带有针对其他操作系统的特殊说明。

脚步：

如果您已经设置了Android SDK和NDK，请直接转到“ 安装Vuforia Engine for Android”。

Vuforia Engine需要Android SDK和Android NDK才能进行C ++开发。

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

1. Android Studio IDE
2. Android SDK
3. Android NDK
4. 适用于Android的Vuforia引擎

为了使用C ++在Android Studio中进行开发，请从SDK Manager安装Android NDK。请参阅“ Android SDK软件包”部分。

 

安装Android Studio

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

1. 从以下网址下载Android Studio安装程序：https :  //developer.android.com/studio， 选择您喜欢的操作系统。
2. 下载完成后，请运行安装程序可执行文件，然后按照官方 安装说明 安装IDE。
3. 请注意以下安装步骤：
   • 在 安装向导的“ 配置设置安装位置”步骤中，将使用的默认目录为 C：\ Program Files \ Android \ Android Studio。我们建议选择或创建更容易找到的路径，例如 C：\ Development \ Android。此后可以将SDK和Vuforia Engine安装在该目录中。

Android SDK套件

Android Studio包含一个SDK管理器，除了与Android Studio一起安装的组件外，它还允许您安装其他SDK组件，并更新您的Android SDK工具。
我们建议在安装Android Studio之后运行SDK Manager，以便下载使用Vuforia Engine开发所需的组件。

1. 启动Android Studio
2. 在“ 欢迎使用Android Studio”中， 单击“ 配置”， 然后选择“  SDK管理器”， 或者在Android Studio中，单击工具栏中的“ SDK管理器”图标。 

1. 在打开的对话框窗口中，将Android SDK位置设置  为C：\ Development \ Android \ android-sdk
2. 选择所需的工具：

• 工具：
  • Android SDK工具（最新版本）
  • Android SDK生成工具（最新版本）
  • Android SDK平台工具（最新修订）
• 附加功能：
  • Google USB驱动程序（仅Windows）
  • 与您自己的Android设备匹配的Android API。
  • Android NDK

1. 选择了所有需要的软件包后，请继续单击“安装”并接受许可协议。

注意： 下载进度显示在SDK Manager窗口的底部。不要退出SDK Manager，否则它将取消下载。

设置系统环境变量

如果您打算在Android Studio之外工作并直接使用adb之类的工具，则需要 在系统上手动配置 环境变量以进行Android开发。
如果您选择的文件夹目录不同于默认目录，则有必要将这些目录添加到Windows路径：

1. 在“ 文件资源管理器”中，右键单击“ 此PC”， 然后选择“ 属性”。
2. 单击 高级系统设置 按钮以打开“ 系统属性” 窗口
3. 在“ 高级” 选项卡下，选择“ 环境变量”， 然后 在“系统变量” 窗口中选择“ 变量路径”  。
4. 按 Edit后，滚动到Variable value：的末尾，然后添加 New  variable。将完整路径添加到路径末尾的目录中，并与前一个路径以分号分隔。在上面的示例中，您将添加： 

复制

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

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

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

复制

export PATH=$PATH:~/Development/Android/android-sdk/tools:~/Development/Android/android-sdk/platform-tools

Linux： 更新您的PATH以指向Android SDK Platform-tools目录。如果使用bash shell，则将以下内容添加到 ~/.bashrc ：  

复制

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

安装适用于Android的Vuforia Engine

清洁安装

Vuforia Engine作为ZIP软件包分发给以下平台：

• 视窗
• 苹果系统

要开始使用Vuforia Engine SDK进行开发，请执行以下操作：

• 下载Android版 Vuforia Engine
• 提取SDK ZIP存档的内容，并将其放置在您的Android开发根文件夹中（例如，在Windows上为C：\ Development \ Android，在OSX或Linux上为/ Users / [account] / Development / Android）
• 按照惯例，我们将Vuforia Engine for Android开发环境的根目录称为DEVELOPMENT_ROOT。

提取SDK将为您的Android开发环境创建目录结构。这种结构确保可以使用Android SDK，Android NDK和Android Studio开发环境轻松构建和部署Vuforia Engine示例应用程序。

结果目录结构

为了简化开发，我们定义了一个目录结构，该目录结构在单独的目录树中维护Vuforia Engine和您的应用程序。这样就可以更新SDK，而无需修改您的源代码树。

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

复制

<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 readme.txt // Starting read-me document

在手持设备上启用开发者设置

Android设备需要特殊的设置才能进行开发。

您将需要：

• 启用从未知来源安装应用程序
  • 在设备上，转到“设置”>“安全性”，然后选择“ 未知来源”。此设置允许从Eclipse内部直接安装未签名的APK。
• 启用USB调试
  • 转到设置>开发人员选项，然后启用 USB调试。

安装USB驱动程序（仅Windows）

• 使用USB电缆将设备连接到开发PC。

初始连接时，Windows会识别新设备并尝试查找兼容的驱动程序。Android SDK已经包含一些USB驱动程序，其他驱动程序可以直接从设备制造商处获得。

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

复制

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

设备驱动程序安装完成后即可使用您的设备。

编译并运行Android示例

可通过C ++ API访问适用于Android平台的Vuforia Engine。示例应用程序演示了Vuforia Engine的“图像目标”和“模型目标”功能，并展示了用Kotlin编写的应用程序如何使用C ++ API 。

可以从https://developer.vuforia.com/downloads/samples
下载Vuforia Engine示例 。下载后，解压缩示例ZIP包并将其复制到Vuforia Engine 安装目录 下的 示例文件夹中 （例如， C：\ ... \ Android \ vuforia-sdk-android-xx-yy-zz \ samples \ ）。

Vuforia-sample-xyz应用程序是开始学习SDK的好地方，因为它在单个应用程序中显示了SDK的主要功能。本部分说明如何使用Android Studio生成源代码并创建可部署到设备的APK包。

建立样本

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

1. 启动Android Studio。
2.  从“快速入门”启动页面中选择“ 打开现有的Android Studio项目”。

1. 浏览到 \…\ vuforia-sdk-android-xx-yy-zz \ samples \ Vuforia-samples-xyz \ Android 目录，然后单击“ 确定” 将其打开。
2. 首次打开示例项目时，Android Studio可能会提示一个对话框，询问您是否要为该项目创建Gradle Wrapper；您可以通过单击“确定” 按钮来回答“是”  ：

1. 加载项目后，打开 Build 菜单，然后选择 Make Project 来编译应用程序。这还将创建用于部署的APK包；生成的APK文件由Android Studio存储在 应用程序/构建/输出/ 示例项目的子目录。
   
   或者，您可以单击“ 重建项目” 以触​​发应用程序的全新完整重建。

1. 如果尚未这样做，请  为您的应用创建许可证密钥。
2. 将许可证密钥添加 到您的应用程序。

运行Vuforia Engine Samples应用程序

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

启动Vuforia Engine Sample应用程序后，设备上会显示一个主菜单，您可以从中选择“图像目标”或“模型目标”功能：

选择图像目标功能以开始使用。

您已经使用Vuforia Engine成功部署了第一个应用程序！

点击屏幕一次以触发相机对焦，或点按两次以返回主菜单。

故障排除

如果您在安装示例应用程序期间遇到问题，请在“对设备连接进行故障排除”中检查设备的连接设置 。

在Android Studio中，您可以查看设备是否通过Android Profiler正确连接 ，如果检测到您的设备并将其列 在Android Studio中的“设备”下，则可以激活该 设备。

使用ADB安装APK

您可以通过使用USB线将设备连接到PC，然后使用Android调试桥 （ADB）连接到设备，将APK安装到Android设备上 。

1. 使用USB电缆将设备连接到开发人员桌面环境。
2. 打开bash shell或Windows命令行并执行：

复制

adb devices

输出应显示连接的设备：

复制

$ adb devices List of devices attached HT012P123456 device

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

复制

$ cd C:\Temp $ adb install VuforiaSample.apk

4.如果设备列表为空，或者未列出给定设备，请通过执行以下操作终止ADB服务器：

复制

adb kill-server

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