Mode Aman

Overview

Mode Aman Unity adalah mode bahwa Editor Unity dapat masuk ketika Anda membuka proyek yang memiliki kesalahan kompilasi skrip. Safe Mode dirancang untuk menyediakan lingkungan terbaik untuk menyelesaikan kesalahan kompilasi, sehingga Anda dapat dengan cepat mengembalikan proyek Anda ke keadaan fungsional.

Dalam Safe Mode, Unity menyediakan versi minimal dari antarmuka pengguna Editor, dengan fungsi terbatas. Ini hanya mengimpor aset terkait skrip, dan mencegah impor aset non-script (seperti model, bahan, tekstur dan prefab). Ini karena Safe Mode tidak dimaksudkan untuk produksi konten, hanya untuk menyelesaikan kesalahan kompilasi.

Safe Mode tidak pernah memungkinkan kode yang dikelola untuk dijalankan dari proyek Anda, atau paketnya. Ini berarti scriptsSepotong kode yang memungkinkan Anda untuk membuat Komponen Anda sendiri, memicu peristiwa permainan, memodifikasi sifat komponen dari waktu ke waktu dan menanggapi input pengguna dengan cara apa pun yang Anda sukai. More info
Lihat di Glossary Anda sendiri seperti Script di Editor, asset post-processors, dan importir skrip tidak berjalan. Mode Aman juga menonaktifkan perakitan overrides, dan Burst dan Roslyn Analysers. Ini memastikan Editor dalam Safe Mode selalu sepenuhnya fungsional dan dapat diandalkan, bahkan ketika membuka proyek dalam keadaan yang sangat rusak.

Unity secara otomatis keluar Safe Mode ketika mendeteksi tidak ada kesalahan kompilasi lebih. Ketika keluar Safe Mode, Unity mengimpor proyek Anda penuh, dan Editor mengembalikan fungsi penuh normal.

Penyebab umum dari kesalahan kompilasi

Beberapa skenario umum yang mungkin mengakibatkan Anda menemukan kesalahan kompilasi terjadi ketika Anda:

• Tingkatkan proyek dari versi Unity yang lebih tua ke versi yang lebih baru.
• Buka proyek dalam versi Unity yang berbeda dari yang diciptakan.
• Buka proyek dengan packageWadah yang menyimpan berbagai jenis fitur dan aset untuk Unity, termasuk alat Editor atau Runtime dan perpustakaan, koleksi Aset, dan template proyek. Paket adalah unit mandiri yang dapat dibagikan di proyek Unity. Sebagian besar waktu ini disebut packages, tetapi kadang-kadang mereka disebut Unity Package Manager (UPM) packages. More info
  Lihat di Glossary yang hilang, atau versi paket yang salah.
• Buka proyek yang memiliki kesalahan dalam skrip Anda sendiri.
• Buka proyek di bawah kontrol versiSistem untuk mengelola perubahan file. Anda dapat menggunakan Unity bersama dengan alat kontrol versi yang paling umum, termasuk Perforce, Git, Mercurial dan PlasticSCM. More info
  Lihat di Glossary, di mana perubahan terbaru Anda menarik kesalahan kompilasi.

Membuka proyek yang memiliki kesalahan kompilasi tanpa Safe Mode dapat menyebabkan banyak jenis masalah. Sebagai contoh, packagesPaket adalah koleksi aset untuk dibagikan dan digunakan kembali dalam Unity. Manajer Paket Unity (UPM) dapat menampilkan, menambahkan, dan menghapus paket dari proyek Anda. Paket-paket ini berasal dari Unity Package Manager dan memberikan metode mendasar untuk memberikan fungsi Unity. Namun, Unity Package Manager juga dapat menampilkan Paket Asset Store yang Anda unduh dari Asset Store. More info
Lihat di Glossary dalam proyek Anda mungkin tidak memuat atau berfungsi dengan benar, dan aset Anda mungkin diimpor dengan benar, menghasilkan artefak yang salah tersimpan dalam Library atau di MySQL ServerAplikasi mandiri yang dapat Anda jalankan di komputer lokal Anda yang menyimpan data aset impor untuk mengurangi waktu yang dibutuhkan untuk mengimpor aset. More info
Lihat di Glossary Anda.

Dalam situasi ini, Anda biasanya tidak ingin menunggu sisa proyek untuk mengimpor sebelum Anda dapat menyelesaikan kesalahan. Login Mode memberi Anda alat untuk menyelesaikan masalah terkait skrip ini sendiri, atau untuk menggunakan kontrol versi untuk memperbarui proyek Anda ke versi yang lebih baru yang menyelesaikan kesalahan, tanpa menunggu impor penuh proyek.

Masukkan Mode Aman

