Manuals+

Create OEM App for Smart Life

Version: 20250811

Online Version

1. Create OEM App for SmartLife

This topic describes how to create, configure, and launch an OEM app for Smartlife on the Tuya Developer Platform.

2. Create app

Steps to create an app:

  1. Navigate to Tuya Developer Platform > App > OEM App > App Creation.
  2. Click 'Create App'. In the 'Select OEM App Category' dialog box, click 'Create' for the SmartLife category.
  3. In the dialog box that appears, enter the app information, and carefully read and accept the terms in the 'OEM App Service and Software License Agreement'.

App Creation Options:

OptionDescriptionExample
Edition TypeChoose between the following edition types to fit your needs:
• Basic Edition: Provides all features of the SmartLife app for you to quickly build a branded smart app.
• Advanced Edition: Offers enhanced customization, Siri voice assistant integration, and other capabilities. For more information, see OEM App Plans on Tuya Developer Platform.		Advanced Edition
App NameThe app name displayed on the user's mobile phone home screen. Recommended: within 6 characters in Chinese or 12 characters in English.Smart app
Package Name for Android / Bundle ID for iOSThe unique identifier used for launching apps on app stores. Recommended format: com.yourcompany.appname. Ensure it's unique. Avoid using 'tuya'. Example: com.tuya.smart.com.testapp.smartiot
App SchemaOptional. If not specified, it's automatically generated based on the package name or bundle ID. It's used to evoke the app on the mobile phone and relates to the QR code URL. Cannot be modified after confirmation.Auto Generated
Targeted LocationsSelect the countries or regions where your app will be available. This determines configurations and installation packages. The 'Global' option is described as an example.Global

3. Configure app

Certain settings require subscription to the Advanced edition or purchase of the 'Custom App Tools' value-added service. Otherwise, default configurations apply.

3.1. Customize UI

Custom UI styles determine the app's logo and appearance.

  1. Set App Icon:
    • Only square .png images are supported. Do not use transparent backgrounds to avoid display errors.
    • Dimensions: 1024 × 1024 pixels.
    • File size: Cannot exceed 10 MB.
  2. Click 'Detailed Settings' to navigate to the Custom App Tools.
  3. Select a suitable app style template to quickly finish UI settings.
  4. Configure 'Custom Theme Style', 'Unified Background Image', 'Dark Mode', and 'Select Suitable App Theme Template' as needed.
  5. Set Page: This component is divided into:
    • Tab Pages: Includes settings for Home, Scene, and Me.
    • General Pages: Includes settings for Pairing Devices, Login/Register, and Splash Screen. After settings are finished, click 'Save', rebuild the app, and install it on a mobile phone to preview.

The system displays available settings for pages. For example, to configure 'Home':

  1. Use the switch to enable or disable a component.
  2. Select a style for the enabled component.
  3. Drag and drop components on the previewed page to arrange the layout.
  4. Choose Pages > Tab pages and customize 'Icon Settings'. Upload .png icons (108 × 108 pixels). Tuya provides default icons.

Note on Tab Icons: To display desired tab icons, go to Step 2: Set Functions > Tab Icon Features and enable them. The 'Mall' tab icon requires binding the mall in the Seller Center.

Splash Screen:

A splash screen is generated after uploading the app icon. You can upload a preferred image. Background image requirements:

  • iPhone: PNG, 1284 × 2788 pixels.
  • iPad: PNG, 2732 × 2048 pixels.
  • Android: PNG, 1080 × 1920 pixels or 1080 × 2160 pixels.

You can upload one image or merge images for iOS and Android splash screens. The app merges them to avoid distortion. If 'Adapt to Tablet' and 'Merge Images' are enabled, upload a new background image for Android without a logo. Click 'Restore Default' to preview the default splash screen.

Set Details: Configure placeholder image, text color transparency, corner styles for cards, buttons, and dialog boxes, customize theme style, and personalize colors.

Dark Mode: Available for template versions v3.25.2 or later. Users can choose Me > Settings > Dark Mode.

UI Customization Notes:

  • Details > Personalized Colors cannot be the same as Theme > Background Color.
  • Theme > Theme Color cannot be the same as Theme > Background Color.
  • Details > Background Color of Tab Bar cannot be the same as Page > Tab Icon > Font Color of Active Tab Label.

The following table shows previews of detailed settings:

