Устранение неполадок сборки и предпросмотра

Начните здесь

После того как Agent завершает задачу, Просмотр приложений загружает ваше приложение. Терминал показывает активность задач и ошибки, а панель инструментов Просмотр приложений предоставляет элемент управления Reload App Viewer, переключатель вида устройства, возможность открыть предпросмотр в новой вкладке и Console.

1. Сохраните последнее изменение и дождитесь завершения текущей задачи или сборки.
2. Выберите Reload App Viewer один раз, если предпросмотр выглядит устаревшим или остается на экране загрузки.
3. Откройте предпросмотр в новой вкладке, если встроенный Просмотр приложений завис или не отвечает.
4. Откройте Console и скопируйте первую видимую ошибку. Сохраните ссылку на проект и время сбоя.

Когда сборка завершается с ошибкой

Сначала попробуйте Resolve

Когда Atoms обнаруживает проблему со сборкой, в левом нижнем углу появляется уведомление Сообщить о проблеме. Если уведомление содержит Resolve, сначала запустите одну попытку исправления, прежде чем выполнять другие действия.

1. Выберите Resolve и дождитесь завершения текущей попытки.
2. Не выбирайте Resolve повторно, пока он выполняется.
3. Если попытка не завершается, зафиксируйте видимый статус и перейдите к шагам отправки отчета ниже. Не запускайте еще одну попытку Resolve.
4. Когда попытка завершится, проверьте обновленный предпросмотр. Если он не обновился, один раз обновите браузер.
5. Повторите действие, вызвавшее проблему. Если проблема сохраняется, разверните Сообщить о проблеме и перейдите к шагам отправки отчета ниже.

Ошибка сборки или отсутствующая зависимость

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

1. Откройте Console и скопируйте полное сообщение об ошибке, которое там видно.
2. Если Resolve доступен, используйте его один раз и дождитесь завершения попытки.
3. Если кнопки Resolve нет, вставьте точный текст ошибки в чат проекта и попросите Agent исправить эту ошибку сборки.
4. Если ошибка появилась после конкретного изменения, откройте History и сравните текущую версию с последней рабочей версией.
5. Если ошибку трудно изолировать, выполните Ремикс из последней стабильной версии и повторно применяйте изменения постепенно.

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

Сборка остается в процессе выполнения

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

Когда Preview или Просмотр приложений не загружается

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

Сначала проверьте, затронут ли только встроенный Просмотр приложений или также затронуты URL Preview и опубликованный сайт.

1. Убедитесь, что текущая задача или сборка все еще выполняется.
2. Выберите Reload App Viewer один раз.
3. Откройте Preview в новой вкладке браузера.
4. Проверьте тот же URL в окне Incognito.
5. Если последняя известная рабочая версия загружается, сравните ее с недавним изменением, которое вызвало проблему.

Если продукт явно сообщает о недостаточном балансе Cloud & AI или о приостановленном приложении, откройте Settings → Cloud & AI и проверьте этот статус. Не пополняйте баланс только на основании пустого экрана.

Пустой или неполный предпросмотр

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

Запишите любую ошибку Console или Network, не передавая cookies, tokens или секретные значения. Если проблема сохраняется, включите очищенные данные об ошибке в свой отчет.

Preview показывает более старую версию

Preview и опубликованный сайт — это отдельные каналы. Убедитесь, что последние изменения сохранены и последняя сборка завершена, прежде чем обновлять предпросмотр. Снова откройте Preview после завершения сборки. Если он по-прежнему показывает старый контент, сравните текущую версию с последней известной рабочей версией в History.

Когда предпросмотр выглядит неправильно

Не работают взаимодействия или навигация

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

Нарушена мобильная верстка

1. Используйте переключатель устройства на панели инструментов Просмотр приложений, чтобы перейти в мобильный вид.
2. Выберите сломанный элемент в режиме Design, если он доступен.
3. Опишите ожидаемую мобильную верстку и что не должно измениться.
4. Внесите одно изменение, затем проверьте десктопный и мобильный виды, а также состояния загрузки, пустого состояния, наведения и ошибки.

Отсутствуют изображения или другие ресурсы

1. Откройте раздел Files и убедитесь, что указанный файл существует.
2. Проверьте, что путь, имя файла и формат соответствуют ссылке, используемой приложением.
3. Если ресурс недавно был перемещен или переименован, восстановите ссылку на него или обновите ее намеренно.
4. Выберите Reload App Viewer и снова проверьте затронутую страницу.

Agent изменил не тот элемент или сломал другую область

1. Откройте History и выполните Ремикс из последней стабильной версии.
2. Используйте режим Design, чтобы выбрать точный элемент, если это доступно.
3. Укажите, что не должно измениться, и вносите по одному изменению на каждый промпт.
4. Проверяйте результат перед переходом к следующему изменению.

Сообщить о проблеме

Сообщите о проблеме, если Resolve недоступен, проблема сохраняется после завершенной попытки Resolve, Preview не отвечает, но чат проекта по-прежнему работает, или неожиданное поведение продолжается после того, как Agent провел проверку.

Откройте Feedback из чата проекта

1. Откройте затронутый чат проекта и найдите последнее релевантное сообщение Agent.
2. Выберите ... (дополнительные параметры), затем выберите Feedback.
3. В мессенджере поддержки выберите Send us a message и отправьте отчет в существующую переписку, если она уже есть.

Полный процесс Сообщить о проблеме описан в Сообщить о проблеме.

Укажите достаточно деталей, чтобы воспроизвести проблему

• Краткое описание проблемы. Опишите проблему одним или двумя предложениями.
• Ссылка на проект или чат. Укажите URL, где возникла проблема.
• Дата и время. Укажите ваш часовой пояс.
• Шаги для воспроизведения. Перечислите точные действия по порядку.
• Ожидаемый результат и фактический результат. Укажите, что должно было произойти и что произошло вместо этого.
• Что вы уже пробовали. Укажите, появлялся ли Resolve, что произошло после его завершения и изменился ли результат после обновления или Ремикс.
• Браузер и устройство. Укажите браузер, операционную систему и тип устройства.
• Подтверждающие материалы. Приложите скриншот или запись, а также соответствующие видимые сведения из Сообщить о проблеме или Console.

Перед отправкой скриншотов или журналов удалите пароли, API-ключи, токены аутентификации, cookies, платежные данные и несвязанные личные или конфиденциальные данные.

После исправления проблемы

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

FAQ

Почему Просмотр приложений показывает пустой белый экран?

1. Убедитесь, затрагивает ли проблема только Просмотр приложений, URL Preview или также опубликованный сайт.
2. Один раз выберите Reload App Viewer, откройте Preview в новой вкладке и проверьте в окне Incognito.
3. Проверьте, не выполняется ли все еще текущая задача или сборка. Дождитесь завершения перед повторной попыткой.
4. Если явное сообщение говорит, что баланс Cloud & AI недостаточен или приложение приостановлено, откройте Settings → Cloud & AI и проверьте этот баланс. Не пополняйте его только на основании пустого экрана.
5. Запишите любую ошибку Console или Network, не передавая cookies, tokens или секретные значения.

Если экран остается пустым, обратитесь в поддержку, указав ссылку на чат, полный URL Viewer, время и часовой пояс, затронутые среды, скриншот и очищенные данные об ошибке.