Skip to main content

Upgrade and Migration Guide

How to Perform Separate Component Upgrade​

Click the "Upgrade to New Version" button in the properties area to upgrade a single component, for example

Then a confirmation window pops up, displaying the precautions for the upgrade and the introduction to the new version of the component:

Here, click "Learn about the features of the new version component" to view details, and then based on the actual situation, click to confirm the upgrade.

Expected Changes After Upgrade​

Text Component​

After upgrade:

  • Text component supports configuring text overflow ellipsis
  • The font, font size, and styles during text initialization have been optimized.
  • Added three size options (large, medium, small) for body text formatting
preview link

Icon Component​

After upgrade:

  • The color configuration in the attribute area for icons has been removed. It can now be configured via the font color setting in the style panel (the color values previously configured for icons will be retained).
  • The original icon's size configuration via numerical input has been replaced with a size-options dropdown (the previously configured size is retained).
preview link

Button Component:​

After upgrade:

  • The default button size has been adjusted, and full-width button configuration has been added (after upgrading, the default size of existing buttons will change).
  • Buttons have had their default padding removed, are no longer centered by default on the page, and individual buttons no longer occupy a full row by default on mobile (After upgrading, pay attention to layout changes and adjust as needed).
  • Enriched the default button colors. After upgrading, please note the color changes of default buttons and adjust as needed.
  • The disabled state style of buttons has been optimized.
  • Buttons now support configuring icons within them.
  • Enriched the default button types, providing options for filled, outlined, text, and link styles.
preview link

Divider Component​

After upgrade:

  • Added support for two divider line types: solid and dashed.
preview link

Self-Service Troubleshooting​

Rollback of Component Library Upgrade​

If you encounter issues after upgrading the component library and need to completely roll back the version, you can click the rollback button in the component list within the editor within 3 days after the upgrade to revert the changes.

Rollback to Specified Application Version​

If you encounter issues after upgrading the component library and need to completely roll back to a specific previous application version, click on the application history in the editor, locate the pre-upgrade snapshot, and restore it.

Rollback of Single Component Upgrade​

If you have upgraded a specific type of component, it is recommended to promptly verify after the upgrade and only proceed with subsequent development after confirming everything is correct. If you encounter any issues, you can locate the pre-upgrade snapshot in the application history and roll back. (Note: Rolling back to a snapshot will discard all changes made after that snapshot.)