#include <Addon.h>

Inheritance diagram for ADDON::CAddon:

Public Member Functions
	CAddon (CAddonInfo addonInfo)

	~CAddon () override=default

TYPE	Type () const override

TYPE	FullType () const override

bool	IsType (TYPE type) const override

std::string	ID () const override

std::string	Name () const override

bool	IsInUse () const override

AddonVersion	Version () const override

AddonVersion	MinVersion () const override

std::string	Summary () const override

std::string	Description () const override

std::string	Path () const override

std::string	Profile () const override

std::string	LibPath () const override

std::string	Author () const override

std::string	ChangeLog () const override

std::string	Icon () const override

ArtMap	Art () const override

std::vector< std::string >	Screenshots () const override

std::string	Disclaimer () const override

std::string	Broken () const override

CDateTime	InstallDate () const override

CDateTime	LastUpdated () const override

CDateTime	LastUsed () const override

std::string	Origin () const override

uint64_t	PackageSize () const override

const InfoMap &	ExtraInfo () const override

const std::vector< DependencyInfo > &	GetDependencies () const override

std::string	FanArt () const override

bool	HasSettings () override
	Check whether the this addon can be configured or not. More...

virtual bool	HasUserSettings ()
	Check whether the user has configured this addon or not. More...

void	SaveSettings () override
	Save any user configured settings. More...

void	UpdateSetting (const std::string &key, const std::string &value) override
	Update a user-configured setting with a new value. More...

bool	UpdateSettingBool (const std::string &key, bool value) override
	Update a user-configured setting with a new boolean value. More...

bool	UpdateSettingInt (const std::string &key, int value) override
	Update a user-configured setting with a new integer value. More...

bool	UpdateSettingNumber (const std::string &key, double value) override
	Update a user-configured setting with a new number value. More...

bool	UpdateSettingString (const std::string &key, const std::string &value) override
	Update a user-configured setting with a new string value. More...

std::string	GetSetting (const std::string &key) override
	Retrieve a particular settings value If a previously configured user setting is available, we return it's value, else we return the default (if available) More...

bool	GetSettingBool (const std::string &key, bool &value) override
	Retrieve a particular settings value as boolean If a previously configured user setting is available, we return it's value, else we return the default (if available) More...

bool	GetSettingInt (const std::string &key, int &value) override
	Retrieve a particular settings value as integer If a previously configured user setting is available, we return it's value, else we return the default (if available) More...

bool	GetSettingNumber (const std::string &key, double &value) override
	Retrieve a particular settings value as number If a previously configured user setting is available, we return it's value, else we return the default (if available) More...

bool	GetSettingString (const std::string &key, std::string &value) override
	Retrieve a particular settings value as string If a previously configured user setting is available, we return it's value, else we return the default (if available) More...

CAddonSettings *	GetSettings () const override

AddonVersion	GetDependencyVersion (const std::string &dependencyID) const override
	get the required version of a dependency. More...

bool	MeetsVersion (const AddonVersion &version) const override
	return whether or not this addon satisfies the given version requirements More...

bool	ReloadSettings () override

AddonPtr	GetRunningInstance () const override
	retrieve the running instance of an add-on if it persists while running. More...

void	OnPreInstall () override

void	OnPostInstall (bool update, bool modal) override

void	OnPreUnInstall () override

void	OnPostUnInstall () override

Public Member Functions inherited from ADDON::IAddon
virtual	~IAddon ()=default

Protected Member Functions
virtual bool	SettingsInitialized () const
	Whether or not the settings have been initialized. More...

virtual bool	SettingsLoaded () const
	Whether or not the settings have been loaded. More...

bool	LoadSettings (bool bForce, bool loadUserSettings=true)
	Load the default settings and override these with any previously configured user settings. More...

virtual bool	LoadUserSettings ()
	Load the user settings. More...

virtual bool	HasSettingsToSave () const

virtual bool	SettingsFromXML (const CXBMCTinyXML &doc, bool loadDefaults=false)
	Parse settings from an XML document. More...

virtual bool	SettingsToXML (CXBMCTinyXML &doc) const
	Write settings into an XML document. More...

Protected Attributes
const CAddonInfo	m_addonInfo

std::string	m_userSettingsPath