ItemPreview APreview B
Background color of cards[Image Description: Preview of cards with different background colors][Image Description: Preview of cards with different background colors]
Background color of dialog boxes[Image Description: Preview of dialog boxes with different background colors][Image Description: Preview of dialog boxes with different background colors]
Background color of tab bars[Image Description: Preview of tab bars with different background colors][Image Description: Preview of tab bars with different background colors]
Text transparency of headlines[Image Description: Preview of headlines with varying text transparency][Image Description: Preview of headlines with varying text transparency]
Text transparency of headings[Image Description: Preview of headings with varying text transparency][Image Description: Preview of headings with varying text transparency]
Text transparency of notes[Image Description: Preview of notes with varying text transparency][Image Description: Preview of notes with varying text transparency]
Text transparency of expiration prompts[Image Description: Preview of expiration prompts with varying text transparency][Image Description: Preview of expiration prompts with varying text transparency]
Right-angle or round corner of cards[Image Description: Preview of cards with different corner styles][Image Description: Preview of cards with different corner styles]
Right-angle or round corner of buttons[Image Description: Preview of buttons with different corner styles][Image Description: Preview of buttons with different corner styles]
Right-angle or round corner of dialog boxes[Image Description: Preview of dialog boxes with different corner styles][Image Description: Preview of dialog boxes with different corner styles]

After UI customization, click 'Save' > 'Preview' to scan a QR code and download the app for preview.

3.2. Set functions

To try an OEM app, click 'Next: Set Functions'. You can use default settings or modify them. Then click 'Next: Build App' > 'Build' to test the app. Each version can be built up to 10 times a day and 30 times a month.

