Create a proprietary app

Procedure

1. Log on to the IoT Platform console.

2. Create a proprietary app.

   1. In the navigation pane on the left, click APP to go to the App Management page. Then, click Create App.

      Note

      By default, you can create up to three proprietary apps in a project. You can use them for different clients, such as mobile phones, tablets, and TVs.

      If you create multiple proprietary apps in the same project, they share the same account system and receive the same push messages.

   2. Configure the application name, package name, and other information. When you are finished, click Confirm. You can modify this information later.

      Follow these rules to configure the application package name.

      • Each app requires two package names: one for the iOS application and one for the Android application. You must configure both package names.

      • The package name must be in the com.xxx.xxx format. The name can contain uppercase letters, lowercase letters, and numbers. It cannot contain spaces. For example: com.mycompany.myproductname.

      Note

      As of April 1, 2020, test versions of apps are no longer provided when you create a proprietary app. Existing test versions of proprietary apps are not affected and can still be used. For more information, see Differences between test and official versions.

3. Obtain the proprietary app keys: AppKey and AppSecret. The AppKey and AppSecret are required for identity authentication and authorization when you call client APIs.

   

   Note

   Keep your keys secure.

4. (Optional) Configure multi-device logon.

   • Multi-device logon disabled: An account can only be logged on to one device at a time. If you log on to a new device, you are automatically logged out from other devices. By default, the IoT Platform does not support multi-device logon.

   • Multi-device logon enabled: An account can be logged on to multiple devices at the same time.

   Choose the option that suits your needs. If your app must support multi-device logon, perform the following steps.

   1. Click Edit next to Support multi-device logon.

      

   2. Select Yes and click OK.

      

5. On the Associate Product page, configure product associations. For more information, see Set associated products.

6. On the User Account page, configure user accounts.

   By default, the system uses the Built-in account system, which is integrated into the SDK package.

   To integrate your own account system, select the Proprietary account system checkbox and enter the required configuration information. For more information, see User Account Developer Guide.

   

7. (Optional) Integrate app interface plugins.

   The IoT Platform provides user interface (UI) plugins for common app features. You can embed the plugin code into your app project to call the corresponding modules. For more information, see Plugin Usage Guide. You can also develop your own app interfaces for these features instead of using the plugins from the SDK and Plugins > Plugins window. If you choose to develop your own interfaces, skip this step.

   The IoT Platform provides UI plugins for the following features: Device Panel, Cloud Timing, Local Timing, Device Message Record, and Feedback, as shown in the following figure.

8. Download and integrate the SDK. For more information, see Download and integrate the SDK.