Key application class containing all critical elements of the application. More...

#include <application.h>

Collaboration diagram for Application:

Public Slots
void	checkForUpdatesOnBackground ()
	Schedules check for updates. More...

Signals
void	externalApplicationsRechecked ()
	Emitted if external applications are rechecked which happens usually if path to some of external application changes.

Public Member Functions
	Application (int &argc, char **argv)
	Constructor. More...

UpdateCheck	checkForUpdates ()
	Tries to download list with new updates. More...

Settings *	settings ()
	Access to application-wide settings. More...

QMutex *	closeLock () const
	Access to application-wide close lock. More...

SkinFactory *	skinFactory ()
	Access to application-wide skin facilities. More...

QString	zipUtilityPath ()
	Access to "zip" utility path. More...

void	setZipUtilityPath (const QString &zip_path)
	Sets new path to "zip". More...

QString	signApkUtlityPath ()
	Access to path to "signapk" utility. More...

void	setSignApkUtilityPath (const QString &signapk_path)
	Sets new path to "signapk". More...

QString	javaInterpreterPath ()
	Access to path to "java" interpreter. More...

void	setJavaInterpreterPath (const QString &java_path)
	Sets new "java" interpreter path. More...

int	checkJava (const QString &new_path=QString())
	Tests if binary in new_path is correct JAVA executable. More...

int	checkSignApk (const QString &new_path=QString(), const QString &java_path=QString())
	Tests if binary in new_path is correct SIGNAPK executable. More...

int	checkZip (const QString &new_path=QString())
	Tests if binary in new_path is correct ZIP executable. More...

void	recheckExternalApplications (bool emit_signals)

QString	interpretJava (int return_code)

QString	interpretZip (int return_code)

QString	interpretSignApk (int return_code)

FormMain *	mainForm ()
	Access to main application form. More...

void	setMainForm (FormMain *main_form)
	Setter for main application form. More...

QList< QAction * >	availableActions ()
	Access to all application-wide useable actions. More...

SystemTrayIcon *	trayIcon ()
	Access to application tray icon. More...

TemplateFactory *	templateManager ()
	Access to template high level manager. More...

bool	externalApplicationsReady () const

QString	externalApplicationsStatus () const

bool	externalApplicationChecked () const

bool	isClosing () const
	Application closing indication. More...

Static Public Member Functions
static Application *	instance ()
	Main static getter of global Application instance. More...

Detailed Description

Key application class containing all critical elements of the application.

See also: Settings, FormMain, UpdateInfo, SystemTrayIcon

Definition at line 63 of file application.h.

Constructor & Destructor Documentation

Application::Application	(	int &	argc,
		char **	argv
	)

explicit

Constructor.

Parameters

argc	Count of arguments passed to the executable file.
argv	Array of strings of arguments.

Definition at line 51 of file application.cpp.

   : QApplication(argc, argv),
     m_externalApplicationChecked(false),
     m_closeLock(new QMutex()),
     m_availableActions(QList<QAction*>()),
     m_settings(NULL),
     m_skinFactory(NULL),
     m_trayIcon(NULL),
     m_templateManager(NULL),
     m_closing(false) {
   connect(this, SIGNAL(aboutToQuit()), this, SLOT(onAboutToQuit()));
   connect(this, SIGNAL(commitDataRequest(QSessionManager&)), this, SLOT(onCommitData(QSessionManager&)));
   connect(this, SIGNAL(saveStateRequest(QSessionManager&)), this, SLOT(onSaveState(QSessionManager&)));
 }

Member Function Documentation

QList< QAction * > Application::availableActions ( )

Access to all application-wide useable actions.

Returns: Return list of user actions.

Definition at line 233 of file application.cpp.

                                               {
   if (m_mainForm == NULL) {
     return QList<QAction*>();
   }
   else {
     if (m_availableActions.isEmpty()) {
       m_availableActions = m_mainForm->allActions();
     }
 
     return m_availableActions;
   }
 }

Here is the call graph for this function:

UpdateCheck Application::checkForUpdates ( )

Tries to download list with new updates.

Returns: Returns pair of information: metadata of update and network status of update.

Definition at line 70 of file application.cpp.

                                          {
   return SystemFactory::checkForUpdates();
 }

