DevOps / CI/CD

Как принять миграцию RN на HarmonyOS NEXT перед выпуском в 2026 году?

Миграцию RN на HarmonyOS NEXT следует принимать только по доказательствам по каждому критическому уровню, а не по факту успешной сборки и запуска приложения. Такой подход подходит командам, которым нужно решить, готов ли проект к тестированию, пилотному выпуску или полноценному переключению; если хотя бы одна ключевая пользовательская цепочка не воспроизводится, безопаснее сохранить двойной контур или отложить полную замену.

Руководителю выпуска эта схема помогает определить условие допуска к релизу и серому запуску. Руководителю тестирования — превратить различия между RN, ArkTS и системными возможностями в воспроизводимые сценарии. Техническому руководителю и команде поставки — отделить проблемы community-ветки, сторонних библиотек, собственной нативной адаптации и инструментария.

Последнее обновление: 23 сентября 2026 года. Данные повторно сверены с официальным руководством по адаптации приложений HarmonyOS, документацией DevEco Studio и командных инструментов, материалами по диагностике производительности и состоянием репозитория React Native for OpenHarmony.

Сначала зафиксируйте, что именно считается завершённой миграцией

Одна из самых дорогих ошибок — принять разные варианты поставки за один и тот же результат. Перед началом приёмки руководитель выпуска должен выбрать фактическую цель:

  • RN-контейнер собирается и запускает согласованный набор экранов;
  • часть страниц остаётся на RN, а отдельные системные или критичные экраны переписаны на ArkTS;
  • приложение переводится на смешанную архитектуру с заранее определёнными границами между RN и ArkTS;
  • выполняется полная нативная замена, после которой RN больше не является обязательным слоем.

Эти варианты отличаются составом рисков, необходимыми тестами и условиями отката. Если команда заявляет «готово», но не указывает, какие страницы ещё используют RN, какие нативные модули заменены, а какие функции временно исключены, итоговая приёмка не имеет однозначного смысла.

В документе выпуска следует отдельно перечислить:

  • обязательные пользовательские цепочки;
  • страницы, которые пока не мигрируют;
  • разрешённые известные дефекты;
  • функции, запрещённые к выпуску при любом условии;
  • ответственного за каждую область;
  • доказательство закрытия: лог, запись теста, trace, скриншот, артефакт сборки или ссылка на задачу.

Официальное руководство по адаптации HarmonyOS указывает на необходимость проверять изменения API, SDK, инструментов разработки и зависимостей формата HAR/HSP, поэтому среда также входит в границы приёмки, а не считается внешней предпосылкой. Сверять эти условия следует с официальным руководством по обновлению и адаптации приложений HarmonyOS.

Как использовать чек-лист перед решением о релизе

Ниже приведён рабочий чек-лист, который можно включить в задачу на приёмку или в release-документ. Пункт отмечается только после сохранения доказательства; устное подтверждение разработчика или единичный ручной запуск не заменяют лог, тестовый отчёт, trace или проверенный артефакт.

Среда и границы поставки

  • [ ] Зафиксированы версия HarmonyOS NEXT, целевой API, DevEco Studio, SDK и командные инструменты.
  • [ ] Записаны ветка проекта, commit адаптации, lock-файлы и версия React Native for OpenHarmony, если она используется.
  • [ ] Разделены основная ветка React Native, community-ветка и собственные патчи команды.
  • [ ] Составлен список RN-страниц, ArkTS-страниц и смешанных экранов.
  • [ ] Для каждой страницы указано, входит ли она в текущий релиз или остаётся в двойном контуре.
  • [ ] Выполнены чистые Debug- и Release-сборки без использования старых промежуточных артефактов.
  • [ ] Сборка через IDE и сборка через командную строку или CI используют сопоставимую цепочку инструментов.
  • [ ] Сохранены логи успешной сборки и последнего воспроизведённого сбоя.

Функции и нативные модули

  • [ ] Пройдены вход, загрузка главного экрана, получение данных, пагинация и отправка формы.
  • [ ] Проверены загрузка файлов, разрешения и критическое действие предметной области.
  • [ ] Для навигации, жестов, хранения, сети, push, изображений, карт и аналитики назначен статус адаптации.
  • [ ] Для каждого нативного модуля определено, переносится ли он, заменяется, переписывается или блокирует выпуск.
  • [ ] Проверены возврат назад, восстановление состояния, фоновой режим и перезапуск процесса.
  • [ ] Проверены отказ в разрешении, потеря сети и повторная отправка после ошибки.
  • [ ] Для спорных библиотек сохранён минимальный проект воспроизведения или полный журнал сборки.

