kicad.cpp

Go to the documentation of this file.

/*
 * This program source code file is part of KiCad, a free EDA CAD application.
 *
 * Copyright (C) 2004-2015 Jean-Pierre Charras, jp.charras at wanadoo.fr
 * Copyright The KiCad Developers, see AUTHORS.txt for contributors.
 *
 * 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; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 * GNU General Public License for more details.
 *
 * You should have received a copy of the GNU General Public License
 * along with this program.  If not, see <https://www.gnu.org/licenses/>.
 */

 
 
#include <wx/filename.h>
#include <wx/log.h>
#include <wx/app.h>
#include <wx/stdpaths.h>
#include <wx/msgdlg.h>
#include <wx/cmdline.h>
 
#include <api/api_server.h>
#include <common.h>
#include <env_vars.h>
#include <file_history.h>
#include <hotkeys_basic.h>
#include <kiway.h>
#include <macros.h>
#include <paths.h>
#include <richio.h>
#include <settings/settings_manager.h>
#include <settings/kicad_settings.h>
#include <settings/common_settings.h>
#include <../include/startwizard/startwizard.h>
#include <systemdirsappend.h>
#include <thread_pool.h>
#include <trace_helpers.h>
#include <wildcards_and_files_ext.h>
#include <confirm.h>
#if defined( KICAD_NATIVE_MODEL_PREVIEW ) && defined( __WINDOWS__ )
#include <model_preview_manager.h>
#endif
 
#include <git/git_backend.h>
#include <git/libgit_backend.h>
#include <cstdlib>
 
#include "pgm_kicad.h"
#include "kicad_manager_frame.h"
#include "mergetool_frame.h"
 
#include <wx/crt.h>
#include <wx/evtloop.h>
#include <wx/weakref.h>
 
#include <kiplatform/app.h>
#include <kiplatform/environment.h>
 
// a dummy to quiet linking with EDA_BASE_FRAME::config();
#include <kiface_base.h>
 
#include <libraries/library_manager.h>
 
 
KIFACE_BASE& Kiface()
{
    // This function should never be called. It is only referenced from
    // EDA_BASE_FRAME::config() and this is only provided to satisfy the
    // linker, not to be actually called. Print the diagnostic to stderr
    // and abort — throwing here lets wxApp's top-level exception handler
    // pop a second modal dialog, which defeats the point of moving the
    // diagnostic to the terminal in the first place.
    wxFprintf( stderr,
               wxT( "Unexpected call to Kiface() in kicad/kicad.cpp — a "
                    "project-manager-process code path is reaching into a "
                    "kiface stub. Re-run with KICAD_TRACE=KICAD for a "
                    "backtrace.\n" ) );
    std::abort();
}
 
 
static PGM_KICAD program;
 
