- 设置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中使用最新版本的工具:
- JDK(Java SE)
- Android Studio IDE
- Android SDK包
- Cygwin环境
- 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安装程序目录。选择一个已知快速连接的下载站点。
下载软件包信息时,您将看到一个分层浏览器来选择软件包。
- 从层次结构中选择下列软件包进行下载:All - > Devel - >“make:'make'实用程序的GNU版本”
- 选择单词skip将其更改为将要安装的实际版本号
- 点击下一步完成安装。
您的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,则可以跳过本节。
- 从http://developer.android.com/sdk/ndk/index.html下载NDK软件包
- 解压缩存档,并将内容复制到目录中。为了与我们以前的设置保持一致,我们建议将内容放在“C:\ Development \ Android \ android-ndk-rxy \”中。因此,Android SDK和Android NDK共享相同的父目录。稍后,我们将添加Vuforia SDK和您的项目文件。NDK要求将上述目录添加到Windows路径中。
- 右键单击桌面上的我的电脑,然后选择属性。
- 点击高级系统设置按钮打开系统属性窗口
- 在Advanced选项卡下,选择Environment Variables并在System variables窗口中查找Variable Path。
- 按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
公众号推荐:
转载于:https://blog.51cto.com/4789781/2128104