desktop/inc/app.hxx

   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:
  50         enum BootstrapError
  51         {
  52             BE_OK,
  53             BE_UNO_SERVICEMANAGER,
  54             BE_UNO_SERVICE_CONFIG_MISSING,
  55             BE_PATHINFO_MISSING,
  56             BE_USERINSTALL_FAILED,
  57             BE_LANGUAGE_MISSING,
  58             BE_USERINSTALL_NOTENOUGHDISKSPACE,
  59             BE_USERINSTALL_NOWRITEACCESS,
  60             BE_OFFICECONFIG_BROKEN
  61         };
  62         enum BootstrapStatus
  63         {
  64             BS_OK,
  65             BS_TERMINATE
  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 );
  89         static CommandLineArgs& GetCommandLineArgs();
  90
  91         static void             HandleBootstrapErrors(
  92                                     BootstrapError nError, OUString const & aMessage );
  93         void                    SetBootstrapError(
  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
 104         void                    SetBootstrapStatus( BootstrapStatus nStatus )
 105         {
 106             m_aBootstrapStatus = nStatus;
 107         }
 108         BootstrapStatus          GetBootstrapStatus() const
 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 );
 150         /** checks if the office is run the first time
 151             <p>If so, <method>DoFirstRunInitializations</method> is called (asynchronously and delayed) and the
 152             respective flag in the configuration is reset.</p>
 153         */
 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
 162         bool                    m_bCleanedExtensionCache;
 163         bool                    m_bServicesRegistered;
 164         BootstrapError          m_aBootstrapError;
 165         OUString                m_aBootstrapErrorMessage;
 166         BootstrapStatus         m_aBootstrapStatus;
 167
 168         std::unique_ptr<Lockfile> m_xLockfile;
 169         Timer                   m_firstRunTimer;
 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: */