运行一个 Demo(Eclipse)

本页教程只适合使用 Eclipse 的开发者，如果您是使用 Android Studio 开发的，请移步至运行一个 Demo。

如果你还没有下载过源码，可以运行以下命令下载 Demo 源码。

git clone https://github.com/FacePlusPlus/MegviiFacepp-Android-SDK.git

如果你是 Windows 7 及以上版本的用户，并且您的工作分区是 NTFS 格式的，并且安装并使用 git-for-windows，那么你可以进行 git-for-windows 的软连接配置，再运行如下命令：

git clone -c core.symlinks=true https://github.com/FacePlusPlus/MegviiFacepp-Android-SDK.git

如果你是其他版本的 Windows 用户，或者并不想使用软连接，那么您可以使用如下命令；并在下载完成后，进入 EclipseFaceppDemo/FaceppDemo/ 目录，双击运行 project-copy.bat 脚本，再进入 EclipseFaceppDemo/FaceppDemoUI/ 目录，同样运行 project-copy.bat 脚本：

git clone https://github.com/FacePlusPlus/MegviiFacepp-Android-SDK.git

Face++ 项目配置

登录 Face++ 官网选择人脸识别 > SDK > Android，下载 Android SDK。（对于非联网授权的用户，会直接从客服那儿获取到 SDK）
下载 Face++ 人脸 SDK

打开 Eclipse，选择 File > Import > Android > Existing Android Code Into Workspace，并且找到下载好的代码选择 EclipseFaceppDemo 目录，并确认；
- 导入的工程有两个，其中 FaceppDemoUI 是一个 Library Project，而 FaceppDemo 是使用了该 Library 的一个项目，只有一个启动页面；
- 建议在导入工程时对项目名字重新配置，避免与你现有 workspace 中的项目重名；
将官网下载的 SDK 包中的人脸 SDK 的 jar 包直接拷贝到 EclipseFaceppDemo/FaceppDemoUI/libs 目录下；(_注：这里的 android-support-v4.jar 是默认已经有的)
将 model（算法模型）拷贝到 EclipseFaceppDemo/FaceppDemoUI/res/raw 目录下；

添加授权管理 SDK
- 【对于联网授权的 SDK】将在官网下载的 SDK 包中的联网授权管理 SDK拷贝到 EclipseFaceppDemo/FaceppDemoUI/libs 目录下；
- 【对于非联网授权的 SDK】将 EclipseFaceppDemo/FaceppDemo/src/com/facepp/demo/LoadingActivity.java 代码中 void network() 函数 if 语句块后面的代码都注释掉；（同时需要注释掉 import）
添加 API_KEY 和 API_SECRET
- 【对于联网授权的 SDK】需要将 api_key 和 api_secret 填写到 EclipseFaceppDemo/FaceppDemoUI/src/com/facepp/library/util/Util.java 中（api_key 和 api_secret 是 Face++ 云服务的服务使用凭证，可以在 Face++ 网站的控制台中申请获得，你也可以查看教程学习如何申请 api_key 和 api_secret）；
- 【对于非联网授权的 SDK】将 EclipseFaceppDemo/FaceppDemoUI/src/com/facepp/library/util/Util.java 中的 API_KEY 和 API_SECRET 赋值为空字符串 ""；

将项目中的 bundle-id，修改为与你在官网上设置的相同。如果你不会在官网上配置 bundle-id，可以查看教程。
将 EclipseFaceppDemo/FaceppDemo/AndroidManifest.xml 文件中 package="..." 中的字段修改为对应的 bundle-id，后同步 gradle 配置即可；

将设备接到电脑上后，点击运行按钮，即可看到真机运行效果了。

Face++ Demo 运行

恭喜你已经完成了入门教程，接下来你可以进一步学习 Face++ Android SDK 的 API 接口，更好的使用我们提供的人脸算法来进行开发，为你的 APP 添加智能的 AI。

Provide feedback