Constructor & Destructor Documentation

§ CAddon()

ADDON::CAddon::CAddon ( CAddonInfo addonInfo )

explicit

§ ~CAddon()

ADDON::CAddon::~CAddon ( )

overridedefault

Member Function Documentation

§ Art()

ArtMap ADDON::CAddon::Art ( ) const

inlineoverridevirtual

Implements ADDON::IAddon.

§ Author()

std::string ADDON::CAddon::Author ( ) const

inlineoverridevirtual

Implements ADDON::IAddon.

§ Broken()

std::string ADDON::CAddon::Broken ( ) const

inlineoverridevirtual

Implements ADDON::IAddon.

§ ChangeLog()

std::string ADDON::CAddon::ChangeLog ( ) const

inlineoverridevirtual

Implements ADDON::IAddon.

§ Description()

std::string ADDON::CAddon::Description ( ) const

inlineoverridevirtual

Implements ADDON::IAddon.

§ Disclaimer()

std::string ADDON::CAddon::Disclaimer ( ) const

inlineoverridevirtual

Implements ADDON::IAddon.

§ ExtraInfo()

const InfoMap& ADDON::CAddon::ExtraInfo ( ) const

inlineoverridevirtual

Implements ADDON::IAddon.

§ FanArt()

std::string ADDON::CAddon::FanArt ( ) const

inlineoverridevirtual

Implements ADDON::IAddon.

§ FullType()

TYPE ADDON::CAddon::FullType ( ) const

inlineoverridevirtual

Implements ADDON::IAddon.

Reimplemented in ADDON::CPluginSource.

§ GetDependencies()

const std::vector<DependencyInfo>& ADDON::CAddon::GetDependencies ( ) const

inlineoverridevirtual

Implements ADDON::IAddon.

§ GetDependencyVersion()

AddonVersion ADDON::CAddon::GetDependencyVersion ( const std::string & dependencyID ) const

overridevirtual

get the required version of a dependency.

Parameters

dependencyID the addon ID of the dependency.

Returns: the version this addon requires.

Implements ADDON::IAddon.

§ GetRunningInstance()

AddonPtr ADDON::CAddon::GetRunningInstance ( ) const

inlineoverridevirtual

retrieve the running instance of an add-on if it persists while running.

Implements ADDON::IAddon.

Reimplemented in PVR::CPVRClient, ADDON::CAddonDll, and KODI::GAME::CGameClient.

§ GetSetting()

std::string ADDON::CAddon::GetSetting ( const std::string & key )

overridevirtual

Retrieve a particular settings value If a previously configured user setting is available, we return it's value, else we return the default (if available)

Parameters

key	the id of the setting to retrieve

Returns: the current value of the setting, or the default if the setting has yet to be configured.

See also: LoadSettings, LoadUserSettings, SaveSettings, HasSettings, HasUserSettings, UpdateSetting

Implements ADDON::IAddon.

Reimplemented in ADDON::CAddonDll.

§ GetSettingBool()

bool ADDON::CAddon::GetSettingBool	(	const std::string &	key,
		bool &	value
	)

overridevirtual

Retrieve a particular settings value as boolean If a previously configured user setting is available, we return it's value, else we return the default (if available)

Parameters

key	the id of the setting to retrieve
value	the current value of the setting, or the default if the setting has yet to be configured

Returns: true if the setting's value was retrieved, false otherwise.

See also: LoadSettings, LoadUserSettings, SaveSettings, HasSettings, HasUserSettings, UpdateSetting

Implements ADDON::IAddon.

§ GetSettingInt()

bool ADDON::CAddon::GetSettingInt	(	const std::string &	key,
		int &	value
	)

overridevirtual

Retrieve a particular settings value as integer If a previously configured user setting is available, we return it's value, else we return the default (if available)

Parameters

key	the id of the setting to retrieve
value	the current value of the setting, or the default if the setting has yet to be configured

Returns: true if the setting's value was retrieved, false otherwise.

See also: LoadSettings, LoadUserSettings, SaveSettings, HasSettings, HasUserSettings, UpdateSetting

Implements ADDON::IAddon.

§ GetSettingNumber()

bool ADDON::CAddon::GetSettingNumber	(	const std::string &	key,
		double &	value
	)

