[EN] Deploy a Demo - FacePlusPlus/MegviiFacepp-Android-SDK GitHub Wiki

This tutorial is for developers using Android Studio. Please refer to Deploy a Demo (Eclipse) if you are using Eclipse.

1. Download Demo Source Code

---

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

2. Import Face SDK aar File

---

• Open Android Studiot, choose Open an existing Android Studio project, open FaceppDemo folder;

• Android Studio will then prompt that cannot find aar file, so the next step will be importing aar file;

• Copy the compiled Face SDK aar file to FaceppDemo/FaceppDemoUI/libs folder: (The SDK downloaded from Face++ website contains compiled Face SDK aar file, which you can directly use)

• Copy algorithm model to FaceppDemo/FaceppDemoUI/src/main/res/raw folder.

3. Set License Configuration

---

• Add Online Licensing Manager SDK

  • [Online Licensing version SDK] Copy compiled Online Licensing Manager SDK aar file to FaceppDemo/FaceppDemoUI/libs folder: (The SDK downloaded from Face++ website contains compiled Online Licensing Manager SDK aar file, which you can directly use)

  

  • [Offline Licensing version SDK] Comment out the code about importing LicMgr SDK in FaceppDemo/build.gradle; And in FaceppDemo/app/src/main/java/com/facepp/demo/LoadingActivity.java, comment out the code after if block in void network() function;

• Add API_KEY and API_SECRET

  • [Online Licensing version SDK] Add your api_key and api_secret into FaceppDemo/FaceppDemoUI/src/main/java/com/facepp/library/util/Util.java (api_key and api_secret are credentials to use Face++ cloud services, which can be accessed in Face++ Console; Check the tutorial to learn about how to get api_key and api_secret);

  

  • [Offline Licensing version SDK] Assign null value "" to API_KEY and API_SECRET in FaceppDemo/FaceppDemoUI/src/main/java/com/facepp/library/util/Util.java;

4. Set Bundle ID (ApplicationID)

---

• Set the bundle-id in this project as the one you submit in Face++ Console. For how to set bundle-id in Face++ Console, check the tutorial;

• Set appliactionId in FaceppDemo/app/build.gradle(Module.app) as corresponding bundle-id, then sync gradle configurations;

5. Run Demo App

---

Connect your device with computer, click run button, you will then be able to run demo app on your device.

6. Next Step

---

Congratulations! You've finished this tutorial. You can refer to Face++ Android SDK API, to learn more about how to use Face++ algorithms to power your applications.