OEM APP build instruction

OEM APP build instruction

One、Log in to the IoT platform

1、Login Tuya IoT Platform https://iot.tuya.com ,enter into the login page, you could log in directly if you have an existing account; If there is no account, please register first and then log in.

Two、Experience Service

In order to facilitate the experience of the OEM App service creation process, we have launched the OEM App service experience function . The configuration process of the experience service and the formal service are basically the same, so you can choose whether to experience it according to your needs.

Number of experience services which are supported to created by different account

Account lever Basic version Enterprise version Ultimate version
Number of OEM App Experience services that can be created 3 times 50 times 100 times

Attention issues for creating experience services:

  • The number of times for experience services will be refunded after deleting the created experience app;

  • The experience time of OEM APP is 30 days, you can pay for it at any time during the experience process. If you still have not paid after expiration, you will not be able to configure the app. But you can activate it when complete the payment, and we will reserve the configuration data for you.

Three、 Create App

1、 Enter into 【Product】section, select App Service, click on Go,next click on Create to start the creation;

2、You can select Experience to experience the function, or choose Buy Now to complete the payment;

3、If you click Experience, the page will jump to Complete App Information

  • App Name:It is recommended to input the length in 6 Chinese characters or 12 English letters as the App name which is displayed on the mobile phone desktop.

  • App package name:As the unique identifier of the APP, it is not allowed to be duplicated. It is recommended that each segment is controlled within 3-20 letters and only lower case letters are supported.

4、 If you click Buy Now, it will enter into the service order purchase page. When you click Buy Now and complete the payment, then start to improve your OEM APP.

5、Complete App information

  • App Name:It is recommended to input the length in 6 Chinese characters or 12 English letters as the App name which is displayed on the mobile phone desktop.

  • App package name:As the unique identifier of the App, it is not allowed to be duplicated. It is recommended that each segment is controlled within 3-20 letters and only lower case letters are supported.

Four、App Configuration

1.Personalization configuration, it determines the appearance of your App: including App icon, App startup page、App color theme.

  • App icon:It only supports png format, the size should be equal to 1024*1024px;

  • App startup page:After uploading the logo, the system will automatically generate a startup page for you. If you are not satisfied with it, you also can re-upload it;It only supports png format, you can choose to click once to upload (1242*2436px), or upload separately in a single size;

  • App color theme:Including setting the navigation font color at the bottom of the app, prompting background color, prompting font color, etc., preset 21 color schemes for quick selection, and support custom setting colors;

Please confirm the APP Personalization custom effect after configuration. If you are not satisfied, click the ‘Re-upload’ button to modify

Note: If you want to quickly demo demo, after the above configuration is confirmed, you can continue to click ‘Next’. If the basic function configuration is not modified, the graffiti provides default configuration. After submitting ‘Immediately build’, refer to the sixth step of this manual. Can be tested first.

  • App Tab icon Settings: Tuya provides the default Tab icon. If you need to modify it, you can click Settings to replace it.

You can upload 6 icons of your own design here, the size must be 108 * 108px, PNG format;

The red box below shows: Default means icon is not selected, Activate means icon is selected;

The effect can be seen in real time in the mobile phone model on the right; the font color of the copy also supports customization;  

  • Login and Registration page background image, Login and Registration page logo tuya provides the default Tab icon, if you need to modify, you can click to set to replace;

Sign in/sign up background: Support format: png, image size: 1080 * 1920px (recommended replacement)

Sign in/sign up logo: Supported format: png, logo size: 400 * 400px

2. Function Configuration

  • Map positioning:Click Get SHA1 to get App related value, and check “help”, then you could configure the Map Key according to the operation guidance manual, and obtain the corresponding key and fill it into the box. (If you want to process for the APP store, * it is the mandatory item)

  • Privacy Policy/Service Agreement

Tuya provides Reference document: Chinese and English, you can click to download the reference. If you need multi-language version, you can upload the modified document by clicking Upload file(doc)according to the English translation.

Attention:This Privacy Policy and Service Agreement template is for your reference only and we make no representations or warranties regarding its accuracy, completeness, timeliness, validity, suitability and consequences. Your company need to make a comprehensive judgment on the above reference documents and conduct legal and compliance risk control.

3.List Settings for Devices on Network Distribution

  • At present, the page can be selected for Standard category. The general distribution network logic of Tuya is used. The Standard category does not support the modification of the relevant pages and contents of the distribution network.

App page display please refers to the following picture, taking Official template A V3.8.0 as an example (click “+” devices )

  • If your actual category does not need so much, you can choose Custom category(Level 2 Catalog Mode) - Create a standard category, select some of the categories you need based on the public version, and select the public version which is not supported to modify the relevant page and content;

  • If your product has its own distribution method, you can choose Custom category - Create a custom category to configure, each product supports the custom icon, name and corresponding distribution guide