Here is the call graph for this function:

Here is the caller graph for this function:

void Application::checkForUpdatesOnBackground ( )

slot

Schedules check for updates.

Check for updates is executed in separate thread. Result is announced via tray icon balloon tip. If tray icon is not available, then result is not announced and is suppressed.

Definition at line 316 of file application.cpp.

                                               {
   if (!settings()->value(APP_CFG_GEN,
                          "check_for_updates_startup",
                          true).toBool()) {
     qDebug("Checking for updates after application startup is not allowed.");
   }
   else {
     qDebug("Checking for updates after application has started.");
 
     QFutureWatcher<UpdateCheck> *watcher_for_future = new QFutureWatcher<UpdateCheck>(this);
 
     connect(watcher_for_future, SIGNAL(finished()), this, SLOT(handleBackgroundUpdatesCheck()));
     watcher_for_future->setFuture(QtConcurrent::run(this, &Application::checkForUpdates));
   }
 }

Here is the call graph for this function:

int Application::checkJava ( const QString & new_path = QString() )

Tests if binary in new_path is correct JAVA executable.

Parameters

new_path Path to JAVA executable.

Returns: Returns specific return code of JAVA executable.

Definition at line 90 of file application.cpp.

                                                   {
   QString java_path = new_path.isEmpty() ? javaInterpreterPath() : new_path;
 
   if (java_path.isEmpty()) {
     return EXIT_STATUS_NOT_STARTED;
   }
   else {
     QProcess process;
 
     process.setReadChannelMode(QProcess::MergedChannels);
     process.start(QDir::toNativeSeparators(java_path), QStringList() << "-version");
     process.waitForFinished(-1);
 
     return process.exitCode();
   }
 }

Here is the call graph for this function:

int Application::checkSignApk	(	const QString &	new_path = `QString()`,
		const QString &	java_path = `QString()`
	)

Tests if binary in new_path is correct SIGNAPK executable.

Parameters

new_path	Path to SIGNAPK executable.
java_path	Path to JAVA executable.

Returns: Returns specific return code of SIGNAPK executable.

Definition at line 107 of file application.cpp.

                                                                                {
   QString real_java_path = java_path.isEmpty() ? javaInterpreterPath() : java_path;
   QString signapk_path = new_path.isEmpty() ? signApkUtlityPath() : new_path;
 
   if (signapk_path.isEmpty()) {
     return EXIT_STATUS_NOT_STARTED;
   }
   else {
     QProcess process;
 
     process.setReadChannelMode(QProcess::MergedChannels);
     process.start(QDir::toNativeSeparators(real_java_path),
                   QStringList() << "-jar" << QDir::toNativeSeparators(signapk_path));
     process.waitForFinished(-1);
 
     return process.exitCode();
   }
 }

Here is the call graph for this function:

int Application::checkZip ( const QString & new_path = QString() )

Tests if binary in new_path is correct ZIP executable.

Parameters

new_path Path to ZIP executable.

Returns: Returns specific return code of ZIP executable.

Definition at line 126 of file application.cpp.

                                                  {
   QString zip_path = new_path.isEmpty() ? zipUtilityPath() : new_path;
 
   if (zip_path.isEmpty()) {
     return EXIT_STATUS_NOT_STARTED;
   }
   else {
     QProcess process;
 
     process.setReadChannelMode(QProcess::MergedChannels);
     process.start(QDir::toNativeSeparators(zip_path), QStringList() << "--version");
     process.waitForFinished(-1);
 
     return process.exitCode();
   }
 }

Here is the call graph for this function:

QMutex* Application::closeLock ( ) const

inline

Access to application-wide close lock.

Returns: Returns pointer to application-wide close lock.

Remarks: Application-wide close lock is used to determine if application can be closed securely.

Definition at line 92 of file application.h.

                                      {
       return m_closeLock;
     }

static Application* Application::instance ( )

inlinestatic

Main static getter of global Application instance.

Returns: Returns singleton for Application.

Definition at line 186 of file application.h.

                                           {
       return static_cast<Application*>(QCoreApplication::instance());
     }

bool Application::isClosing ( ) const

Application closing indication.

Returns: Returns true, if application is closing, otherwise returns false.

