运行一个 Demo

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

1. 下载 Demo 源码

---

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

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

2. 从官网下载 Face++ 人脸 SDK

---

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

3. 添加人脸 SDK 的 aar 包

---

• 打开 Android Studio，选择 Open an existing Android Studio project，打开 FaceppDemo 目录；
  

• 在等待一小会儿之后， Android Studio 就成功打开了这个项目，这个时候会提示找不到 aar 包，你需要按照后续步骤导入 aar 包；

• 将官网下载的 SDK 包中的人脸 SDK 的 aar 包直接拷贝到 FaceppDemo/FaceppDemoUI/libs 目录下；

• 将 model（算法模型）拷贝到 FaceppDemo/FaceppDemoUI/src/main/res/raw 目录下；
  

4. 配置授权管理

---

• 添加授权管理 SDK

  • 【对于联网授权的 SDK】将在官网下载的 SDK 包中的联网授权管理的 aar 包拷贝到 FaceppDemo/FaceppDemoUI/libs 目录下；

  

  

  • 【对于非联网授权的 SDK】 将FaceppDemo/build.gradle 下导入联网授权 SDK 的代码注释掉；将 FaceppDemo/app/src/main/java/com/facepp/demo/LoadingActivity.java 代码中 void network() 函数 if 语句块后面的代码也都注释掉；

• 添加 API_KEY 和 API_SECRET

  • 【对于联网授权的 SDK】 需要将正式的 api_key 和 api_secret 填写到 FaceppDemo/FaceppDemoUI/src/main/java/com/facepp/library/util/Util.java 中（api_key 和 api_secret 是 Face++ 云服务的服务使用凭证，可以在 Face++ 网站的控制台中申请获得，你也可以查看教程学习如何申请 api_key 和 api_secret）；

  

  • 【对于非联网授权的 SDK】将 FaceppDemo/FaceppDemoUI/src/main/java/com/facepp/library/util/Util.java 中的 API_KEY 和 API_SECRET 赋值为空字符串 ""；
    

5. 配置 Bundle ID（ApplicationID）

---

• 将项目中的 bundle-id，修改为与你在官网上设置的相同。如果你不会在官网上配置 bundle-id，可以查看教程。

• 将 FaceppDemo/app/build.gradle(Module.app) 中的 appliactionId 字段修改为对应的 bundle-id，后同步 gradle 配置即可；

6. 运行 Demo

---

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

7. 下一步

---

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