Ketika Anda membuka proyek yang memiliki kesalahan kompilasi, Editor menampilkan dialog untuk meminta apakah Anda ingin memasukkan Safe Mode:

Pada titik ini Anda memiliki tiga pilihan:

• Enter Safe Mode
• Ignore kesalahan dan membuka proyek Anda
• Sitemap LoginQuit Unity

Dalam kebanyakan kasus, Anda harus memilih Enter Safe Mode untuk menyelesaikan kesalahan dalam proyek Anda (atau, jika Anda bekerja dengan kontrol versi, untuk menarik perubahan yang mengandung perbaikan pada kesalahan). Login Mode menyediakan lingkungan terbaik untuk memecahkan kesalahan kompilasi, sehingga Anda dapat dengan cepat mengembalikan proyek Anda ke keadaan fungsional sebelum Unity mengimpor sisa proyek Anda.

Namun, ada beberapa kasus di mana Anda mungkin tidak ingin masuk Safe Mode, di mana Anda dapat Quit Unity, atau Ignore kesalahan.

Note: Anda dapat menonaktifkan dialog ini di Edit > Preferences > Asset Pipeline > Show Enter Safe Mode Dialog. Jika Anda menonaktifkan dialog, Unity secara otomatis masuk Safe Mode ketika membuka proyek dengan kesalahan kompilasi.

Cukup tanpa memasukkan Safe Mode

Safe Mode dirancang khusus untuk memperbaiki kesalahan kompilasi. Jika Anda bekerja pada proyek Unity sebagai bagian dari tim, tetapi Anda tidak bertanggung jawab atas skrip yang menyebabkan kesalahan, dan tidak tahu apa yang harus dilakukan, Anda harus memilih Quit in dialog, dan menghubungi programmer di tim Anda untuk saran.

Mengabaikan kesalahan dan terus impor

Ada beberapa situasi di mana Anda tidak perlu proyek untuk berada dalam keadaan yang dapat digunakan (misalnya, jika Anda membuka proyek lama untuk menyalin beberapa bagian, atau hanya memeriksa bagaimana dikonfigurasi). Dalam hal ini, Anda dapat mengabaikan kesalahan dan membuka proyek Anda dalam keadaan yang rusak pula.

Jika Anda memilih Ignore, dan kemudian ingin membuka proyek dalam Safe Mode, Anda dapat menutup dan membuka kembali Unity untuk mengakses dialog "Enter Safe Mode".

Implikasi kesalahan kompilasi pengapian

Jika Anda memilih untuk mengabaikan kesalahan, Unity terus mengimpor sisa aset Anda dan membuka proyek Anda sepenuhnya. implikasi potensial di sini meliputi:

• Proyek Anda mungkin tidak ada di negara yang dapat digunakan. Anda mungkin tidak dapat memasukkan Mode Play, atau membuat build dari proyek Anda, sampai kesalahan diselesaikan. Selain itu, setiap paket dalam proyek Anda mungkin tidak memuat dengan benar, atau sama sekali.

• Unity mungkin perlu mengimpor aset Anda dua kali; setelah peluncuran, dan lagi setelah Anda menyelesaikan kesalahan kompilasi proyek. Ini meningkatkan jumlah waktu yang dibutuhkan untuk memuat proyek Anda dalam keadaan yang dapat digunakan.

• Jika proyek Anda menggunakan API Reference, render pipelineRangkaian operasi yang mengambil isi dari Adegan, dan menampilkannya di layar. Unity memungkinkan Anda memilih dari pipa render yang dibangun sebelumnya, atau menulis sendiri. More info
  Lihat di Glossary Anda mungkin tidak memuat, mengakibatkan masalah visual seperti error shader.

• Kesalahan kompilasi script dapat menyebabkan kesalahan sekunder dalam proyek Anda. Misalnya, jika scripted importer dalam proyek Anda tidak dapat memuat karena kesalahan kompilasi, aset Anda mungkin mengimpor dalam keadaan yang salah.

Mode Aman dirancang untuk membantu Anda menghindari semua masalah ini.

Editor di Safe Mode

Dalam Safe Mode, Unity menyediakan antarmuka Editor minimal dengan fungsi terbatas.

Editor Unity menampilkan spanduk Mode Aman di bagian toolbarSe baris tombol dan kontrol dasar di bagian atas Editor Unity yang memungkinkan Anda untuk berinteraksi dengan Editor dengan berbagai cara (misalnya scaling, terjemahan). More info
Lihat di Glossary di bagian atas Editor, yang menggantikan bilah alat Editor standar. Toolbar menunjukkan bahwa Anda dalam Safe Mode, dan menyediakan tombol Exit Safe Mode, yang memungkinkan Anda untuk mengabaikan kesalahan yang tersisa dan keluar Safe Mode. Banner juga menunjukkan apakah proyek Anda menggunakan paket pratinjauPaket preview adalah dalam pengembangan dan belum siap untuk produksi. Paket dalam pratinjau mungkin ada tahap perkembangan, dari tahap awal hingga penyelesaian dekat.
Lihat di Glossary.

