mojo/runner/native_application_support.h

   1 // Copyright 2014 The Chromium Authors. All rights reserved.
   2 // Use of this source code is governed by a BSD-style license that can be
   3 // found in the LICENSE file.
   4
   5 #ifndef MOJO_RUNNER_NATIVE_APPLICATION_SUPPORT_H_
   6 #define MOJO_RUNNER_NATIVE_APPLICATION_SUPPORT_H_
   7
   8 #include "base/native_library.h"
   9 #include "mojo/public/cpp/bindings/interface_request.h"
  10 #include "mojo/shell/native_runner.h"
  11
  12 namespace base {
  13 class FilePath;
  14 }
  15
  16 namespace mojo {
  17
  18 class Application;
  19
  20 namespace runner {
  21
  22 // Loads the native Mojo application from the DSO specified by |app_path|.
  23 // Returns the |base::NativeLibrary| for the application on success (or null on
  24 // failure).
  25 //
  26 // Note: The caller may choose to eventually unload the returned DSO. If so,
  27 // this should be done only after the thread on which |LoadNativeApplication()|
  28 // and |RunNativeApplication()| were called has terminated, so that any
  29 // thread-local destructors have been executed.
  30 base::NativeLibrary LoadNativeApplication(const base::FilePath& app_path);
  31
  32 // Runs the native Mojo application from the DSO that was loaded using
  33 // |LoadNativeApplication()|; this tolerates |app_library| being null. This
  34 // should be called on the same thread as |LoadNativeApplication()|. Returns
  35 // true if |MojoMain()| was called (even if it returns an error), and false
  36 // otherwise.
  37 // TODO(vtl): Maybe this should also have a |MojoResult| as an out parameter?
  38 bool RunNativeApplication(base::NativeLibrary app_library,
  39                           InterfaceRequest<Application> application_request);
  40
  41 }  // namespace runner
  42 }  // namespace mojo
  43
  44 #endif  // MOJO_RUNNER_NATIVE_APPLICATION_SUPPORT_H_