game_version_dialog.cpp

Go to the documentation of this file.

/*
    Copyright (C) 2013 - 2025
    by Iris Morelle <shadowm2006@gmail.com>
    Part of the Battle for Wesnoth Project https://www.wesnoth.org/
 
    This program is free software; you can redistribute it and/or modify
    it under the terms of the GNU General Public License as published by
    the Free Software Foundation; either version 2 of the License, or
    (at your option) any later version.
    This program is distributed in the hope that it will be useful,
    but WITHOUT ANY WARRANTY.
 
    See the COPYING file for more details.
*/
 
#define GETTEXT_DOMAIN "wesnoth-lib"
 
#include "gui/dialogs/game_version_dialog.hpp"
 
#include "build_info.hpp"
#include "desktop/clipboard.hpp"
#include "desktop/open.hpp"
#include "desktop/version.hpp"
#include "filesystem.hpp"
#include "formula/string_utils.hpp"
#include "gui/widgets/button.hpp"
#include "gui/widgets/styled_widget.hpp"
#include "gui/widgets/listbox.hpp"
#include "gui/widgets/tab_container.hpp"
#include "gui/widgets/text_box_base.hpp"
#include "gui/widgets/window.hpp"
#include "gui/dialogs/message.hpp"
#include "gui/dialogs/migrate_version_selection.hpp"
#include "gui/dialogs/end_credits.hpp"
#include "gettext.hpp"
#include "help/help.hpp"
#include "language.hpp"
#include "serialization/markup.hpp"
 
#include <functional>
 
namespace
{
 
const std::string text_feature_on =  markup::span_color("#0f0", "&#9679;");
const std::string text_feature_off = markup::span_color("#f00", "&#9679;");
 
} // end anonymous namespace
 