PGM_KICAD& PgmTop()
{
    return program;
}
 
 
bool PGM_KICAD::OnPgmInit()
{
    App().SetAppDisplayName( wxT( "KiCad" ) );
 
#if defined(DEBUG)
    wxString absoluteArgv0 = wxStandardPaths::Get().GetExecutablePath();
 
    if( !wxIsAbsolutePath( absoluteArgv0 ) )
    {
        wxLogError( wxT( "No meaningful argv[0]" ) );
        return false;
    }
#endif
 
    // Initialize the git backend before trying to initialize individual programs
    SetGitBackend( new LIBGIT_BACKEND() );
    GetGitBackend()->Init();
 
    static const wxCmdLineEntryDesc desc[] = {
        { wxCMD_LINE_OPTION, "f", "frame", "Frame to load", wxCMD_LINE_VAL_STRING, 0 },
        { wxCMD_LINE_SWITCH, "n", "new", "New instance of KiCad, does not attempt to load previously open files",
          wxCMD_LINE_VAL_NONE, 0 },
        { wxCMD_LINE_SWITCH, nullptr, "mergetool",
          "Launch the 3-way merge tool. Expects four positional args: "
          "ANCESTOR OURS THEIRS MERGED. Intended as a `git mergetool` driver.",
          wxCMD_LINE_VAL_NONE, 0 },
#ifndef __WXOSX__
        { wxCMD_LINE_SWITCH, nullptr, "software-rendering", "Use software rendering instead of OpenGL",
          wxCMD_LINE_VAL_NONE, 0 },
#endif
        { wxCMD_LINE_PARAM, nullptr, nullptr, "File to load", wxCMD_LINE_VAL_STRING,
          wxCMD_LINE_PARAM_MULTIPLE | wxCMD_LINE_PARAM_OPTIONAL },
        { wxCMD_LINE_NONE, nullptr, nullptr, nullptr, wxCMD_LINE_VAL_NONE, 0 }
    };
 
    wxCmdLineParser parser( App().argc, App().argv );
    parser.SetDesc( desc );
    parser.Parse( false );
 
    bool mergetoolMode = parser.FoundSwitch( "mergetool" ) == wxCMD_SWITCH_ON;
 
    if( mergetoolMode && parser.GetParamCount() != 4 )
    {
        wxFprintf( stderr,
                   wxT( "kicad --mergetool expects four positional arguments: "
                        "ANCESTOR OURS THEIRS MERGED\n" ) );
        return false;
    }
 
    FRAME_T appType = mergetoolMode ? FRAME_MERGETOOL : KICAD_MAIN_FRAME_T;
 
    const struct
    {
        wxString name;
        FRAME_T  type;
        // clang-format off
    } frameTypes[] = { { wxT( "pcb" ), FRAME_PCB_EDITOR },
                       { wxT( "fpedit" ), FRAME_FOOTPRINT_EDITOR },
                       { wxT( "sch" ), FRAME_SCH },
                       { wxT( "calc" ), FRAME_CALC },
                       { wxT( "ds" ), FRAME_PL_EDITOR },
                       { wxT( "gerb" ), FRAME_GERBER },
                       { wxT( "" ), FRAME_T_COUNT } };
    // clang-format on
 
    wxString frameName;
 
    if( parser.Found( "frame", &frameName ) )
    {
        appType = FRAME_T_COUNT;
 
        for( const auto& it : frameTypes )
        {
            if( it.name == frameName )
                appType = it.type;
        }
 
        if( appType == FRAME_T_COUNT )
        {
            wxLogError( wxT( "Unknown frame: %s" ), frameName );
            // Clean up
            OnPgmExit();
            return false;
        }
    }
 
    if( appType == KICAD_MAIN_FRAME_T )
    {
        Kiway.SetCtlBits( KFCTL_CPP_PROJECT_SUITE );
    }
    else
    {
        Kiway.SetCtlBits( KFCTL_STANDALONE );
    }
 
#ifndef __WXMAC__
    if( parser.Found( "software-rendering" ) )
    {
        wxSetEnv( "KICAD_SOFTWARE_RENDERING", "1" );
    }
#endif
 
    if( !InitPgm( false ) )
        return false;
 
 
    m_bm.InitSettings( new KICAD_SETTINGS );
    GetSettingsManager().RegisterSettings( PgmSettings() );
    GetSettingsManager().SetKiway( &Kiway );
    m_bm.Init();
 
    if( const COMMON_SETTINGS* cfg = Pgm().GetCommonSettings() )
    {
        if( cfg->m_Appearance.app_theme == APP_THEME::DARK )
            KIPLATFORM::APP::EnableDarkMode( true );
        else if( cfg->m_Appearance.app_theme == APP_THEME::AUTO )
            KIPLATFORM::APP::EnableDarkMode( false );
    }
 
    // Add search paths to feed the PGM_KICAD::SysSearch() function,
    // currently limited in support to only look for project templates
    {
        SEARCH_STACK bases;
 
        SystemDirsAppend( &bases );
 
        for( unsigned i = 0; i < bases.GetCount(); ++i )
        {
            wxFileName fn( bases[i], wxEmptyString );
 
            // Add KiCad template file path to search path list.
            fn.AppendDir( wxT( "template" ) );
 
            // Only add path if exists and can be read by the user.
            if( fn.DirExists() && fn.IsDirReadable() )
                m_bm.m_search.AddPaths( fn.GetPath() );
        }
 
        auto insertExpanded = [&]( const wxString& aValue )
        {
            wxString resolved = ExpandEnvVarSubstitutions( aValue, nullptr );
 
            // Skip values that still contain unresolved variable references so we don't
            // pollute the search stack with paths like "${MISSING}/templates".
            if( resolved.Contains( wxT( "${" ) ) || resolved.Contains( wxT( "$(" ) ) )
                return;
 
            m_bm.m_search.Insert( resolved, 0 );
        };
 
        // The versioned TEMPLATE_DIR takes precedence over the search stack template path.
        if( std::optional<wxString> v = ENV_VAR::GetVersionedEnvVarValue( GetLocalEnvVariables(),
                                                                          wxT( "TEMPLATE_DIR" ) ) )
        {
            if( !v->IsEmpty() )
                insertExpanded( *v );
        }
 
        // We've been adding system (installed default) search paths so far, now for user paths
        // The default user search path is inside KIPLATFORM::ENV::GetDocumentsPath()
        m_bm.m_search.Insert( PATHS::GetUserTemplatesPath(), 0 );
 
        // ...but the user can override that default with the KICAD_USER_TEMPLATE_DIR env var.
        // The value may itself reference other KiCad path variables, so expand them here.
        ENV_VAR_MAP_CITER it = GetLocalEnvVariables().find( "KICAD_USER_TEMPLATE_DIR" );
 
        if( it != GetLocalEnvVariables().end() && it->second.GetValue() != wxEmptyString )
            insertExpanded( it->second.GetValue() );
    }
 
    wxFrame*              frame         = nullptr;
    KIWAY_PLAYER*         playerFrame   = nullptr;
    KICAD_MANAGER_FRAME*  managerFrame  = nullptr;
    MERGETOOL_FRAME*      mergetoolFrame = nullptr;
 
    // Editor frames register their API handlers in their constructors, so the API server must
    // be live before any frame is built.  The short-lived --mergetool driver skips it to avoid
    // contending for the singleton IPC socket.
    if( appType != FRAME_MERGETOOL )
    {
        m_api_server = std::make_unique<KICAD_API_SERVER>();
        m_api_common_handler = std::make_unique<API_HANDLER_COMMON>();
        m_api_server->RegisterHandler( m_api_common_handler.get() );
        m_api_libraries_handler = std::make_unique<API_HANDLER_LIBRARIES>(
                LIBRARY_TABLE_TYPE::DESIGN_BLOCK );
        m_api_server->RegisterHandler( m_api_libraries_handler.get() );
    }
 
    if( appType == FRAME_MERGETOOL )
    {
        MERGETOOL_PATHS paths{ parser.GetParam( 0 ), parser.GetParam( 1 ),
                               parser.GetParam( 2 ), parser.GetParam( 3 ) };
        mergetoolFrame = new MERGETOOL_FRAME( &Kiway, nullptr, paths );
        frame          = mergetoolFrame;
    }
    else if( appType == KICAD_MAIN_FRAME_T )
    {
        managerFrame = new KICAD_MANAGER_FRAME( nullptr, wxT( "KiCad" ), wxDefaultPosition,
                                                wxWindow::FromDIP( wxSize( 775, -1 ), NULL ) );
        frame = managerFrame;
 
        STARTWIZARD startWizard;
        startWizard.CheckAndRun( frame );
    }
    else
    {
        // Use KIWAY to create a top window, which registers its existence also.
        // "TOP_FRAME" is a macro that is passed on compiler command line from CMake,
        // and is one of the types in FRAME_T.
        playerFrame = Kiway.Player( appType, true );
        frame = playerFrame;
 
        if( frame == nullptr )
        {
            return false;
        }
    }
 
    App().SetTopWindow( frame );
 
    if( playerFrame )
        App().SetAppDisplayName( playerFrame->GetAboutTitle() );
 
    Kiway.SetTop( frame );
 
    KIPLATFORM::ENV::SetAppDetailsForWindow( frame, '"' + wxStandardPaths::Get().GetExecutablePath() + '"' + " -n",
                                             frame->GetTitle() );
 
    KICAD_SETTINGS* settings = static_cast<KICAD_SETTINGS*>( PgmSettings() );
 
    GetLibraryManager().LoadGlobalTables();
 
    wxString projToLoad;
 
    HideSplash();
 
    if( playerFrame && parser.GetParamCount() )
    {
        // Now after the frame processing, the rest of the positional args are files
        std::vector<wxString> fileArgs;
        /*
            gerbview handles multiple project data files, i.e. gerber files on
            cmd line. Others currently do not, they handle only one. For common
            code simplicity we simply pass all the arguments in however, each
            program module can do with them what they want, ignore, complain
            whatever.  We don't establish policy here, as this is a multi-purpose
            launcher.
        */
 
        for( size_t i = 0; i < parser.GetParamCount(); i++ )
            fileArgs.push_back( parser.GetParam( i ) );
 
        // special attention to a single argument: argv[1] (==argSet[0])
        if( fileArgs.size() == 1 )
        {
            wxFileName argv1( fileArgs[0] );
 
#if defined( PGM_DATA_FILE_EXT )
            // PGM_DATA_FILE_EXT, if present, may be different for each compile,
            // it may come from CMake on the compiler command line, but often does not.
            // This facility is mostly useful for those program footprints
            // supporting a single argv[1].
            if( !argv1.GetExt() )
                argv1.SetExt( wxT( PGM_DATA_FILE_EXT ) );
#endif
            argv1.MakeAbsolute();
 
            fileArgs[0] = argv1.GetFullPath();
        }
 
        // Use the KIWAY_PLAYER::OpenProjectFiles() API function:
        if( !playerFrame->OpenProjectFiles( fileArgs ) )
        {
            // OpenProjectFiles() API asks that it report failure to the UI.
            // Nothing further to say here.
 
            // We've already initialized things at this point, but wx won't call OnExit if
            // we fail out. Call our own cleanup routine here to ensure the relevant resources
            // are freed at the right time (if they aren't, segfaults will occur).
            OnPgmExit();
 
            // Fail the process startup if the file could not be opened,
            // although this is an optional choice, one that can be reversed
            // also in the KIFACE specific OpenProjectFiles() return value.
            return false;
        }
    }
    else if( managerFrame )
    {
        if( parser.GetParamCount() > 0 )
        {
            wxFileName tmp = parser.GetParam( 0 );
 
            if( tmp.GetExt() != FILEEXT::ProjectFileExtension && tmp.GetExt() != FILEEXT::LegacyProjectFileExtension )
            {
                DisplayErrorMessage( nullptr, wxString::Format( _( "File '%s'\n"
                                                                   "does not appear to be a KiCad project file." ),
                                                                tmp.GetFullPath() ) );
            }
            else
            {
                projToLoad = tmp.GetFullPath();
            }
        }
 
        // If no file was given as an argument, check that there was a file open.
        if( projToLoad.IsEmpty() && settings->m_OpenProjects.size() && !parser.FoundSwitch( "new" ) )
        {
            wxString last_pro = settings->m_OpenProjects.front();
            settings->m_OpenProjects.erase( settings->m_OpenProjects.begin() );
 
            if( wxFileExists( last_pro ) )
            {
                // Try to open the last opened project,
                // if a project name is not given when starting Kicad
                projToLoad = last_pro;
            }
        }
 
        bool loaded = false;
 
        // Do not attempt to load a non-existent project file.
        if( !projToLoad.empty() )
        {
            wxFileName fn( projToLoad );
 
            if( fn.Exists() && (   fn.GetExt() == FILEEXT::ProjectFileExtension
                                || fn.GetExt() == FILEEXT::LegacyProjectFileExtension ) )
            {
                fn.MakeAbsolute();
 
                if( appType == KICAD_MAIN_FRAME_T )
                    loaded = managerFrame->LoadProject( fn );
            }
        }
 
        if( !loaded && appType == KICAD_MAIN_FRAME_T )
            managerFrame->PreloadAllLibraries();
    }
 
    if( mergetoolFrame )
    {
        // Closing the host frame must not replace the merge result with an exit code of zero.
        App().SetExitOnFrameDelete( false );
 
        // Stay hidden; the merge dialog is its own modal. The frame just needs
        // to be the wxApp top window so the modal has a parent and the wxApp
        // loop has something to drive. Defer the run via CallAfter so the
        // event loop is up before ShowModal spins its nested loop. The
        // wxWeakRef guards against the frame being destroyed (window-manager
        // close, fatal init) before the callback fires.
        wxWeakRef<MERGETOOL_FRAME> mergeToolFrameRef( mergetoolFrame );
 
        mergetoolFrame->CallAfter(
                [mergeToolFrameRef]() mutable
                {
                    if( !mergeToolFrameRef || mergeToolFrameRef->IsBeingDeleted() )
                        return;
 
                    int exitCode = mergeToolFrameRef->RunMerge();
 
                    // Propagate the merge JOB's exit code to the kicad
                    // process exit status so `git mergetool` sees a non-zero
                    // status on unresolved conflicts.
                    if( wxEventLoopBase* loop = wxTheApp->GetMainLoop() )
                        loop->ScheduleExit( exitCode );
 
                    mergeToolFrameRef->Close( true );
                } );
    }
    else
    {
        frame->Show( true );
        frame->Raise();
 
#if defined( KICAD_NATIVE_MODEL_PREVIEW ) && defined( __WINDOWS__ )
        frame->CallAfter( [frame] { MaybeShowModelPreviewSetupPrompt( frame ); } );
#endif
    }
 
    if( m_api_server )
        m_api_server->SetReadyToReply();
 
    return true;
}
 
 
int PGM_KICAD::OnPgmRun()
{
    return 0;
}
 
 
void PGM_KICAD::OnPgmExit()
{
    // Signal all background library preloads to abort before waiting for the thread pool.
    // The design block preload runs on the global thread pool and checks this flag; without
    // setting it here the pool wait below can block for up to 120 seconds.
    m_libraryPreloadAbort.store( true );
 
    // Abort and wait on any background jobs
    GetKiCadThreadPool().purge();
    GetKiCadThreadPool().wait();
 
    Kiway.OnKiwayEnd();
 
    m_api_server.reset();
 
    if( m_settings_manager && m_settings_manager->IsOK() )
    {
        SaveCommonSettings();
        m_settings_manager->Save();
    }
 
    // Destroy PGM_KICAD earlier than wxApp and static destruction would
    Destroy();
    GetGitBackend()->Shutdown();
    delete GetGitBackend();
    SetGitBackend( nullptr );
}
 
 
void PGM_KICAD::MacOpenFile( const wxString& aFileName )
{
#if defined(__WXMAC__)
 
    KICAD_MANAGER_FRAME* frame = (KICAD_MANAGER_FRAME*) App().GetTopWindow();
 
    if( !aFileName.empty() && wxFileExists( aFileName ) )
        frame->LoadProject( wxFileName( aFileName ) );
 
#endif
}
 
 
void PGM_KICAD::Destroy()
{
    // unlike a normal destructor, this is designed to be called more
    // than once safely:
 
    m_bm.End();
 
    PGM_BASE::Destroy();
}
 
 
KIWAY  Kiway( KFCTL_CPP_PROJECT_SUITE );
 
