LibreOffice Module desktop (master)  1
app.hxx
Go to the documentation of this file.
1 /* -*- Mode: C++; tab-width: 4; indent-tabs-mode: nil; c-basic-offset: 4 -*- */
2 /*
3  * This file is part of the LibreOffice project.
4  *
5  * This Source Code Form is subject to the terms of the Mozilla Public
6  * License, v. 2.0. If a copy of the MPL was not distributed with this
7  * file, You can obtain one at http://mozilla.org/MPL/2.0/.
8  *
9  * This file incorporates work covered by the following license notice:
10  *
11  * Licensed to the Apache Software Foundation (ASF) under one or more
12  * contributor license agreements. See the NOTICE file distributed
13  * with this work for additional information regarding copyright
14  * ownership. The ASF licenses this file to you under the Apache
15  * License, Version 2.0 (the "License"); you may not use this file
16  * except in compliance with the License. You may obtain a copy of
17  * the License at http://www.apache.org/licenses/LICENSE-2.0 .
18  */
19 
20 #pragma once
21 
22 #include <optional>
23 #include <sal/log.hxx>
24 #include <vcl/svapp.hxx>
25 #include <vcl/timer.hxx>
26 #include <unotools/bootstrap.hxx>
27 #include <com/sun/star/frame/XDesktop2.hpp>
28 #include <com/sun/star/task/XStatusIndicator.hpp>
29 #include <com/sun/star/uno/Reference.h>
30 
31 #include <memory>
32 #include <thread>
33 
34 namespace com::sun::star::uno { class XComponentContext; }
35 
36 namespace desktop
37 {
38 
39 /*--------------------------------------------------------------------
40  Description: Application-class
41  --------------------------------------------------------------------*/
42 class CommandLineArgs;
43 class Lockfile;
44 struct ConvertData;
45 class Desktop final : public Application
46 {
47  int doShutdown();
48 
49  public:
51  {
61  };
63  {
66  };
67 
68  Desktop();
69  virtual ~Desktop() override;
70  virtual int Main( ) override;
71  virtual void Init() override;
72  virtual void InitFinished() override;
73  virtual void DeInit() override;
74  virtual bool QueryExit() override;
75  virtual void Shutdown() override;
76  virtual void Exception(ExceptionCategory nCategory) override;
77  virtual void OverrideSystemSettings( AllSettings& rSettings ) override;
78  virtual void AppEvent( const ApplicationEvent& rAppEvent ) override;
79 
80  DECL_LINK( OpenClients_Impl, void*, void );
81 
82  static void OpenClients();
83  static void OpenDefault();
84  static void CheckOpenCLCompute(const css::uno::Reference<css::frame::XDesktop2> &);
85 
86  DECL_STATIC_LINK( Desktop, EnableAcceptors_Impl, void*, void);
87 
88  static void HandleAppEvent( const ApplicationEvent& rAppEvent );
90 
91  static void HandleBootstrapErrors(
92  BootstrapError nError, OUString const & aMessage );
94  BootstrapError nError, OUString const & aMessage )
95  {
96  if ( m_aBootstrapError == BE_OK )
97  {
98  SAL_INFO("desktop.app", "SetBootstrapError: " << nError << " '" << aMessage << "'");
99  m_aBootstrapError = nError;
100  m_aBootstrapErrorMessage = aMessage;
101  }
102  }
103 
105  {
106  m_aBootstrapStatus = nStatus;
107  }
109  {
110  return m_aBootstrapStatus;
111  }
112 
113  // first-start (ever) related methods
114  static bool CheckExtensionDependencies();
115 
116  static void SynchronizeExtensionRepositories(bool bCleanedExtensionCache, Desktop* pDesktop = nullptr);
117  void SetSplashScreenText( const OUString& rText );
118  void SetSplashScreenProgress( sal_Int32 );
119 
120  // Bootstrap methods
121  static void InitApplicationServiceManager();
122  // throws an exception upon failure
123 
124  private:
125  void RegisterServices(
126  css::uno::Reference< css::uno::XComponentContext > const & context);
127  static void DeregisterServices();
128 
129  public:
130  static void CreateTemporaryDirectory();
131  static void RemoveTemporaryDirectory();
132 
133  private:
134  static bool InitializeConfiguration();
135  static void FlushConfiguration();
136  static bool InitializeQuickstartMode( const css::uno::Reference< css::uno::XComponentContext >& rxContext );
137 
138  static void HandleBootstrapPathErrors( ::utl::Bootstrap::Status, const OUString& aMsg );
139 
140  // Create an error message depending on bootstrap failure code and an optional file url
141  static OUString CreateErrorMsgString( utl::Bootstrap::FailureCode nFailureCode,
142  const OUString& aFileURL );
143 
144  css::uno::Reference<css::task::XStatusIndicator> m_rSplashScreen;
145  void OpenSplashScreen();
146  void CloseSplashScreen();
147 
148  DECL_STATIC_LINK( Desktop, ImplInitFilterHdl, ::ConvertData&, bool );
149  DECL_STATIC_LINK( Desktop, AsyncInitFirstRun, Timer*, void );
154  void CheckFirstRun( );
155 
156  static void ShowBackingComponent(Desktop * progress);
157 
158  // on-demand acceptors
159  static void createAcceptor(const OUString& aDescription);
160  static void destroyAcceptor(const OUString& aDescription);
161 
167 
168  std::unique_ptr<Lockfile> m_xLockfile;
170  std::thread m_aUpdateThread;
171 };
172 
173 OUString GetURL_Impl(
174  const OUString& rName, std::optional< OUString > const & cwdUrl );
175 
176 OUString ReplaceStringHookProc(const OUString& rStr);
177 
178 }
179 
180 /* vim:set shiftwidth=4 softtabstop=4 expandtab: */
static void destroyAcceptor(const OUString &aDescription)
Definition: appinit.cxx:200
css::uno::Reference< css::task::XStatusIndicator > m_rSplashScreen
Definition: app.hxx:144
static bool InitializeConfiguration()
Definition: app.cxx:1714
void OpenSplashScreen()
Definition: app.cxx:2372
virtual void AppEvent(const ApplicationEvent &rAppEvent) override
Definition: app.cxx:1167
static void HandleBootstrapPathErrors(::utl::Bootstrap::Status, const OUString &aMsg)
Definition: app.cxx:600
void CheckFirstRun()
checks if the office is run the first time
Definition: app.cxx:2514
static void CreateTemporaryDirectory()
Definition: appinit.cxx:227
DECL_STATIC_LINK(Desktop, EnableAcceptors_Impl, void *, void)
virtual void DeInit() override
Definition: app.cxx:525
OUString ReplaceStringHookProc(const OUString &rStr)
Definition: app.cxx:380
std::unique_ptr< Lockfile > m_xLockfile
Definition: app.hxx:168
OUString GetURL_Impl(const OUString &rName, std::optional< OUString > const &cwdUrl)
Definition: app.cxx:2178
void SetBootstrapStatus(BootstrapStatus nStatus)
Definition: app.hxx:104
static OUString CreateErrorMsgString(utl::Bootstrap::FailureCode nFailureCode, const OUString &aFileURL)
Definition: app.cxx:626
int doShutdown()
Definition: app.cxx:1601
Definition: app.cxx:159
void SetSplashScreenProgress(sal_Int32)
Definition: app.cxx:2424
BootstrapError m_aBootstrapError
Definition: app.hxx:164
static void ShowBackingComponent(Desktop *progress)
Definition: app.cxx:2465
virtual void OverrideSystemSettings(AllSettings &rSettings) override
Definition: app.cxx:1823
static void FlushConfiguration()
Definition: app.cxx:1780
BootstrapStatus m_aBootstrapStatus
Definition: app.hxx:166
static void InitApplicationServiceManager()
Definition: appinit.cxx:65
ExceptionCategory
virtual ~Desktop() override
Definition: app.cxx:420
virtual void Init() override
Definition: app.cxx:424
static void DeregisterServices()
Definition: appinit.cxx:221
void RegisterServices(css::uno::Reference< css::uno::XComponentContext > const &context)
Definition: appinit.cxx:88
Timer m_firstRunTimer
Definition: app.hxx:169
static void RemoveTemporaryDirectory()
Definition: appinit.cxx:262
static void HandleBootstrapErrors(BootstrapError nError, OUString const &aMessage)
Definition: app.cxx:717
void SetBootstrapError(BootstrapError nError, OUString const &aMessage)
Definition: app.hxx:93
bool m_bCleanedExtensionCache
Definition: app.hxx:162
static CommandLineArgs & GetCommandLineArgs()
Definition: app.cxx:375
void SetSplashScreenText(const OUString &rText)
Definition: app.cxx:2432
static void OpenDefault()
Definition: app.cxx:2121
static void createAcceptor(const OUString &aDescription)
Definition: appinit.cxx:131
virtual void Shutdown() override
Definition: app.cxx:595
OUString m_aBootstrapErrorMessage
Definition: app.hxx:165
bool m_bServicesRegistered
Definition: app.hxx:163
std::thread m_aUpdateThread
Definition: app.hxx:170
static void HandleAppEvent(const ApplicationEvent &rAppEvent)
Definition: app.cxx:2227
static void CheckOpenCLCompute(const css::uno::Reference< css::frame::XDesktop2 > &)
static void SynchronizeExtensionRepositories(bool bCleanedExtensionCache, Desktop *pDesktop=nullptr)
#define SAL_INFO(area, stream)
virtual void InitFinished() override
Definition: app.cxx:520
static bool InitializeQuickstartMode(const css::uno::Reference< css::uno::XComponentContext > &rxContext)
Definition: app.cxx:1788
DECL_LINK(OpenClients_Impl, void *, void)
virtual void Exception(ExceptionCategory nCategory) override
Definition: app.cxx:1106
static void OpenClients()
Definition: app.cxx:1908
virtual int Main() override
Definition: app.cxx:1223
virtual bool QueryExit() override
Definition: app.cxx:553
void CloseSplashScreen()
Definition: app.cxx:2440
static bool CheckExtensionDependencies()
BootstrapStatus GetBootstrapStatus() const
Definition: app.hxx:108