Производительность и стабильность

  • [ ] Зафиксированы сценарии первого показа, перехода, ввода, загрузки изображений и прокрутки.
  • [ ] Для List, Grid и WaterFlow указаны используемый механизм построения элементов и условия его применения.
  • [ ] Проверены LazyForEach, NodeAdapter или другая реализация, если они участвуют в архитектуре списка.
  • [ ] Проверены повторное создание элементов, освобождение невидимых узлов и обновление данных во время прокрутки.
  • [ ] Сохранены trace и описание условий измерения, а не только итоговое число FPS.
  • [ ] Проверена граница обмена между JavaScript-потоком и UI-потоком на смешанных экранах.
  • [ ] Повторный запуск после фонового режима не приводит к зависанию, дубликатам или потере данных.

Выпуск и откат

  • [ ] Проверены подпись, разрешения, конфигурационные файлы, ресурсы и HAR/HSP-зависимости.
  • [ ] Сопоставлены параметры сжатия, обфускации и логирования в локальной и CI-сборке.
  • [ ] Сохранены контрольный идентификатор артефакта, commit и сведения о среде.
  • [ ] Определены устройства, системы и API, на которых выполнена проверка.
  • [ ] Подготовлены условия остановки серого запуска и процедура отката.
  • [ ] Назначены ответственные за сбор инцидентов и повторную проверку.
  • [ ] Все известные ограничения community-библиотек и временных патчей явно отражены в заключении.

Если любой блок содержит незакрытый пункт, решение следует формулировать не как безусловное «принято», а как «разрешён ограниченный запуск», «сохранён двойной контур» или «переход приостановлен». Такой формат делает чек-лист инструментом принятия решения, а не перечнем действий ради отчётности.

Как проверить среду, ветки и воспроизводимость сборки

До функционального тестирования нужно получить чистый результат сборки из зафиксированной среды. В противном случае команда может исправлять локальную проблему, которая исчезает на машине другого разработчика или в конвейере поставки.

Порядок проверки должен быть следующим.

  1. Зафиксировать версию HarmonyOS NEXT, целевой API, DevEco Studio, SDK и командных инструментов. Версии нужно хранить не только в описании задачи, но и в журнале сборки.
  2. Записать точную ветку исходного проекта, commit собственной адаптации и состояние зависимостей.
  3. Отдельно указать, какая часть кода относится к основной ветке React Native, какая — к React Native for OpenHarmony, а какая поддерживается самой командой.
  4. Выполнить чистую сборку Debug и Release, не используя старые промежуточные артефакты.
  5. Повторить сборку через командную строку или CI, если именно этот путь применяется перед поставкой.
  6. Сравнить подпись, конфигурационные файлы, ресурсы, HAR/HSP-зависимости и итоговые пакеты.
  7. Сохранить логи успешной и неуспешной сборки, чтобы последующий сбой можно было сопоставить с изменением среды.

Инструменты командной строки DevEco Studio должны проверяться в той же связке, что и IDE, SDK и проектные настройки; описание их назначения и получения опубликовано в документации командных инструментов DevEco Studio. Сам факт запуска из IDE не доказывает, что конвейер поставки использует тот же набор компонентов.

Версию API нельзя фиксировать только по названию целевой системы. При обновлении могут меняться доступные API, правила совместимости и поведение инструментов. Поэтому публикационный пакет должен содержать запись о целевом API и результат проверки на соответствующем устройстве. Для этого пригодятся официальные сведения о версиях API и обновлениях.

Отдельного внимания требует происхождение RN-кода. React Native for OpenHarmony — это поддерживаемая сообществом OpenHarmony ветка с собственным состоянием репозитория и документации, а не автоматически доступная возможность основной линии React Native. Теги и историю этой ветки нужно проверять непосредственно в репозитории OpenHarmony React Native. Нельзя записывать возможность community-ветки в список гарантированных возможностей официальной основной ветки.

Что должен принять технический руководитель фронтенда

После воспроизводимой сборки проверяется не синтаксис ArkTS, а поставляемость каждого нативного контракта. Для каждого модуля команда должна ответить, что произойдёт в Release-сборке, при отзыве разрешения, после перезапуска процесса и при отсутствии ожидаемой системной возможности.

Минимальный реестр следует вести по следующим группам:

  • навигация и жесты;
  • локальное хранение и миграция данных;
  • сеть, TLS, прокси и обработка разрыва;
  • push-уведомления;
  • камера, файлы и медиадоступ;
  • изображения, кеш и декодирование;
  • карты и геолокация;
  • авторизация и платёжные или иные критические SDK;
  • аналитика, логирование и отчёты об ошибках.

Для каждого элемента выбирается только один статус:

  • переносится без изменения;
  • переносится после настройки;
  • заменяется другой библиотекой;
  • переписывается как нативный модуль;
  • временно недоступен и блокирует определённый сценарий.

