Debugging

Studio menawarkan banyak alat dan alur kerja debugging yang biasanya ditemukan di Lingkungan Pengembangan Terintegrasi (IDE). Ini membantu Anda memeriksa dan menyelesaikan kesalahan dalam skrip saat mereka berjalan.

Debugging titik henti

Titik henti adalah titik pemeriksaan yang menghentikan atau "memutuskan" eksekusi skrip Anda pada garis tertentu. Anda dapat menggunakan jeda ini untuk memeriksa dan melakukan debug pengalaman Anda, mengawasi variabel, dan memeriksa call stack. Titik henti adalah salah satu cara paling efektif untuk melakukan debug fungsi, jadi mereka adalah salah satu alat debugging yang paling penting.

Manajemen

Di Script Editor, Anda dapat menyisipkan beberapa jenis titik henti dan mengedit konfigurasi titik henti kapan saja, termasuk selama sesi playtest. Jika Anda mengedit titik henti selama sesi playtest, editan akan tetap ada bahkan setelah Anda menyelesaikannya. Anda juga dapat mengedit titik henti yang aktif menghentikan sesi playtest Anda, tetapi perubahan tidak berlaku hingga sesi playtest berikutnya.

Sisipkan

Titik henti memiliki beberapa variasi dan dapat disisipkan di baris mana pun dari kode yang dapat dieksekusi sebagai berikut:

Untuk menyisipkan titik henti standar di baris kode, klik di dalam jurang tepat di sebelah kanan nomor garisnya. Jika tidak, klik kanan dalam jurang dan pilih Sisipkan Titik Henti. Ikon titik henti muncul sebagai lingkaran merah.

Titik henti standar ditunjukkan di jurang skrip

Nonaktifkan

Untuk menonaktifkan sementara titik henti tanpa menghapusnya, gunakan salah satu alur kerja berikut:

Klik pada ikon titik henti tersebut.
Klik kanan pada ikon titik henti dan pilih Nonaktifkan Titik Henti.
Edit titik henti dan alihkan checkbox Diaktifkannya.

Titik henti yang dinonaktifkan muncul sebagai versi kosong dari ikon yang diaktifkan, misalnya lingkaran kosong untuk titik henti standar yang dinonaktifkan, atau berlian kosong untuk logpoint yang dinonaktifkan.

Titik henti standar dinonaktifkan ditunjukkan di jurang skrip — Titik henti standar dinonaktifkan

Logpoint dinonaktifkan ditunjukkan di jurang skrip — Logpoint dinonaktifkan

Hapus

Untuk menghapus titik henti, klik tengah pada ikonnya atau klik kanan pada ikonnya dan pilih Hapus Titik Henti.

Menghapus titik henti akan menghapus Kondisi dan Pesan Lognya. Jika Anda ingin menyimpan informasi ini untuk debugging di masa mendatang, nonaktifkan titik henti tersebut sebagai gantinya.

Edit

Anda dapat mengedit konfigurasi titik henti kapan saja, termasuk selama sesi playtest. Jika Anda mengedit titik henti selama sesi playtest, editan akan tetap ada bahkan setelah Anda menyelesaikannya. Anda juga dapat mengedit titik henti yang aktif menghentikan sesi playtest Anda, tetapi perubahan tidak berlaku hingga sesi playtest berikutnya.

Untuk mengedit titik henti:

Klik kanan pada ikon titik henti dan pilih Edit Titik Henti.

Di jendela Edit Titik Henti, atur titik henti sesuai keinginan. Anda dapat mencampur konfigurasi ini bersama-sama untuk memenuhi kebutuhan debugging Anda dengan terbaik.

