English
English
简体中文
Contact Us
Register
Log In
layoutIndex

Launch an App for iOS

Last Updated on : 2022-01-29 08:24:41download

This topic describes how to launch a Tuya-powered OEM app on Apple’s App Store.

Preparation

  1. Register an Apple developer account.

  2. Submit a ticket to let Tuya configure the review mode, inform Tuya of the time when the request for review will be submitted, and then rebuild the app.

    After the review mode is configured, create a demo video and preview images, and go to the Tuya IoT Development Platform to get the installation package to be launched on the App Store.

    Launch an App for iOS

  3. Prepare a test account that can be used to log in to the app. You can create this account that is registered in the USA with an email address. This account must be linked with a test device. A virtual device is allowed. This device must stay online during the review.

  4. Log in to the app with the registered test account and prepare four to five images to preview device features:

    • Use the app to pair a product. We recommend that you do not use products such as light bulbs, strip lights, and sockets. Their simple panel UI design might cause the review to be rejected in most cases. Create specially designed screenshots of different functional pages.
    • Upload the 6.5-inch (1242 × 2688 pixels) iPhone screenshot and 5.5-inch (1242 × 2208 pixels) iPhone screenshot. Other dimensions are not required.
    • Take these screenshots by using iPhones.
    • Do not show other app icons on the notification bar in the screenshots. We recommend that you enable the airplane mode for the iPhones when taking the screenshots.
  5. Create an app demo video. We recommend that you upload this video to YouTube. The following video is used as an example.

Create an app

If you have created the target app, skip this section.

  1. Log in to App Store Connect and click My Apps.

    Launch an App for iOS
  2. Click the Add (+) sign and select New App.

    Launch an App for iOS
  3. Enter the required information in the dialog box that appears.

    Launch an App for iOS
    • Platforms: Select iOS.
    • Name: Enter your app name.
    • Primary Language: Select a language as the default language of the app as needed.
    • Bundle ID: Select the Bundle ID used when you generate certificates. It is the same as the Bundle ID for iOS without the suffix.
    • SKU: It can be the same as Bundle ID. The Bundle ID for iOS is recommended.
  4. Click Create.

Enter information about the app

Enter the following information about the app:

  • Subtitle: It is optional.

  • Content Rights: Set it to This app has the necessary rights to its third-party content.

  • Category: Utilities and Lifestyle are recommended.

    Launch an App for iOS
  • If the app needs to support other languages, click English (U.S.) in the top-right corner of the page and select other required languages.

    Launch an App for iOS
  • Enter the app information for each specified language.

Set pricing and availability

Enter the following information about pricing and availability:

  • PRICE: Set the price based on your needs.

  • Availability: Select the locations in which your app will be launched. In most cases, all locations are selected.

  • Distribution for Business and Education: We recommend that you select Available on the App Store, for volume purchasing on Apple Business Manager and Apple School Manager.

    Launch an App for iOS

Set app privacy

Enter the following privacy information:

  • Privacy Policy is required. Click Edit next to Privacy Policy, and in the dialog box that appears, set the Privacy Policy URL field that can be the official website address of your organization.

    Launch an App for iOS Launch an App for iOS
  • Set data collection

    Starting from December 08, 2020, the user data to be collected and used by an app must be disclosed before the app can be launched or updated on the App Store.

    1. Perform the following steps to set Data Collection:

      Launch an App for iOS

      Launch an App for iOS

      Launch an App for iOS

      Launch an App for iOS

      Launch an App for iOS

    2. If your app does not support voice services, skip the Audio Data option.

      Launch an App for iOS

      The Device ID option represents an iOS device that runs the app rather than a smart device to be controlled by the app.

    3. Click Save to show the following result.

      Launch an App for iOS

    4. Click Set Up Email Address and other data types to set the purpose of data collection.

  • Set purpose of data collection

    1. Set the purpose of the data to be collected.

      Launch an App for iOS

      Launch an App for iOS

    2. Select Yes to link the email addresses collected from this app with the identities of users.

      Launch an App for iOS

      Launch an App for iOS

      Launch an App for iOS

    3. Select No, so the email addresses collected from the app will not be linked with the identities of users.

    4. Other data types are similar to the preceding settings, as described in the following table.

      If your app does not support voice services, skip the Audio Data option.

      Data type Purpose Data linked to users Tracking
      Email address Analytics and app features Yes No
      Mobile phone number Analytics and app features Yes No
      Precise location App features Yes No
      Rough location App features Yes No
      Photos or videos App features Yes No
      Audio data App features No No
      Customer support App features Yes No
      Other content of users App features Yes No
      User ID Analytics and app features Yes No
      Product interaction Analytics Yes No
      Crash data App features Yes No
      Performance data App features No No
    5. Save the settings to see the following result.

      Launch an App for iOS

      If your app does not provide voice capabilities, the Data Not Linked to You section does not display User Content.

      Launch an App for iOS

    6. Click Publish.

