editor_debugger_node.cpp 35 KB

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