TuyaOS Development Framework EOL Rules

Last Updated on : 2024-01-03 06:19:59download

This topic describes the TuyaOS release convention and end of life (EOL) cycle.

Release numbering

The release number consists of three parts: the major release, the minor release, and the patch release. For example, 3.5.0 is major release 3, minor release 5, and patch release 0.

  • Major release: This number is incremented when there is a new upgrade to the architecture.
  • Minor release: This number is incremented when there is a feature added or modified.
  • Patch release: This number is incremented when there is a bug fix.

You can check the release notes from TuyaOS EasyGo or Resource Center in Tuya Wind IDE.

Support lifecycle

Major and minor releases, such as version 3.3, receive support for 36 months from their initial official release date. The support cycle includes servicing cycle, maintenance cycle, and EOL cycle.

  • Servicing cycle

    You can use a release for new project development during its servicing cycle. During this cycle, the focus is on bug fixes and backward-compatible releases. Breaking changes are not added at this time.

    Additionally, patch releases will be issued as needed, to fix bugs and security issues. These are marked by incrementing the third part of the release number. For example, 3.3.3 or 3.3.4 is released to fix bugs introduced in 3.3.2. We recommend you update to the latest patch release of the minor release you are currently using.

  • Maintenance cycle

    During the maintenance cycle, support is limited to addressing critical bugs and security issues. It is recommended not to initiate new projects during this cycle.

  • EOL cycle

    During the EOL cycle, Tuya will discontinue all support for EOL releases. We recommend you update all the projects to the latest releases.

    If you require customization or dedicated bug fixes for EOL releases, contact your account manager for more information.

    Support Servicing cycle Maintenance cycle EOL cycle
    Duration 0 to 18 months 18 to 36 months After 36 months
    Updates of existing features × ×
    Fixes for common bugs × ×
    Security updates ×
    Fixes for critical bugs ×

Lifecycle timelines

Beginning with TuyaOS 3.8.0, all future releases will be labeled with their respective release dates, helping you choose a suitable TuyaOS version and strategically plan for the future.

Version number Release date End of servicing End of maintenance Notes
3.9.x series November 11, 2023 May 10, 2025 November 10, 2026 Recommended for developers new to TuyaOS
3.8.x series July 7, 2023 January 6, 2025 July 6, 2026 -
3.7.x series February 28, 2023 August 27, 2024 February 27, 2026 -
3.6.x series October 19, 2022 April 18, 2024 October 18, 2025 -
3.5.x series July 15, 2022 January 14, 2024 July 14, 2025 -
3.4.x series June 2, 2022 December 1, 2023 June 1, 2025 -
3.3.x series April 15, 2022 October 14, 2024 April 14, 2025 -
2.3.x series December 31, 2020 June 30, 2022 December 31, 2023 End of support. Please upgrade to the latest release.
2.2.x and earlier - - - End of support. Please upgrade to the latest release.
  • TuyaOS 3.x.x series and its interfaces are not compatible with TuyaOS 2.x.x series.
  • If you are using TuyaOS 2.x.x, upgrade to a newer release as the 2.x.x series is no longer supported.