Book a Demo!
CoCalc Logo Icon
StoreFeaturesDocsShareSupportNewsAboutPoliciesSign UpSign In
godotengine
GitHub Repository: godotengine/godot
Path: blob/master/editor/debugger/editor_debugger_node.cpp
20957 views
1
/**************************************************************************/
2
/* editor_debugger_node.cpp */
3
/**************************************************************************/
4
/* This file is part of: */
5
/* GODOT ENGINE */
6
/* https://godotengine.org */
7
/**************************************************************************/
8
/* Copyright (c) 2014-present Godot Engine contributors (see AUTHORS.md). */
9
/* Copyright (c) 2007-2014 Juan Linietsky, Ariel Manzur. */
10
/* */
11
/* Permission is hereby granted, free of charge, to any person obtaining */
12
/* a copy of this software and associated documentation files (the */
13
/* "Software"), to deal in the Software without restriction, including */
14
/* without limitation the rights to use, copy, modify, merge, publish, */
15
/* distribute, sublicense, and/or sell copies of the Software, and to */
16
/* permit persons to whom the Software is furnished to do so, subject to */
17
/* the following conditions: */
18
/* */
19
/* The above copyright notice and this permission notice shall be */
20
/* included in all copies or substantial portions of the Software. */
21
/* */
22
/* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, */
23
/* EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF */
24
/* MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. */
25
/* IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY */
26
/* CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, */
27
/* TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE */
28
/* SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. */
29
/**************************************************************************/
30
31
#include "editor_debugger_node.h"
32
33
#include "core/io/resource_loader.h"
34
#include "core/object/undo_redo.h"
35
#include "editor/debugger/editor_debugger_plugin.h"
36
#include "editor/debugger/editor_debugger_tree.h"
37
#include "editor/debugger/script_editor_debugger.h"
38
#include "editor/docks/editor_dock_manager.h"
39
#include "editor/docks/inspector_dock.h"
40
#include "editor/docks/scene_tree_dock.h"
41
#include "editor/editor_log.h"
42
#include "editor/editor_node.h"
43
#include "editor/editor_string_names.h"
44
#include "editor/editor_undo_redo_manager.h"
45
#include "editor/run/editor_run_bar.h"
46
#include "editor/script/script_editor_plugin.h"
47
#include "editor/settings/editor_command_palette.h"
48
#include "editor/settings/editor_settings.h"
49
#include "editor/themes/editor_theme_manager.h"
50
#include "scene/gui/menu_button.h"
51
#include "scene/gui/tab_container.h"
52
#include "scene/resources/packed_scene.h"
53
54
template <typename Func>
55
void _for_all(TabContainer *p_node, const Func &p_func) {
56
for (int i = 0; i < p_node->get_tab_count(); i++) {
57
ScriptEditorDebugger *dbg = Object::cast_to<ScriptEditorDebugger>(p_node->get_tab_control(i));
58
ERR_FAIL_NULL(dbg);
59
p_func(dbg);
60
}
61
}
62
63
EditorDebuggerNode *EditorDebuggerNode::singleton = nullptr;
64
65
EditorDebuggerNode::EditorDebuggerNode() {
66
set_name(TTRC("Debugger"));
67
set_icon_name("Debug");
68
set_layout_key("Debugger");
69
set_dock_shortcut(ED_SHORTCUT_AND_COMMAND("bottom_panels/toggle_debugger_bottom_panel", TTRC("Toggle Debugger Dock"), KeyModifierMask::ALT | Key::D));
70
set_default_slot(EditorDock::DOCK_SLOT_BOTTOM);
71
set_available_layouts(EditorDock::DOCK_LAYOUT_HORIZONTAL);
72
set_global(false);
73
set_transient(true);
74
75
_update_margins();
76
77
if (!singleton) {
78
singleton = this;
79
}
80
81
tabs = memnew(TabContainer);
82
tabs->set_tabs_visible(false);
83
tabs->connect("tab_changed", callable_mp(this, &EditorDebuggerNode::_debugger_changed));
84
add_child(tabs);
85
86
Ref<StyleBoxEmpty> empty;
87
empty.instantiate();
88
tabs->add_theme_style_override(SceneStringName(panel), empty);
89
90
auto_switch_remote_scene_tree = EDITOR_GET("debugger/auto_switch_to_remote_scene_tree");
91
_add_debugger();
92
93
// Remote scene tree
94
remote_scene_tree = memnew(EditorDebuggerTree);
95
remote_scene_tree->connect("objects_selected", callable_mp(this, &EditorDebuggerNode::_remote_objects_requested));
96
remote_scene_tree->connect("selection_cleared", callable_mp(this, &EditorDebuggerNode::_remote_selection_cleared));
97
remote_scene_tree->connect("save_node", callable_mp(this, &EditorDebuggerNode::_save_node_requested));
98
remote_scene_tree->connect("button_clicked", callable_mp(this, &EditorDebuggerNode::_remote_tree_button_pressed));
99
SceneTreeDock::get_singleton()->add_remote_tree_editor(remote_scene_tree);
100
SceneTreeDock::get_singleton()->connect("remote_tree_selected", callable_mp(this, &EditorDebuggerNode::request_remote_tree));
101
102
remote_scene_tree_timeout = EDITOR_GET("debugger/remote_scene_tree_refresh_interval");
103
inspect_edited_object_timeout = EDITOR_GET("debugger/remote_inspect_refresh_interval");
104
105
if (Engine::get_singleton()->is_recovery_mode_hint()) {
106
return;
107
}
108
109
EditorRunBar::get_singleton()->get_pause_button()->connect(SceneStringName(pressed), callable_mp(this, &EditorDebuggerNode::_paused));
110
}
111
112
ScriptEditorDebugger *EditorDebuggerNode::_add_debugger() {
113
ScriptEditorDebugger *node = memnew(ScriptEditorDebugger);
114
115
int id = tabs->get_tab_count();
116
node->connect("stop_requested", callable_mp(this, &EditorDebuggerNode::_debugger_wants_stop).bind(id));
117
node->connect("stopped", callable_mp(this, &EditorDebuggerNode::_debugger_stopped).bind(id));
118
node->connect("stack_frame_selected", callable_mp(this, &EditorDebuggerNode::_stack_frame_selected).bind(id));
119
node->connect("error_selected", callable_mp(this, &EditorDebuggerNode::_error_selected).bind(id));
120
node->connect("breakpoint_selected", callable_mp(this, &EditorDebuggerNode::_error_selected).bind(id));
121
node->connect("clear_execution", callable_mp(this, &EditorDebuggerNode::_clear_execution));
122
node->connect("breaked", callable_mp(this, &EditorDebuggerNode::_breaked).bind(id));
123
node->connect("debug_data", callable_mp(this, &EditorDebuggerNode::_debug_data).bind(id));
124
node->connect("remote_tree_select_requested", callable_mp(this, &EditorDebuggerNode::_remote_tree_select_requested).bind(id));
125
node->connect("remote_tree_clear_selection_requested", callable_mp(this, &EditorDebuggerNode::_remote_tree_clear_selection_requested).bind(id));
126
node->connect("remote_tree_updated", callable_mp(this, &EditorDebuggerNode::_remote_tree_updated).bind(id));
127
node->connect("remote_objects_updated", callable_mp(this, &EditorDebuggerNode::_remote_objects_updated).bind(id));
128
node->connect("remote_object_property_updated", callable_mp(this, &EditorDebuggerNode::_remote_object_property_updated).bind(id));
129
node->connect("remote_objects_requested", callable_mp(this, &EditorDebuggerNode::_remote_objects_requested).bind(id));
130
node->connect("set_breakpoint", callable_mp(this, &EditorDebuggerNode::_breakpoint_set_in_tree).bind(id));
131
node->connect("clear_breakpoints", callable_mp(this, &EditorDebuggerNode::_breakpoints_cleared_in_tree).bind(id));
132
node->connect("errors_cleared", callable_mp(this, &EditorDebuggerNode::_update_errors));
133
134
if (tabs->get_tab_count() > 0) {
135
get_debugger(0)->clear_style();
136
}
137
138
tabs->add_child(node);
139
140
node->set_name(vformat(TTR("Session %d"), tabs->get_tab_count()));
141
if (tabs->get_tab_count() > 1) {
142
node->clear_style();
143
tabs->set_tabs_visible(true);
144
tabs->add_theme_style_override(SceneStringName(panel), EditorNode::get_singleton()->get_editor_theme()->get_stylebox(SNAME("DebuggerPanel"), EditorStringName(EditorStyles)));
145
}
146
147
if (!debugger_plugins.is_empty()) {
148
for (Ref<EditorDebuggerPlugin> plugin : debugger_plugins) {
149
plugin->create_session(node);
150
}
151
}
152
153
return node;
154
}
155
156
void EditorDebuggerNode::_stack_frame_selected(int p_debugger) {
157
const ScriptEditorDebugger *dbg = get_debugger(p_debugger);
158
ERR_FAIL_NULL(dbg);
159
if (dbg != get_current_debugger()) {
160
return;
161
}
162
_text_editor_stack_goto(dbg);
163
}
164
165
void EditorDebuggerNode::_error_selected(const String &p_file, int p_line, int p_debugger) {
166
if (!p_file.is_resource_file() && !ResourceCache::has(p_file)) {
167
// If it's a built-in script, make sure the scene is opened first.
168
EditorNode::get_singleton()->load_scene(p_file.get_slice("::", 0));
169
}
170
Ref<Script> s = ResourceLoader::load(p_file);
171
emit_signal(SNAME("goto_script_line"), s, p_line - 1);
172
}
173
174
void EditorDebuggerNode::_text_editor_stack_goto(const ScriptEditorDebugger *p_debugger) {
175
String file = p_debugger->get_stack_script_file();
176
if (file.is_empty()) {
177
return;
178
}
179
if (file.is_resource_file()) {
180
stack_script = ResourceLoader::load(file);
181
} else {
182
// If the script is built-in, it can be opened only if the scene is loaded in memory.
183
int i = file.find("::");
184
int j = file.rfind_char('(', i);
185
if (j > -1) { // If the script is named, the string is "name (file)", so we need to extract the path.
186
file = file.substr(j + 1, file.find_char(')', i) - j - 1);
187
}
188
Ref<PackedScene> ps = ResourceLoader::load(file.get_slice("::", 0));
189
stack_script = ResourceLoader::load(file);
190
}
191
const int line = p_debugger->get_stack_script_line() - 1;
192
emit_signal(SNAME("goto_script_line"), stack_script, line);
193
emit_signal(SNAME("set_execution"), stack_script, line);
194
stack_script.unref(); // Why?!?
195
}
196
197
void EditorDebuggerNode::_text_editor_stack_clear(const ScriptEditorDebugger *p_debugger) {
198
String file = p_debugger->get_stack_script_file();
199
if (file.is_empty()) {
200
return;
201
}
202
if (file.is_resource_file()) {
203
stack_script = ResourceLoader::load(file);
204
} else {
205
// If the script is built-in, it can be opened only if the scene is loaded in memory.
206
int i = file.find("::");
207
int j = file.rfind_char('(', i);
208
if (j > -1) { // If the script is named, the string is "name (file)", so we need to extract the path.
209
file = file.substr(j + 1, file.find_char(')', i) - j - 1);
210
}
211
Ref<PackedScene> ps = ResourceLoader::load(file.get_slice("::", 0));
212
stack_script = ResourceLoader::load(file);
213
}
214
emit_signal(SNAME("clear_execution"), stack_script);
215
stack_script.unref(); // Why?!?
216
}
217
218
void EditorDebuggerNode::_bind_methods() {
219
// LiveDebug.
220
ClassDB::bind_method("live_debug_create_node", &EditorDebuggerNode::live_debug_create_node);
221
ClassDB::bind_method("live_debug_instantiate_node", &EditorDebuggerNode::live_debug_instantiate_node);
222
ClassDB::bind_method("live_debug_remove_node", &EditorDebuggerNode::live_debug_remove_node);
223
ClassDB::bind_method("live_debug_remove_and_keep_node", &EditorDebuggerNode::live_debug_remove_and_keep_node);
224
ClassDB::bind_method("live_debug_restore_node", &EditorDebuggerNode::live_debug_restore_node);
225
ClassDB::bind_method("live_debug_duplicate_node", &EditorDebuggerNode::live_debug_duplicate_node);
226
ClassDB::bind_method("live_debug_reparent_node", &EditorDebuggerNode::live_debug_reparent_node);
227
228
ADD_SIGNAL(MethodInfo("goto_script_line"));
229
ADD_SIGNAL(MethodInfo("set_execution", PropertyInfo("script"), PropertyInfo(Variant::INT, "line")));
230
ADD_SIGNAL(MethodInfo("clear_execution", PropertyInfo("script")));
231
ADD_SIGNAL(MethodInfo("breaked", PropertyInfo(Variant::BOOL, "reallydid"), PropertyInfo(Variant::BOOL, "can_debug")));
232
ADD_SIGNAL(MethodInfo("breakpoint_toggled", PropertyInfo(Variant::STRING, "path"), PropertyInfo(Variant::INT, "line"), PropertyInfo(Variant::BOOL, "enabled")));
233
ADD_SIGNAL(MethodInfo("breakpoint_set_in_tree", PropertyInfo("script"), PropertyInfo(Variant::INT, "line"), PropertyInfo(Variant::BOOL, "enabled"), PropertyInfo(Variant::INT, "debugger")));
234
ADD_SIGNAL(MethodInfo("breakpoints_cleared_in_tree", PropertyInfo(Variant::INT, "debugger")));
235
}
236
237
void EditorDebuggerNode::register_undo_redo(UndoRedo *p_undo_redo) {
238
p_undo_redo->set_method_notify_callback(_methods_changed, this);
239
p_undo_redo->set_property_notify_callback(_properties_changed, this);
240
}
241
242
ScriptEditorDebugger *EditorDebuggerNode::get_debugger(int p_id) const {
243
return Object::cast_to<ScriptEditorDebugger>(tabs->get_tab_control(p_id));
244
}
245
246
ScriptEditorDebugger *EditorDebuggerNode::get_previous_debugger() const {
247
return Object::cast_to<ScriptEditorDebugger>(tabs->get_tab_control(tabs->get_previous_tab()));
248
}
249
250
ScriptEditorDebugger *EditorDebuggerNode::get_current_debugger() const {
251
return Object::cast_to<ScriptEditorDebugger>(tabs->get_tab_control(tabs->get_current_tab()));
252
}
253
254
ScriptEditorDebugger *EditorDebuggerNode::get_default_debugger() const {
255
return Object::cast_to<ScriptEditorDebugger>(tabs->get_tab_control(0));
256
}
257
258
String EditorDebuggerNode::get_server_uri() const {
259
return server.is_valid() ? server->get_uri() : "";
260
}
261
262
void EditorDebuggerNode::set_keep_open(bool p_keep_open) {
263
keep_open = p_keep_open;
264
if (keep_open) {
265
if (server.is_null() || !server->is_active()) {
266
start();
267
}
268
} else {
269
bool found = false;
270
_for_all(tabs, [&](ScriptEditorDebugger *p_debugger) {
271
if (p_debugger->is_session_active()) {
272
found = true;
273
}
274
});
275
if (!found) {
276
stop();
277
}
278
}
279
}
280
281
Error EditorDebuggerNode::start(const String &p_uri) {
282
if (Engine::get_singleton()->is_recovery_mode_hint()) {
283
return ERR_UNAVAILABLE;
284
}
285
286
ERR_FAIL_COND_V(!p_uri.contains("://"), ERR_INVALID_PARAMETER);
287
if (keep_open && current_uri == p_uri && server.is_valid()) {
288
return OK;
289
}
290
stop(true);
291
current_uri = p_uri;
292
293
server = Ref<EditorDebuggerServer>(EditorDebuggerServer::create(p_uri.substr(0, p_uri.find("://") + 3)));
294
const Error err = server->start(p_uri);
295
if (err != OK) {
296
return err;
297
}
298
set_process(true);
299
EditorNode::get_log()->add_message("--- Debugging process started ---", EditorLog::MSG_TYPE_EDITOR);
300
return OK;
301
}
302
303
void EditorDebuggerNode::stop(bool p_force) {
304
if (keep_open && !p_force) {
305
return;
306
}
307
308
remote_scene_tree_wait = false;
309
inspect_edited_object_wait = false;
310
311
current_uri.clear();
312
if (server.is_valid()) {
313
server->stop();
314
EditorNode::get_log()->add_message("--- Debugging process stopped ---", EditorLog::MSG_TYPE_EDITOR);
315
316
if (EditorRunBar::get_singleton()->is_movie_maker_enabled()) {
317
// Request attention in case the user was doing something else when movie recording is finished.
318
DisplayServer::get_singleton()->window_request_attention();
319
}
320
321
server.unref();
322
}
323
324
// Also close all debugging sessions.
325
_for_all(tabs, [&](ScriptEditorDebugger *dbg) {
326
if (dbg->is_session_active()) {
327
dbg->_stop_and_notify();
328
}
329
});
330
_break_state_changed();
331
breakpoints.clear();
332
EditorUndoRedoManager::get_singleton()->clear_history(EditorUndoRedoManager::REMOTE_HISTORY, false);
333
set_process(false);
334
}
335
336
void EditorDebuggerNode::_notification(int p_what) {
337
switch (p_what) {
338
case EditorSettings::NOTIFICATION_EDITOR_SETTINGS_CHANGED: {
339
if (!EditorThemeManager::is_generated_theme_outdated()) {
340
return;
341
}
342
343
if (tabs->get_tab_count() > 1) {
344
tabs->add_theme_style_override(SceneStringName(panel), EditorNode::get_singleton()->get_editor_theme()->get_stylebox(SNAME("DebuggerPanel"), EditorStringName(EditorStyles)));
345
}
346
_update_margins();
347
348
remote_scene_tree->update_icon_max_width();
349
} break;
350
351
case NOTIFICATION_READY: {
352
_update_debug_options();
353
initializing = false;
354
} break;
355
356
case NOTIFICATION_PROCESS: {
357
if (server.is_null()) {
358
return;
359
}
360
361
if (!server->is_active()) {
362
stop();
363
return;
364
}
365
server->poll();
366
367
_update_errors();
368
369
// Remote scene tree update.
370
if (!remote_scene_tree_wait) {
371
remote_scene_tree_timeout -= get_process_delta_time();
372
if (remote_scene_tree_timeout < 0) {
373
remote_scene_tree_timeout = EDITOR_GET("debugger/remote_scene_tree_refresh_interval");
374
375
if (remote_scene_tree->is_visible_in_tree()) {
376
remote_scene_tree_wait = true;
377
get_current_debugger()->request_remote_tree();
378
}
379
}
380
}
381
382
// Remote inspector update.
383
if (!inspect_edited_object_wait) {
384
inspect_edited_object_timeout -= get_process_delta_time();
385
if (inspect_edited_object_timeout < 0) {
386
inspect_edited_object_timeout = EDITOR_GET("debugger/remote_inspect_refresh_interval");
387
388
if (EditorDebuggerRemoteObjects *robjs = Object::cast_to<EditorDebuggerRemoteObjects>(InspectorDock::get_inspector_singleton()->get_edited_object())) {
389
inspect_edited_object_wait = true;
390
get_current_debugger()->request_remote_objects(robjs->remote_object_ids, false);
391
}
392
}
393
}
394
395
// Take connections.
396
if (server->is_connection_available()) {
397
ScriptEditorDebugger *debugger = nullptr;
398
_for_all(tabs, [&](ScriptEditorDebugger *dbg) {
399
if (debugger || dbg->is_session_active()) {
400
return;
401
}
402
debugger = dbg;
403
});
404
if (debugger == nullptr) {
405
if (tabs->get_tab_count() <= 4) { // Max 4 debugging sessions active.
406
debugger = _add_debugger();
407
} else {
408
// We already have too many sessions, disconnecting new clients to prevent them from hanging.
409
server->take_connection()->close();
410
return; // Can't add, stop here.
411
}
412
}
413
414
EditorRunBar::get_singleton()->get_pause_button()->set_disabled(false);
415
// Switch to remote tree view if so desired.
416
remote_scene_tree->set_new_session();
417
auto_switch_remote_scene_tree = EDITOR_GET("debugger/auto_switch_to_remote_scene_tree");
418
if (auto_switch_remote_scene_tree) {
419
SceneTreeDock::get_singleton()->show_remote_tree();
420
}
421
// Good to go.
422
SceneTreeDock::get_singleton()->show_tab_buttons();
423
debugger->set_editor_remote_tree(remote_scene_tree);
424
debugger->start(server->take_connection());
425
// Send breakpoints.
426
for (const KeyValue<Breakpoint, bool> &E : breakpoints) {
427
const Breakpoint &bp = E.key;
428
debugger->set_breakpoint(bp.source, bp.line, E.value);
429
} // Will arrive too late, how does the regular run work?
430
431
debugger->update_live_edit_root();
432
}
433
} break;
434
}
435
}
436
437
void EditorDebuggerNode::_update_errors() {
438
int error_count = 0;
439
int warning_count = 0;
440
_for_all(tabs, [&](ScriptEditorDebugger *dbg) {
441
error_count += dbg->get_error_count();
442
warning_count += dbg->get_warning_count();
443
});
444
445
if (error_count != last_error_count || warning_count != last_warning_count) {
446
_for_all(tabs, [&](ScriptEditorDebugger *dbg) {
447
dbg->update_tabs();
448
});
449
450
last_error_count = error_count;
451
last_warning_count = warning_count;
452
453
if (error_count == 0 && warning_count == 0) {
454
set_title("");
455
set_dock_icon(Ref<Texture2D>());
456
set_title_color(Color(0, 0, 0, 0));
457
set_force_show_icon(false);
458
} else {
459
set_title(TTR("Debugger") + " (" + itos(error_count + warning_count) + ")");
460
if (error_count >= 1 && warning_count >= 1) {
461
set_dock_icon(get_editor_theme_icon(SNAME("ErrorWarning")));
462
// Use error color to represent the highest level of severity reported.
463
set_title_color(get_theme_color(SNAME("error_color"), EditorStringName(Editor)));
464
} else if (error_count >= 1) {
465
set_dock_icon(get_editor_theme_icon(SNAME("Error")));
466
set_title_color(get_theme_color(SNAME("error_color"), EditorStringName(Editor)));
467
} else {
468
set_dock_icon(get_editor_theme_icon(SNAME("Warning")));
469
set_title_color(get_theme_color(SNAME("warning_color"), EditorStringName(Editor)));
470
}
471
set_force_show_icon(true);
472
}
473
}
474
}
475
476
void EditorDebuggerNode::_update_margins() {
477
Ref<StyleBox> bottom_panel_margins = EditorNode::get_singleton()->get_editor_theme()->get_stylebox(SNAME("BottomPanel"), EditorStringName(EditorStyles));
478
add_theme_constant_override("margin_top", -bottom_panel_margins->get_margin(SIDE_TOP));
479
add_theme_constant_override("margin_left", -bottom_panel_margins->get_margin(SIDE_LEFT));
480
add_theme_constant_override("margin_right", -bottom_panel_margins->get_margin(SIDE_RIGHT));
481
add_theme_constant_override("margin_bottom", -bottom_panel_margins->get_margin(SIDE_BOTTOM));
482
}
483
484
void EditorDebuggerNode::_debugger_stopped(int p_id) {
485
ScriptEditorDebugger *dbg = get_debugger(p_id);
486
ERR_FAIL_NULL(dbg);
487
488
bool found = false;
489
_for_all(tabs, [&](ScriptEditorDebugger *p_debugger) {
490
if (p_debugger->is_session_active()) {
491
found = true;
492
}
493
});
494
if (!found) {
495
EditorRunBar::get_singleton()->get_pause_button()->set_pressed(false);
496
EditorRunBar::get_singleton()->get_pause_button()->set_disabled(true);
497
SceneTreeDock *dock = SceneTreeDock::get_singleton();
498
if (dock->is_inside_tree()) {
499
dock->hide_remote_tree();
500
dock->hide_tab_buttons();
501
}
502
EditorNode::get_singleton()->notify_all_debug_sessions_exited();
503
}
504
}
505
506
void EditorDebuggerNode::_debugger_wants_stop(int p_id) {
507
// Ask editor to kill PID.
508
if (int pid = get_debugger(p_id)->get_remote_pid()) {
509
callable_mp(EditorNode::get_singleton(), &EditorNode::stop_child_process).call_deferred(pid);
510
}
511
}
512
513
void EditorDebuggerNode::_debugger_changed(int p_tab) {
514
remote_scene_tree_wait = false;
515
inspect_edited_object_wait = false;
516
517
if (Object *robjs = InspectorDock::get_inspector_singleton()->get_edited_object()) {
518
if (Object::cast_to<EditorDebuggerRemoteObjects>(robjs)) {
519
// Clear inspected object, you can only inspect objects in selected debugger.
520
// Hopefully, in the future, we will have one inspector per debugger.
521
EditorNode::get_singleton()->push_item(nullptr);
522
}
523
}
524
525
if (ScriptEditorDebugger *prev_debug = get_previous_debugger()) {
526
prev_debug->clear_inspector();
527
_text_editor_stack_clear(prev_debug);
528
}
529
if (remote_scene_tree->is_visible_in_tree()) {
530
get_current_debugger()->request_remote_tree();
531
}
532
if (get_current_debugger()->is_breaked()) {
533
_text_editor_stack_goto(get_current_debugger());
534
}
535
536
_break_state_changed();
537
}
538
539
void EditorDebuggerNode::_debug_data(const String &p_msg, const Array &p_data, int p_debugger) {
540
if (p_debugger != tabs->get_current_tab()) {
541
return;
542
}
543
544
if (p_msg == "scene:scene_tree") {
545
remote_scene_tree_wait = false;
546
} else if (p_msg == "scene:inspect_objects") {
547
inspect_edited_object_wait = false;
548
}
549
}
550
551
void EditorDebuggerNode::set_script_debug_button(MenuButton *p_button) {
552
script_menu = p_button;
553
script_menu->set_text(TTRC("Debug"));
554
script_menu->set_switch_on_hover(true);
555
PopupMenu *p = script_menu->get_popup();
556
p->add_shortcut(ED_GET_SHORTCUT("debugger/step_into"), DEBUG_STEP);
557
p->add_shortcut(ED_GET_SHORTCUT("debugger/step_over"), DEBUG_NEXT);
558
p->add_separator();
559
p->add_shortcut(ED_GET_SHORTCUT("debugger/break"), DEBUG_BREAK);
560
p->add_shortcut(ED_GET_SHORTCUT("debugger/continue"), DEBUG_CONTINUE);
561
p->add_separator();
562
p->add_check_shortcut(ED_GET_SHORTCUT("debugger/debug_with_external_editor"), DEBUG_WITH_EXTERNAL_EDITOR);
563
p->connect(SceneStringName(id_pressed), callable_mp(this, &EditorDebuggerNode::_menu_option));
564
565
_break_state_changed();
566
script_menu->show();
567
}
568
569
void EditorDebuggerNode::_break_state_changed() {
570
const bool breaked = get_current_debugger()->is_breaked();
571
const bool can_debug = get_current_debugger()->is_debuggable();
572
if (breaked) { // Show debugger.
573
EditorDockManager::get_singleton()->focus_dock(this);
574
}
575
576
// Update script menu.
577
if (!script_menu) {
578
return;
579
}
580
PopupMenu *p = script_menu->get_popup();
581
p->set_item_disabled(p->get_item_index(DEBUG_NEXT), !(breaked && can_debug));
582
p->set_item_disabled(p->get_item_index(DEBUG_STEP), !(breaked && can_debug));
583
p->set_item_disabled(p->get_item_index(DEBUG_BREAK), breaked);
584
p->set_item_disabled(p->get_item_index(DEBUG_CONTINUE), !breaked);
585
}
586
587
void EditorDebuggerNode::_menu_option(int p_id) {
588
switch (p_id) {
589
case DEBUG_NEXT: {
590
debug_next();
591
} break;
592
case DEBUG_STEP: {
593
debug_step();
594
} break;
595
case DEBUG_BREAK: {
596
debug_break();
597
} break;
598
case DEBUG_CONTINUE: {
599
debug_continue();
600
} break;
601
case DEBUG_WITH_EXTERNAL_EDITOR: {
602
bool ischecked = script_menu->get_popup()->is_item_checked(script_menu->get_popup()->get_item_index(DEBUG_WITH_EXTERNAL_EDITOR));
603
debug_with_external_editor = !ischecked;
604
script_menu->get_popup()->set_item_checked(script_menu->get_popup()->get_item_index(DEBUG_WITH_EXTERNAL_EDITOR), !ischecked);
605
if (!initializing) {
606
EditorSettings::get_singleton()->set_project_metadata("debug_options", "debug_with_external_editor", !ischecked);
607
}
608
} break;
609
}
610
}
611
612
void EditorDebuggerNode::_update_debug_options() {
613
if (EditorSettings::get_singleton()->get_project_metadata("debug_options", "debug_with_external_editor", false).operator bool()) {
614
_menu_option(DEBUG_WITH_EXTERNAL_EDITOR);
615
}
616
}
617
618
void EditorDebuggerNode::_paused() {
619
const bool paused = EditorRunBar::get_singleton()->get_pause_button()->is_pressed();
620
_for_all(tabs, [&](ScriptEditorDebugger *dbg) {
621
if (paused && !dbg->is_breaked()) {
622
dbg->debug_break();
623
} else if (!paused && dbg->is_breaked()) {
624
dbg->debug_continue();
625
}
626
});
627
}
628
629
void EditorDebuggerNode::_breaked(bool p_breaked, bool p_can_debug, const String &p_message, bool p_has_stackdump, int p_debugger) {
630
if (get_current_debugger() != get_debugger(p_debugger)) {
631
if (!p_breaked) {
632
return;
633
}
634
tabs->set_current_tab(p_debugger);
635
}
636
_break_state_changed();
637
EditorRunBar::get_singleton()->get_pause_button()->set_pressed(p_breaked);
638
emit_signal(SNAME("breaked"), p_breaked, p_can_debug);
639
}
640
641
bool EditorDebuggerNode::is_skip_breakpoints() const {
642
return get_current_debugger()->is_skip_breakpoints();
643
}
644
645
bool EditorDebuggerNode::is_ignore_error_breaks() const {
646
return get_default_debugger()->is_ignore_error_breaks();
647
}
648
649
void EditorDebuggerNode::set_breakpoint(const String &p_path, int p_line, bool p_enabled) {
650
breakpoints[Breakpoint(p_path, p_line)] = p_enabled;
651
_for_all(tabs, [&](ScriptEditorDebugger *dbg) {
652
dbg->set_breakpoint(p_path, p_line, p_enabled);
653
});
654
655
emit_signal(SNAME("breakpoint_toggled"), p_path, p_line, p_enabled);
656
}
657
658
void EditorDebuggerNode::set_breakpoints(const String &p_path, const Array &p_lines) {
659
for (int i = 0; i < p_lines.size(); i++) {
660
set_breakpoint(p_path, p_lines[i], true);
661
}
662
663
for (const KeyValue<Breakpoint, bool> &E : breakpoints) {
664
Breakpoint b = E.key;
665
if (b.source == p_path && !p_lines.has(b.line)) {
666
set_breakpoint(p_path, b.line, false);
667
}
668
}
669
}
670
671
void EditorDebuggerNode::reload_all_scripts() {
672
_for_all(tabs, [&](ScriptEditorDebugger *dbg) {
673
dbg->reload_all_scripts();
674
});
675
}
676
677
void EditorDebuggerNode::reload_scripts(const Vector<String> &p_script_paths) {
678
_for_all(tabs, [&](ScriptEditorDebugger *dbg) {
679
dbg->reload_scripts(p_script_paths);
680
});
681
}
682
683
void EditorDebuggerNode::debug_next() {
684
get_current_debugger()->debug_next();
685
}
686
687
void EditorDebuggerNode::debug_step() {
688
get_current_debugger()->debug_step();
689
}
690
691
void EditorDebuggerNode::debug_break() {
692
get_current_debugger()->debug_break();
693
}
694
695
void EditorDebuggerNode::debug_continue() {
696
get_current_debugger()->debug_continue();
697
}
698
699
String EditorDebuggerNode::get_var_value(const String &p_var) const {
700
return get_current_debugger()->get_var_value(p_var);
701
}
702
703
// LiveEdit/Inspector
704
void EditorDebuggerNode::request_remote_tree() {
705
get_current_debugger()->request_remote_tree();
706
}
707
708
void EditorDebuggerNode::set_remote_selection(const TypedArray<int64_t> &p_ids) {
709
stop_waiting_inspection();
710
get_current_debugger()->request_remote_objects(p_ids);
711
}
712
713
void EditorDebuggerNode::clear_remote_tree_selection() {
714
remote_scene_tree->clear_selection();
715
get_current_debugger()->clear_inspector(remote_scene_tree_clear_msg);
716
}
717
718
void EditorDebuggerNode::stop_waiting_inspection() {
719
inspect_edited_object_timeout = EDITOR_GET("debugger/remote_inspect_refresh_interval");
720
inspect_edited_object_wait = false;
721
}
722
723
bool EditorDebuggerNode::match_remote_selection(const TypedArray<uint64_t> &p_ids) const {
724
return p_ids == remote_scene_tree->get_selection();
725
}
726
727
void EditorDebuggerNode::_remote_tree_select_requested(const TypedArray<int64_t> &p_ids, int p_debugger) {
728
if (p_debugger == tabs->get_current_tab()) {
729
remote_scene_tree->select_nodes(p_ids);
730
}
731
}
732
733
void EditorDebuggerNode::_remote_tree_clear_selection_requested(int p_debugger) {
734
if (p_debugger != tabs->get_current_tab()) {
735
return;
736
}
737
remote_scene_tree->clear_selection();
738
remote_scene_tree_clear_msg = false;
739
get_current_debugger()->clear_inspector(false);
740
remote_scene_tree_clear_msg = true;
741
}
742
743
void EditorDebuggerNode::_remote_tree_updated(int p_debugger) {
744
if (p_debugger != tabs->get_current_tab()) {
745
return;
746
}
747
remote_scene_tree->clear();
748
remote_scene_tree->update_scene_tree(get_current_debugger()->get_remote_tree(), p_debugger);
749
}
750
751
void EditorDebuggerNode::_remote_tree_button_pressed(Object *p_item, int p_column, int p_id, MouseButton p_button) {
752
if (p_button != MouseButton::LEFT) {
753
return;
754
}
755
756
TreeItem *item = Object::cast_to<TreeItem>(p_item);
757
ERR_FAIL_NULL(item);
758
759
if (p_id == EditorDebuggerTree::BUTTON_SUBSCENE) {
760
remote_scene_tree->emit_signal(SNAME("open"), item->get_meta("scene_file_path"));
761
} else if (p_id == EditorDebuggerTree::BUTTON_VISIBILITY) {
762
ObjectID obj_id = item->get_metadata(0);
763
ERR_FAIL_COND(obj_id.is_null());
764
get_current_debugger()->update_remote_object(obj_id, "visible", !item->get_meta("visible"));
765
get_current_debugger()->request_remote_tree();
766
}
767
}
768
769
void EditorDebuggerNode::_remote_objects_updated(EditorDebuggerRemoteObjects *p_objs, int p_debugger) {
770
if (p_debugger == tabs->get_current_tab() && p_objs != InspectorDock::get_inspector_singleton()->get_edited_object()) {
771
EditorNode::get_singleton()->push_item(p_objs);
772
}
773
}
774
775
void EditorDebuggerNode::_remote_object_property_updated(ObjectID p_id, const String &p_property, int p_debugger) {
776
if (p_debugger != tabs->get_current_tab()) {
777
return;
778
}
779
780
Object *obj = InspectorDock::get_inspector_singleton()->get_edited_object();
781
if (obj && obj->get_instance_id() == p_id) {
782
InspectorDock::get_inspector_singleton()->update_property(p_property);
783
}
784
}
785
786
void EditorDebuggerNode::_remote_objects_requested(const TypedArray<uint64_t> &p_ids, int p_debugger) {
787
if (p_debugger != tabs->get_current_tab()) {
788
return;
789
}
790
stop_waiting_inspection();
791
get_current_debugger()->request_remote_objects(p_ids);
792
}
793
794
void EditorDebuggerNode::_remote_selection_cleared(int p_debugger) {
795
if (p_debugger != tabs->get_current_tab()) {
796
return;
797
}
798
stop_waiting_inspection();
799
get_current_debugger()->clear_inspector();
800
}
801
802
void EditorDebuggerNode::_save_node_requested(ObjectID p_id, const String &p_file, int p_debugger) {
803
if (p_debugger != tabs->get_current_tab()) {
804
return;
805
}
806
get_current_debugger()->save_node(p_id, p_file);
807
}
808
809
void EditorDebuggerNode::_breakpoint_set_in_tree(Ref<RefCounted> p_script, int p_line, bool p_enabled, int p_debugger) {
810
if (p_debugger != tabs->get_current_tab()) {
811
return;
812
}
813
814
emit_signal(SNAME("breakpoint_set_in_tree"), p_script, p_line, p_enabled);
815
}
816
817
void EditorDebuggerNode::_breakpoints_cleared_in_tree(int p_debugger) {
818
if (p_debugger != tabs->get_current_tab()) {
819
return;
820
}
821
822
emit_signal(SNAME("breakpoints_cleared_in_tree"));
823
}
824
825
// Remote inspector/edit.
826
void EditorDebuggerNode::_methods_changed(void *p_ud, Object *p_base, const StringName &p_name, const Variant **p_args, int p_argcount) {
827
if (!singleton) {
828
return;
829
}
830
_for_all(singleton->tabs, [&](ScriptEditorDebugger *dbg) {
831
dbg->_method_changed(p_base, p_name, p_args, p_argcount);
832
});
833
}
834
835
void EditorDebuggerNode::_properties_changed(void *p_ud, Object *p_base, const StringName &p_property, const Variant &p_value) {
836
if (!singleton) {
837
return;
838
}
839
_for_all(singleton->tabs, [&](ScriptEditorDebugger *dbg) {
840
dbg->_property_changed(p_base, p_property, p_value);
841
});
842
}
843
844
// LiveDebug
845
void EditorDebuggerNode::set_live_debugging(bool p_enabled) {
846
_for_all(tabs, [&](ScriptEditorDebugger *dbg) {
847
dbg->set_live_debugging(p_enabled);
848
});
849
}
850
851
void EditorDebuggerNode::update_live_edit_root() {
852
_for_all(tabs, [&](ScriptEditorDebugger *dbg) {
853
dbg->update_live_edit_root();
854
});
855
}
856
857
void EditorDebuggerNode::live_debug_create_node(const NodePath &p_parent, const String &p_type, const String &p_name) {
858
_for_all(tabs, [&](ScriptEditorDebugger *dbg) {
859
dbg->live_debug_create_node(p_parent, p_type, p_name);
860
});
861
}
862
863
void EditorDebuggerNode::live_debug_instantiate_node(const NodePath &p_parent, const String &p_path, const String &p_name) {
864
_for_all(tabs, [&](ScriptEditorDebugger *dbg) {
865
dbg->live_debug_instantiate_node(p_parent, p_path, p_name);
866
});
867
}
868
869
void EditorDebuggerNode::live_debug_remove_node(const NodePath &p_at) {
870
_for_all(tabs, [&](ScriptEditorDebugger *dbg) {
871
dbg->live_debug_remove_node(p_at);
872
});
873
}
874
875
void EditorDebuggerNode::live_debug_remove_and_keep_node(const NodePath &p_at, ObjectID p_keep_id) {
876
_for_all(tabs, [&](ScriptEditorDebugger *dbg) {
877
dbg->live_debug_remove_and_keep_node(p_at, p_keep_id);
878
});
879
}
880
881
void EditorDebuggerNode::live_debug_restore_node(ObjectID p_id, const NodePath &p_at, int p_at_pos) {
882
_for_all(tabs, [&](ScriptEditorDebugger *dbg) {
883
dbg->live_debug_restore_node(p_id, p_at, p_at_pos);
884
});
885
}
886
887
void EditorDebuggerNode::live_debug_duplicate_node(const NodePath &p_at, const String &p_new_name) {
888
_for_all(tabs, [&](ScriptEditorDebugger *dbg) {
889
dbg->live_debug_duplicate_node(p_at, p_new_name);
890
});
891
}
892
893
void EditorDebuggerNode::live_debug_reparent_node(const NodePath &p_at, const NodePath &p_new_place, const String &p_new_name, int p_at_pos) {
894
_for_all(tabs, [&](ScriptEditorDebugger *dbg) {
895
dbg->live_debug_reparent_node(p_at, p_new_place, p_new_name, p_at_pos);
896
});
897
}
898
899
void EditorDebuggerNode::set_debug_mute_audio(bool p_mute) {
900
_for_all(tabs, [&](ScriptEditorDebugger *dbg) {
901
dbg->set_debug_mute_audio(p_mute);
902
});
903
debug_mute_audio = p_mute;
904
}
905
906
bool EditorDebuggerNode::get_debug_mute_audio() const {
907
return debug_mute_audio;
908
}
909
910
void EditorDebuggerNode::set_camera_override(CameraOverride p_override) {
911
_for_all(tabs, [&](ScriptEditorDebugger *dbg) {
912
dbg->set_camera_override(p_override);
913
});
914
camera_override = p_override;
915
}
916
917
EditorDebuggerNode::CameraOverride EditorDebuggerNode::get_camera_override() {
918
return camera_override;
919
}
920
921
void EditorDebuggerNode::add_debugger_plugin(const Ref<EditorDebuggerPlugin> &p_plugin) {
922
ERR_FAIL_COND_MSG(p_plugin.is_null(), "Debugger plugin is null.");
923
ERR_FAIL_COND_MSG(debugger_plugins.has(p_plugin), "Debugger plugin already exists.");
924
debugger_plugins.insert(p_plugin);
925
926
Ref<EditorDebuggerPlugin> plugin = p_plugin;
927
for (int i = 0; get_debugger(i); i++) {
928
plugin->create_session(get_debugger(i));
929
}
930
}
931
932
void EditorDebuggerNode::remove_debugger_plugin(const Ref<EditorDebuggerPlugin> &p_plugin) {
933
ERR_FAIL_COND_MSG(p_plugin.is_null(), "Debugger plugin is null.");
934
ERR_FAIL_COND_MSG(!debugger_plugins.has(p_plugin), "Debugger plugin doesn't exists.");
935
debugger_plugins.erase(p_plugin);
936
Ref<EditorDebuggerPlugin>(p_plugin)->clear();
937
}
938
939
bool EditorDebuggerNode::plugins_capture(ScriptEditorDebugger *p_debugger, const String &p_message, const Array &p_data) {
940
int session_index = tabs->get_tab_idx_from_control(p_debugger);
941
ERR_FAIL_COND_V(session_index < 0, false);
942
int colon_index = p_message.find_char(':');
943
ERR_FAIL_COND_V_MSG(colon_index < 1, false, "Invalid message received.");
944
945
const String cap = p_message.substr(0, colon_index);
946
bool parsed = false;
947
for (Ref<EditorDebuggerPlugin> plugin : debugger_plugins) {
948
if (plugin->has_capture(cap)) {
949
parsed |= plugin->capture(p_message, p_data, session_index);
950
}
951
}
952
return parsed;
953
}
954
955