Khắc phục sự cố build và xem trước

Khi một bản build thất bại hoặc bản xem trước của bạn không tải, hãy bắt đầu với lỗi hiển thị đầu tiên và thực hiện theo quy trình khôi phục cho triệu chứng đó. Trang này bao gồm Trình xem App, Preview, lỗi build và các bước cần thực hiện trước khi báo cáo sự cố.

Bắt đầu tại đây

Sau khi một Agent hoàn thành tác vụ, Trình xem App sẽ tải app của bạn. Terminal hiển thị hoạt động tác vụ và lỗi, trong khi thanh công cụ Trình xem App cung cấp điều khiển Reload App Viewer, nút chuyển chế độ xem thiết bị, tùy chọn mở bản xem trước trong tab mới và Console.

1. Lưu thay đổi mới nhất và chờ tác vụ hoặc bản build hiện tại hoàn tất.
2. Chọn Reload App Viewer một lần nếu bản xem trước có vẻ chưa được cập nhật hoặc vẫn ở màn hình tải.
3. Mở bản xem trước trong tab mới nếu Trình xem App nhúng bị treo hoặc không phản hồi.
4. Mở Console và sao chép lỗi hiển thị đầu tiên. Giữ lại liên kết dự án và thời điểm xảy ra lỗi.

Khi bản build thất bại

Hãy thử Resolve trước

Khi Atoms phát hiện sự cố build, một thông báo Báo cáo sự cố sẽ xuất hiện ở góc dưới bên trái. Nếu thông báo có Resolve, hãy bắt đầu một lần sửa chữa trước khi thực hiện hành động khác.

1. Chọn Resolve và chờ lần thử hiện tại hoàn tất.
2. Không chọn Resolve lần nữa khi nó đang chạy.
3. Nếu lần thử không hoàn tất, hãy ghi lại trạng thái hiển thị và tiếp tục với các bước báo cáo bên dưới. Không bắt đầu thêm lần thử Resolve nào khác.
4. Khi lần thử hoàn tất, hãy kiểm tra bản xem trước đã được làm mới. Nếu nó không cập nhật, hãy làm mới trình duyệt một lần.
5. Lặp lại hành động đã gây ra sự cố. Nếu sự cố vẫn còn, hãy mở rộng Báo cáo sự cố và tiếp tục với các bước báo cáo bên dưới.

Lỗi build hoặc thiếu dependency

Nếu bảng Preview hiển thị lỗi build, biểu ngữ lỗi màu đỏ hoặc thông báo về gói bị thiếu, hãy dùng chính xác thông báo đó để thu hẹp bước tiếp theo.

1. Mở Console và sao chép toàn bộ thông báo lỗi hiển thị ở đó.
2. Nếu có Resolve, hãy dùng một lần và chờ lần thử hoàn tất.
3. Nếu không có nút Resolve, hãy dán chính xác lỗi vào chat Dự án và yêu cầu Agent sửa lỗi build đó.
4. Nếu lỗi bắt đầu sau một thay đổi cụ thể, hãy mở History và so sánh phiên bản hiện tại với phiên bản hoạt động gần nhất.
5. Nếu lỗi khó xác định, hãy Remix từ phiên bản ổn định gần nhất và áp dụng lại các thay đổi theo từng bước.

Các lỗi đề cập đến Trình xem App, script khởi động, Publish, bản ghi triển khai hoặc các tệp nội bộ của gói bên thứ ba có thể cho thấy sự cố nền tảng. Hãy bao gồm toàn bộ thông báo lỗi khi bạn liên hệ Support.

Build vẫn đang chạy

Kiểm tra Terminal để xem hoạt động tác vụ hiện tại trước khi thử lại. Nếu tác vụ hoặc bản build vẫn đang chạy, hãy chờ nó hoàn tất. Nếu nó vẫn ở trạng thái đang chạy sau khi lần thử hiện tại kết thúc, hãy ghi lại trạng thái, dấu thời gian, liên kết dự án và mọi chi tiết lỗi hiển thị, sau đó báo cáo sự cố.

Khi Preview hoặc Trình xem App không tải

Màn hình tải hoặc bản xem trước không phản hồi

Trước tiên hãy kiểm tra xem chỉ Trình xem App nhúng bị ảnh hưởng hay Preview URL và trang đã xuất bản cũng bị ảnh hưởng.

1. Xác nhận xem tác vụ hoặc bản build hiện tại có còn đang chạy hay không.
2. Chọn Reload App Viewer một lần.
3. Mở Preview trong tab trình duyệt mới.
4. Kiểm tra cùng URL đó trong cửa sổ Ẩn danh.
5. Nếu phiên bản hoạt động gần nhất tải được, hãy so sánh nó với thay đổi gần đây đã gây ra sự cố.

Nếu sản phẩm hiển thị rõ ràng rằng số dư Cloud & AI không đủ hoặc app bị tạm ngưng, hãy mở Settings → Cloud & AI và xem lại trạng thái đó. Không nạp thêm tiền chỉ dựa trên một màn hình trống.

Bản xem trước trống hoặc không đầy đủ

Kiểm tra xem màn hình trống ảnh hưởng đến toàn bộ app hay chỉ một trang hoặc thành phần. Nếu chỉ một khu vực bị ảnh hưởng, hãy dùng bộ chọn trang để mở trực tiếp trang đó và lặp lại hành trình người dùng nhỏ nhất dẫn đến đó. Nếu toàn bộ bản xem trước bị trống, hãy quay lại kết quả build và xử lý lỗi build hoặc lỗi runtime đầu tiên trước khi kiểm tra lại.

