Pemecahan masalah build dan pratinjau

Mulai di sini

Setelah Agen menyelesaikan tugas, Penampil App memuat app Anda. Terminal menampilkan aktivitas tugas dan error, sementara toolbar Penampil App memberi Anda kontrol Reload App Viewer, pengalih tampilan perangkat, opsi untuk membuka pratinjau di tab baru, dan Console.

1. Simpan perubahan terbaru dan tunggu hingga tugas atau build saat ini selesai.
2. Pilih Reload App Viewer sekali jika pratinjau terlihat usang atau tetap berada di layar pemuatan.
3. Buka pratinjau di tab baru jika Penampil App yang disematkan macet atau tidak responsif.
4. Buka Console dan salin error pertama yang terlihat. Simpan tautan proyek dan waktu terjadinya kegagalan.

Saat build gagal

Coba Resolve terlebih dahulu

Saat Atoms mendeteksi masalah build, notifikasi Laporan Masalah akan muncul di sudut kiri bawah. Jika notifikasi menyertakan Resolve, mulai satu percobaan perbaikan sebelum melakukan tindakan lain.

1. Pilih Resolve dan tunggu hingga percobaan saat ini selesai.
2. Jangan pilih Resolve lagi saat proses sedang berjalan.
3. Jika percobaan tidak selesai, catat status yang terlihat dan lanjutkan dengan langkah pelaporan di bawah. Jangan mulai percobaan Resolve lainnya.
4. Saat percobaan selesai, periksa pratinjau yang telah diperbarui. Jika tidak diperbarui, segarkan browser sekali.
5. Ulangi tindakan yang menyebabkan masalah. Jika masalah tetap ada, perluas Laporan Masalah dan lanjutkan dengan langkah pelaporan di bawah.

Error build atau dependensi hilang

Jika panel Preview menampilkan error build, banner error merah, atau pesan tentang package yang hilang, gunakan pesan yang tepat untuk mempersempit langkah berikutnya.

1. Buka Console dan salin pesan error lengkap yang terlihat di sana.
2. Jika Resolve tersedia, gunakan sekali dan tunggu hingga percobaan selesai.
3. Jika tidak ada tombol Resolve, tempelkan error yang tepat ke chat Proyek dan minta Agen memperbaiki error build tersebut.
4. Jika error mulai muncul setelah perubahan tertentu, buka History dan bandingkan versi saat ini dengan versi terakhir yang berfungsi.
5. Jika error sulit diisolasi, lakukan Remix dari versi stabil terakhir dan terapkan kembali perubahan secara bertahap.

Error yang menyebut Penampil App, skrip startup, Publish, catatan deployment, atau file internal package pihak ketiga dapat mengindikasikan masalah platform. Sertakan pesan error lengkap saat Anda menghubungi Support.

Build tetap berlangsung

Periksa Terminal untuk aktivitas tugas saat ini sebelum mencoba lagi. Jika tugas atau build masih berjalan, tunggu hingga selesai. Jika tetap berlangsung setelah percobaan saat ini berakhir, catat status, stempel waktu, tautan proyek, dan detail error yang terlihat, lalu laporkan masalah tersebut.

Saat Preview atau Penampil App tidak dimuat

Layar pemuatan atau pratinjau tidak responsif

Pertama, periksa apakah hanya Penampil App yang disematkan yang terdampak, atau apakah URL Preview dan situs yang dipublikasikan juga terdampak.

1. Konfirmasikan apakah tugas atau build saat ini masih berjalan.
2. Pilih Reload App Viewer sekali.
3. Buka Preview di tab browser baru.
4. Uji URL yang sama di jendela Incognito.
5. Jika versi terakhir yang diketahui berfungsi dapat dimuat, bandingkan dengan perubahan terbaru yang memunculkan masalah.

Jika produk secara eksplisit melaporkan saldo Cloud & AI yang tidak mencukupi atau app yang ditangguhkan, buka Settings → Cloud & AI dan tinjau status tersebut. Jangan isi ulang hanya berdasarkan layar kosong.

Pratinjau kosong atau tidak lengkap

Periksa apakah layar kosong memengaruhi seluruh app atau hanya satu halaman atau komponen. Jika hanya satu area yang terdampak, gunakan pemilih halaman untuk membuka halaman tersebut secara langsung dan ulangi alur pengguna terkecil yang mencapainya. Jika seluruh pratinjau kosong, kembali ke hasil build dan selesaikan error build atau runtime pertama sebelum menguji lagi.

Catat error Console atau Network apa pun tanpa membagikan cookie, token, atau nilai rahasia. Jika masalah berlanjut, sertakan detail error yang telah disanitasi dalam laporan Anda.

Preview menampilkan versi yang lebih lama

Preview dan situs yang dipublikasikan adalah saluran yang terpisah. Pastikan perubahan terbaru telah disimpan dan build terbaru telah selesai sebelum menyegarkan pratinjau. Buka kembali Preview setelah build selesai. Jika masih menampilkan konten lama, bandingkan versi saat ini dengan versi terakhir yang diketahui berfungsi di History.

