Derleme ve önizleme sorun giderme

Bir derleme başarısız olduğunda veya önizlemeniz yüklenmediğinde, ilk görünen hatayla başlayın ve o belirti için kurtarma yolunu izleyin. Bu sayfa Uygulama Görüntüleyici, Önizleme, derleme hataları ve bir sorunu bildirmeden önce atılması gereken adımları kapsar.

Buradan başlayın

Bir Agent bir görevi tamamladıktan sonra, Uygulama Görüntüleyici uygulamanızı yükler. Terminal görev etkinliğini ve hataları gösterirken, Uygulama Görüntüleyici araç çubuğu size Uygulama Görüntüleyiciyi Yeniden Yükle denetimi, bir cihaz görünümü anahtarı, önizlemeyi yeni bir sekmede açma seçeneği ve Console sunar.

1. En son değişikliği kaydedin ve mevcut görevin veya derlemenin tamamlanmasını bekleyin.
2. Önizleme eski görünüyorsa veya bir yükleme ekranında kalıyorsa bir kez Uygulama Görüntüleyiciyi Yeniden Yükle seçeneğini seçin.
3. Gömülü Uygulama Görüntüleyici takılmışsa veya yanıt vermiyorsa önizlemeyi yeni bir sekmede açın.
4. Console'u açın ve ilk görünen hatayı kopyalayın. Proje bağlantısını ve hatanın oluştuğu zamanı not edin.

Derleme başarısız olduğunda

Önce Resolve'u deneyin

Atoms bir derleme sorunu algıladığında, sol alt köşede bir Sorun Bildir bildirimi görünür. Bildirimde Resolve varsa, başka bir işlem yapmadan önce bir onarım denemesi başlatın.

1. Resolve'u seçin ve mevcut denemenin tamamlanmasını bekleyin.
2. Çalışırken tekrar Resolve'u seçmeyin.
3. Deneme tamamlanmazsa, görünen durumu kaydedin ve aşağıdaki bildirim adımlarıyla devam edin. Başka bir Resolve denemesi başlatmayın.
4. Deneme tamamlandığında, yenilenmiş önizlemeyi kontrol edin. Güncellenmezse tarayıcıyı bir kez yenileyin.
5. Soruna neden olan işlemi tekrarlayın. Sorun devam ederse, Sorun Bildir'i genişletin ve aşağıdaki bildirim adımlarıyla devam edin.

Derleme hatası veya eksik bağımlılık

Önizleme panelinde bir derleme hatası, kırmızı bir hata başlığı veya eksik bir paketle ilgili bir mesaj görünüyorsa, sonraki adımı daraltmak için tam mesajı kullanın.

1. Console'u açın ve orada görünen tam hata mesajını kopyalayın.
2. Eğer Resolve kullanılabiliyorsa, bir kez kullanın ve denemenin tamamlanmasını bekleyin.
3. Eğer Resolve düğmesi yoksa, tam hatayı Project chat'e yapıştırın ve Agent'tan bu derleme hatasını düzeltmesini isteyin.
4. Hata belirli bir değişiklikten sonra başladıysa, History'yi açın ve mevcut sürümü son çalışan sürümle karşılaştırın.
5. Hatanın yalıtılması zorsa, son kararlı sürümden Remix yapın ve değişiklikleri kademeli olarak yeniden uygulayın.

Uygulama Görüntüleyici, başlangıç betiği, Publish, bir dağıtım kaydı veya üçüncü taraf bir paketin dahili dosyalarından bahseden hatalar bir platform sorununa işaret edebilir. Support ile iletişime geçtiğinizde tam hata mesajını ekleyin.

Derleme devam ediyor olarak kalıyor

Yeniden denemeden önce mevcut görev etkinliği için Terminal'i kontrol edin. Görev veya derleme hâlâ çalışıyorsa, tamamlanmasını bekleyin. Mevcut deneme bittikten sonra da devam ediyor görünüyorsa, durumu, zaman damgasını, proje bağlantısını ve görünen hata ayrıntılarını kaydedin, ardından sorunu bildirin.

Önizleme veya Uygulama Görüntüleyici yüklenmediğinde

Yükleme ekranı veya yanıt vermeyen önizleme

Önce yalnızca gömülü Uygulama Görüntüleyici'nin mi etkilendiğini, yoksa Önizleme URL'si ve yayımlanmış sitenin de mi etkilendiğini kontrol edin.

1. Mevcut görevin veya derlemenin hâlâ çalışıp çalışmadığını doğrulayın.
2. Bir kez Uygulama Görüntüleyiciyi Yeniden Yükle seçeneğini seçin.
3. Önizlemeyi yeni bir tarayıcı sekmesinde açın.
4. Aynı URL'yi bir Gizli pencere içinde test edin.
5. Bilinen son çalışan sürüm yükleniyorsa, bunu sorunu ortaya çıkaran son değişiklikle karşılaştırın.

Ürün açıkça yetersiz Cloud & AI bakiyesi veya askıya alınmış bir uygulama bildiriyorsa, Settings → Cloud & AI'ı açın ve bu durumu inceleyin. Yalnızca boş bir ekrana bakarak bakiye yüklemeyin.

Boş veya eksik önizleme

Boş ekranın tüm uygulamayı mı yoksa yalnızca bir sayfayı ya da bileşeni mi etkilediğini kontrol edin. Yalnızca bir alan etkileniyorsa, sayfa seçiciyi kullanarak o sayfayı doğrudan açın ve ona ulaşan en küçük kullanıcı yolculuğunu tekrarlayın. Tüm önizleme boşsa, derleme sonucuna dönün ve yeniden test etmeden önce ilk derleme veya çalışma zamanı hatasını çözün.