#ifdef NDEBUG
// Define a custom assertion handler
void CustomAssertHandler(const wxString& file,
                         int line,
                         const wxString& func,
                         const wxString& cond,
                         const wxString& msg)
{
    Pgm().HandleAssert( file, line, func, cond, msg );
}
#endif

struct APP_KICAD : public wxApp
{
    APP_KICAD() : wxApp()
    {
        SetPgm( &program );
 
        // Init the environment each platform wants
        KIPLATFORM::ENV::Init();
    }
 
 
    bool OnInit()           override
    {
#ifdef NDEBUG
        // These checks generate extra assert noise
        wxSizerFlags::DisableConsistencyChecks();
        wxDISABLE_DEBUG_SUPPORT();
        wxSetAssertHandler( CustomAssertHandler );
#endif
 
        // Perform platform-specific init tasks
        if( !KIPLATFORM::APP::Init() )
            return false;
 
#ifndef DEBUG
        // Enable logging traces to the console in release build.
        // This is usually disabled, but it can be useful for users to run to help
        // debug issues and other problems.
        if( wxGetEnv( wxS( "KICAD_ENABLE_WXTRACE" ), nullptr ) )
        {
            wxLog::EnableLogging( true );
            wxLog::SetLogLevel( wxLOG_Trace );
        }
#endif
 
        if( !program.OnPgmInit() )
        {
            program.OnPgmExit();
            return false;
        }
 
        return true;
    }
 