overridevirtual

Retrieve a particular settings value as number If a previously configured user setting is available, we return it's value, else we return the default (if available)

Parameters

key	the id of the setting to retrieve
value	the current value of the setting, or the default if the setting has yet to be configured

Returns: true if the setting's value was retrieved, false otherwise.

See also: LoadSettings, LoadUserSettings, SaveSettings, HasSettings, HasUserSettings, UpdateSetting

Implements ADDON::IAddon.

§ GetSettings()

CAddonSettings * ADDON::CAddon::GetSettings ( ) const

overridevirtual

Implements ADDON::IAddon.

§ GetSettingString()

bool ADDON::CAddon::GetSettingString	(	const std::string &	key,
		std::string &	value
	)

overridevirtual

Retrieve a particular settings value as string If a previously configured user setting is available, we return it's value, else we return the default (if available)

Parameters

key	the id of the setting to retrieve
value	the current value of the setting, or the default if the setting has yet to be configured

Returns: true if the setting's value was retrieved, false otherwise.

See also: LoadSettings, LoadUserSettings, SaveSettings, HasSettings, HasUserSettings, UpdateSetting

Implements ADDON::IAddon.

§ HasSettings()

bool ADDON::CAddon::HasSettings ( )

overridevirtual

Check whether the this addon can be configured or not.

Returns: true if the addon has settings, false otherwise

See also: LoadSettings, LoadUserSettings, SaveSettings, HasUserSettings, GetSetting, UpdateSetting

Settings Handling

Implements ADDON::IAddon.

Reimplemented in ADDON::CSkinInfo.

§ HasSettingsToSave()

bool ADDON::CAddon::HasSettingsToSave ( ) const

protectedvirtual

§ HasUserSettings()

bool ADDON::CAddon::HasUserSettings ( )

virtual

Check whether the user has configured this addon or not.

Returns: true if previously saved settings are found, false otherwise

See also: LoadSettings, LoadUserSettings, SaveSettings, HasSettings, GetSetting, UpdateSetting

Reimplemented in ADDON::CSkinInfo.

§ Icon()

std::string ADDON::CAddon::Icon ( ) const

inlineoverridevirtual

Implements ADDON::IAddon.

§ ID()

std::string ADDON::CAddon::ID ( ) const

inlineoverridevirtual

Implements ADDON::IAddon.

§ InstallDate()

CDateTime ADDON::CAddon::InstallDate ( ) const

inlineoverridevirtual

Implements ADDON::IAddon.

§ IsInUse()

bool ADDON::CAddon::IsInUse ( ) const

inlineoverridevirtual

Implements ADDON::IAddon.

Reimplemented in ADDON::CSkinInfo, ADDON::CScraper, ADDON::CLanguageResource, and ADDON::CUISoundsResource.

§ IsType()

bool ADDON::CAddon::IsType ( TYPE type ) const

inlineoverridevirtual

Implements ADDON::IAddon.

Reimplemented in ADDON::CPluginSource.

§ LastUpdated()

CDateTime ADDON::CAddon::LastUpdated ( ) const

inlineoverridevirtual

Implements ADDON::IAddon.

§ LastUsed()

CDateTime ADDON::CAddon::LastUsed ( ) const

inlineoverridevirtual

Implements ADDON::IAddon.

§ LibPath()

std::string ADDON::CAddon::LibPath ( ) const

overridevirtual

Implements ADDON::IAddon.

Reimplemented in KODI::GAME::CGameClient, and ADDON::CAddonDll.

§ LoadSettings()

bool ADDON::CAddon::LoadSettings	(	bool	bForce,
		bool	loadUserSettings = `true`
	)

protected

Load the default settings and override these with any previously configured user settings.

Parameters

bForce	force the load of settings even if they are already loaded (reload)
loadUserSettings	whether or not to load user settings

Returns: true if settings exist, false otherwise

See also: LoadUserSettings, SaveSettings, HasSettings, HasUserSettings, GetSetting, UpdateSetting

§ LoadUserSettings()

bool ADDON::CAddon::LoadUserSettings ( )

protectedvirtual

Load the user settings.

Returns: true if user settings exist, false otherwise

