Как перенести Ionic Cordova 3 на Ionic Cordova 5?

Question

У меня есть проект Ionic 3, и мне нужно перейти на Ionic 5. Пожалуйста, нужен лучший способ обновить проект.

Answer 1

Вы можете сделать это в два этапа.

Ионный 3 - Ионный 4

Для получения полного списка критических изменений с Ionic 3 на Ionic 4, пожалуйста, обратитесь к документу критических изменений в репозитории ядра Ionic.

В Ionic 4 имя пакета @ionic/angular. Удалите Ionic 3 и установите Ionic 4, используя новое имя пакета:

npm uninstall ionic-angular
npm install @ionic/angular

Общий процесс миграции существующего приложения с Ionic 3 на 4:

1. Создайте новый проект, используя blankстартер (см. Запуск приложения)

2. Скопируйте любые сервисы Angular из src/providers к src/app/services

   • Услуги должны включать { providedIn: 'root' } в @Injectable() декоратор. Подробнее см. В документации поставщика Angular.

3. Скопируйте другие элементы корневого уровня приложения (каналы, компоненты и т. Д.), Помня, что структура каталогов изменяется с src/components к src/app/components, так далее.

4. Скопируйте глобальный стиль Sass из src/app/app.scss к src/global.scss

5. Скопируйте остальную часть приложения, страницу за страницей или функцию за функцией, учитывая следующие моменты:

   • Emulated Shadow DOM включен по умолчанию
   • Страница / компонент Sass больше не должен быть заключен в тег страницы / компонента и должен использовать Angular styleUrls вариант @Component декоратор
   • RxJS был обновлен с v5 до v6 (см. Изменения RxJS)
   • Некоторые хуки жизненного цикла должны быть заменены хуками Angular (см. События жизненного цикла)
   • Могут потребоваться изменения разметки (доступен инструмент миграции, см. Изменения разметки)

Во многих случаях использование Ionic CLI для создания нового объекта с последующим копированием кода также работает очень хорошо. Например:ionic g service weather создаст оболочку Weatherсервис и тест. Затем код можно скопировать из старого проекта с небольшими изменениями по мере необходимости. Это помогает обеспечить соблюдение правильной структуры. Это также создает оболочки для модульных тестов.

От ионного 4 до ионного 5

Для миграции приложения с 4.x на 5.x требуется несколько обновлений свойств API, утилит CSS и установленных зависимостей пакетов.

Полный список критических изменений с 4.x на 5.x см. В документе о критических изменениях в репозитории ядра Ionic.

Для проектов на основе Angular вы можете просто запустить:

npm install @ionic/angular@latest @ionic/angular-toolkit@latest --save

Дополнительные сведения и инструкции см. В Руководстве по миграции.