Extended Functions: Enable or set various functions:

  • About Us: Enter your official website URL (must start with https://). Supports Chinese and English.
  • Copyright Information: Enter copyright details. Supports Chinese and English. Viewable in the app under 'Me' > Settings > About.
  • Registration-free Mode: Allows access to certain functions without registration. Available for free trial, requires subscription later.
  • User Agreement: Enabled by default due to app store rules. Users can view the latest version.
  • Scan: Enable or disable the scan function.
  • Bluetooth Mesh: Enable or disable Bluetooth device pairing.
  • Gesture Password: Enable for app lock and enhanced security.
  • Wi-Fi EZ Pairing: Enable or disable this function.
  • Privacy Policy: Enabled by default. Users can view the latest version.
  • OTA Update: Set default auto-update status and allow user modification.

Third-Party Voice Assistants: If your product supports smart speakers, select voice assistants and add skill names. Users can access these via 'Me' > 'Third-Party Voice Services'.

Document Customization: You can edit documents in a preferred language. For languages other than Chinese and English, create the English version first, then select the desired language.

Voice Assistant Skills: Enabling Alexa and Google Assistant requires subscribing to OEM skills. Alexa app-to-app account linking is available.

Advanced Functions: Configure features required for app store launch. You can complete configurations or click 'Next: Build App' to build and test later.

Available Advanced Functions (Trial/Subscription required):

  • Quick Login on Mobile Phone
  • Integrate with Matter
  • Custom Domain Name
  • Integrate with Siri
  • Adapt to Tablets

3.3. Build app

1. In the 'Build App' step, click 'Build'.

2. Select App Stores: Choose the app stores where the app will be launched. The platform shows required configurations for each store. Development processes are classified into 'App for Launch' and 'App for Test'.

3. If the app is built, scan the QR code to download and install it for testing. The QR code identifies the mobile OS (Android/iOS).

4. In case of build failure, an error message will guide troubleshooting. You can also submit a ticket for technical support.

4. Trial app

The trial app is created and configured on the Tuya Developer Platform. After building, scan the QR code to download and install it on your mobile phone.

  • The trial app is valid for 30 days. After expiration, it cannot be edited or built, and the installed app may not function as expected.
  • The trial app installation package cannot be used for app store launch. Purchase the OEM App service and complete configurations for official launch.

5. Official app

If you have already purchased the OEM App service, proceed to launch on app stores.

5.1. Purchase OEM App service

If your app passes testing, you can launch it on app stores. The OEM App service must be purchased to get the installation package. After the trial app expires, you cannot continue using it.

  1. Click 'Purchase OEM App' and go to 'Value-Added Services' to place an order and complete payment.
  2. Check and confirm order information. Click 'Buy Now'.
    • Confirm Order: For offline payments, provide your order number and contact Tuya's account manager.
    • Invoice Information: Contact Tuya's account manager for an invoice after service completion.
  3. After payment, return to the Tuya Developer Platform to continue app configuration.

5.2. App overview

After subscribing to the OEM App service, enter the 'app overview page' from the OEM app list to update information as needed.

  • Modify App Name: Set name in Chinese and English.
  • History Version: View configuration information of historical versions.
  • Change Template: Update to the latest template version. Updates take effect after rebuilding. View release notes for details. Subscribe to 'App Update' notifications for template updates.
  • Continue: Access the last configuration page of the latest version.
  • App Operations and Data: View app analytics, user feedback, and marketing tool information.
  • Recommended Value-Added Services: Subscribe to additional functions.

6. Launch app

6.1. Method 1: Purchase App Launch Service

Subscribe to 'App Launch Service' at Advanced Functions > Take Effect in Real Time > Independent Subscriptions.

Note: If you modify content (UI, extended functions), you must rebuild the app.

If you haven't purchased 'App Launch Service', it's recommended to do so. Tuya provides configuration services for Location, App Certificate, and Push Certificate. If purchased, Tuya's staff will contact you.

6.2. Method 2: Launch app by yourself

1. If the app is not fully configured, click 'Configure' for each item to complete required configurations.

Rebuilding: Any configuration modification requires rebuilding the app. Complete all configurations before building to accelerate the process.

2. After the app is built, uninstall the previous version and install the latest for testing. Check push notifications and map functions for Android. iOS push notifications can be tested after launch.

  • Upload and download the iOS bundle from the Tuya Developer Platform. Read the operation manual carefully for iOS app review.
  • Android packages support mainland China and Google Play. New apps require Android App Bundle on Google Play starting August 2021.
  • The default Android (mainland China) package includes AutoNavi map service, WeChat/Tencent QQ login, and supports push notifications for multiple brands.
  • The Google Play-specific package includes Google Maps and Google Push services.

4. (Optional) Submit a ticket for consultation and troubleshooting during app launch.

5. After the app passes review, click 'Confirm Finished Launch' to confirm launch on app stores.

7. Required setting

The following functions on the 'Required Setting' page must be finished to launch your app.

7.1. User agreement and privacy policy

  1. (Optional) Tuya provides 'Template Reference' in multiple languages (Chinese, English). English versions are required for app launch.
  2. Click 'Add Version' to provide custom privacy policy and service terms.
  3. Tuya's templates are for reference only. Upload accurate and legal content. Tuya makes no warranties regarding template applicability. Update your policy and agreement as needed.

7.2. Certificate for iOS

To launch on Apple's App Store, upload required certificates. Register a developer account first. If certificates are not uploaded, the system cannot build the app.

Manually Create and Upload Certificates: Refer to 'Create Certificates and Provisioning Profiles for iOS'.

7.3. Certificate for Android

To launch on Android app stores, upload required certificates. Register an Android developer account and configure the app as required by app stores. If certificates are not uploaded, the system cannot build the app.

  • App certificate
  • Signature Protection for Android: Improves app security. Refer to 'Enable Signature Protection for Android'.
  • App Signing Certificate: Apply for certificates for specific services, e.g., Login with Amazon (LWA).
  • Push certificate: Set according to user location.
    • Google FCM: Certificate info for Google Push service. Refer to 'Register FCM'.
    • For users in mainland China, use Tuya push channel or Umeng push channel.
    • To allow push notifications without opening the app, set up branded system-level channels.

7.4. Map for Android

Click 'Get SHA-1' to get values. Follow instructions in 'Apply for Google Map Android API Key' and 'Request AutoNavi Map Key' to get map keys and enter them.

8. Optional setting

Configure device pairing lists, third-party integrations, mall service access, and other features on the 'Optional Setting' page.

8.1. Devices

The device pairing list supports 'Standard View', 'Tiled View', and 'List View'.

  • Standard View: Default. Uses same pairing list and guide content as SmartLife app. Cannot modify pairing list/guide content.
  • Tiled View: For less than 10 categories. Visualizes all product categories easily without switching.
  • List View: For multiple product categories. Devices classified into level-1 categories. Allows quick entry to pairing target products.

Customizing Tiled and List Views:

  1. If no product is created, click 'Add Standard Category' or create a product first. Refer to 'Create Products'.
  2. Click 'Create Custom Category'. Select the product, customize icon and category name.

After association, pairing guidance improves success rate. Set category names in other languages. Use the hamburger menu icon to sort categories.

Click 'Setup Instructions' to navigate to the pairing wizard. Refer to 'Configure Pairing Information'.

Click the meatballs menu (...) in the 'Operation' column for more options: 'Multilingual', 'Modify', 'Delete'.

Adding a standard category: Click 'Add Standard Category', add required categories to the 'Selected' column. Standard categories cannot have their icon, name, or pairing guidance modified; only sorting or deletion is possible.

8.2. Third-party service integration

Preset third-party push notifications and enable third-party account logins. Refer to 'Third-Party Service Integration'.

  • Third-Party Push: Support for LINE push messages. More services to be integrated. Requires Client ID, Callback URL, Service Name.
  • Third-Party Login Support: Quick logins from WeChat, QQ, Facebook. Requires Client ID, App Key.
  • Biometric Login: Configure biometric login.
  • Login Configuration for iOS: App Store requires Apple login and third-party login to be enabled. Rebuild and launch the app.

8.3. Malls

Navigate to 'App Mall', check associated mall, 'Mall' tab label, 'Mall Center' name, and set multilingual options.

8.4. More

  • Simultaneous Login on Devices: Enable simultaneous login on multiple phones with the same account.
  • Support Tuya's Generic Skills: Enable Tuya's generic skills for smart speaker control.
  • Verify with Mobile Phone SMS: Users can register, log in, or reset passwords using their mobile number. Bind mobile number with the app.

9. Common tools

Configure app download URL, update notifications, and manage debugging allowlist at 'Common Tools'.

9.1. QR code

A QR code can be printed on product packaging. It links to the app download URL. Ensure the URL is available and points to the app details page on the respective app store.

The QR code requires configuration of one download URL per operating system. Users scan the QR code to visit the download URL.

App Download URL Configuration:

  • QR Code Address: https://a.smart321.com/testappssmartandiot
  • App Download URL for iOS: e.g., https://itunes.apple.com/app/id1034649547
  • App Download URL for Android in Mainland China: e.g., URL of Tencent MyApp.
  • Google Play App Download URL for Android Outside Mainland China: e.g., URL of Google Play.
  • Huawei AppGallery URL for Android Outside Mainland China: Recommended for Huawei users outside mainland China.

Use iPhone and Android phones to scan the QR code to verify app download. Check download addresses if errors occur.

9.2. Update notification

Configure update notifications to inform app users about new releases. Users can then decide whether to update.

9.3. Manage allowlist for debugging

Add an app account registered in mainland China to the debugging allowlist. Users can then choose Me > Settings > Multilingual Debug Mode on the app to check UI text updates.

10. Smart settings

Choose OEM App > Smart settings and configure smart miniapps for the app. Refer to 'Configure Smart Miniapps'.

Smart MiniApp Configuration:

  • Lighting Scene: Create lighting effects.
  • Multi-Video Preview: View multiple camera videos on one screen.
  • Smart Protect: Provide easy-to-use security features.
  • Energy Saving: Get suggestions based on energy consumption.

11. Multilingual settings

Modify app UI entries in the same task or specified entries online.

  • Method 1 (batch modification): Export UI entries spreadsheet, modify content, and upload the edited file.
  • Method 2 (individual modification): Search for entries by UI text and modify them. Refer to 'App Multilingual Introduction'.

12. Subscribe to template updates

Enable 'App Update' in the 'OEM App' section of 'Subscriptions' to receive email notifications for template updates. Up to 30 email addresses can be set per subscription.

We recommend adding the email address to your trusted list to avoid blocked emails.

Models: OEM App for Smart Life, App for Smart Life, Smart Life

File Info : application/pdf, 40 Pages, 5.50MB

PDF preview unavailable. Download the PDF instead.

Create OEM App for Smart Life Tuya Developer Platform Tuya Developer Platform

References

Typst 0.13.1

Related Documents

PreviewTuya Spatial App: Manage Smart Devices
Learn about the Tuya Spatial App, a mobile application for adding and managing smart devices within Tuya's Cloud Development platform. Discover its scenarios, advantages, capabilities, and download information.
PreviewTuya AI Toy App Development Solution
A comprehensive guide to developing AI Toy applications using Tuya's platform, covering product overview, core advantages, template showcase, configuration, integration process, case studies, FAQs, and contact information.
PreviewTuya Smart App & Smart Life App Advantages Overview
An overview of the advantages and features of the Tuya Smart App and Smart Life App, detailing their capabilities for smart home device control, automation, and integration with third-party services.
PreviewTuya Device Panel Initialization Guide
A guide to configuring device panel initialization on the Tuya Developer Platform, allowing for custom user guidance upon first access to a device's control panel.
PreviewTuya Link Devices Guide: Connecting Your Products
A comprehensive guide on how to link devices with Tuya's cloud projects, covering methods for app integration, WeChat mini programs, Tuya app accounts, and SaaS applications.
PreviewTuya Smart & Smart Life V3.13.0 User Manual - Guide to Smart Home Automation
Comprehensive user guide for the Tuya Smart and Smart Life apps (V3.13.0). Learn to download, register, manage devices, set up automations, use voice control, and optimize your smart home experience.
PreviewTuya Developer Platform: Step 2 - Add Device
Learn how to add devices to your Tuya IoT project using the Smart Device Management app, virtual devices, or by linking existing applications.
PreviewTuya Device Binding Guide
Learn how to configure device binding scope for TuyaLink-based devices, enabling secure access management for end-users and development projects.