See also: LoadSettings, SaveSettings, HasSettings, HasUserSettings, GetSetting, UpdateSetting

§ MeetsVersion()

bool ADDON::CAddon::MeetsVersion ( const AddonVersion & version ) const

inlineoverridevirtual

return whether or not this addon satisfies the given version requirements

Parameters

version the version to meet.

Returns: true if min_version <= version <= current_version, false otherwise.

Implements ADDON::IAddon.

§ MinVersion()

AddonVersion ADDON::CAddon::MinVersion ( ) const

inlineoverridevirtual

Implements ADDON::IAddon.

§ Name()

std::string ADDON::CAddon::Name ( ) const

inlineoverridevirtual

Implements ADDON::IAddon.

§ OnPostInstall()

void ADDON::CAddon::OnPostInstall	(	bool	update,
		bool	modal
	)

inlineoverridevirtual

Implements ADDON::IAddon.

Reimplemented in ADDON::CSkinInfo, ADDON::CLanguageResource, ADDON::CFontResource, and ADDON::CUISoundsResource.

§ OnPostUnInstall()

void ADDON::CAddon::OnPostUnInstall ( )

inlineoverridevirtual

Implements ADDON::IAddon.

§ OnPreInstall()

void ADDON::CAddon::OnPreInstall ( )

inlineoverridevirtual

Implements ADDON::IAddon.

Reimplemented in PVR::CPVRClient, and ADDON::CSkinInfo.

§ OnPreUnInstall()

void ADDON::CAddon::OnPreUnInstall ( )

inlineoverridevirtual

Implements ADDON::IAddon.

Reimplemented in PVR::CPVRClient, and ADDON::CImageResource.

§ Origin()

std::string ADDON::CAddon::Origin ( ) const

inlineoverridevirtual

Implements ADDON::IAddon.

§ PackageSize()

uint64_t ADDON::CAddon::PackageSize ( ) const

inlineoverridevirtual

Implements ADDON::IAddon.

§ Path()

std::string ADDON::CAddon::Path ( ) const

inlineoverridevirtual

Implements ADDON::IAddon.

§ Profile()

std::string ADDON::CAddon::Profile ( ) const

inlineoverridevirtual

Implements ADDON::IAddon.

§ ReloadSettings()

bool ADDON::CAddon::ReloadSettings ( )

overridevirtual

Implements ADDON::IAddon.

§ SaveSettings()

void ADDON::CAddon::SaveSettings ( void )

overridevirtual

Save any user configured settings.

See also: LoadSettings, LoadUserSettings, HasSettings, HasUserSettings, GetSetting, UpdateSetting

Implements ADDON::IAddon.

Reimplemented in ADDON::CAddonDll.

§ Screenshots()

std::vector<std::string> ADDON::CAddon::Screenshots ( ) const

inlineoverridevirtual

Implements ADDON::IAddon.

§ SettingsFromXML()

bool ADDON::CAddon::SettingsFromXML	(	const CXBMCTinyXML &	doc,
		bool	loadDefaults = `false`
	)

protectedvirtual

Parse settings from an XML document.

Parameters

doc	XML document to parse for settings
loadDefaults	if true, the default attribute is used and settings are reset prior to parsing, else the value attribute is used.

Returns: true if settings are loaded, false otherwise

See also: SettingsToXML

Reimplemented in ADDON::CSkinInfo.

§ SettingsInitialized()

bool ADDON::CAddon::SettingsInitialized ( ) const

protectedvirtual

Whether or not the settings have been initialized.

Reimplemented in ADDON::CSkinInfo.

§ SettingsLoaded()

bool ADDON::CAddon::SettingsLoaded ( ) const

protectedvirtual

Whether or not the settings have been loaded.

Reimplemented in ADDON::CSkinInfo.

§ SettingsToXML()

bool ADDON::CAddon::SettingsToXML ( CXBMCTinyXML & doc ) const

protectedvirtual

Write settings into an XML document.

Parameters

doc	XML document to receive the settings

Returns: true if settings are saved, false otherwise

See also: SettingsFromXML

Reimplemented in ADDON::CSkinInfo.

§ Summary()

std::string ADDON::CAddon::Summary ( ) const

inlineoverridevirtual

Implements ADDON::IAddon.

§ Type()

