DevOps / CI/CD

HarmonyOS NEXT в 2026 году: контрольный список приёмки миграции React Native перед выпуском

Победивший вариант — принимать миграцию React Native на HarmonyOS NEXT по этапам, начиная с одного представительного бизнес-сценария; расширять объём работ стоит только после проверки зависимостей, поведения на целевых устройствах и процедуры отката. Если приложение компилируется или запускает экран, это ещё не подтверждает совместимость его бизнес-функций и среды выполнения.

Техническим руководителям материал поможет определить границы пилота и условия остановки.
Инженерам RN и ArkTS — проверить библиотеки, интерфейсы и воспроизводимость сборки.
Командам тестирования — собрать доказательства для реальных устройств и решения о выпуске.

Последняя проверка — 29 сентября 2026 года. Сверены документация OpenHarmony по ArkTS и тестированию интерфейса, а также доступные инструкции и версия ветки сообщества; это не подтверждает сроки коммерческого выпуска HarmonyOS NEXT или совместимость конкретного приложения.

Границы пилота и критерии решения

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

До начала работ зафиксируйте область проверки:

  • какие функции и модули включены в пилот, а какие явно исключены;
  • какие устройства и версии системы входят в поддерживаемую область приложения;
  • какая ветка React Native for HarmonyOS, какие ArkTS-компоненты и какие версии библиотек используются;
  • какие внешние сервисы, тестовые учётные записи и разрешения нужны для прохождения сценария;
  • кто принимает решения о продолжении работ, приостановке и возврате к предыдущей версии.

Для обоснования выбора ветки и понимания ограничений используйте документацию сообщества по React Native for HarmonyOS вместе с заметками конкретной версии 0.72.5-ohos-5.0-release. Номер в имени ветки — признак конкретной линии разработки, а не обещание, что она поддерживает все зависимости или устройства проекта. Перед запуском пилота команда должна записать точную используемую ветку и сопоставить её требования с фактическим проектом.

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

Реестр зависимостей перед сборкой

Совместимость React Native с OpenHarmony нельзя установить по одному факту успешной компиляции. Сборка показывает, что конкретный набор исходников, скриптов и инструментов смог создать артефакт в текущем окружении. Она не доказывает, что нативный модуль корректно выполняет свою функцию, что библиотека поддерживает нужный интерфейс или что обработка ошибок совпадает с поведением исходного приложения.

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

Объект проверки Свидетельство готовности Если подтверждения нет
Нативный модуль RN Документация для выбранной ветки, успешный вызов в целевом сценарии и журнал результата Пометить как ожидающий проверки; найти адаптированный модуль или спроектировать замену
Сторонняя библиотека Зафиксированная версия, инструкция по подключению и воспроизводимая функциональная проверка Не считать совместимой по имени или факту установки; исследовать API и подобрать замену
Сборочные скрипты Повторяемая сборка из зафиксированного состояния репозитория с сохранёнными параметрами Остановить интеграционный этап до выяснения различий между окружениями
Подпись и пакет Записанные параметры подписания и установка итогового пакета на целевое устройство Проверить конфигурацию упаковки и причины отказа установки
Разрешения и системные вызовы Сценарии успешного и отказного результата с сохранёнными логами Уточнить реализацию в ArkTS или хост-приложении и повторить тест

Зависимость без проверяемых сведений должна оставаться статусом «ожидает проверки» или «к замене». Переводить её в «совместима» только на основании зелёной сборки нельзя.

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

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

Первый сквозной сценарий

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

В сценарии входа, чтения и записи полезно отдельно проверить:

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

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

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

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

Проверки на устройствах и стабильность

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

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

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

Для наблюдения за стабильностью дополните функциональные прогоны руководством по инструменту Wukong. Не переносите результаты такого прогона на другой набор устройств или сборок без отдельной проверки. Аналогично, любые выводы о плавности интерфейса должны быть основаны на трассировке при сопоставимых условиях. Если измерений нет, запишите метод, конфигурацию и статус «не проверено»; не заменяйте отсутствие данных субъективной оценкой или неподтверждённой цифрой.

Кандидат выпуска и пакетирование

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

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

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

Решение о выпуске и возврат

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

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

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

Отделяйте эту внутреннюю дисциплину от официальных ограничений платформы. Документация OpenHarmony описывает возможности разработки и тестирования, но не подтверждает срок коммерческого выпуска HarmonyOS NEXT и не обещает совместимость ветки RN с конкретным продуктом. По этой причине дату выхода или готовность стороннего инструментария не следует закладывать как доказательство приёмки без соответствующего проверяемого источника.

Частые вопросы

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

Как оформлять библиотеку, для которой нет инструкции об адаптации?
Сохраните её как непроверенную, перечислите используемые API и определите минимальный тест, который подтверждает её поведение в вашем сценарии. Если она критична, не расширяйте пилот до появления доказательств: исследуйте замену или отдельную реализацию. Отсутствие упоминания в каталоге не доказывает несовместимость, но и не даёт основания считать библиотеку поддерживаемой.

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

Как действовать, если на одном устройстве сценарий проходит, а на другом — нет?
Не объединяйте результаты в общий статус «прошло». Зафиксируйте различия устройства, версии системы, настроек и сборки, затем повторите сценарий в сопоставимых условиях. Если устройство входит в заявленную область поддержки, выпуск следует приостановить до объяснения расхождения или документированного решения о риске; исключение устройства должно быть явным продуктовым решением.

Ресурсы для параллельной приёмки

Если текущая схема опирается на один локальный компьютер, очередь сборок мешает параллельной проверке; нехватка тестовых устройств затрудняет воспроизводимость; а ручная передача артефактов и логов делает результаты менее прослеживаемыми. Удалённый Mac не заменяет целевые HarmonyOS NEXT-устройства, не подтверждает совместимость RN-зависимостей и сам по себе не решает вопросы подписи или приёмки. Он может быть полезен как отдельный удалённый ресурс для задач команды, которым действительно нужна macOS-среда, например для параллельных сборок и проверок Apple-платформ.

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

Подготовьте инфраструктуру к выпуску с KuzCloud

Используйте выделенный облачный Mac mini M4 для сборок, автоматизации и задач CI/CD в удобной для вашей команды среде macOS.

Подключайтесь к физической машине по SSH или VNC и получайте полный root-доступ для настройки необходимых инструментов.