从经典 UI 迁移

在 IDE 打开 Classic UI 项目。

使用 Full-Stack Application with Incubating FlowUI 模板在不同的文件夹创建一个 Jmix 1.5 最新版本的新项目。创建时，请使用与待迁移项目相同的项目名和包名。

将新建项目的下列文件拷贝至待迁移项目的根目录：

.gitignore
build.gradle
package.json
tsconfig.json
types.d.ts
vite.config.ts

在待迁移项目中，删除下列文件夹（可以关闭 Safe delete 避免无效警告）：

将新建项目的下列文件夹复制到待迁移项目：

在待迁移项目的 application.properties 中：

从新建项目复制 src/main/resources/<base_package>/menu.xml 文件至待迁移项目，并覆盖已有文件。

打开待迁移项目的 src/main/resources/<base_package>/messages_en.properties 文件并删除 <base_package>.screen.* 和 <base_package>/menu.application 相关的键值。从新建项目的相同文件中复制 <base_package>.view.* 和 <base_package>/menu.application.title 键值至待迁移项目。

复制新建项目 <base_package>.security 包中的 FullAccessRole 和 UiMinimalRole 类至待迁移项目。

在待迁移项目的其他角色中，删除 io.jmix.securityui.role.annotation.MenuPolicy 和 io.jmix.securityui.role.annotation.ScreenPolicy 注解。

在应用程序主类中添加下列代码：

@Push
@Theme(value = "<project_name>")
@PWA(name = "<project_name>", shortName = "<project_name>")
class ... implements AppShellConfigurator

// ...
import com.vaadin.flow.component.page.AppShellConfigurator;
import com.vaadin.flow.component.page.Push;
import com.vaadin.flow.server.PWA;
import com.vaadin.flow.theme.Theme;
// ...

@Push
@Theme(value = "onboarding")
@PWA(name = "Onboarding", shortName = "Onboarding")
@SpringBootApplication
public class OnboardingApplication implements AppShellConfigurator {
}

运行 Gradle 工具窗口的 Reload All Gradle Projects 命令重新加载项目。

使用 Studio 的 Upgrade 升级程序 将项目升级至最新的 Jmix 2.4。

按照扩展组件文档的说明通过市场或者手动添加 starter 的方式为项目添加所需的扩展组件。

执行 Build → Build Project 并修复可能出现的编译错误。

运行应用程序。