namespace gui2::dialogs
{
 
REGISTER_DIALOG(game_version)
 
game_version::game_version(unsigned start_page)
    : modal_dialog(window_id())
    , path_wid_stem_("path_")
    , copy_wid_stem_("copy_")
    , browse_wid_stem_("browse_")
    , path_map_()
    , log_path_(lg::get_log_file_path())
    , deps_()
    , opts_(game_config::optional_features_table())
    , report_()
    , start_page_(start_page)
{
    // NOTE: these path_map_ entries are referenced by the GUI2 WML
    // definition of this dialog using preprocessor macros.
    path_map_["datadir"] = game_config::path;
    path_map_["userdata"] = filesystem::get_user_data_dir();
    path_map_["saves"] = filesystem::get_saves_dir();
    path_map_["addons"] = filesystem::get_addons_dir();
    path_map_["cache"] = filesystem::get_cache_dir();
    // path to logs directory
    path_map_["logs"] = filesystem::get_logs_dir();
    path_map_["screenshots"] = filesystem::get_screenshot_dir();
 
    for(unsigned k = 0; k < game_config::LIB_COUNT; ++k) {
        const game_config::LIBRARY_ID lib = game_config::LIBRARY_ID(k);
 
        deplist_entry e;
        e[0] = game_config::library_name(lib);
        if(e[0].empty()) {
            continue;
        }
        e[1] = game_config::library_build_version(lib);
        e[2] = game_config::library_runtime_version(lib);
        deps_.push_back(e);
    }
 
    generate_plain_text_report();
}
 
void game_version::pre_show()
{
    utils::string_map i18n_syms;
 
 
    //
    // General information.
    //
 
    find_widget<styled_widget>("version").set_label(game_config::revision);
    find_widget<styled_widget>("os").set_label(markup::italic(desktop::os_version()));
    find_widget<styled_widget>("arch").set_label(game_config::build_arch());
 
    connect_signal_mouse_left_click(find_widget<button>("copy_all"),
            std::bind(&game_version::report_copy_callback, this));
 
    // Bottom row buttons
    connect_signal_mouse_left_click(find_widget<button>("credits"),
            std::bind(&game_version::show_credits_dialog, this));
 
    connect_signal_mouse_left_click(find_widget<button>("license"),
            std::bind(&game_version::show_license, this));
 
    connect_signal_mouse_left_click(find_widget<button>("issue"),
            std::bind(&game_version::report_issue, this));
 
    connect_signal_mouse_left_click(find_widget<button>("run_migrator"),
            std::bind(&game_version::run_migrator, this));
 
    connect_signal_mouse_left_click(find_widget<button>("view_manual"),
            std::bind(&game_version::show_manual, this));
 
    //
    // Game paths tab.
    //
 
    for(const auto & path_ent : path_map_)
    {
        const std::string& path_id = path_ent.first;
        const std::string& path_path = filesystem::normalize_path(path_ent.second, true);
 
        text_box_base& path_w = find_widget<text_box_base>(path_wid_stem_ + path_id);
        button& copy_w = find_widget<button>(copy_wid_stem_ + path_id);
        button& browse_w = find_widget<button>(browse_wid_stem_ + path_id);
 
        path_w.set_value(path_path);
 
        connect_signal_mouse_left_click(
                copy_w,
                std::bind(&game_version::copy_to_clipboard_callback, this, path_path, copy_wid_stem_ + path_id));
        connect_signal_mouse_left_click(
                browse_w,
                std::bind(&game_version::browse_directory_callback, this, path_path));
 
        if(!desktop::open_object_is_supported()) {
            // No point in displaying these on platforms that can't do
            // open_object().
            browse_w.set_visible(widget::visibility::invisible);
        }
    }
 
    button& stderr_button = find_widget<button>("open_stderr");
    connect_signal_mouse_left_click(stderr_button,
            std::bind(&game_version::browse_directory_callback, this, log_path_));
    stderr_button.set_active(!log_path_.empty() && filesystem::file_exists(log_path_));
 
    //
    // Build info tab.
    //
 
    listbox& deps_listbox = find_widget<listbox>("deps_listbox");
 
    for(const auto& dep : deps_) {
        deps_listbox.add_row(widget_data{
            { "dep_name", {
                { "label", dep[0] }
            }},
            { "dep_build_version",{
                { "label", dep[1] }
            }},
            // The build version is always known, but runtime version isn't, esp. for
            // header-only libraries like Boost for which the concept does not apply.
            { "dep_rt_version", {
                { "label", dep[2].empty() ? font::unicode_em_dash : dep[2] }
            }},
        });
    }
 
    deps_listbox.select_row(0);
 
    //
    // Features tab.
    //
 
    listbox& opts_listbox = find_widget<listbox>("opts_listbox");
 
    for(const auto& opt : opts_) {
        opts_listbox.add_row(widget_data{
            { "opt_name", {
                { "label", opt.name }
            }},
            { "opt_status", {
                { "label", opt.enabled ? text_feature_on : text_feature_off },
                { "use_markup", "true" }
            }},
        });
    }
 
    opts_listbox.select_row(0);
 
    //
    // Community tab
    //
 
    connect_signal_mouse_left_click(find_widget<button>("forums"),
            std::bind(&desktop::open_object, "https://forums.wesnoth.org/"));
    connect_signal_mouse_left_click(find_widget<button>("discord"),
            std::bind(&desktop::open_object, "https://discord.gg/battleforwesnoth"));
    connect_signal_mouse_left_click(find_widget<button>("irc"),
            std::bind(&desktop::open_object, "https://web.libera.chat/#wesnoth"));
    connect_signal_mouse_left_click(find_widget<button>("steam"),
            std::bind(&desktop::open_object, "https://steamcommunity.com/app/599390/discussions/"));
    connect_signal_mouse_left_click(find_widget<button>("reddit"),
            std::bind(&desktop::open_object, "https://www.reddit.com/r/wesnoth/"));
    connect_signal_mouse_left_click(find_widget<button>("donate"),
            std::bind(&desktop::open_object, "https://www.spi-inc.org/projects/wesnoth/"));
 
    find_widget<tab_container>("tabs").select_tab(start_page_);
}
 
void game_version::browse_directory_callback(const std::string& path)
{
    desktop::open_object(path);
}
 
void game_version::run_migrator()
{
    migrate_version_selection::execute();
}
 
void game_version::copy_to_clipboard_callback(const std::string& path, const std::string& btn_id)
{
    desktop::clipboard::copy_to_clipboard(path);
    find_widget<button>(btn_id).set_success(true);
}
 
void game_version::report_copy_callback()
{
    desktop::clipboard::copy_to_clipboard(report_);
    find_widget<button>("copy_all").set_success(true);
}
 
void game_version::generate_plain_text_report()
{
    report_ = game_config::full_build_report();
}
 
void game_version::show_credits_dialog() {
    gui2::dialogs::end_credits::display();
}
 
void game_version::show_license() {
    help::show_help("license");
}
 
void game_version::report_issue() {
    if (desktop::open_object_is_supported()) {
        desktop::open_object("https://bugs.wesnoth.org");
    } else {
        show_message("", _("Opening links is not supported, contact your packager"), dialogs::message::auto_close);
    }
}
 
void game_version::show_manual() {
    if (!desktop::open_object_is_supported()) {
        show_message("", _("Opening links is not supported, contact your packager"), dialogs::message::auto_close);
        return;
    }
 
    std::string sl = get_language().short_localename();
    if (sl.empty()) sl = "en"; // Assume en is always available as a fall-back
    const auto& manual_path = filesystem::get_game_manual_file(get_language().localename, sl);
    if (manual_path) {
        desktop::open_object(manual_path.value());
    } else {
        // Use web manual as a last resort
        desktop::open_object("https://www.wesnoth.org/manual/dev/manual." + sl + ".html");
    }
}
 
} // namespace dialogs