This project takes care of all the needed configuration so that you can start coding right away using the Huawei Mobile Services (HMS) SDKs. We mostly use this project during hackathons.
Basically, the starter project is a native Android skeleton app that:
-
has the main featured HMS Kits added as dependencies (just comment out those you need)
-
has all needed permissions added to the Android manifest
-
streamlines the connection to an App Gallery account which is needed by the HMS SDKs
-
when started, does a self test to check if everything is properly configured
-
fork/clone this project
-
ask for the file with secrets
🕵 -
unzip the file into the project's root directory
-
start coding!
It streamlines the connection to a shared App Gallery account so that you don't have to create and configure one yourself. It's basically a zip containing 3 files:
-
the
agconnect-services.jsonconfiguration file needed by any HMS SDK -
the signing configuration needed to authenticate the project to App Gallery, for the cloud related functions:
-
a Java keystore (.jks file) containing the signing key
-
the keystore.properties file that unlocks the keystore and it's referenced from within app/build.gradle
-
If you're participating in a hackathon, simply ask the Huawei devrel team at the event for the zip file and extract it in the root of the project. Alternatively, you could generate the 3 needed files yourself and thus link the project to your own App Gallery account.
There are solutions:
- If you're participating on-site, ask for a test device from the Huawei devrel team at the event
- Download and temporary install HMS Core on your own generic Android device from here
- Cloud Debugging : this requires you to actually own/create a Huawei ID, but once that's done, you can just download the HMS Toolkit Android Studio plugin and access physical devices in the cloud
-
for Flutter: https://github.com/abusuioc/hms-start-hacking-flutter
-
for React Native: https://github.com/abusuioc/hms-start-hacking-reactnative
Happy hacking! 👨🏻💻