Vuforia Engine Android开发入门

设置Android开发环境

支持的开发平台

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

脚步：

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

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

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

Android Studio IDE
Android SDK
Android NDK
适用于Android的Vuforia引擎

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

安装Android Studio

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

从以下网址下载Android Studio安装程序：https : //developer.android.com/studio，选择您喜欢的操作系统。
下载完成后，请运行安装程序可执行文件，然后按照官方安装说明安装IDE。
请注意以下安装步骤：
- 在安装向导的“ 配置设置安装位置”步骤中，将使用的默认目录为 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开发所需的组件。

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

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

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

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

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

设置系统环境变量

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

在“ 文件资源管理器”中，右键单击“ 此PC”， 然后选择“ 属性”。
单击 高级系统设置 按钮以打开“ 系统属性” 窗口
在“ 高级” 选项卡下，选择“ 环境变量”， 然后在“系统变量” 窗口中选择“ 变量路径” 。
按 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示例，请按照以下步骤操作：

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

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

加载项目后，打开 Build 菜单，然后选择 Make Project 来编译应用程序。这还将创建用于部署的APK包；生成的APK文件由Android Studio存储在应用程序/构建/输出/ 示例项目的子目录。

或者，您可以单击“ 重建项目” 以触发应用程序的全新完整重建。

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

运行Vuforia Engine Samples应用程序

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

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

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

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

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

故障排除

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

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

使用ADB安装APK

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

使用USB电缆将设备连接到开发人员桌面环境。
打开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设备以重新启动服务器，重新检测设备，然后重试。