Editor Unity mempertahankan integrasi dengan editor kode dalam Safe Mode, sehingga Anda dapat klik dua kali pada aset skrip atau kesalahan konsolsAssets. Ini juga mempertahankan integrasinya dengan Sistem kontrol versi.

Satu set jendela yang dibatasi dalam Mode Aman

Editor menampilkan pilihan terbatas windows dalam Safe Mode. Ini adalah:

• Jendela Konsol
• Jendela Proyek
• Jendela InspectorJendela Unity yang menampilkan informasi tentang Pengaturan GameObject yang dipilih saat ini, aset atau proyek, memungkinkan Anda untuk memeriksa dan mengedit nilai. More info
  Lihat di Glossary window
• Paket jendela Manager

Ini adalah satu-satunya jendela yang tersedia karena mereka berhubungan dengan memperbaiki kesalahan kompilasi. Tidak ada jendela lain yang tersedia dalam Safe Mode.

Menu Editor di Safe Mode

Pilihan yang tersedia di menu utama Editor dibatasi untuk set terbatas sementara dalam Mode Aman. Anda hanya dapat melihat dan memilih opsi menu yang berkaitan dengan skrip; opsi reguler untuk membuat dan bekerja dengan konten lain tidak tersedia. Misalnya, Anda tidak dapat membuat atau membuka ScenesAdegan berisi lingkungan dan menu permainan Anda. Pikirkan setiap file Adegan unik sebagai tingkat yang unik. Di setiap Adegan, Anda menempatkan lingkungan, hambatan, dan dekorasi, pada dasarnya merancang dan membangun permainan Anda dalam potongan-potongan. More info
Lihat di Glossary, atau membuat aset non-script seperti bentuk primitif, lampu, atau camerasKomponen yang menciptakan gambar sudut pandang tertentu di tempat kejadian Anda. Output ditarik ke layar atau ditangkap sebagai tekstur. More info
Lihat di Glossary. Menu GameObjectThe fundamental object in Unity scenes, which can represent characters, props, scenery, cameras, waypoints, and more. A GameObject’s functionality is defined by the Components attached to it. More info
See in Glossary dan Component tidak hadir, dan menu Window hanya menawarkan set jendela yang dibatasi.

Jendela Proyek dalam Mode Aman

Dalam Safe Mode, Project windowJendela yang menunjukkan isi folder Assets (Project tab) More info
Lihat di Glossary memiliki beberapa perbedaan fungsional dibandingkan dengan perilaku normal di luar Safe Mode.

Perbedaan utama adalah bahwa Anda hanya dapat memilih aset terkait kompilasi. Jenis aset lain tidak dapat dipilih. Mereka tetap terlihat sebagai entri abu-abu di jendela Proyek, tetapi Anda tidak dapat memilih atau mengeditnya.

Secara spesifik, jenis aset terkait kompilasi yang dapat Anda berinteraksi dengan adalah:

• C# file (.cs)
• DLL file (.dll)
• Definisi perakitan (.asm)
• Response files (.rsp)
• File name (.ruleset)

Selain itu, ikon untuk aset yang tidak dapat dipilih tidak menunjukkan pratinjau konten aset. Sebaliknya, mereka menunjukkan ikon generik untuk mewakili jenis aset.

Tombol menu create (+) dinonaktifkan, dan menu konteks jendela Proyek memiliki set pilihan yang berkurang tersedia.

Mode Aman Keluar

Unity secara otomatis keluar Safe Mode ketika Anda telah menyelesaikan semua kesalahan kompilasi. Unity kemudian terus membuka proyek dan mengimpor aset Anda.

Untuk keluar Safe Mode sementara masih ada kesalahan kompilasi tersisa, pilih tombol Exit Safe Mode di Safe Mode toolbar. Ini tidak dianjurkan (lihat Implikasi kesalahan kompilasi pengapian), dan Unity meminta Anda dengan dialog untuk mengkonfirmasi keputusan Anda.

Jika Anda keluar Safe Mode sementara kesalahan tetap dalam proyek Anda, dan kemudian ingin kembali ke Safe Mode, Anda dapat menutup dan membuka kembali Unity untuk mengakses dialog "Enter Safe Mode".

Mode Aman dalam Mode Batch

Dalam Mode Batch, Unity secara otomatis berhenti jika ada kesalahan kompilasi dalam proyek Anda, kecuali Anda menggunakan -ignoreCompilerErrors perintah baris argumen.