Çerezleri, jetonları veya gizli değerleri paylaşmadan herhangi bir Console veya Network hatasını kaydedin. Sorun devam ederse, temizlenmiş hata ayrıntılarını bildiriminize ekleyin.

Önizleme daha eski bir sürümü gösteriyor

Önizleme ve yayımlanmış site ayrı kanallardır. Önizlemeyi yenilemeden önce en son değişikliklerin kaydedildiğinden ve en son derlemenin tamamlandığından emin olun. Derleme tamamlandıktan sonra Önizleme'yi yeniden açın. Hâlâ daha eski içerik gösteriyorsa, mevcut sürümü History'de bilinen son çalışan sürümle karşılaştırın.

Önizleme yanlış göründüğünde

Etkileşimler veya gezinme çalışmıyor

Görüntülenen bir sayfa, çalışan bir sayfa ile aynı şey değildir. Her önemli gezinme bağlantısını açın, birincil düğmelere basın, temel formları gönderin ve ana kullanıcı yolculuğunu baştan sona takip edin. Bir etkileşim başarısız olduğunda, beklenen sonucun durduğu tam işlemi kaydedin ve her düzeltmeden sonra o yolu yeniden test edin.

Mobil düzen bozuk

1. Mobil görünüme geçmek için Uygulama Görüntüleyici araç çubuğundaki cihaz geçişini kullanın.
2. Kullanılabiliyorsa bozuk öğeyi Tasarım modunda seçin.
3. Beklenen mobil düzeni ve neyin değişmemesi gerektiğini açıklayın.
4. Bir değişiklik uygulayın, ardından masaüstü ve mobil görünümleri ayrıca yükleme, boş, hover ve hata durumlarını doğrulayın.

Görseller veya diğer varlıklar eksik

1. Files bölümünü açın ve başvurulan dosyanın mevcut olduğunu doğrulayın.
2. Yolun, dosya adının ve biçimin uygulamanın kullandığı başvuruyla eşleştiğini kontrol edin.
3. Varlık yakın zamanda taşındıysa veya yeniden adlandırıldıysa, başvuruyu geri yükleyin ya da bilinçli şekilde güncelleyin.
4. Uygulama Görüntüleyiciyi Yeniden Yükle'yi seçin ve etkilenen sayfayı yeniden test edin.

Agent yanlış öğeyi değiştirdi veya başka bir alanı bozdu

1. History'yi açın ve son kararlı sürümden Remix yapın.
2. Kullanılabiliyorsa tam öğeyi hedeflemek için Tasarım modunu kullanın.
3. Neyin değişmemesi gerektiğini belirtin ve her istemde yalnızca bir değişiklik yapın.
4. Sonraki değişikliğe geçmeden önce sonucu doğrulayın.

Bir sorunu bildirin

Resolve kullanılamadığında, tamamlanmış bir Resolve denemesinden sonra sorun devam ettiğinde, Önizleme yanıt vermediği hâlde Project chat hâlâ çalıştığında veya Agent inceledikten sonra beklenmeyen davranış sürdüğünde sorunu bildirin.

Project chat'ten Feedback'i açın

1. Etkilenen Project chat'i açın ve ilgili en son Agent mesajını bulun.
2. ... (daha fazla seçenek) öğesini seçin, ardından Feedback'i seçin.
3. Destek mesajlaşmasında Send us a message seçeneğini seçin ve zaten mevcut bir konuşma varsa bildirimi mevcut konuşmada gönderin.

Tam Sorun Bildir akışı için Bir Sorunu Bildir bölümüne bakın.

Sorunu yeniden oluşturmak için yeterli ayrıntı ekleyin

• Sorun özeti. Sorunu bir veya iki cümleyle açıklayın.
• Project veya Chat Linki. Sorunun oluştuğu URL'yi ekleyin.
• Tarih ve saat. Saat diliminizi ekleyin.
• Yeniden oluşturma adımları. Tam işlemleri sırayla listeleyin.
• Beklenen sonuç ve gerçek sonuç. Ne olması gerektiğini ve bunun yerine ne olduğunu belirtin.
• Zaten denedikleriniz. Resolve'un görünüp görünmediğini, tamamlandıktan sonra ne olduğunu ve yenilemenin veya Remix'in sonucu değiştirip değiştirmediğini söyleyin.
• Tarayıcı ve cihaz. Tarayıcıyı, işletim sistemini ve cihaz türünü ekleyin.
• Kanıt. Bir ekran görüntüsü veya kayıt ile ilgili görünen Sorun Bildir ya da Console ayrıntılarını ekleyin.

Ekran görüntülerini veya günlükleri paylaşmadan önce parolaları, API anahtarlarını, kimlik doğrulama jetonlarını, çerezleri, ödeme ayrıntılarını ve ilgisiz kişisel ya da gizli verileri kaldırın.

Sorun düzeltildikten sonra

Ana kullanıcı yolculuğunu baştan sona çalıştırın. Önizleme'yi hem masaüstü hem de mobil görünümlerde kontrol edin, sayfa seçiciden her sayfayı açın ve Console'da kırmızı hata mesajları olmadığını doğrulayın. Uygulama yayımlanmaya hazırsa, yer tutucu içeriği değiştirin ve Uygulama Görüntüleyici'de yayımlama kontrollerini tamamlayın.

SSS