#include <wx/wx.h>
#include <config.h>
#include <boost/version.hpp>
#include <kiplatform/app.h>
#include <font/version_info.h>
#include <build_version.h>
#include <tuple>
#include <Standard_Version.hxx>
#include <ngspice/sharedspice.h>
#include <kicad_build_version.h>

Macros
#define	INCLUDE_KICAD_VERSION

#define	ON "ON" << eol

#define	OFF "OFF" << eol

Functions
std::string	GetKicadCurlVersion ()

std::string	GetCurlLibVersion ()

wxString	GetPlatformGetBitnessName ()

bool	IsNightlyVersion ()
	Check if the build is meant to be nightly.

wxString	GetBuildVersion ()
	Get the full KiCad version string.

wxString	GetBaseVersion ()
	Get the KiCad version string without the information added by the packagers.

wxString	GetBuildDate ()
	Get the build date as a string.

wxString	GetSemanticVersion ()
	Get the semantic version string for KiCad defined inside the KiCadVersion.cmake file in the variable KICAD_SEMANTIC_VERSION.

wxString	GetMajorMinorVersion ()
	Get only the major and minor version in a string major.minor.

wxString	GetCommitHash ()
	Get the commit hash as a string.

wxString	GetMajorMinorPatchVersion ()
	Get the major, minor and patch version in a string major.minor.patch This is extracted by CMake from the KICAD_SEMANTIC_VERSION variable.

const std::tuple< int, int, int > &	GetMajorMinorPatchTuple ()
	Get the build version numbers as a tuple.

wxString	GetVersionInfoData (const wxString &aTitle, bool aHtml, bool aBrief)
	Create a version info string for bug reports and the about dialog.

Macro Definition Documentation

◆ INCLUDE_KICAD_VERSION

#define INCLUDE_KICAD_VERSION

Definition at line 50 of file build_version.cpp.

◆ OFF

#define OFF "OFF" << eol

◆ ON

#define ON "ON" << eol

Function Documentation

◆ GetBaseVersion()

wxString GetBaseVersion ( )

Get the KiCad version string without the information added by the packagers.

It is created by CMake in the KICAD_VERSION variable.

Returns: the base version string

Definition at line 74 of file build_version.cpp.

Referenced by DS_DRAW_ITEM_LIST::BuildFullText().

◆ GetBuildDate()

wxString GetBuildDate ( )

Get the build date as a string.

Returns: the build date string

Definition at line 81 of file build_version.cpp.

Referenced by buildKicadAboutBanner(), GetVersionInfoData(), and KICAD_CURL_EASY::KICAD_CURL_EASY().

◆ GetBuildVersion()

wxString GetBuildVersion ( )

Get the full KiCad version string.

This string contains platform-specific information added by the packagers. It is created by CMake in the KICAD_FULL_VERSION variable.

Returns: the full version string

Definition at line 67 of file build_version.cpp.

Referenced by AddGerberX2Header(), GERBER_JOBFILE_WRITER::addJSONHeader(), buildKicadAboutBanner(), GENCAD_EXPORTER::CreateHeaderInfoData(), PCB_EDIT_FRAME::Export_IDF3(), PLACE_FILE_EXPORTER::GenPositionData(), PLACE_FILE_EXPORTER::GenReportData(), GetVersionInfoData(), API_HANDLER_COMMON::handleGetVersion(), KICAD_CURL_EASY::KICAD_CURL_EASY(), NETLIST_EXPORTER_XML::makeDesignHeader(), DSN::PARSER::PARSER(), GERBER_PLOTTER::StartPlot(), EXCELLON_WRITER::writeEXCELLONHeader(), PCB_CALCULATOR_DATAFILE::WriteHeader(), and NETLIST_EXPORTER_CADSTAR::WriteNetlist().

◆ GetCommitHash()

wxString GetCommitHash ( )

Get the commit hash as a string.

Returns: the commit hash string

Definition at line 102 of file build_version.cpp.

Referenced by CLI::VERSION_COMMAND::doPerform().

◆ GetCurlLibVersion()

std::string GetCurlLibVersion ( )

Definition at line 54 of file kicad_curl.cpp.

Referenced by GetVersionInfoData().

◆ GetKicadCurlVersion()

std::string GetKicadCurlVersion ( )

Definition at line 48 of file kicad_curl.cpp.

References KICAD_CURL::GetVersion().

Referenced by GetVersionInfoData().

◆ GetMajorMinorPatchTuple()

const std::tuple< int, int, int > & GetMajorMinorPatchTuple ( )

