Configure Matter Certificate Profiles

Last Updated on : 2024-06-17 10:46:33download

This topic describes how to configure Matter certificate profiles for your OEM app on the Apple Developer platform. These profiles are required for the iOS app to support Matter features.

Before you start

Log in to the Apple Member Center and select Certificates, Identifiers & Profiles.

Configure Matter Certificate Profiles

Step 1: Create App Group

If an App Group already exists in your Apple Developer account and the Identifier of the App Group is group.Bundle ID, you can skip this step and proceed to Step 2: Enable Matter for main application ID.

To enable Matter for your existing app (referred to as the main application in this topic), you need to create an App Group.

  1. Go to the Identifiers page and click +.

    Configure Matter Certificate Profiles
  2. Select App Groups, and in the top right corner of the page, click Continue.

    Configure Matter Certificate Profiles
  3. Fill in the following information:

    • Description: Enter a name for the App Group.

    • Identifier: Enter an identifier for the main application, in the following format: group.com.xxx.xxx. com.xxx.xxx is the bundle ID of your existing app. Then, click Continue.

      Configure Matter Certificate Profiles
  4. Confirm the information about the app group.

    • To rectify any error, click Back and modify the information.

    • After all information is confirmed, click Register.

      Configure Matter Certificate Profiles

Now, the App Group is created.

Step 2: Enable Matter for main application ID

  1. In the top right corner of the Identifiers list, select App Groups > App IDs.

    Configure Matter Certificate Profiles
  2. Find and click the App ID of the main application to enter the configuration page.

    Configure Matter Certificate Profiles
  3. Check whether the feature App Groups is enabled. If not, select the checkbox ☑️ for this feature.

    Configure Matter Certificate Profiles
  4. Then, click Configure and select the previously created App Group. Scroll down the page and check whether the feature Matter Allow Setup Payload is enabled. If not, select the checkbox ☑️ for this feature.

    Configure Matter Certificate Profiles
  5. Click Save in the top right corner of the page.

  6. Select App Groups and click Continue.

    Configure Matter Certificate Profiles

Step 3: Create Matter App ID

  1. Go to the Identifiers page and click +.

    Configure Matter Certificate Profiles
  2. Select the App IDs option and click Continue.
    Configure Matter Certificate Profiles

  3. Fill in the following information:

    • Name: Enter a name for Matter.

    • Bundle ID: Enter a Bundle ID for Matter, in the format of Bundle ID of main application.matter.

    • Select the checkbox ☑️ for App Groups and click Continue.

      Configure Matter Certificate Profiles
  4. Select the previously created App ID and click Configure.

    Configure Matter Certificate Profiles
  5. Select the App Group created in Step 1 to bind the Matter App ID with the App Group.
    Configure Matter Certificate Profiles

Step 4: Generate new .mobileprovision profile for main application

The configuration of the main application has been modified with Matter added, so a new .mobileprovision profile must be generated.

  1. Go to the Profiles page and click the main application to modify its information.

    Configure Matter Certificate Profiles
  2. In the Certificates section, select a new distribution certificate. In this section, multiple distribution certificates with the same name might occur. In this case, determine the creation time of each certificate by the expiration time next to the certificate name. If the creation time is uncertain, select the last certificate and click Save.

    Configure Matter Certificate Profiles
  3. Now, the .mobileprovision profile for the main application is configured. Click Download to download the profile.

    Configure Matter Certificate Profiles

Step 5: Generate .mobileprovision profile for Matter

  1. Go to the Profiles page and click +.

    Configure Matter Certificate Profiles
  2. In the Distribution section, select App Store and click Continue.

    Configure Matter Certificate Profiles
  3. From the App ID drop-down list, select the app ID in the format of Bundle ID of main application.matter, and click Continue.

    Configure Matter Certificate Profiles
  4. Select the same distribution certificate as selected in Step 6 for the main application and click Continue.

    Configure Matter Certificate Profiles
  5. In the Provisioning Profile Name field, enter the name of the .mobileprovision profile for Matter.

    Configure Matter Certificate Profiles
  6. Now, the .mobileprovision profile for Matter is configured. Click Download to download the profile.

    Configure Matter Certificate Profiles

Step 6: Upload provisioning profiles to Tuya Developer Platform

  1. Go to Certificate for iOS on the Tuya Developer Platform.

    You can click Change App beside Required Setting on the top and find your desired app.

    Configure Matter Certificate Profiles

  2. Upload the downloaded provisioning profiles.

    Configure Matter Certificate Profiles

    Configure Matter Certificate Profiles

Things to note

  • The distribution certificate takes effect only after you rebuild the app.