Custom category operations are as follows

(1)Click Create a custom category, and the page jumps as follows. Here you need to create a custom product before you can select it in the drop-down box in Associated Products;

(2)If you have not created a custom product, please go back to the Product page, click on "Create " to create the product you need, and then go back to the App Create a custom category to select the product;

(3)Only the products with Custom category support the modification. As shown in the figure below, you can click the Modify button to modify the product icon and name.

(4)You can click the Distribution button to modify the distribution network related guide page;

(5)As shown in the figure below, there are two distribution modes: SmartConfig mode (ie fast distribution mode) and AP mode (ie compatibility mode); the relevant copy can be modified;

App page display please refers to the following picture, taking Official template A V3.8.0 as an example

(6)As shown in the figure below, you can click the Download button to modify the distribution mode page. The file is downloaded in HTML format and need to be modified by the editor. It can be modified according to the template. Please submit the modified HTML file to the Tuya staff for uploaded ;

App page display please refers to the following picture, taking Official template A V3.8.0 as an example

Note: Please remember to click the Release button after modifying this copy.

4.More Settings

At present, there are Multi-language settingsExpansion settingsThird-party support in this section.

  • Multi-language settings: Multi-language setting can be configured for part of the App language.(If you want to modify, please contact the tuya staff.)

  • Expansion settings :The effect can be seen in real time in the mobile phone model on the right, please select it according to your demand.

Copyright information:You can add the copyright information of the app in the “Me - Settings - About” at the bottom of the page.

App page display please refers to the following picture, taking Official template A V3.8.0 as an example

About us:Please enter the link for About us starting with https:// or http://.

FAQ:You could decide whether you will expose the FAQ part in the profile page in the app. If you want to modify it, Please download the template and after modifying please submit it to tuya staff for revision.

(This feature does not supported since App Official template A V3.7.2)

Support Bluetooth:You can choose whether it supports Bluetooth device distribution network according to your actual needs.

Smart scenarios:You can choose whether it supports the smart scene function according to your actual needs.

Scan:You can choose whether it supports this function according to your actual needs.

Gesture password:You can configure whether to enable the app’s gesture password function. If enabled, the user of the app can use the gesture password to lock/unlock the app to improve the security.

Dashboard weather:You can choose whether it supports this function according to your actual needs.

Simultaneous log ins on multiple devices:According to your actual needs, you can choose whether it supports multiple mobile phones login for the same account.

Upload an empty list page: You can configure the bottom picture when all the lists in the app are empty.

Default avatar:You can configure the default avatar of the personal center within the app.

  • Third-party support(If you need to enable it, please check it first ,then refer to the help documentation for configuration.)

(1)Third-party voice support:If your product is connected to a smart speaker, you could check the corresponding speaker skill here, and please fill in the skill name on the right side, after checking, it would have the corresponding button in the app-- personal center–more services. Then click the button to jump to the voice assistant accessing help page. If want to modify the content of the help page, please consult the tuya staff.

(2)Third-party login support :Domestic Support QQ and Wechat, abroad support Facebook and Twitter, please select it according to your actual demand. Accessing the Facebook and Twitter has the active the lower limitation. If it doesn’t reach the lowest bound, it would be canceled the authorization, also it would fail to use the third-party Facebook and Twitter to sign on in the app. More detail rules please reference the Facebook,Twitter document.

Five、The Status Bar

  • Modify:Support for modifying the App name. After modification, it need to be rebuilt to take effect.

  • Change:Here you can select the App version (Official template A), the template is different, the built app features will be different;When the app is created, it defaults to the latest template of the public version.。

(1)If the public version of the App template is released, the current App is not available, you can also select and click curent to the latest template here;

(2)If you are not satisfied with the app built by the updated template, you can rollback to the previous template and rebuild the test.

  • Build status:The current status of the app can be viewed in real time.

  • Certificate configuration: If the application need to be published to the application market, you need to upload the relevant certificate here. To create the certificate, you need to register the developer account first. Please refer to the corresponding application help document for details. If the certificate has not uploaded, you can only build the test version.

Six、Completion

1、After configuration, click Build Now, the status display is built, it takes 30-60 minutes to build the app, the system would automatically build, the build result need to refresh the page view; if timeout, it has not returned the result, it is recommended to contact the tuya staff for consultation, and the possibly cause of failure is the incorrect configuration ;

2、After the construction success, you can scan to download and test your branded App. If there is no problem for the test App, please follow the instructions below to upload it to the major application markets.

Official App installation package ( Please submit your request on our paltform as shown below and share with us your e-mail address to obtain it.)

3、If the build fails, please click Return to modification the App relavant information or click to Contact customer service to view the reason for failure.


400 Call

Consult

400-881-8611