Get the build version numbers as a tuple.

Returns: A tuple with three ints for major/minor/patch revisions

Definition at line 115 of file build_version.cpp.

Referenced by ENV_VAR::GetVersionedEnvVarName(), and API_HANDLER_COMMON::handleGetVersion().

◆ GetMajorMinorPatchVersion()

wxString GetMajorMinorPatchVersion ( )

Get the major, minor and patch version in a string major.minor.patch This is extracted by CMake from the KICAD_SEMANTIC_VERSION variable.

Returns: the major.minor.patch version as a string

Definition at line 109 of file build_version.cpp.

Referenced by DIALOG_UPDATE_NOTICE::DIALOG_UPDATE_NOTICE(), CLI::VERSION_COMMAND::doPerform(), PCB_IO_IPC2581::generateHistorySection(), ERC_REPORT::WriteJsonReport(), and DRC_REPORT::WriteJsonReport().

◆ GetMajorMinorVersion()

wxString GetMajorMinorVersion ( )

Get only the major and minor version in a string major.minor.

This is extracted by CMake from the KICAD_SEMANTIC_VERSION variable.

Returns: the major and minor version as a string

Definition at line 95 of file build_version.cpp.

Referenced by PATHS::CalculateUserSettingsPath(), KICAD_MANAGER_FRAME::CreateNewProject(), EVT_MENU_RANGE(), PCB_IO_KICAD_SEXPR::format(), DS_DATA_MODEL_IO::Format(), SCH_IO_KICAD_SEXPR::Format(), SETTINGS_MANAGER::GetSettingsVersion(), PATHS::GetUserCachePath(), PATHS::getUserDocumentPath(), PGM_BASE::InitPgm(), HTML_MESSAGE_BOX::OnHTMLLinkClicked(), BITMAPCONV_INFO::outputDataHeader(), PLUGIN_CONTENT_MANAGER::PLUGIN_CONTENT_MANAGER(), KICAD_MANAGER_FRAME::ProjectChanged(), SCH_IO_KICAD_SEXPR_LIB_CACHE::Save(), CLIPBOARD_IO::SaveBoard(), PCB_IO_KICAD_SEXPR::SaveBoard(), CLIPBOARD_IO::SaveSelection(), COMMON_CONTROL::ShowHelp(), and GBR_TO_PCB_EXPORTER::writePcbHeader().

◆ GetPlatformGetBitnessName()

wxString GetPlatformGetBitnessName ( )

Returns: the bitness name string (like "Little endian")

Definition at line 54 of file build_version.cpp.

Referenced by buildKicadAboutBanner(), GetVersionInfoData(), and KICAD_CURL_EASY::KICAD_CURL_EASY().

◆ GetSemanticVersion()

wxString GetSemanticVersion ( )

Get the semantic version string for KiCad defined inside the KiCadVersion.cmake file in the variable KICAD_SEMANTIC_VERSION.

Returns: the semantic version string

Definition at line 88 of file build_version.cpp.

Referenced by UPDATE_MANAGER::CheckForUpdate(), and STEP_PCB_MODEL::WriteGLTF().

◆ GetVersionInfoData()

wxString GetVersionInfoData	(	const wxString &	aTitle,
		bool	aHtml = `false`,
		bool	aBrief = `false`
	)

Create a version info string for bug reports and the about dialog.

Parameters

aTitle	is the application title to include at the top of the report
aBrief	= true to condense information for the bug report URL
aHtml	= true to use a minimal HTML format, false for plan text

Returns: the version info string

Definition at line 123 of file build_version.cpp.

References KIFONT::VERSION_INFO::FontConfig(), KIFONT::VERSION_INFO::FreeType(), GetBuildDate(), GetBuildVersion(), GetCurlLibVersion(), GetKicadCurlVersion(), GetPlatformGetBitnessName(), KIFONT::VERSION_INFO::HarfBuzz(), KIPLATFORM::APP::IsOperatingSystemUnsupported(), OFF, and ON.

Referenced by DIALOG_ABOUT::createNotebooks(), CLI::VERSION_COMMAND::doPerform(), DIALOG_ABOUT::onCopyVersionInfo(), and COMMON_CONTROL::ReportBug().

◆ IsNightlyVersion()

bool IsNightlyVersion ( )

Check if the build is meant to be nightly.

Returns: true if running nightly build

Definition at line 61 of file build_version.cpp.

Referenced by DIALOG_ABOUT::DIALOG_ABOUT(), and EVT_MENU_RANGE().

Macros

Functions