Configure iOS Certificates for Widget

This topic describes how to configure iOS certificates for your OEM app. These certificates are required for the app to run on Apple Widget.

Preparation

Log in to the Apple Developer platform and select Certificates, Identifiers & Profiles.

Step 1: Create app group

To allow your app to run on Apple Widget, you must create an app group for the existing main app.

1. Go to the Identifiers page and click +. Select App Groups, and in the top right corner of the page, click Continue.

   

2. Enter the following information and click Continue.

   • Description: Enter a name for the app group.

   • ID: Enter the bundle ID of the main app, in the following format: group.Bundle ID. Format of Bundle ID: com.xxx.xxx.

     

3. Confirm the information about the app group. To rectify any error, click Back and modify the information. After all information is confirmed, click Register.

   

4. Now, the app group is created.

Step 2: Create device widget app ID

1. Go to the Identifiers page and click +. Select App IDs, and in the top right corner of the page, click Continue.

   

2. Enter the following information:

   • Description: Enter the certificate name for the app to run on Widget.

   • Bundle ID: Enter the Widget bundle ID, in the format of Bundle ID of main app.widgetdevice.

     After you enter the preceding information, you must select App Groups in the Capabilities section and then click Continue.

     

3. Bind the app ID with the app group. Perform the following steps:

   Click the newly-created app ID, find Capabilities > App Groups, click Edit, select the app group for Widget created in Step 1, and then click Continue.

   

Step 3: Create scene widget app ID

1. Go to the Identifiers page and click +. Select App IDs, and in the top right corner of the page, click Continue.

   

2. Enter the following information:

   • Description: Enter the certificate name for the app to run on Widget.

   • Bundle ID: Enter the Widget bundle ID, in the format of Bundle ID of main app.widgetscene.

     :::
     After you enter the preceding information, you must select App Groups in the Capabilities section and then click Continue.
     :::

     

3. Bind the scene widget app ID with the app group. Perform the following steps:

   Click the newly-created scene widget app ID, find Capabilities > App Groups, click Edit, select the app group for Widget created in Step 1, and then click Continue.

   

   

Step 4: Generate device widget .mobileprovision certificate

1. Go to the Profiles page and click +.

   

2. In the Distribution section, select App Store and click Continue.

   

3. From the App ID drop-down list, select the app ID in the format of Bundle ID of main app.widgetdevice, and click Continue.

   

4. Select the distribution certificate for the main app and click Continue.

   In certain cases, multiple certificates with the same name might appear. You can distinguish these certificates by their expiration time, and select the one that matches the actual expiration time of the distribution certificate.

   

5. In the Provisioning Profile Name field, enter the name of the .mobileprovision certificate for Widget.

   

6. Now, the device widget .mobileprovision certificate is configured. Click Download to download the certificate file, and submit a ticket to send this file to Tuya.

   

Step 5: Generate scene widget .mobileprovision certificate

1. Go to the Profiles page and click +.

   

2. In the Distribution section, select App Store and click Continue.

   

3. From the App ID drop-down list, select the app ID in the format of Bundle ID of main app.widgetscene, and click Continue.

   

4. Select the distribution certificate for the main app and click Continue.

   In certain cases, multiple certificates with the same name might appear. You can distinguish these certificates by their expiration time, and select the one that matches the actual expiration time of the distribution certificate.

   

5. In the Provisioning Profile Name field, enter the name of the .mobileprovision certificate for Widget.

   

6. Now, the scene widget .mobileprovision certificate is configured. Click Download to download the certificate file, and submit a ticket to send this file to Tuya.

   

7. Please upload the device widget .mobileprovision certificate generated in Step 4 and the scene widget .mobileprovision certificate generated in Step 5 to the Tuya IoT Development Platform. After uploaded, you need to rebuild the app to make the configuration take effect.

   To display and control a certain product feature on a device widget, perform the following steps:

   Go to Tuya IoT Development Platform > Product > Tuya OS > Development, and open the development wizard for the target product. Select Step 4: Product Configuration > Quick toggle settings > Settings. In the Select functional points field, select the data point (DP) applicable to the product feature.