How to Test My App Configuration on Zenbo?
Having finished building your apps on the DDE editor, it's time to test how them will behave on Zenbo.
Note that if your image is version TW_Zenbo_V13.10.3.x or newer, please also see appendix of this article.
Step 1. Fill your app’s package name, activity name, and get your app key ID in the Console of the Developer Site.
Before you start using the DDE Editor, you should register the info of your app (such as 1. Package Name 2. App Name 3. Activity Name, etc.,) in the App Key Management page by clicking Console in the upper right corner(see figure 3), and after completing some more operations illustrated below, you will be assigned an app key ID for this app (with the corresponding package name, activity name, app name, etc.).
Fig. 3. The figure shows where the console button is.
After getting in the console page (if you have not logged-in, the website will ask you to log in), you will see the App Key Management page as figure 4 below:
Fig. 4. The figure shows the App Key Management Page.
You can click “Add” to register a new app. Now you should predefine some static info here and maybe follow the default grey-out text in some fields.
Fig. 5. The figure shows you an example of how to fill the app related info to get an app key ID.
After pressing SUBMIT, you will get an app key like below:
Fig. 6. The figure shows you the results if the submission is successful.
Now go back to the DDE Editor.
By clicking Project -> Info, you can choose an app ID as the figure below:
Fig. 7. The figure shows you how to go to the place to enter the app-specific info.
Case 1. For developers to deploy
Having successfully registered the app, you will get an ID generated from the App Key Management. Now from the App ID field, you can choose the ID you just got. Note that you can use the same ID for other projects as well.
For case 1, all you need to fill in by yourself are the Domain Name and App ID, and then the other fields will be filled automatically after you have chosen an app ID.
Fig. 8. Project Info -> register a domain ID.
Fig. 9. Register a new Domain Name.
Fig. 10. Click All to access the list describing all the domains.
Case 2. For developers who intend to test the app
Case 2 is for users who only intend to use the DDE editor to test an app flow but don’t want it to be deployed at all. In contrast to Case 1, you can leave the app ID field blank by not selecting any. However, you have to to fill in “DDE Domain ID”, “Package Name”, “Launch Activity” and “App Names” by yourself. The system will not do it for you. (see Fig. 9.)
“Package Name”: "com.asus.webTest"
“Launch Activity”: "test.webTestActivity"
“App Names”: "webTest"
Fig. 11. Fill Domain Name, Package Name, Launch Activity and App Name
If the App Key ID is correct, the related info blanks will be filled automatically. Be sure to make your Package Name and Activity Name be the same as your own apps’ (here it means the package name and activity name in the code you will install on Zenbo), because that is how Zenbo SDK will get the corrected path to launch your app.
Step 2. Test on Zenbo
Now, you must be wondering on how to test it on Zenbo.
First, you must install your own app with your registered packageName and Activity Name on the Dev Site.
After Installing, you can say “hey zenbo” and wait for the sign to speak “start the hello world sample”, now you will see Zenbo launch your app.
For more infomation on the right way to test on Zenbo, please refer to the developer website for other formal documents.
Your andorid code apk need add "82F199B9E7774C688114A72457E3C229 = domin id" and "0.0.1" is the version you can found before you go to edit a project on project center in "Manifest.xml".
<meta-data android:name="zenbo_ds_domainuuid" android:value="82F199B9E7774C688114A72457E3C229"/>
<meta-data android:name="zenbo_ds_version_82F199B9E7774C688114A72457E3C229" android:value="0.0.1" />
Notice that the meta-data needs to be put between <application> and </application>
Note: Look up your image version and put the corresponding format in xml
And, you should to modify the domain id which is in the class "ZenboDialogSample" .
One domain ID can only be used with one package name; one package name can be used with more than one domain ID. It is, however, unacceptable that multiple package names are used with the same domain ID.
Appendix - Publish a Project and Test it on Zenbo, for the 3.x or the newer image
Publish the app by clicking Publish in the upper right corner.
After seeing the message reading the project has been published successfully, click Dev -> Deploy to Downloader.
Having done the above two steps, you will see the following message indicating a success:
By doing step 1 and step 2 the sentence data of the app will be uploaded to the download server.
Download the DS tool. (Note. As for Nicolas, download the Nicola DS tool by clicking the Download button on the upper right corner of this page.)
Use the DS tool.
Below we give you a description of the buttons available on this tool.
- Update by Domain UUID: enter the domain UUID of the app and click the button to search.
- Update by package name: enter the package name and click the button to search.
- Set Server: choose a server to be updated and click Set Server.
- Status: dynamically show the up-to-date status.
It's important to note that users have to use "Update by Package Name" to install the apk on Zenbo at the first time.