Android开发Vuforia引擎入门

设置Android开发环境

支持的开发平台

请参阅Vuforia引擎支持的版本第页了解最新支持的Android和Android工具版本（如Android Studio）的详细信息。

注：对于针对Android API级别31或更高的Vuforia项目，应确保添加权限android许可。高采样率传感器到清单文件文件。该权限确保Vuforia Engine可以使用VISLAM从Android设备检索传感器数据。

注释：本安装指南是为Windows 10 64位平台编写的，并为其他操作系统提供了特别说明。

步骤：

如果您已经设置了Android SDK和NDK，请直接转到安装Android版Vuforia引擎。

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

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

  1. 安卓工作室IDE
  2. 安卓模拟器
  3. 安卓NDK
  4. 用于Android的Vuforia引擎

为了使用C++在Android Studio中进行开发，请从SDK管理器安装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： \程序文件\Android\Android Studio。我们建议选择或创建更容易找到的路径，例如C： \开发\安卓。SDK和Vuforia引擎此后可以安装在该目录中。

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： \开发\Android\Android-sdk
  2. 选择所需的工具：

  • 工具：
    • Android SDK工具（最新版本）
    • Android SDK构建工具（最新版本）
    • Android SDK平台工具（最新版本）
  • 附加服务：
    • 谷歌USB驱动程序（仅限Windows）
    • 与您自己的Android设备相匹配的Android API。
    • 安卓NDK
  1. 选择所有所需的软件包后，继续单击“安装”并接受许可协议。

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

设置系统环境变量

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

  1. 在文件资源管理器，右键单击这台电脑并选择属性。
  2. 单击高级系统设置按钮打开系统属性窗口
  3. 在高级选项卡，选择环境变量并选择可变路径在中系统变量窗口。
  4. 按下后编辑，滚动到Variable value:的末尾，然后添加新建变量。将完整路径添加到路径末尾的目录中，路径之间用分号隔开。在上述示例中，您需要添加：
C： \Development\Android\Android-sdk\tools\；C： \开发\Android\Android-sdk\平台工具\

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

Mac OSX：更新PATH变量以指向/etc/rc.com.mon等文件或~/.bash_profile:  

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

Linux操作系统：更新PATH以指向Android SDK Platform-tools目录。如果使用bashshell，请将以下内容添加到~/.bashrc :  

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

安装Android版Vuforia引擎

清洁安装

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

  • 窗户
  • Mac操作系统

要开始使用Vuforia Engine SDK进行开发：

  • 下载用于Android的Vuforia引擎
  • 提取SDK ZIP存档的内容，将其放在Android开发根文件夹中（例如C： \开发\安卓在Windows上，或/用户/[帐户]/开发/安卓在OSX或Linux上）
  • 按照惯例，我们将您的Vuforia Engine for Android开发环境的根目录称为development_root

解压缩SDK将为您的Android开发环境创建目录结构。此结构确保可以使用Android SDK、Android NDK和Android Studio开发环境轻松构建和部署Vuforia Engine示例应用程序。

结果目录结构

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

提取的SDK存档将在vuforia-sdk-android-[xx-yy-zz]文件夹。模式xx-yy-zz年代表Vuforia Engine的版本号。

<开发_ROOT>\安卓-ndk-rxy\android-sdk\vuforia-sdk-android-xx-yy-zz\构建\//Vuforia增强现实SDK许可证\//许可协议示例\//包含完整源代码的示例应用程序readme.txt//启动read-me文档

在手持设备上启用开发人员设置

Android设备的开发需要特殊设置。

您需要：

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

安装USB驱动程序（仅限Windows）

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

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

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

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

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

编译和运行Android示例

Android平台的Vuforia引擎可通过C API访问。示例应用程序演示了Vuforia Engine的Image Targets和Model Targets功能，并显示了用Kotlin编写的应用程序如何使用C API.

Vuforia引擎示例可从以下网址下载https://developer.vuforia.com/downloads/samples网站
下载后，解压缩示例ZIP包并将其复制到样品文件夹下Vuforia发动机安装目录（例如C： \。。。\Android\vuforia-sdk-Android-xx-yy-zz\示例\ ).

Vuforia-sample-x-y-z应用程序是学习SDK的好地方，因为它在单个应用程序中显示了SDK的主要功能。本节介绍如何使用Android Studio构建源代码并创建可以部署到设备上的APK包。

构建示例

要为Android平台构建Vuforia Engine示例，请执行以下步骤：

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

  1. 浏览到\…\vuforia-sdk-android-xx-yy-zz\samples\vuforia-samples-x-y-z\android目录并单击好的打开它。
  2. 首次打开示例项目时，Android Studio可能会提示一个对话框，询问您是否要为项目创建Gradle Wrapper；您可以通过单击好 啊按钮：

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

    或者，您可以单击重建项目以触发应用程序的干净完整重建。

  1. 如果您还没有这样做创建许可证密钥适用于您的应用程序。
  2. 将许可证密钥添加到示例项目中。许可证密钥在应用程序的名称空间中定义。
    命名空间{ constexpr char licenseKey[]=“”；}

运行Vuforia Engine Samples应用程序

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

启动Vuforia Engine Sample应用程序后，设备上会显示一个主菜单，您可以从中选择Image Targets或Model Targets功能：

选择“图像目标”功能以开始。

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

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

故障排除

如果在安装示例应用程序期间遇到问题，请在中检查设备的连接设置设备连接疑难解答.

在Android Studio中，您可以通过Android探查器，如果检测到您的设备并将其列在下面，则可以激活设备在Android Studio中。

使用ADB安装APK

通过使用USB线将设备连接到PC，然后使用Android调试桥（亚洲开发银行）。

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

输出应显示连接的设备：

$adb设备连接的设备列表HT012P123456设备

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

$cd C:\温度$adb安装VuforiaSample.apk

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

adb kill服务器

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

这个页面能更好吗？
通过我们的问题跟踪器分享您的反馈