Миграция с Classic UI

Откройте проект на Classic UI в IDE.

Создайте новый проект на последней версии Jmix 1.5 в другом каталоге, используя шаблон Full-Stack Application with Incubating FlowUI. Выберите то же имя и базовый пакет, что и в мигрирующем проекте.

Скопируйте следующие файлы из корневого каталога созданного проекта в мигрирующий:

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

В мигрирующем проекте удалите следующие каталоги (выключите Safe delete чтобы избежать бесполезных предупреждений от IDE):

Скопируйте следующие каталоги из созданного проекта в мигрирующий:

В файле 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 из такого же файла созданного проекта.

Скопируйте классы FullAccessRole и UiMinimalRole пакета <base_package>.security из созданного проекта в мигрирующий.

В других имеющихся ролях мигрирующего проекта удалите аннотации 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 {

Запустите команду Reload All Gradle Projects в окне инструментов Gradle чтобы заново импортировать проект в IDE.

Обновите проект до версии Jmix 2.4, используя стандартную процедуру апгрейда проекта в Studio.

Добавьте в проект необходимые дополнения используя Marketplace или руководствуясь инструкциями по ручной установке этих дополнений.

Выполните команду Build → Build Project и устраните ошибки компиляции, если они возникнут.

Запустите приложение.