/* * This program source code file is part of KiCad, a free EDA CAD application. * * Copyright (C) 2021 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 3 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 . */ #include #include #include #include #include #include #include #include #include // lowercase or pretty case depending on platform #if defined( __WXMAC__ ) || defined( __WXMSW__ ) #define KICAD_PATH_STR wxT( "KiCad" ) #else #define KICAD_PATH_STR wxT( "kicad" ) #endif void PATHS::getUserDocumentPath( wxFileName& aPath ) { wxString envPath; if( wxGetEnv( wxT( "KICAD_DOCUMENTS_HOME" ), &envPath ) ) aPath.AssignDir( envPath ); else aPath.AssignDir( KIPLATFORM::ENV::GetDocumentsPath() ); aPath.AppendDir( KICAD_PATH_STR ); aPath.AppendDir( SETTINGS_MANAGER::GetSettingsVersion() ); } wxString PATHS::GetUserPluginsPath() { wxFileName tmp; getUserDocumentPath( tmp ); tmp.AppendDir( wxT( "plugins" ) ); return tmp.GetPath(); } wxString PATHS::GetUserPlugins3DPath() { wxFileName tmp; tmp.AssignDir( PATHS::GetUserPluginsPath() ); tmp.AppendDir( wxT( "3d" ) ); return tmp.GetPath(); } wxString PATHS::GetUserScriptingPath() { wxFileName tmp; getUserDocumentPath( tmp ); tmp.AppendDir( wxT( "scripting" ) ); return tmp.GetPath(); } wxString PATHS::GetUserTemplatesPath() { wxFileName tmp; getUserDocumentPath( tmp ); tmp.AppendDir( wxT( "template" ) ); return tmp.GetPathWithSep(); } wxString PATHS::GetDefaultUserSymbolsPath() { wxFileName tmp; getUserDocumentPath( tmp ); tmp.AppendDir( wxT( "symbols" ) ); return tmp.GetPath(); } wxString PATHS::GetDefaultUserFootprintsPath() { wxFileName tmp; getUserDocumentPath( tmp ); tmp.AppendDir( wxT( "footprints" ) ); return tmp.GetPath(); } wxString PATHS::GetDefaultUser3DModelsPath() { wxFileName tmp; getUserDocumentPath( tmp ); tmp.AppendDir( wxT( "3dmodels" ) ); return tmp.GetPath(); } wxString PATHS::GetDefault3rdPartyPath() { wxFileName tmp; getUserDocumentPath( tmp ); tmp.AppendDir( wxT( "3rdparty" ) ); return tmp.GetPath(); } wxString PATHS::GetDefaultUserProjectsPath() { wxFileName tmp; getUserDocumentPath( tmp ); tmp.AppendDir( wxT( "projects" ) ); return tmp.GetPath(); } wxString PATHS::GetStockDataPath( bool aRespectRunFromBuildDir ) { wxString path; if( aRespectRunFromBuildDir && wxGetEnv( wxT( "KICAD_RUN_FROM_BUILD_DIR" ), nullptr ) ) { // Allow debugging from build dir by placing relevant files/folders in the build root #if defined( __WXMAC__ ) wxFileName fn = wxStandardPaths::Get().GetExecutablePath(); fn.RemoveLastDir(); fn.RemoveLastDir(); fn.RemoveLastDir(); fn.RemoveLastDir(); path = fn.GetPath(); #elif defined( __WXMSW__ ) path = getWindowsKiCadRoot(); #else path = Pgm().GetExecutablePath() + wxT( ".." ); #endif } else { #if defined( __WXMAC__ ) path = GetOSXKicadDataDir(); #elif defined( __WXMSW__ ) path = getWindowsKiCadRoot() + wxT( "share/kicad" ); #else path = wxString::FromUTF8Unchecked( KICAD_DATA ); #endif } return path; } wxString PATHS::GetStockEDALibraryPath() { wxString path; #if defined( __WXMAC__ ) path = GetOSXKicadMachineDataDir(); #elif defined( __WXMSW__ ) path = GetStockDataPath( false ); #else path = wxString::FromUTF8Unchecked( KICAD_LIBRARY_DATA ); #endif return path; } wxString PATHS::GetStockSymbolsPath() { wxString path; path = GetStockEDALibraryPath() + wxT( "/symbols" ); return path; } wxString PATHS::GetStockFootprintsPath() { wxString path; path = GetStockEDALibraryPath() + wxT( "/footprints" ); return path; } wxString PATHS::GetStock3dmodelsPath() { wxString path; path = GetStockEDALibraryPath() + wxT( "/3dmodels" ); return path; } wxString PATHS::GetStockScriptingPath() { wxString path; path = GetStockDataPath() + wxT( "/scripting" ); return path; } wxString PATHS::GetStockTemplatesPath() { wxString path; path = GetStockEDALibraryPath() + wxT( "/template" ); return path; } wxString PATHS::GetLocaleDataPath() { wxString path; path = GetStockDataPath() + wxT( "/internat" ); return path; } wxString PATHS::GetStockPluginsPath() { wxFileName fn; #if defined( __WXMSW__ ) fn.AssignDir( Pgm().GetExecutablePath() ); fn.AppendDir( wxT( "scripting" ) ); #else fn.AssignDir( PATHS::GetStockDataPath( false ) ); #endif fn.AppendDir( wxT( "plugins" ) ); return fn.GetPathWithSep(); } wxString PATHS::GetStockPlugins3DPath() { wxFileName fn; #ifdef __WXGTK__ // KICAD_PLUGINDIR = CMAKE_INSTALL_FULL_LIBDIR path is the absolute path // corresponding to the install path used for constructing KICAD_USER_PLUGIN wxString tfname = wxString::FromUTF8Unchecked( KICAD_PLUGINDIR ); fn.Assign( tfname, "" ); fn.AppendDir( wxT( "kicad" ) ); fn.AppendDir( wxT( "plugins" ) ); #elif defined( __WXMAC__ ) fn.Assign( wxStandardPaths::Get().GetPluginsDir(), wxEmptyString ); #else if( wxGetEnv( wxT( "KICAD_RUN_FROM_BUILD_DIR" ), nullptr ) ) { fn.AssignDir( getWindowsKiCadRoot() ); } else { fn.AssignDir( Pgm().GetExecutablePath() ); } fn.AppendDir( wxT( "plugins" ) ); #endif fn.AppendDir( wxT( "3d" ) ); return fn.GetPathWithSep(); } wxString PATHS::GetStockDemosPath() { wxFileName fn; fn.AssignDir( PATHS::GetStockDataPath( false ) ); fn.AppendDir( wxT( "demos" ) ); return fn.GetPathWithSep(); } wxString PATHS::GetUserCachePath() { wxString envPath; wxFileName tmp; tmp.AssignDir( KIPLATFORM::ENV::GetUserCachePath() ); // Use KICAD_CACHE_HOME to allow the user to force a specific cache path. if( wxGetEnv( wxT( "KICAD_CACHE_HOME" ), &envPath ) && !envPath.IsEmpty() ) { // Override the assignment above with KICAD_CACHE_HOME tmp.AssignDir( envPath ); } tmp.AppendDir( KICAD_PATH_STR ); tmp.AppendDir( SETTINGS_MANAGER::GetSettingsVersion() ); return tmp.GetPathWithSep(); } wxString PATHS::GetDocumentationPath() { wxString path; #if defined( __WXMAC__ ) path = GetOSXKicadDataDir(); #elif defined( __WXMSW__ ) path = getWindowsKiCadRoot() + wxT( "share/doc/kicad" ); #else path = wxString::FromUTF8Unchecked( KICAD_DOCS ); #endif return path; } bool PATHS::EnsurePathExists( const wxString& aPath ) { wxFileName path( aPath ); if( !path.MakeAbsolute() ) { return false; } if( !wxFileName::DirExists( aPath ) ) { if( !wxFileName::Mkdir( aPath, wxS_DIR_DEFAULT, wxPATH_MKDIR_FULL ) ) { return false; } } return true; } void PATHS::EnsureUserPathsExist() { EnsurePathExists( GetUserCachePath() ); EnsurePathExists( GetUserPluginsPath() ); EnsurePathExists( GetUserPlugins3DPath() ); EnsurePathExists( GetUserScriptingPath() ); EnsurePathExists( GetUserTemplatesPath() ); EnsurePathExists( GetDefaultUserProjectsPath() ); EnsurePathExists( GetDefaultUserSymbolsPath() ); EnsurePathExists( GetDefaultUserFootprintsPath() ); EnsurePathExists( GetDefaultUser3DModelsPath() ); EnsurePathExists( GetDefault3rdPartyPath() ); } #ifdef __WXMAC__ wxString PATHS::GetOSXKicadUserDataDir() { // According to wxWidgets documentation for GetUserDataDir: // Mac: ~/Library/Application Support/appname wxFileName udir( wxStandardPaths::Get().GetUserDataDir(), wxEmptyString ); // Since appname is different if started via launcher or standalone binary // map all to "kicad" here udir.RemoveLastDir(); udir.AppendDir( wxT( "kicad" ) ); return udir.GetPath(); } wxString PATHS::GetOSXKicadMachineDataDir() { // 6.0 forward: Same as the main data dir return GetOSXKicadDataDir(); } wxString PATHS::GetOSXKicadDataDir() { // According to wxWidgets documentation for GetDataDir: // Mac: appname.app/Contents/SharedSupport bundle subdirectory wxFileName ddir( wxStandardPaths::Get().GetDataDir(), wxEmptyString ); // This must be mapped to main bundle for everything but kicad.app const wxArrayString dirs = ddir.GetDirs(); // Check if we are the main kicad binary. in this case, the path will be // /path/to/bundlename.app/Contents/SharedSupport // If we are an aux binary, the path will be something like // /path/to/bundlename.app/Contents/Applications/.app/Contents/SharedSupport if( dirs.GetCount() >= 6 && dirs[dirs.GetCount() - 4] == wxT( "Applications" ) && dirs[dirs.GetCount() - 6].Lower().EndsWith( wxT( "app" ) ) ) { ddir.RemoveLastDir(); ddir.RemoveLastDir(); ddir.RemoveLastDir(); ddir.RemoveLastDir(); ddir.AppendDir( wxT( "SharedSupport" ) ); } return ddir.GetPath(); } #endif #ifdef __WXWINDOWS__ wxString PATHS::GetWindowsFontConfigDir() { wxFileName fn; fn.AssignDir( getWindowsKiCadRoot() ); fn.AppendDir( wxS( "etc" ) ); fn.AppendDir( wxS( "fonts" ) ); return fn.GetPathWithSep(); } wxString PATHS::getWindowsKiCadRoot() { wxFileName root( Pgm().GetExecutablePath() + wxT( "/../" ) ); root.MakeAbsolute(); return root.GetPathWithSep(); } #endif