Opsi	Deskripsi
Kondisi	Ekspresi opsional yang menentukan apakah titik henti diaktifkan. Jika kondisi kosong, titik henti selalu diaktifkan. Jika kondisi ada, titik henti menjadi titik henti kondisional dan hanya diaktifkan jika kondisi tersebut benar. Misalnya, jika Anda ingin titik henti diaktifkan hanya jika variabel var sama dengan 10, atur kondisi menjadi var == 10.
Pesan Log	Ekspresi yang dicetak ke jendela Output saat titik henti dicapai. Format pesan log adalah sama dengan pernyataan print(). Misalnya, atur pesan log sebagai "Nilai dari var:", var untuk mengeluarkan pesan yang sama seperti print("Nilai dari var:", var).
Lanjutkan Eksekusi	Menentukan apakah titik henti menghentikan skrip jika diaktifkan. Opsi ini tidak diaktifkan secara default kecuali titik henti yang disisipkan adalah logpoint.
Hapus Titik Henti saat Terkena	Jika dicentang, titik henti otomatis menghapus dirinya setelah sesi playtest pertama, dengan efektif menjadikannya titik henti sementara.
Trigger Di	Konteks dari titik henti menentukan apakah seharusnya diaktifkan di Klien (skrip sisi klien), Server (skrip sisi server), atau Edit (debugging plugin skrip). Jika Anda memilih Konteks Kustom, jendela menunjukkan konteks trigger saat ini.

Alur Kerja

Alur kerja tipikal untuk debugging titik henti adalah sebagai berikut:

Buka skrip yang ingin Anda debug dan sisipkan titik henti pada baris kode yang ingin Anda periksa.
Dari mezzanine Studio, mulai sesi playtest untuk mulai melakukan debug.
Ketika skrip mencapai titik henti, sesi playtest berhenti kecuali titik henti tersebut sudah dikonfigurasi untuk melanjutkan eksekusi. Sebuah panah kuning di atas titik henti menunjukkan baris kode mana yang akan dieksekusi berikutnya.
Saat skrip berhenti, periksa jendela Titik Henti, jendela Watch, jendela Call Stack, jendela Output, dan Script Editor untuk menemukan informasi tentang nilai variabel dan eksekusi fungsi.

Untuk melanjutkan eksekusi kode setelah mencapai titik henti, klik Lanjutkan Skrip di mezzanine.

Tombol Lanjutkan Skrip ditunjukkan di mezzanine Studio

Anda juga dapat mengeksekusi kode satu baris pada satu waktu dengan tombol langkah di mezzanine:

Tombol langkah titik henti ditunjukkan di mezzanine Studio

Aktion	Shortcut	Deskripsi
Langkah Masuk	F11	Tombol Langkah Masuk memindahkan debugger ke kode fungsi di garis saat ini. Jika tidak ada fungsi di garis saat ini, debugger bergerak ke garis berikutnya.
Langkah Lewat	F10	Tombol Langkah Lewat memindahkan debugger ke garis kode berikutnya, tidak masuk ke fungsi.
Langkah Keluar	ShiftF11	Tombol Langkah Keluar memindahkan debugger keluar dari fungsi saat ini dan ke garis kode berikutnya setelah pemanggilan fungsi. Jika garis saat ini tidak ada di dalam fungsi, debugger bergerak ke garis berikutnya.

Ketika Anda selesai melakukan debugging sesi saat ini, klik tombol Hentikan.

Memantau

Studio mencakup beberapa jendela dan alat untuk memantau nilai variabel dan eksekusi fungsi saat dilakukan debugging. Dengan informasi ini, Anda dapat menemukan penyebab utama kebanyakan masalah dalam skrip Anda.

Titik Henti

Jendela Titik Henti adalah tampilan terpadu yang menunjukkan semua titik henti dalam semua skrip. Untuk membukanya, klik Titik Henti dari toolbar tab Skrip Studio, atau navigasikan ke menu Jendela ⟩ Debug dan aktifkan Titik Henti.

Dalam jendela tersebut, kolom Skrip dan Garis selalu ditampilkan, dan Anda dapat mengaktifkan/mematikan kolom konfigurasi lainnya melalui menu ⋮ di sudut kanan atas. Di dalam kolom Skrip, klik kanan pada titik henti mana pun untuk menampilkan menu opsi untuk mengedit, menonaktifkan/mengaktifkan, menghapus, atau melompat ke garis titik henti dalam skrip.