Ghi lại mọi lỗi Console hoặc Network mà không chia sẻ cookie, token hoặc giá trị bí mật. Nếu sự cố tiếp diễn, hãy đưa các chi tiết lỗi đã được làm sạch vào báo cáo của bạn.

Preview hiển thị phiên bản cũ hơn

Preview và trang đã xuất bản là hai kênh riêng biệt. Hãy đảm bảo các thay đổi mới nhất đã được lưu và bản build mới nhất đã hoàn tất trước khi làm mới bản xem trước. Mở lại Preview sau khi build hoàn tất. Nếu nó vẫn hiển thị nội dung cũ hơn, hãy so sánh phiên bản hiện tại với phiên bản hoạt động gần nhất trong History.

Khi bản xem trước trông không đúng

Tương tác hoặc điều hướng không hoạt động

Một trang hiển thị được không đồng nghĩa với một trang hoạt động đúng. Hãy mở mọi liên kết điều hướng quan trọng, nhấn các nút chính, gửi các biểu mẫu quan trọng và đi theo hành trình người dùng chính từ đầu đến cuối. Khi một tương tác thất bại, hãy ghi lại chính xác hành động tại đó kết quả mong đợi dừng lại và kiểm tra lại đường dẫn đó sau mỗi lần chỉnh sửa.

Bố cục trên di động bị hỏng

1. Dùng nút chuyển thiết bị trong thanh công cụ Trình xem App để chuyển sang chế độ xem di động.
2. Chọn phần tử bị lỗi trong chế độ Design nếu có.
3. Mô tả bố cục di động mong muốn và những gì không được thay đổi.
4. Áp dụng một thay đổi, sau đó xác minh chế độ xem desktop và di động cùng với các trạng thái tải, trống, hover và lỗi.

Thiếu hình ảnh hoặc tài nguyên khác

1. Mở phần Files và xác nhận rằng tệp được tham chiếu thực sự tồn tại.
2. Kiểm tra xem đường dẫn, tên tệp và định dạng có khớp với tham chiếu mà app đang dùng hay không.
3. Nếu tài nguyên gần đây đã được di chuyển hoặc đổi tên, hãy khôi phục tham chiếu hoặc cập nhật nó một cách có chủ đích.
4. Chọn Reload App Viewer và kiểm tra lại trang bị ảnh hưởng.

Agent đã thay đổi sai phần tử hoặc làm hỏng khu vực khác

1. Mở History và Remix từ phiên bản ổn định gần nhất.
2. Dùng chế độ Design để nhắm đúng phần tử khi có sẵn.
3. Nêu rõ những gì không được thay đổi và chỉ thực hiện một thay đổi cho mỗi câu lệnh.
4. Xác minh kết quả trước khi tiếp tục thay đổi tiếp theo.

Báo cáo sự cố

Hãy báo cáo sự cố khi Resolve không khả dụng, vấn đề vẫn còn sau một lần Resolve hoàn tất, Preview không phản hồi nhưng chat Dự án vẫn hoạt động hoặc hành vi bất thường vẫn tiếp diễn sau khi Agent điều tra.

Mở Feedback từ chat Dự án

1. Mở chat Dự án bị ảnh hưởng và tìm tin nhắn Agent liên quan mới nhất.
2. Chọn ... (thêm tùy chọn), sau đó chọn Feedback.
3. Trong trình nhắn tin hỗ trợ, chọn Send us a message và gửi báo cáo trong cuộc trò chuyện hiện có nếu đã có sẵn.

Để xem đầy đủ quy trình Báo cáo sự cố, hãy xem Report an Issue.

Bao gồm đủ chi tiết để tái hiện sự cố

• Tóm tắt sự cố. Mô tả vấn đề trong một hoặc hai câu.
• Liên kết Dự án hoặc Chat. Bao gồm URL nơi sự cố xảy ra.
• Ngày và giờ. Bao gồm múi giờ của bạn.
• Các bước để tái hiện. Liệt kê chính xác các hành động theo thứ tự.
• Kết quả mong đợi và kết quả thực tế. Nêu điều đáng lẽ phải xảy ra và điều đã xảy ra thay thế.
• Những gì bạn đã thử. Cho biết Resolve có xuất hiện hay không, điều gì xảy ra sau khi nó hoàn tất và việc làm mới hoặc Remix có thay đổi kết quả hay không.
• Trình duyệt và thiết bị. Bao gồm trình duyệt, hệ điều hành và loại thiết bị.
• Bằng chứng. Đính kèm ảnh chụp màn hình hoặc bản ghi và các chi tiết Báo cáo sự cố hoặc Console hiển thị có liên quan.

Xóa mật khẩu, API keys, token xác thực, cookie, chi tiết thanh toán và dữ liệu cá nhân hoặc dữ liệu mật không liên quan trước khi chia sẻ ảnh chụp màn hình hoặc nhật ký.

Sau khi sự cố được khắc phục

Chạy hành trình người dùng chính từ đầu đến cuối. Kiểm tra Preview ở cả chế độ xem desktop và di động, mở từng trang từ bộ chọn trang và xác nhận rằng Console không có thông báo lỗi màu đỏ. Nếu app đã sẵn sàng để xuất bản, hãy thay thế mọi nội dung giữ chỗ và hoàn tất các bước kiểm tra xuất bản trong Trình xem App.

Câu hỏi thường gặp