Нельзя использовать статус «работает» без условия. Например, модуль может работать в Debug, но падать в Release из-за подписи, обфускации, отсутствующего ресурса или другой конфигурации. Для нестабильного модуля нужно сохранить минимальный проект воспроизведения, входные данные, ожидаемый результат и журнал сборки. Это снижает риск того, что спор о библиотеке закончится ручной демонстрацией на одной рабочей станции.

При проверке смешанной страницы особое внимание уделяется границе между RN и ArkTS. Нужно проверить передачу параметров, возврат результата, повторное открытие страницы, обработку системного разрешения и восстановление состояния после ухода приложения в фон. Ошибка на этой границе часто выглядит как проблема интерфейса, хотя фактически связана с жизненным циклом нативного модуля или очередью событий.

Как React Native for OpenHarmony проходит функциональную приёмку

Функциональная приёмка должна строиться вокруг реальных цепочек, а не вокруг перечня экранов. Для коммерческого приложения базовый набор обычно включает вход, загрузку главного экрана, получение данных, пагинацию, заполнение формы, отправку, загрузку файла и критическое действие предметной области. Конкретный состав определяется продуктом, но каждая цепочка обязана иметь начало, успешный результат, ошибку и способ повторной попытки.

Для RN-страниц, ArkTS-страниц и смешанных экранов отдельно проверяются:

  • переход вперёд и возврат назад;
  • повторное открытие уже посещённого экрана;
  • сохранение или корректный сброс состояния;
  • запрос разрешения и отказ пользователя;
  • переход приложения в фон и возврат;
  • потеря сети во время запроса;
  • восстановление после перезапуска процесса;
  • повторная отправка формы после ошибки;
  • очистка временных файлов и незавершённых операций.

Практический порядок выполнения такой:

  1. Сначала пройти цепочку на чистом профиле пользователя.
  2. Затем повторить её с существующими данными и активной сессией.
  3. Прервать каждый внешний шаг: сеть, разрешение, файл, возврат из фона.
  4. Проверить результат после принудительного закрытия и нового запуска.
  5. Сопоставить визуальный результат, состояние данных и запись в журнале.
  6. Повторить исправленный сценарий на той же версии сборки и на другом целевом устройстве.

Каждый сбой фиксируется вместе с устройством, версией системы и API, типом пакета, веткой, commit, шагами воспроизведения и расположением логов. Формулировка «не работает на планшете» непригодна для повторной проверки: она не содержит ни условий, ни ожидаемого результата.

В случаях, когда устройство и пакет предположительно несовместимы, следует сверяться с официальными материалами по диагностике совместимости API и HAP, а не сразу менять прикладной код.

Как ArkTS и DevEco Studio должны быть включены в проверку производительности

Перевод части интерфейса на ArkTS сам по себе не является доказательством ускорения. На приёмке проверяются пользовательские задержки и причины их возникновения: первый показ, переход между страницами, ввод, обновление данных, изображения, анимации и прокрутка длинного списка.

Особенно опасно принимать результат по одному числу FPS. Инструмент может измерять отдельный участок, компонент может иметь ограничения поддержки, а пользовательская задержка может возникать раньше или позже измеряемого фрагмента. Официальные материалы по SmartPerf описывают сценарную запись и сбор trace, а руководство по SmartPerf следует использовать для определения состава доказательств.

Для List, Grid и WaterFlow необходимо записать не только название компонента, но и условия его применения:

  • каким механизмом создаются элементы;
  • используется ли LazyForEach, NodeAdapter или другая реализация;
  • когда создаются и освобождаются элементы;
  • что происходит при обновлении массива;
  • сохраняется ли стабильный идентификатор элемента;
  • как обрабатываются изображения разного размера;
  • нет ли повторного создания элементов при возврате на экран;
  • не возникает ли ошибка при изменении данных во время прокрутки.

Для каждого сценария сохраняются trace и описание конфигурации. Если при обновлении данных появляются дубликаты, пропуски или неправильный порядок элементов, это функциональный дефект, а не только «неидеальная плавность». Если интерфейс реагирует с задержкой из-за обмена между JavaScript-потоком и UI-потоком, нужно зафиксировать конкретную операцию, объём данных и момент блокировки, а не ограничиваться выводом «ArkTS медленный».

Проверка должна включать как минимум:

  • открытие экрана с пустыми данными;
  • получение первой порции;
  • несколько последовательных обновлений;
  • подгрузку следующей порции;
  • быстрое движение к началу и концу;
  • загрузку изображений;
  • возврат с другого экрана;
  • повторное открытие после фонового режима.

Официальное описание диагностики зависаний при прокрутке ArkUI помогает отделить измеряемый сбой от субъективной оценки. Но даже официальный trace не заменяет проверку пользовательской цепочки: технический показатель и сквозная задержка не являются одним и тем же.

Как руководителю тестирования собрать матрицу устройств и доказательств