Saat dalam sesi debugging, kolom paling kiri menunjukkan (x3) yang menunjukkan banyak konteks (Klien, Server, Edit) untuk titik henti tersebut. Dengan memperluas cabang titik henti mana pun, Anda kemudian dapat mengklik ikon di sebelah konteks tertentu untuk menonaktifkan/mengaktifkannya untuk konteks tersebut, seperti menonaktifkan titik henti hanya di konteks Klien sambil tetap mengaktifkannya di konteks Server.

Titik henti diperluas untuk menunjukkan konteks

Call Stack

Jendela Call Stack, yang dapat diakses dari toolbar tab Skrip Studio atau menu Jendela ⟩ Debug, menunjukkan garis kode mana yang akan dieksekusi berikutnya ketika debugger mencapai titik henti. Jika Anda memanggil fungsi dari dalam fungsi lain, itu menunjukkan garis mana fungsi-fungsi tersebut dipanggil, memungkinkan Anda untuk mengonfirmasi apakah alur panggilan yang sebenarnya sesuai dengan alur yang diharapkan.

Saat skrip berhenti di titik henti, gunakan tombol langkah di mezzanine untuk melangkah masuk, lewat, atau keluar dari fungsi/garis seperti yang dijelaskan dalam alur kerja.

Watch

Jendela Watch, yang dapat diakses dari toolbar tab Skrip Studio atau menu Jendela ⟩ Debug, memungkinkan Anda untuk secara aktif memantau nilai variabel dan ekspresi saat Anda melangkah melalui titik henti.

Tab Variabel menunjukkan informasi tentang variabel saat ini dalam cakupan, dapat difilter dengan mengklik tombol Semua Cakupan di bagian atas jendela. Memperluas cabang menunjukkan anggota dari variabel atau instance itu dan nilai-nilainya. Anda juga dapat memantau variabel mana pun dengan menyorotnya di Script Editor secara double-click, mengklik kanan, dan memilih Tambah Saksikan dari menu popup.

Script Editor

Debugger terintegrasi dengan Script Editor. Ketika pengalaman Anda berhenti di titik henti dalam sebuah skrip, Anda bisa mengarahkan mouse Anda ke nama variabel untuk melihat nilainya. Misalnya, Anda dapat melihat komposisi dari sebuah tabel dan kunci/nilainya yang terkandung di dalamnya.

Buka File Explorer.
Navigasikan ke direktori %LOCALAPPDATA%\Roblox\logs.
Klik dua kali pada log untuk membukanya. Log dengan nilai XXXXX yang sama berasal dari sesi Studio yang sama.

Mac

Untuk mengakses file log di Mac:

Buka Finder.
Di menu bar, pilih Pergi ⟩ Pergi ke Folder....
Di dialog, masukkan ~/Library/Logs/Roblox.
Klik dua kali hasilnya untuk menavigasi ke direktori log Roblox.
Di dalam direktori, klik dua kali pada log untuk membukanya.

iOS

Anda dapat mengumpulkan log iOS menggunakan Mac atau menggunakan perangkat iOS.

Untuk mengakses file log iOS di Mac:

Sambungkan perangkat iOS ke Mac.
Buka Finder.
Navigasikan ke Utilitas dan buka aplikasi Console.
Untuk memuat log real-time di aplikasi Console, pilih perangkat iOS dari sidebar, klik tombol Mulai, dan reproduksi masalah di perangkat iOS.
Untuk memuat log yang diarsipkan di aplikasi Console, jalankan sudo log collect --device-name "[iOS Device Name]" di Terminal. Pastikan tidak ada tanda petik di nama perangkat atau Anda mungkin akan mendapatkan kesalahan saat menjalankan perintah.

Android

Untuk mengakses file log di Android:

Navigasikan ke Pengaturan ⟩ Sistem ⟩ Opsi Pengembang.
Aktifkan Opsi Pengembang.
Di komputer, unduh dan instal Android Studio.
Di Android Studio, klik Logcat.
Sambungkan perangkat Android ke komputer untuk otomatis mengisi Logcat dengan log.