Enter app version information

  1. Preview app features

    • Upload the prepared preview images of the app features and use the app to pair a product. We recommend that you do not use products such as light bulbs, strip lights, and sockets. Their simple panel UI design might cause the review to be rejected in most cases. Create specially designed screenshots of different functional pages.

    • Upload the 6.5-inch iPhone screenshot and 5.5-inch iPhone screenshot. Other dimensions are not required.

    • Take these screenshots by using iPhones.

    • Do not show other app icons on the notification bar in the screenshots. We recommend that you enable the airplane mode for the iPhones when taking the screenshots.

      Launch an App for iOS

    Examples of preview images

    • The background image dimensions are 1242 × 2688 pixels and the phone model is iPhone XR:

      Launch an App for iOS

    • The background image dimensions are 1242 × 2208 pixels and the phone model is iPhone 6 Plus:

      Launch an App for iOS

  2. Enter the app information

    Launch an App for iOS

    • Promotional Text: the overview of the new features of the app. This text will appear below the app name on App Store.

    • Description: a detailed description of the app and its features.

    • Keywords: one or more keywords used to search for the app. Proper keywords will increase the probability of finding the app.

    • Support URL: a specific technical support URL. It can also be the official website address of your organization.

    • Marketing URL: optional.

    • If other languages are supported, click English (U.S.) in the top-right corner of the page to switch to other target languages, and enter the app information for each specified language.

      Launch an App for iOS

      If the app supports multiple languages, the promotional text and images must be configured for each target specified language.

  3. Enter general app information

    Launch an App for iOS

    • Version: Enter the version number of the app. Try to make it the same as that used on the Tuya IoT Development Platform.
    • Copyright: Enter the copyright information of your organization, for example: “©2018 Tuya Inc.”.
    • Routing App Coverage File: Skip it.
    • Age Rating: Click Edit. In the dialog box that appears, select NONE for all options and click Done.

    Launch an App for iOS

  4. Enter app review information:

    Launch an App for iOS

    • Sign-In Information: Select Sign-in required, and enter the prepared test account and login password respectively in the username and password fields below the checkbox. If the app account is registered in the USA, a certain device must be linked with the account. This device must be the same as that used in the screenshots and demo video mentioned in the previous sections. We recommend that you link a virtual device. If a real device is used, it must stay online during the review.
    • Contact Information: Enter the actual contact information.
    • Notes: Enter the URL of the demo video.
  5. Set advertising identifier

    Set Does this app use the Advertising Identifier (IDFA)? to No.

  6. Configure the demo video:

    1. Place the smart device along with the iPhone. Implement the whole process from tapping the app on the Home screen to pairing the smart device, controlling the switch of the smart device, and other features with the app on the iPhone. The following video is used as an example.

    2. We recommend that you upload the video to YouTube, and set the video to Unlisted. In this mode, the video can be accessed only from its URL.

      Launch an App for iOS

    3. The URL appears on the page after the video is uploaded. However, the video cannot be watched as expected. Access the URL with a new browser tab to test its validity.

    4. Pass the robot verification. This verification cannot be skipped. Otherwise, the reviewer cannot watch the video and will reject your request.

      Launch an App for iOS
    5. Copy the URL of the video page that appears after the robot verification is passed, and paste it to the Notes field on the App Review Information page.

      Do not use an IP camera (IPC) that has cloud storage configured to make the video. Otherwise, the request might be rejected due to an in-app purchase.

Upload app package

Method 1: Tuya IoT Development Platform

  1. Log in to the Tuya IoT Development Platform.

  2. Go to the Launch App step, set Launch Method to Automatic Upload, and then click Upload Installation Package.

    Launch an App for iOS

  3. In the dialog box that appears, enter the Apple ID and app-specific password to upload the package to App Store Connect.

    Launch an App for iOS

Method 2: Transporter

Do not use the Application Loader tool for the upload. Otherwise, certain unknown issues might cause the upload to be failed. Instead, use the newly launched Transporter tool to upload the package.

  1. Use a Mac computer to log in to the Transporter app.

    Launch an App for iOS
  2. Click ADD APP and select the prepared official version of the app installation package suffixed with .ipa.

    Launch an App for iOS
  3. Click DELIVER. If the package upload is stuck, try again.

    Launch an App for iOS
  4. After the app installation package is uploaded, wait for 15 to 60 minutes, return to the App Store Connect page, select this installation package in the Build section, and then click Complete.

    Launch an App for iOS

Submit for review

Click Submit for Review in the top-right corner of the page to submit all information.

It takes one to three workdays to complete the review. The approved app will be automatically launched on the App Store. An approval notification will be sent to the contact email address.

You can contact Tuya to request support if any problem arises when you launch an app.