    int OnExit() override
    {
        // Drain wxPendingDelete (frames deferred via Destroy()) before tearing down
        // PGM_BASE singletons. On macOS the dock-quit path leaves frames in this
        // queue at OnExit() time, and their canvas destructors call into
        // Pgm().GetGLContextManager(). Running OnPgmExit() first would null that
        // pointer out from under them. See https://gitlab.com/kicad/code/kicad/-/issues/23373
        int ret = wxApp::OnExit();
 
        // Avoid wxLog crashing when used in destructors invoked from OnPgmExit().
        wxLog::EnableLogging( false );
 
        program.OnPgmExit();
        return ret;
    }
 
 
    int OnRun() override
    {
        try
        {
            return wxApp::OnRun();
        }
        catch(...)
        {
            Pgm().HandleException( std::current_exception() );
        }
 
        return -1;
    }
 
 
    void OnUnhandledException() override
    {
        Pgm().HandleException( std::current_exception(), true );
    }
 
 
    int FilterEvent( wxEvent& aEvent ) override
    {
        if( aEvent.GetEventType() == wxEVT_SHOW )
        {
            wxShowEvent& event = static_cast<wxShowEvent&>( aEvent );
            wxDialog*    dialog = dynamic_cast<wxDialog*>( event.GetEventObject() );
 
            std::vector<void*>& dlgs = Pgm().m_ModalDialogs;
 
            if( dialog )
            {
                if( event.IsShown() && dialog->IsModal() )
                {
                    dlgs.push_back( dialog );
                }
                // Under GTK, sometimes the modal flag is cleared before hiding
                else if( !event.IsShown() && !dlgs.empty() )
                {
                    // If we close the expected dialog, remove it from our stack
                    if( dlgs.back() == dialog )
                        dlgs.pop_back();
                    // If an out-of-order, remove all dialogs added after the closed one
                    else if( auto it = std::find( dlgs.begin(), dlgs.end(), dialog ) ; it != dlgs.end() )
                        dlgs.erase( it, dlgs.end() );
                }
            }
        }
 
        return Event_Skip;
    }
 
#if defined( DEBUG )
    bool ProcessEvent( wxEvent& aEvent ) override
    {
        if( aEvent.GetEventType() == wxEVT_CHAR || aEvent.GetEventType() == wxEVT_CHAR_HOOK )
        {
            wxKeyEvent* keyEvent = static_cast<wxKeyEvent*>( &aEvent );
 
            if( keyEvent )
            {
                wxLogTrace( kicadTraceKeyEvent, "APP_KICAD::ProcessEvent %s", dump( *keyEvent ) );
            }
        }
 
        return wxApp::ProcessEvent( aEvent );
    }

    bool OnExceptionInMainLoop() override
    {
        try
        {
            throw;
        }
        catch(...)
        {
            Pgm().HandleException( std::current_exception() );
        }
 
        return false;   // continue on. Return false to abort program
    }
#endif

#if defined( __WXMAC__ )
    void MacOpenFile( const wxString& aFileName ) override
    {
        Pgm().MacOpenFile( aFileName );
    }
#endif
};
 
IMPLEMENT_APP( APP_KICAD )
 
 
// The C++ project manager supports one open PROJECT, so Prj() calls within
// this link image need this function.
PROJECT& Prj()
{
    return Kiway.Prj();
}