FAQs

This topic describes frequently asked questions (FAQs) related to differences in Smart Life App SDK versions and troubleshooting for SDK upgrades. The following key points are mentioned:

• Differences between SDK versions: v3.x, v4.x, and v5.x respectively represent a series of Smart Life App SDK versions. Smart Life App SDK is upgraded from v3.x and v4.x to v5.x. The latest version supports multiple features, such as pairing with Matter devices and development on top of Tuya Smart MiniApp.
• Differences between the development edition and official edition of Smart Life App SDK: The development edition is intended only for development or debugging purposes. The official edition can be used for commercial purposes.
• FAQs about SDK upgrade: You must upgrade Smart Life App SDK to v5.0 or later prior to January 1, 2024 to ensure normal use of respective SDK services. The upgrade will not affect the normal running of the launched apps.
• Renewal of Smart Life App SDK: If Smart Life App SDK is not renewed after expiration, you will not be allowed to check important SDK information or download the latest SDK version. However, Tuya can waive a part of the service fees to reduce your renewal cost. Then, your app can still run as expected after renewal.

Differences between SDK versions

1. I have finished functional testing of the app developed based on the development edition of Smart Life App SDK v5.x. Can I launch the app to serve users?

No, you cannot. To launch the SDK-based app for commercial use, perform the following steps:

1. Go to the Tuya IoT Development Platform and purchase the official edition of Smart Life App SDK. For more information, see Subscription.
2. Rebuild and download the SDK packages of the official edition, and replace the SDK packages in your project with the downloaded ones. For more information, see Build and download the SDK for iOS and Build and download the SDK for Android.
3. Repackage and launch the app.

2. What are the differences between SDK v5.x and SDKs v4.x and v3.x?

v3.x, v4.x, and v5.x respectively represent a series of Smart Life App SDK versions. Smart Life App SDK is upgraded from v3.x and v4.x to v5.x. Compared with SDKs v3.x and v4.x, SDK v5.x additionally supports the following features:

• Pairing and controlling devices over Matter.
• The development on top of Smart MiniApp.
• The entry to pairing with QR code.
• Known issues of SDKs v3.x and v4.x have been fixed.

For more information, see Changelog for Smart Life App SDK for iOS and Changelog for Smart Life App SDK for Android.

3. What are the differences between the development edition and official edition of Smart Life App SDK v5.x?

• The development edition and official edition are suitable for different scenarios:

  • Development edition: limited to non-commercial development and testing use only. A limited number of cloud OpenAPI calls and up to 100 registered users are supported. This edition supports the basic SDK and multiple extension SDKs and UI BizBundles.
  • Official edition: This edition is dedicated to commercial use without the limit on the number of registered users. It supports basic SDKs, multiple extension SDKs, and all UI BizBundles. Custom domain names can be configured if your business is deployed outside mainland China.

• The support for mandatory reminders varies between these editions:

  • Official edition: Mandatory reminders are not supported. The following mandatory reminders are removed from the official edition. The optimal user experience of your app developed based on the official edition can be ensured.

  • Development edition: Certain mandatory reminders are supported. This allows you to distinguish this edition from the official edition and avoid using the development edition in commercial scenarios. Optimal user experience can thus be ensured.

    • Mandatory reminders for iOS

      Dialog box	Scenario	Content
      	Remind you of the limit on the number of registered users every 48 hours.	This app is for testing only, but not for commercial use. If the number of registered users reaches the limit, new users cannot be registered.
      	Remind you of SDK logs every 10 seconds.	This application is for testing only, but not for commercial use. If the number of registered users reaches the limit, new users cannot be registered.

    • Mandatory reminders for Android

      Dialog box	Scenario	Content
      	Remind you of the limit on the number of registered users every 48 hours.	This app is for testing only, but not for commercial use. If the number of registered users reaches the limit, new users cannot be registered.
      	Remind you of SDK logs every 10 seconds.	This app is for testing only, but not for commercial use. If the number of registered users reaches the limit, new users cannot be registered.

Upgrade of SDK versions

1. The Tuya IoT Development Platform prompted me that SDK v3.x cannot be downloaded and asked me to subscribe to the official edition and upgrade to v5.0 or later as soon as possible. What is the latest time allowed for me to upgrade the SDK?

Please finish the upgrade to v5.0 or later prior to January 1, 2024. Follow the instructions in Upgrade Guide for iOS and Upgrade Guide for Android to upgrade the SDK.

2. If I purchase the official edition of Smart Life App SDK and upgrade to v5.x, will the normal running of the app developed based on v3.x be affected?

No, it will not. The upgrade will not affect the app in service.

3. If I keep using v3.x to develop and launch the app, do I need to replace the values of AppKey and AppSecret with those for v5.x?

No, you do not. The app developed based on App SDK v3.x still uses the key information including AppKey and AppSecret for v3.x. After you upgrade to v5.x, change the key information to that for v5.x.

To get the key information for v3.x and v4.x, perform the following steps:

1. Log in to the Tuya IoT Development Platform.
2. Go to App SDK > SDK Development.
3. Find the target SDK-based app and go to its details page.
4. Click Switch to Old App SDK: v4 in the top right corner of the page to switch to v4.x.
   
5. Then, you can get the key information for v4.x and v3.x.

4. After I upgraded to v5.0 or later, an error has occurred, saying that “SING_VALIDATE_FALEDerror: Permission verification failed”. How can I fix the problem?

Check whether the following requirements are met:

1. The values of AppKey and AppSecret configured in your project are the same as those displayed on the Tuya IoT Development Platform.
2. The security image is deleted from the project.
3. The project has the security component configured.

For more information, see Upgrade Guide for iOS and Upgrade Guide for Android.

5. How do I deal with the error message “No implementation found”?

• Full error message: No implementation found for java.lang.Object com.thingclips.smart.security.jni.SecureNativeApi.doCommandNative(android.content.Context, int, byte[], byte[], boolean) (tried Java_com_thingclips_smart_security_jni_SecureNativeApi_doCommandNative and Java_com_thingclips_smart_security_jni_SecureNativeApi_doCommandNative__Landroid_content_Context_2I_3B_3BZ)
• Solution: Check whether the security component and implementation fileTree(include: ['*.aar'], dir: 'libs') have been added to your project.

Subscription to Smart Life App SDK

1. If I subscribe to the official edition of Smart Life App SDK for the first year, but fail to renew it after expiration, what problems will be caused?

If you do not renew the initial subscription after expiration, the following problems will be caused:

• You will not be allowed to check the key information, SHA256 certificate, custom domain name settings, and other important data for the SDK-based app on the Tuya IoT Development Platform.
• You will not be allowed to build and download the latest version of Smart Life App SDK.

You can go to Value-Added Services and renew the official edition as needed.

Based on your ongoing and long-term collaboration with Tuya, Tuya can waive certain basic fees, for example, those for O&M and traffic to your app. Your renewal cost can thus be reduced. Then, after renewal, your app can still run as expected and user experience will not be affected.

If you confirm the potential cessation of your broader collaboration with Tuya, you might incur charges for ongoing traffic and basic O&M costs brought by the app. Alternatively, Tuya might explore more solutions with you to meet your supplier needs in the future and gradually phase out the respective app services.