Definition at line 300 of file application.cpp.

                                   {
   return m_closing;
 }

QString Application::javaInterpreterPath ( )

inline

Access to path to "java" interpreter.

Returns: Returns path to "java" interpreter.

Definition at line 126 of file application.h.

                                          {
       return settings()->value(APP_CFG_GEN, "java_path", QString(APP_JAVA_PATH)).toString();
     }

Here is the call graph for this function:

Here is the caller graph for this function:

FormMain* Application::mainForm ( )

inline

Access to main application form.

Returns: Returns pointer to main application form.

Definition at line 160 of file application.h.

                                 {
       return m_mainForm;
     }

void Application::setJavaInterpreterPath ( const QString & java_path )

inline

Sets new "java" interpreter path.

Parameters

java_path New path to "java".

Definition at line 132 of file application.h.

                                                           {
       settings()->setValue(APP_CFG_GEN, "java_path", java_path);
     }

Here is the call graph for this function:

void Application::setMainForm ( FormMain * main_form )

inline

Setter for main application form.

Parameters

main_form Pointer to main application form.

Definition at line 166 of file application.h.

                                           {
       m_mainForm = main_form;
     }

void Application::setSignApkUtilityPath ( const QString & signapk_path )

Sets new path to "signapk".

Parameters

signapk_path New path to "signapk".

Definition at line 86 of file application.cpp.

                                                                    {
   settings()->value(APP_CFG_GEN, "signapk_path", signapk_path);
 }

Here is the call graph for this function:

Settings* Application::settings ( )

inline

Access to application-wide settings.

Returns

Definition at line 80 of file application.h.

                                 {
       if (m_settings == NULL) {
         m_settings = Settings::setupSettings(this);
       }
 
       return m_settings;
     }

Here is the call graph for this function:

Here is the caller graph for this function:

void Application::setZipUtilityPath ( const QString & zip_path )

Sets new path to "zip".

Parameters

zip_path Path to "zip".

Definition at line 82 of file application.cpp.

                                                            {
   settings()->setValue(APP_CFG_GEN, "zip_path", zip_path);
 }

Here is the call graph for this function:

QString Application::signApkUtlityPath ( )

inline

Access to path to "signapk" utility.

Returns: Return path to "signapk".

Definition at line 114 of file application.h.

                                        {
       return settings()->value(APP_CFG_GEN,
                                "signapk_path",
                                QString(APP_SIGNAPK_PATH)).toString();
     }

Here is the call graph for this function:

Here is the caller graph for this function:

SkinFactory * Application::skinFactory ( )

Access to application-wide skin facilities.

Returns: Returns pointer to skin facilities.

Definition at line 74 of file application.cpp.

                                       {
   if (m_skinFactory == NULL) {
     m_skinFactory = new SkinFactory(this);
   }
 
   return m_skinFactory;
 }

TemplateFactory * Application::templateManager ( )

Access to template high level manager.

See also: TemplateFactory

Definition at line 255 of file application.cpp.

                                               {
   if (m_templateManager == NULL) {
     m_templateManager = new TemplateFactory(this);
   }
 
   return m_templateManager;
 }

SystemTrayIcon * Application::trayIcon ( )

Access to application tray icon.

Returns: Returns pointer to application tray icon.

Warning: Always use this in cooperation with SystemTrayIcon::isSystemTrayActivated().

Definition at line 246 of file application.cpp.

                                       {
   if (m_trayIcon == NULL) {
     m_trayIcon = new SystemTrayIcon(APP_ICON_PATH, m_mainForm);
     m_trayIcon->setToolTip(APP_LONG_NAME);
   }
 
   return m_trayIcon;
 }

QString Application::zipUtilityPath ( )

inline

Access to "zip" utility path.

Returns: Returns path to "zip" utlity.

Definition at line 102 of file application.h.

                                     {
       return settings()->value(APP_CFG_GEN,
                                "zip_path",
                                QString(APP_ZIP_PATH)).toString();
     }

Here is the call graph for this function:

Here is the caller graph for this function:

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

Public Slots

Signals

Public Member Functions

Static Public Member Functions

Detailed Description

Constructor & Destructor Documentation

Member Function Documentation