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 <string_view>
  33 #include <thread>
  34
  35 namespace com::sun::star::uno { class XComponentContext; }
  36
  37 namespace desktop
  38 {
  39
  40 /*--------------------------------------------------------------------
  41     Description:    Application-class
  42  --------------------------------------------------------------------*/
  43 class CommandLineArgs;
  44 class Lockfile;
  45 struct ConvertData;
  46 class Desktop final : public Application
  47 {
  48     int doShutdown();
  49
  50     public:
  51         enum BootstrapError
  52         {
  53             BE_OK,
  54             BE_UNO_SERVICEMANAGER,
  55             BE_UNO_SERVICE_CONFIG_MISSING,
  56             BE_PATHINFO_MISSING,
  57             BE_USERINSTALL_FAILED,
  58             BE_LANGUAGE_MISSING,
  59             BE_USERINSTALL_NOTENOUGHDISKSPACE,
  60             BE_USERINSTALL_NOWRITEACCESS,
  61             BE_OFFICECONFIG_BROKEN
  62         };
  63         enum BootstrapStatus
  64         {
  65             BS_OK,
  66             BS_TERMINATE
  67         };
  68
  69                                 Desktop();
  70                                 virtual ~Desktop() override;
  71         virtual int             Main( ) override;
  72         virtual void            Init() override;
  73         virtual void            InitFinished() override;
  74         virtual void            DeInit() override;
  75         virtual bool            QueryExit() override;
  76         virtual void            Shutdown() override;
  77         virtual void            Exception(ExceptionCategory nCategory) override;
  78         virtual void            OverrideSystemSettings( AllSettings& rSettings ) override;
  79         virtual void            AppEvent( const ApplicationEvent& rAppEvent ) override;
  80
  81         DECL_LINK( OpenClients_Impl, void*, void );
  82
  83         static void             OpenClients();
  84         static void             OpenDefault();
  85         static void             CheckOpenCLCompute(const css::uno::Reference<css::frame::XDesktop2> &);
  86
  87         DECL_STATIC_LINK( Desktop, EnableAcceptors_Impl, void*, void);
  88
  89         static void             HandleAppEvent( const ApplicationEvent& rAppEvent );
  90         static CommandLineArgs& GetCommandLineArgs();
  91
  92         static void             HandleBootstrapErrors(
  93                                     BootstrapError nError, OUString const & aMessage );
  94         void                    SetBootstrapError(
  95                                     BootstrapError nError, OUString const & aMessage )
  96         {
  97             if ( m_aBootstrapError == BE_OK )
  98             {
  99                 SAL_INFO("desktop.app", "SetBootstrapError: " << nError << " '" << aMessage << "'");
 100                 m_aBootstrapError = nError;
 101                 m_aBootstrapErrorMessage = aMessage;
 102             }
 103         }
 104
 105         void                    SetBootstrapStatus( BootstrapStatus nStatus )
 106         {
 107             m_aBootstrapStatus = nStatus;
 108         }
 109         BootstrapStatus          GetBootstrapStatus() const
 110         {
 111             return m_aBootstrapStatus;
 112         }
 113
 114         // first-start (ever) related methods
 115         static bool             CheckExtensionDependencies();
 116
 117         static void             SynchronizeExtensionRepositories(bool bCleanedExtensionCache, Desktop* pDesktop = nullptr);
 118         void                    SetSplashScreenText( const OUString& rText );
 119         void                    SetSplashScreenProgress( sal_Int32 );
 120
 121         // Bootstrap methods
 122         static void             InitApplicationServiceManager();
 123             // throws an exception upon failure
 124
 125     private:
 126         void                    RegisterServices();
 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, std::u16string_view 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: */