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

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

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

После того как 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. Если ошибку трудно изолировать, выполните Ремикс от последней стабильной версии и повторно применяйте изменения постепенно.

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

Сборка остается в процессе

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

Когда 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 keys, authentication tokens, cookies, платежные данные и несвязанные личные или конфиденциальные данные перед тем, как делиться снимками экрана или журналами.

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

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

FAQ