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设备以重新启动服务器,重新检测设备,然后重试。

  • 0
    点赞
  • 0
    收藏
    觉得还不错? 一键收藏
  • 打赏
    打赏
  • 0
    评论

“相关推荐”对你有帮助么?

  • 非常没帮助
  • 没帮助
  • 一般
  • 有帮助
  • 非常有帮助
提交
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包

打赏作者

歇歇

你的鼓励将是我创作的最大动力

¥2 ¥4 ¥6 ¥10 ¥20
输入1-500的整数
余额支付 (余额:-- )
扫码支付
扫码支付:¥2
获取中
扫码支付

您的余额不足,请更换扫码支付或充值

打赏作者

实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、C币套餐、付费专栏及课程。

余额充值