Saat pratinjau terlihat salah

Interaksi atau navigasi tidak berfungsi

Halaman yang dirender tidak sama dengan halaman yang berfungsi. Buka setiap tautan navigasi penting, tekan tombol utama, kirim formulir kunci, dan ikuti alur pengguna utama dari awal hingga akhir. Saat satu interaksi gagal, catat tindakan tepat saat hasil yang diharapkan berhenti dan uji jalur tersebut lagi setelah setiap koreksi.

Tata letak mobile rusak

1. Gunakan pengalih perangkat di toolbar Penampil App untuk beralih ke tampilan mobile.
2. Pilih elemen yang rusak di mode Design jika tersedia.
3. Jelaskan tata letak mobile yang diharapkan dan apa yang tidak boleh berubah.
4. Terapkan satu perubahan, lalu verifikasi tampilan desktop dan mobile serta status pemuatan, kosong, hover, dan error.

Gambar atau aset lain hilang

1. Buka bagian Files dan konfirmasikan bahwa file yang dirujuk ada.
2. Periksa bahwa path, nama file, dan format sesuai dengan referensi yang digunakan oleh app.
3. Jika aset baru-baru ini dipindahkan atau diganti namanya, pulihkan referensinya atau perbarui dengan sengaja.
4. Pilih Reload App Viewer dan uji halaman yang terdampak lagi.

Agen mengubah elemen yang salah atau merusak area lain

1. Buka History dan Remix dari versi stabil terakhir.
2. Gunakan mode Design untuk menargetkan elemen yang tepat jika tersedia.
3. Nyatakan apa yang tidak boleh berubah dan lakukan satu perubahan per prompt.
4. Verifikasi hasilnya sebelum melanjutkan ke perubahan berikutnya.

Laporkan masalah

Laporkan masalah saat Resolve tidak tersedia, masalah tetap ada setelah percobaan Resolve yang selesai, Preview tidak responsif tetapi chat Proyek masih berfungsi, atau perilaku tak terduga berlanjut setelah Agen menyelidiki.

Buka Feedback dari chat Proyek

1. Buka chat Proyek yang terdampak dan temukan pesan Agen relevan terbaru.
2. Pilih ... (opsi lainnya), lalu pilih Feedback.
3. Di messenger dukungan, pilih Send us a message dan kirim laporan dalam percakapan yang sudah ada jika memang sudah tersedia.

Untuk alur Laporan Masalah lengkap, lihat Laporkan Masalah.

Sertakan detail yang cukup untuk mereproduksi masalah

• Ringkasan masalah. Jelaskan masalah dalam satu atau dua kalimat.
• Tautan Proyek atau Chat. Sertakan URL tempat masalah terjadi.
• Tanggal dan waktu. Sertakan zona waktu Anda.
• Langkah untuk mereproduksi. Daftarkan tindakan yang tepat secara berurutan.
• Hasil yang diharapkan dan hasil aktual. Nyatakan apa yang seharusnya terjadi dan apa yang terjadi sebagai gantinya.
• Yang sudah Anda coba. Sebutkan apakah Resolve muncul, apa yang terjadi setelah selesai, dan apakah penyegaran atau Remix mengubah hasilnya.
• Browser dan perangkat. Sertakan browser, sistem operasi, dan jenis perangkat.
• Bukti. Lampirkan tangkapan layar atau rekaman serta detail Laporan Masalah atau Console yang relevan dan terlihat.

Hapus kata sandi, API keys, token autentikasi, cookie, detail pembayaran, dan data pribadi atau rahasia yang tidak terkait sebelum membagikan tangkapan layar atau log.

Setelah masalah diperbaiki

Jalankan alur pengguna utama dari awal hingga akhir. Periksa Preview dalam tampilan desktop dan mobile, buka setiap halaman dari pemilih halaman, dan konfirmasikan bahwa Console tidak memiliki pesan error merah. Jika app siap dipublikasikan, ganti konten placeholder dan selesaikan pemeriksaan publish di Penampil App.

FAQ

Mengapa Penampil App menampilkan layar putih kosong?

1. Konfirmasikan apakah masalah hanya memengaruhi Penampil App, URL Preview, atau juga situs yang dipublikasikan.
2. Pilih Reload App Viewer sekali, buka Preview di tab baru, dan uji jendela Incognito.
3. Periksa apakah tugas atau build saat ini masih berjalan. Tunggu hingga selesai sebelum mencoba lagi.
4. Jika ada pesan eksplisit yang menyatakan saldo Cloud & AI tidak mencukupi atau app ditangguhkan, buka Settings → Cloud & AI dan tinjau saldo tersebut. Jangan isi ulang hanya berdasarkan layar kosong.
5. Catat error Console atau Network apa pun tanpa membagikan cookie, token, atau nilai rahasia.

Jika layar tetap kosong, hubungi Support dengan Tautan Chat, URL Viewer lengkap, waktu dan zona waktu, environment yang terdampak, tangkapan layar, dan detail error yang telah disanitasi.