Pemecahan masalah build dan pratinjau

Saat build gagal atau pratinjau Anda tidak dimuat, mulailah dengan error pertama yang terlihat dan ikuti jalur pemulihan untuk gejala tersebut. Halaman ini membahas Penampil App, Preview, error build, dan langkah-langkah yang perlu diambil sebelum melaporkan masalah.

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 Muat Ulang Penampil App, 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 Muat Ulang Penampil App sekali jika pratinjau terlihat usang atau tetap berada di layar pemuatan.
3. Buka pratinjau di tab baru jika Penampil App tersemat 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 muncul di sudut kiri bawah. Jika notifikasi menyertakan Resolve, mulai satu upaya perbaikan sebelum melakukan tindakan lain.

1. Pilih Resolve dan tunggu hingga upaya saat ini selesai.
2. Jangan pilih Resolve lagi saat proses masih berjalan.
3. Jika upaya tidak selesai, catat status yang terlihat dan lanjutkan dengan langkah pelaporan di bawah. Jangan mulai upaya Resolve lain.
4. Saat upaya 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 yang 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 upaya selesai.
3. Jika tidak ada tombol Resolve, tempelkan error yang tepat ke chat Proyek dan minta Agen memperbaiki error build tersebut.
4. Jika error dimulai 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 deploy, 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 upaya 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 tersemat yang terdampak, atau apakah URL Preview dan situs yang dipublikasikan juga terdampak.

1. Konfirmasikan apakah tugas atau build saat ini masih berjalan.
2. Pilih Muat Ulang Penampil App sekali.
3. Buka Preview di tab browser baru.
4. Uji URL yang sama di jendela Incognito.
5. Jika versi terakhir yang diketahui berfungsi berhasil dimuat, bandingkan dengan perubahan terbaru yang menyebabkan 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 melakukan top up 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 setiap error Console atau Network 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 perbaikan.

Tata letak mobile rusak

1. Gunakan pengalih perangkat di toolbar Penampil App untuk beralih ke tampilan mobile.
2. Pilih elemen yang rusak dalam 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 loading, 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 saja dipindahkan atau diubah namanya, pulihkan referensinya atau perbarui dengan sengaja.
4. Pilih Muat Ulang Penampil App dan uji halaman yang terdampak lagi.

Agen mengubah elemen yang salah atau merusak area lain

1. Buka History dan lakukan Remix dari versi stabil terakhir.
2. Gunakan mode Design untuk menargetkan elemen yang tepat saat 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 upaya 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 ada.

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.
• Apa yang sudah Anda coba. Sebutkan apakah Resolve muncul, apa yang terjadi setelah selesai, dan apakah refresh atau Remix mengubah hasilnya.
• Browser dan perangkat. Sertakan browser, sistem operasi, dan jenis perangkat.
• Bukti. Lampirkan tangkapan layar atau rekaman dan detail Laporan Masalah atau Console yang relevan dan terlihat.

Hapus kata sandi, API key, 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 semua konten placeholder dan selesaikan pemeriksaan publikasi di Penampil App.

FAQ