2019-10-02 12:25:34 +10:00
|
|
|
// Copyright © 2019 The CefSharp Authors. All rights reserved.
|
|
|
|
|
//
|
|
|
|
|
// Use of this source code is governed by a BSD-style license that can be found in the LICENSE file.
|
|
|
|
|
|
|
|
|
|
#pragma once
|
|
|
|
|
|
|
|
|
|
#include "Stdafx.h"
|
|
|
|
|
|
|
|
|
|
#include "SubProcess.h"
|
|
|
|
|
|
|
|
|
|
using namespace System;
|
|
|
|
|
using namespace CefSharp::Internals;
|
|
|
|
|
|
|
|
|
|
namespace CefSharp
|
|
|
|
|
{
|
|
|
|
|
namespace BrowserSubprocess
|
|
|
|
|
{
|
|
|
|
|
/// <summary>
|
|
|
|
|
/// BrowserSubprocessExecutable provides the fundimental browser process handling for
|
|
|
|
|
/// CefSharp.BrowserSubprocess.exe and can be used to self host the BrowserSubProcess in your
|
|
|
|
|
/// existing application (preferred approach for .Net Core).
|
|
|
|
|
/// </summary>
|
|
|
|
|
public ref class BrowserSubprocessExecutable
|
|
|
|
|
{
|
|
|
|
|
public:
|
|
|
|
|
BrowserSubprocessExecutable()
|
|
|
|
|
{
|
|
|
|
|
|
|
|
|
|
}
|
|
|
|
|
|
2023-08-20 08:53:22 +10:00
|
|
|
#ifdef NETCOREAPP
|
2020-03-06 15:50:17 +10:00
|
|
|
/// <summary>
|
|
|
|
|
/// This function should be called from the application entry point function (typically Program.Main)
|
2022-03-21 10:01:26 +10:00
|
|
|
/// to execute a secondary process e.g. gpu, renderer, utility
|
2020-03-06 15:50:17 +10:00
|
|
|
/// This overload is specifically used for .Net Core. For hosting your own BrowserSubProcess
|
|
|
|
|
/// it's preferable to use the Main method provided by this class.
|
|
|
|
|
/// </summary>
|
|
|
|
|
/// <returns>
|
|
|
|
|
/// If called for the browser process (identified by no "type" command-line value) it will return immediately
|
2020-11-25 16:17:49 +10:00
|
|
|
/// with a value of -1. If called for a recognized secondary process it will block until the process should exit
|
|
|
|
|
/// and then return the process exit code.
|
|
|
|
|
/// </returns
|
2020-11-26 09:27:35 +10:00
|
|
|
static int MainSelfHost(array<String^>^ args)
|
2020-11-25 16:17:49 +10:00
|
|
|
{
|
|
|
|
|
auto subProcess = gcnew BrowserSubprocessExecutable();
|
|
|
|
|
return subProcess->Main(args, nullptr);
|
|
|
|
|
}
|
2023-08-20 08:53:22 +10:00
|
|
|
#endif
|
2020-11-25 16:17:49 +10:00
|
|
|
|
|
|
|
|
/// <summary>
|
|
|
|
|
/// This function should be called from the application entry point function (typically Program.Main)
|
2022-03-21 10:01:26 +10:00
|
|
|
/// to execute a secondary process e.g. gpu, renderer, utility
|
2020-11-25 16:17:49 +10:00
|
|
|
/// This overload is specifically used for .Net Core. For hosting your own BrowserSubProcess
|
|
|
|
|
/// it's preferable to use the Main method provided by this class.
|
|
|
|
|
/// - Obtains the command line args via a call to Environment::GetCommandLineArgs
|
|
|
|
|
/// </summary>
|
|
|
|
|
/// <returns>
|
|
|
|
|
/// If called for the browser process (identified by no "type" command-line value) it will return immediately
|
2020-03-06 15:50:17 +10:00
|
|
|
/// with a value of -1. If called for a recognized secondary process it will block until the process should exit
|
|
|
|
|
/// and then return the process exit code.
|
|
|
|
|
/// </returns
|
2020-03-12 17:53:46 +10:00
|
|
|
static int MainNetCore(IntPtr arg, int argLength)
|
2020-03-06 15:50:17 +10:00
|
|
|
{
|
|
|
|
|
auto args = Environment::GetCommandLineArgs();
|
|
|
|
|
|
|
|
|
|
auto subProcess = gcnew BrowserSubprocessExecutable();
|
|
|
|
|
return subProcess->Main(args, nullptr);
|
|
|
|
|
}
|
|
|
|
|
|
2019-10-02 12:25:34 +10:00
|
|
|
/// <summary>
|
|
|
|
|
/// This function should be called from the application entry point function (typically Program.Main)
|
2022-03-21 10:01:26 +10:00
|
|
|
/// to execute a secondary process e.g. gpu, renderer, utility
|
2019-10-02 12:25:34 +10:00
|
|
|
/// It can be used to run secondary processes (BrowserSubProcess) from your main applications executable
|
|
|
|
|
/// or from a separate executable specified by the CefSettings.BrowserSubprocessPath value.
|
|
|
|
|
/// CefSharp defaults to using the latter approach, a default implementation (CefSharp.BrowserSubProcess.exe) is
|
|
|
|
|
/// supplied, see https://github.com/cefsharp/CefSharp/wiki/General-Usage#processes for more details.
|
|
|
|
|
/// </summary>
|
|
|
|
|
/// <param name="args">command line args</param>
|
|
|
|
|
/// <returns>
|
|
|
|
|
/// If called for the browser process (identified by no "type" command-line value) it will return immediately
|
|
|
|
|
/// with a value of -1. If called for a recognized secondary process it will block until the process should exit
|
|
|
|
|
/// and then return the process exit code.
|
|
|
|
|
/// </returns
|
|
|
|
|
int Main(IEnumerable<String^>^ args)
|
|
|
|
|
{
|
|
|
|
|
return Main(args, nullptr);
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
/// <summary>
|
|
|
|
|
/// This function should be called from the application entry point function (typically Program.Main)
|
2022-03-21 10:01:26 +10:00
|
|
|
/// to execute a secondary process e.g. gpu, renderer, utility
|
2019-10-02 12:25:34 +10:00
|
|
|
/// It can be used to run secondary processes (BrowserSubProcess) from your main applications executable
|
|
|
|
|
/// or from a separate executable specified by the CefSettings.BrowserSubprocessPath value.
|
|
|
|
|
/// CefSharp defaults to using the latter approach, a default implementation (CefSharp.BrowserSubProcess.exe) is
|
|
|
|
|
/// supplied, see https://github.com/cefsharp/CefSharp/wiki/General-Usage#processes for more details.
|
|
|
|
|
/// </summary>
|
|
|
|
|
/// <param name="args">command line args</param>
|
|
|
|
|
/// <param name="handler">An option IRenderProcessHandler implementation, use null if no handler is required</param>
|
|
|
|
|
/// <returns>
|
|
|
|
|
/// If called for the browser process (identified by no "type" command-line value) it will return immediately
|
|
|
|
|
/// with a value of -1. If called for a recognized secondary process it will block until the process should exit
|
|
|
|
|
/// and then return the process exit code.
|
|
|
|
|
/// </returns>
|
|
|
|
|
int Main(IEnumerable<String^>^ args, IRenderProcessHandler^ handler)
|
|
|
|
|
{
|
|
|
|
|
auto type = CommandLineArgsParser::GetArgumentValue(args, CefSharpArguments::SubProcessTypeArgument);
|
|
|
|
|
|
2020-01-14 20:28:48 +10:00
|
|
|
if (String::IsNullOrEmpty(type))
|
|
|
|
|
{
|
|
|
|
|
//If --type param missing from command line CEF/Chromium assums
|
|
|
|
|
//this is the main process (as all subprocesses must have a type param).
|
|
|
|
|
//Return -1 to indicate this behaviour.
|
|
|
|
|
return -1;
|
|
|
|
|
}
|
|
|
|
|
|
2019-10-02 12:25:34 +10:00
|
|
|
auto parentProcessId = -1;
|
|
|
|
|
|
|
|
|
|
// The Crashpad Handler doesn't have any HostProcessIdArgument, so we must not try to
|
|
|
|
|
// parse it lest we want an ArgumentNullException.
|
2021-12-07 14:40:23 +10:00
|
|
|
if (type == "crashpad-handler")
|
2019-10-02 12:25:34 +10:00
|
|
|
{
|
2021-12-07 14:40:23 +10:00
|
|
|
//Lower the shutdown priority so the browser process is shutdown first (Issue #3155)
|
|
|
|
|
//The system terminates the process without displaying a retry dialog box for the user.
|
|
|
|
|
//Crashpad is lower than other sub processes so it can still monitor process exit crashes.
|
2021-12-09 10:06:43 +10:00
|
|
|
SetProcessShutdownParameters(0x100, SHUTDOWN_NORETRY);
|
2021-12-07 14:40:23 +10:00
|
|
|
}
|
|
|
|
|
else
|
|
|
|
|
{
|
|
|
|
|
//Lower the shutdown priority so the browser process is shutdown first (Issue #3155)
|
|
|
|
|
//The system terminates the process without displaying a retry dialog box for the user.
|
2021-12-09 10:06:43 +10:00
|
|
|
SetProcessShutdownParameters(0x200, SHUTDOWN_NORETRY);
|
2021-12-07 14:40:23 +10:00
|
|
|
|
2019-10-02 12:25:34 +10:00
|
|
|
parentProcessId = int::Parse(CommandLineArgsParser::GetArgumentValue(args, CefSharpArguments::HostProcessIdArgument));
|
|
|
|
|
if (CommandLineArgsParser::HasArgument(args, CefSharpArguments::ExitIfParentProcessClosed))
|
|
|
|
|
{
|
|
|
|
|
ParentProcessMonitor::StartMonitorTask(parentProcessId);
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
// Use our custom subProcess provides features like EvaluateJavascript
|
|
|
|
|
if (type == "renderer")
|
|
|
|
|
{
|
|
|
|
|
auto subProcess = GetSubprocess(args, parentProcessId, handler);
|
|
|
|
|
|
|
|
|
|
try
|
|
|
|
|
{
|
|
|
|
|
return subProcess->Run();
|
|
|
|
|
}
|
|
|
|
|
finally
|
|
|
|
|
{
|
|
|
|
|
delete subProcess;
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
return SubProcess::ExecuteProcess(args);
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
protected:
|
|
|
|
|
virtual SubProcess^ GetSubprocess(IEnumerable<String^>^ args, int parentProcessId, IRenderProcessHandler^ handler)
|
|
|
|
|
{
|
|
|
|
|
return gcnew SubProcess(handler, args);
|
|
|
|
|
}
|
|
|
|
|
};
|
|
|
|
|
}
|
|
|
|
|
}
|