TYPE ADDON::CAddon::Type ( ) const

inlineoverridevirtual

Implements ADDON::IAddon.

§ UpdateSetting()

void ADDON::CAddon::UpdateSetting	(	const std::string &	key,
		const std::string &	value
	)

overridevirtual

Update a user-configured setting with a new value.

Parameters

key	the id of the setting to update
value	the value that the setting should take

See also: LoadSettings, LoadUserSettings, SaveSettings, HasSettings, HasUserSettings, GetSetting

Implements ADDON::IAddon.

§ UpdateSettingBool()

bool ADDON::CAddon::UpdateSettingBool	(	const std::string &	key,
		bool	value
	)

overridevirtual

Update a user-configured setting with a new boolean value.

Parameters

key	the id of the setting to update
value	the value that the setting should take

See also: LoadSettings, LoadUserSettings, SaveSettings, HasSettings, HasUserSettings, GetSetting

Implements ADDON::IAddon.

§ UpdateSettingInt()

bool ADDON::CAddon::UpdateSettingInt	(	const std::string &	key,
		int	value
	)

overridevirtual

Update a user-configured setting with a new integer value.

Parameters

key	the id of the setting to update
value	the value that the setting should take

See also: LoadSettings, LoadUserSettings, SaveSettings, HasSettings, HasUserSettings, GetSetting

Implements ADDON::IAddon.

§ UpdateSettingNumber()

bool ADDON::CAddon::UpdateSettingNumber	(	const std::string &	key,
		double	value
	)

overridevirtual

Update a user-configured setting with a new number value.

Parameters

key	the id of the setting to update
value	the value that the setting should take

See also: LoadSettings, LoadUserSettings, SaveSettings, HasSettings, HasUserSettings, GetSetting

Implements ADDON::IAddon.

§ UpdateSettingString()

bool ADDON::CAddon::UpdateSettingString	(	const std::string &	key,
		const std::string &	value
	)

overridevirtual

Update a user-configured setting with a new string value.

Parameters

key	the id of the setting to update
value	the value that the setting should take

See also: LoadSettings, LoadUserSettings, SaveSettings, HasSettings, HasUserSettings, GetSetting

Implements ADDON::IAddon.

§ Version()

AddonVersion ADDON::CAddon::Version ( ) const

inlineoverridevirtual

Implements ADDON::IAddon.

Member Data Documentation

§ m_addonInfo

const CAddonInfo ADDON::CAddon::m_addonInfo

protected

§ m_userSettingsPath

std::string ADDON::CAddon::m_userSettingsPath

protected

The documentation for this class was generated from the following files:

Public Member Functions

Protected Member Functions

Protected Attributes

Constructor & Destructor Documentation

§ CAddon()

§ ~CAddon()

Member Function Documentation

§ Art()

§ Author()

§ Broken()

§ ChangeLog()

§ Description()

§ Disclaimer()

§ ExtraInfo()

§ FanArt()

§ FullType()

§ GetDependencies()

§ GetDependencyVersion()

§ GetRunningInstance()

§ GetSetting()

§ GetSettingBool()

§ GetSettingInt()

§ GetSettingNumber()

§ GetSettings()

§ GetSettingString()

§ HasSettings()

§ HasSettingsToSave()

§ HasUserSettings()

§ Icon()

§ ID()

§ InstallDate()

§ IsInUse()

§ IsType()

§ LastUpdated()

§ LastUsed()

§ LibPath()

§ LoadSettings()

§ LoadUserSettings()

§ MeetsVersion()

§ MinVersion()

§ Name()

§ OnPostInstall()

§ OnPostUnInstall()

§ OnPreInstall()

§ OnPreUnInstall()

§ Origin()

§ PackageSize()

§ Path()

§ Profile()

§ ReloadSettings()

§ SaveSettings()

§ Screenshots()

§ SettingsFromXML()

§ SettingsInitialized()

§ SettingsLoaded()

§ SettingsToXML()

§ Summary()

§ Type()

§ UpdateSetting()

§ UpdateSettingBool()

§ UpdateSettingInt()

§ UpdateSettingNumber()

§ UpdateSettingString()

§ Version()

Member Data Documentation

§ m_addonInfo

§ m_userSettingsPath