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