juce/source/src/application/juce_Application.cpp

   1 /*
   2   ==============================================================================
   3
   4    This file is part of the JUCE library - "Jules' Utility Class Extensions"
   5    Copyright 2004-11 by Raw Material Software Ltd.
   6
   7   ------------------------------------------------------------------------------
   8
   9    JUCE can be redistributed and/or modified under the terms of the GNU General
  10    Public License (Version 2), as published by the Free Software Foundation.
  11    A copy of the license is included in the JUCE distribution, or can be found
  12    online at www.gnu.org/licenses.
  13
  14    JUCE is distributed in the hope that it will be useful, but WITHOUT ANY
  15    WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR
  16    A PARTICULAR PURPOSE.  See the GNU General Public License for more details.
  17
  18   ------------------------------------------------------------------------------
  19
  20    To release a closed-source product which uses JUCE, commercial licenses are
  21    available: visit www.rawmaterialsoftware.com/juce for more information.
  22
  23   ==============================================================================
  24 */
  25
  26 #include "../core/juce_StandardHeader.h"
  27
  28 BEGIN_JUCE_NAMESPACE
  29
  30 #include "juce_Application.h"
  31 #include "../events/juce_MessageManager.h"
  32 #include "../core/juce_Initialisation.h"
  33 #include "../threads/juce_Process.h"
  34 #include "../core/juce_PlatformUtilities.h"
  35 #include "../text/juce_LocalisedStrings.h"
  36
  37 #if JUCE_MAC
  38  extern void juce_initialiseMacMainMenu();
  39 #endif
  40
  41 //==============================================================================
  42 class AppBroadcastCallback  : public ActionListener
  43 {
  44 public:
  45     AppBroadcastCallback()    { MessageManager::getInstance()->registerBroadcastListener (this); }
  46     ~AppBroadcastCallback()   { MessageManager::getInstance()->deregisterBroadcastListener (this); }
  47
  48     void actionListenerCallback (const String& message)
  49     {
  50         JUCEApplication* const app = JUCEApplication::getInstance();
  51
  52         if (app != 0 && message.startsWith (app->getApplicationName() + "/"))
  53             app->anotherInstanceStarted (message.substring (app->getApplicationName().length() + 1));
  54     }
  55 };
  56
  57 //==============================================================================
  58 JUCEApplication::JUCEApplication()
  59     : appReturnValue (0),
  60       stillInitialising (true)
  61 {
  62     jassert (isStandaloneApp() && appInstance == nullptr);
  63     appInstance = this;
  64 }
  65
  66 JUCEApplication::~JUCEApplication()
  67 {
  68     if (appLock != nullptr)
  69     {
  70         appLock->exit();
  71         appLock = nullptr;
  72     }
  73
  74     jassert (appInstance == this);
  75     appInstance = nullptr;
  76 }
  77
  78 JUCEApplication::CreateInstanceFunction JUCEApplication::createInstance = 0;
  79 JUCEApplication* JUCEApplication::appInstance = nullptr;
  80
  81 //==============================================================================
  82 bool JUCEApplication::moreThanOneInstanceAllowed()
  83 {
  84     return true;
  85 }
  86
  87 void JUCEApplication::anotherInstanceStarted (const String&)
  88 {
  89 }
  90
  91 void JUCEApplication::systemRequestedQuit()
  92 {
  93     quit();
  94 }
  95
  96 void JUCEApplication::quit()
  97 {
  98     MessageManager::getInstance()->stopDispatchLoop();
  99 }
 100
 101 void JUCEApplication::setApplicationReturnValue (const int newReturnValue) noexcept
 102 {
 103     appReturnValue = newReturnValue;
 104 }
 105
 106 //==============================================================================
 107 void JUCEApplication::unhandledException (const std::exception*,
 108                                           const String&,
 109                                           const int)
 110 {
 111     jassertfalse;
 112 }
 113
 114 void JUCEApplication::sendUnhandledException (const std::exception* const e,
 115                                               const char* const sourceFile,
 116                                               const int lineNumber)
 117 {
 118     if (appInstance != nullptr)
 119         appInstance->unhandledException (e, sourceFile, lineNumber);
 120 }
 121
 122 //==============================================================================
 123 ApplicationCommandTarget* JUCEApplication::getNextCommandTarget()
 124 {
 125     return nullptr;
 126 }
 127
 128 void JUCEApplication::getAllCommands (Array <CommandID>& commands)
 129 {
 130     commands.add (StandardApplicationCommandIDs::quit);
 131 }
 132
 133 void JUCEApplication::getCommandInfo (const CommandID commandID, ApplicationCommandInfo& result)
 134 {
 135     if (commandID == StandardApplicationCommandIDs::quit)
 136     {
 137         result.setInfo (TRANS("Quit"),
 138                         TRANS("Quits the application"),
 139                         "Application",
 140                         0);
 141
 142         result.defaultKeypresses.add (KeyPress ('q', ModifierKeys::commandModifier, 0));
 143     }
 144 }
 145
 146 bool JUCEApplication::perform (const InvocationInfo& info)
 147 {
 148     if (info.commandID == StandardApplicationCommandIDs::quit)
 149     {
 150         systemRequestedQuit();
 151         return true;
 152     }
 153
 154     return false;
 155 }
 156
 157 //==============================================================================
 158 bool JUCEApplication::initialiseApp (const String& commandLine)
 159 {
 160     commandLineParameters = commandLine.trim();
 161
 162    #if ! JUCE_IOS
 163     jassert (appLock == nullptr); // initialiseApp must only be called once!
 164
 165     if (! moreThanOneInstanceAllowed())
 166     {
 167         appLock = new InterProcessLock ("juceAppLock_" + getApplicationName());
 168
 169         if (! appLock->enter(0))
 170         {
 171             appLock = nullptr;
 172             MessageManager::broadcastMessage (getApplicationName() + "/" + commandLineParameters);
 173
 174             DBG ("Another instance is running - quitting...");
 175             return false;
 176         }
 177     }
 178    #endif
 179
 180     // let the app do its setting-up..
 181     initialise (commandLineParameters);
 182
 183    #if JUCE_MAC
 184     juce_initialiseMacMainMenu(); // needs to be called after the app object has created, to get its name
 185    #endif
 186
 187    #if ! JUCE_IOS
 188     broadcastCallback = new AppBroadcastCallback();
 189    #endif
 190
 191     stillInitialising = false;
 192     return true;
 193 }
 194
 195 int JUCEApplication::shutdownApp()
 196 {
 197     jassert (appInstance == this);
 198
 199     broadcastCallback = nullptr;
 200
 201     JUCE_TRY
 202     {
 203         // give the app a chance to clean up..
 204         shutdown();
 205     }
 206     JUCE_CATCH_EXCEPTION
 207
 208     return getApplicationReturnValue();
 209 }
 210
 211 // This is called on the Mac and iOS where the OS doesn't allow the stack to unwind on shutdown..
 212 void JUCEApplication::appWillTerminateByForce()
 213 {
 214     {
 215         const ScopedPointer<JUCEApplication> app (JUCEApplication::getInstance());
 216
 217         if (app != nullptr)
 218             app->shutdownApp();
 219     }
 220
 221     shutdownJuce_GUI();
 222 }
 223
 224 //==============================================================================
 225 #if ! JUCE_ANDROID
 226 int JUCEApplication::main (const String& commandLine)
 227 {
 228     ScopedJuceInitialiser_GUI libraryInitialiser;
 229     jassert (createInstance != nullptr);
 230     int returnCode = 0;
 231
 232     {
 233         const ScopedPointer<JUCEApplication> app (createInstance());
 234
 235         if (! app->initialiseApp (commandLine))
 236             return 0;
 237
 238         JUCE_TRY
 239         {
 240             // loop until a quit message is received..
 241             MessageManager::getInstance()->runDispatchLoop();
 242         }
 243         JUCE_CATCH_EXCEPTION
 244
 245         returnCode = app->shutdownApp();
 246     }
 247
 248     return returnCode;
 249 }
 250
 251 #if JUCE_IOS
 252  extern int juce_iOSMain (int argc, const char* argv[]);
 253 #endif
 254
 255 #if ! JUCE_WINDOWS
 256  extern const char* juce_Argv0;
 257 #endif
 258
 259 int JUCEApplication::main (int argc, const char* argv[])
 260 {
 261     JUCE_AUTORELEASEPOOL
 262
 263    #if ! JUCE_WINDOWS
 264     jassert (createInstance != nullptr);
 265     juce_Argv0 = argv[0];
 266    #endif
 267
 268    #if JUCE_IOS
 269     return juce_iOSMain (argc, argv);
 270    #else
 271     String cmd;
 272     for (int i = 1; i < argc; ++i)
 273         cmd << argv[i] << ' ';
 274
 275     return JUCEApplication::main (cmd);
 276    #endif
 277 }
 278 #endif
 279
 280 END_JUCE_NAMESPACE