Матрица должна отражать реальную аудиторию продукта, а не случайный набор доступных устройств. В неё включаются основные целевые устройства, устройство с меньшим запасом ресурсов, различия ориентации и разрешения, а также сценарии, которые команда считает критичными. Конкретные модели и их доля должны быть подтверждены внутренними данными продукта; без такой информации нельзя объявлять любой набор «достаточным».

Для каждого сочетания устройства, системы, API, типа пакета и ветки в журнале указываются:

  • дата проверки;
  • идентификатор устройства;
  • версия системы и API;
  • сборка и commit;
  • способ установки;
  • выполненные сценарии;
  • найденные дефекты;
  • ссылка на лог или trace;
  • решение о повторной проверке.

На этом этапе важно не смешивать три результата:

  • сценарий не запускался из-за неподготовленной среды;
  • сценарий запустился, но завершился дефектом;
  • сценарий завершился успешно, а доказательство сохранено.

Только третий результат является основанием для зачёта. Если тест был пропущен, его нельзя компенсировать большим числом успешных страниц.

Как проверить подписывание, пакет и выпускные материалы

Финальная приёмка должна включать не только приложение, но и весь поставляемый комплект. Проверяются подпись, разрешения, конфигурационные файлы, ресурсы, HAR/HSP-зависимости, параметры сжатия и обфускации, переключатели логирования, версия пакета и контрольный идентификатор артефакта.

Сборка из IDE и сборка в CI должны использовать согласованную цепочку. Если локально пакет подписан автоматически, а в конвейере применяются другие ключи или настройки, результаты нельзя считать взаимозаменяемыми. Условия автоматического подписывания следует сверять с официальной документацией DevEco Studio.

До решения о выпуске также должны быть подготовлены:

  • план серого запуска;
  • условие остановки распространения;
  • процедура отката;
  • канал сбора ошибок;
  • ответственный за анализ инцидентов;
  • связь версии пакета с исходной веткой;
  • срок повторной проверки известных ограничений;
  • список библиотек и временных патчей, от которых зависит релиз.

Если приложение всё ещё опирается на нестабильную community-библиотеку или локальный патч без владельца, это не должно маскироваться формулировкой «приёмка завершена». Корректнее указать ограниченный статус: разрешён пилот, сохранён двойной контур или миграция остановлена до появления устойчивой зависимости.

Как по одной странице принять решение о выпуске

Итоговый документ должен разделять дефекты по последствиям, а не по удобству закрытия задач.

  • Блокирующие выпуск: не работает критическая цепочка, нарушена безопасность, отсутствует корректный пакет, не подтверждается подпись или нет рабочего отката.
  • Влияющие на ключевой опыт: ошибки в навигации, восстановлении состояния, загрузке данных, вводе, прокрутке или системных разрешениях, которые затрагивают существенную часть пользователей.
  • Допустимые дефекты: ограниченные визуальные отклонения или второстепенные функции, для которых согласованы условия и срок исправления.
  • Документальные пробелы: отсутствует запись, лог, матрица или описание среды при фактически успешной проверке.

Для каждой категории требуется доказательство закрытия. Количество пройденных тестов не может компенсировать провал критической цепочки. На основании документа выпуска выбирается один из четырёх результатов:

  • выпустить;
  • выпустить ограниченно или в сером режиме;
  • сохранить двойной контур и продолжить миграцию;
  • приостановить переход.

Такая формулировка делает решение проверяемым после обновления DevEco Studio, SDK или API. Команда сможет повторить именно те проверки, на которых основывался первоначальный вывод, вместо повторного запуска всего проекта без понятной точки сравнения.

Текущий подход — локальная сборка на отдельных рабочих станциях и ручная передача артефактов — плохо подходит для долгой приёмки: среды расходятся, инструменты обновляются не синхронно, а воспроизведение дефекта зависит от конкретной машины. Если команде требуется стабильная среда для повторной проверки DevEco Studio, SDK и конвейера, можно сначала изучить возможности KuzCloud, а параметры доступа и сопровождения уточнить через раздел помощи KuzCloud. Для временной подготовки релиза это может быть удобнее, чем покупать отдельное оборудование, но для постоянной тяжёлой нагрузки и задач, требующих физического интерфейса, собственная инфраструктура остаётся более предсказуемым вариантом. Перед началом работ стоит сохранить этот список как шаблон полей приёмки и не допускать релиз только потому, что приложение однажды собралась и открылась.

Проверьте готовность RN-проекта к выпуску в KuzCloud

Арендуйте выделенный физический узел KuzCloud с удалённым доступом по SSH и VNC для финальной проверки сборки и пользовательских сценариев.

Получите полный root-доступ и установите необходимые инструменты, чтобы воспроизвести рабочее окружение разработки, тестирования и CI/CD.