/// <summary>
/// <para>设置一个 Chromium 浏览器 启动选项 的对象，并返回这个对象；此方法兼容 Windows7 / Windows Server 2008</para>
/// <para>异常可能：程序运行目录下 Chromium 浏览器不可用。</para>
/// </summary>
/// <param name="checkIsDownload">检查 是否下载 Chromium 浏览器；默认 false</param>
/// <param name="isDisplay">Chromium 运行时 是否显示界面；默认 true</param>
/// <param name="args">要传递给 Chromium 浏览器实例的其他参数。（ 此方法会自动传入 "--no-sandbox" 参数 ）
/// <para>参考：https://peter.sh/experiments/chromium-command-line-switches/#no-sandbox </para>
/// </param>
/// <param name="ignoredDefaultArgs">如果给出数组，则过滤掉给定的 Puppeteer.DefaultArgs 默认参数。
/// （ 此方法会自动设置 "--enable-automation" 过滤掉这个参数 ）
/// <para>参考：https://peter.sh/experiments/chromium-command-line-switches/#no-sandbox </para>
/// </param>
/// <returns></returns>
private static async Task <LaunchOptions> SetChromiumLaunchOptions(
bool checkIsDownload = false,
bool isDisplay = true,
string[] args = null,
string[] ignoredDefaultArgs = null)
{
return(await Task.Run(async() =>
{
BrowserFetcher browserFetcher = Puppeteer.CreateBrowserFetcher(new BrowserFetcherOptions());
RevisionInfo revisionInfo = browserFetcher.RevisionInfo(BrowserFetcher.DefaultRevision);
#region 检查下载 Chromium
if (!(revisionInfo.Downloaded && revisionInfo.Local))
{
if (checkIsDownload)
{
#region 载地址 解析；参考于源代码：https://github.com/hardkoded/puppeteer-sharp/blob/37ea56934281209830254df3ec3ffe37c57cfac2/lib/PuppeteerSharp/BrowserFetcher.cs
// https://storage.googleapis.com/chromium-browser-snapshots/Win_x64/706915/chrome-win.zip 下载地址（ 样例 ）
// const string DefaultDownloadHost = "https://storage.googleapis.com";
// const int DefaultRevision = 706915;
// [Platform.Linux] = "{0}/chromium-browser-snapshots/Linux_x64/{1}/{2}.zip",
// [Platform.MacOS] = "{0}/chromium-browser-snapshots/Mac/{1}/{2}.zip",
// [Platform.Win32] = "{0}/chromium-browser-snapshots/Win/{1}/{2}.zip",
// [Platform.Win64] = "{0}/chromium-browser-snapshots/Win_x64/{1}/{2}.zip"
// case Platform.Linux:
// return "chrome-linux";
// case Platform.MacOS:
// return "chrome-mac";
// case Platform.Win32:
// case Platform.Win64:
// return revision > 591479 ? "chrome-win" : "chrome-win32";
#endregion
// 检查 revisionInfo.Revision 这个版本的 Chromium 浏览器 是否 可下载
bool isCan = await browserFetcher.CanDownloadAsync(revisionInfo.Revision);
if (isCan)
{
// 下载 revisionInfo.Revision 这个版本的无头浏览器；可能需要等待一些时间
await browserFetcher.DownloadAsync(revisionInfo.Revision);
}
else
{
throw new Exception($"程序检测出 Chromium 浏览器（默认版本 {revisionInfo.Revision}）无法更新！");
}
}
else
{
throw new Exception("程序运行目录下 Chromium 浏览器不可用。请开发人员检查 程序运行目录下 是否正确安装 Chromium 浏览器。");
}
}
#endregion
#region 兼容 Windows7 / Windows Server 2008
LaunchOptions launchOptions = default(LaunchOptions);
// 这个判断是为了兼容 Windows7 和 Windows Server 2008
if (OSHelper.IsWin7Under())
{
launchOptions = new LaunchOptions
{
WebSocketFactory = async(uri, socketOptions, cancellationToken) =>
{
WebSocket client = SystemClientWebSocket.CreateClientWebSocket();
if (client is System.Net.WebSockets.Managed.ClientWebSocket managed)
{
managed.Options.KeepAliveInterval = TimeSpan.FromSeconds(0);
await managed.ConnectAsync(uri, cancellationToken);
}
else
{
ClientWebSocket coreSocket = client as ClientWebSocket;
coreSocket.Options.KeepAliveInterval = TimeSpan.FromSeconds(0);
await coreSocket.ConnectAsync(uri, cancellationToken);
}
return client;
}
};
}
else
{
launchOptions = new LaunchOptions();
}
#endregion
#region 设置 Args 参数
string[] argss = default(string[]);
if (args != null && args.Length > 0)
{
List <string> argsList = args.ToList <string>();
argsList.Add("--no-sandbox");
argss = argsList.ToArray();
}
else
{
argss = new string[] { "--no-sandbox" };
}
launchOptions.Args = argss; //这些参数将会传递给 Chromium
#endregion
#region 设置 IgnoredDefaultArgs 参数
string[] defaultArgs = default(string[]);
if (ignoredDefaultArgs != null && ignoredDefaultArgs.Length > 0)
{
List <string> ignoredDefaultArgsList = ignoredDefaultArgs.ToList <string>();
ignoredDefaultArgsList.Add("--enable-automation");
defaultArgs = ignoredDefaultArgsList.ToArray();
}
else
{
defaultArgs = new string[] { "--enable-automation" };
}
launchOptions.IgnoredDefaultArgs = defaultArgs; //这些参数将被 Chromium 忽略
#endregion
launchOptions.Headless = !isDisplay; // Headless : true 是无头模式，无界面；false，有界面
return launchOptions;
}));
}
/// <summary>
/// <para>设置一个 Chromium 浏览器 启动选项 的对象，并返回这个对象；此方法兼容 Windows7 / Windows Server 2008</para>
/// <para>异常可能：程序运行目录下 Chromium 浏览器不可用。</para>
/// </summary>
/// <param name="checkIsDownload">检查 是否下载 Chromium 浏览器；默认 false</param>
/// <param name="isDisplay">Chromium 运行时 是否显示界面；默认 true</param>
/// <param name="args">要传递给 Chromium 浏览器实例的其他参数。（ 此方法会自动传入 "--no-sandbox" 参数 ）
/// <para>参考：https://peter.sh/experiments/chromium-command-line-switches/#no-sandbox </para>
/// </param>
/// <param name="ignoredDefaultArgs">如果给出数组，则过滤掉给定的 Puppeteer.DefaultArgs 默认参数。
/// （ 此方法会自动设置 "--enable-automation" 过滤掉这个参数 ）
/// <para>参考：https://peter.sh/experiments/chromium-command-line-switches/#no-sandbox </para>
/// </param>
/// <returns></returns>
private static async Task <LaunchOptions> SetChromiumLaunchOptions(
bool checkIsDownload = false,
bool isDisplay = true,
string[] args = null,
string[] ignoredDefaultArgs = null)
{
return(await Task.Run(async() =>
{
BrowserFetcher browserFetcher = Puppeteer.CreateBrowserFetcher(new BrowserFetcherOptions());
RevisionInfo revisionInfo = browserFetcher.RevisionInfo(BrowserFetcher.DefaultChromiumRevision);
#region 检查下载 Chromium
if (!(revisionInfo.Downloaded && revisionInfo.Local))
{
if (checkIsDownload)
{
// 检查 revisionInfo.Revision 这个版本的 Chromium 浏览器 是否 可下载
bool isCan = await browserFetcher.CanDownloadAsync(revisionInfo.Revision);
if (isCan)
{
// 下载 revisionInfo.Revision 这个版本的无头浏览器；可能需要等待一些时间
await browserFetcher.DownloadAsync(revisionInfo.Revision);
}
else
{
throw new Exception($"程序检测出 Chromium 浏览器（默认版本 {revisionInfo.Revision}）无法更新！");
}
}
else
{
throw new Exception("程序运行目录下 Chromium 浏览器不可用。请开发人员检查 程序运行目录下 是否正确安装 Chromium 浏览器。");
}
}
#endregion
#region 兼容 Windows7 / Windows Server 2008
LaunchOptions launchOptions = default(LaunchOptions);
// 这个判断是为了兼容 Windows7 和 Windows Server 2008
if (OSHelper.IsWin7Under())
{
launchOptions = new LaunchOptions
{
WebSocketFactory = async(uri, socketOptions, cancellationToken) =>
{
WebSocket client = SystemClientWebSocket.CreateClientWebSocket();
if (client is System.Net.WebSockets.Managed.ClientWebSocket managed)
{
managed.Options.KeepAliveInterval = TimeSpan.FromSeconds(0);
await managed.ConnectAsync(uri, cancellationToken);
}
else
{
ClientWebSocket coreSocket = client as ClientWebSocket;
coreSocket.Options.KeepAliveInterval = TimeSpan.FromSeconds(0);
await coreSocket.ConnectAsync(uri, cancellationToken);
}
return client;
}
};
}
else
{
launchOptions = new LaunchOptions();
}
#endregion
#region 设置 Args 参数
string[] argss = default(string[]);
if (args != null && args.Length > 0)
{
List <string> argsList = args.ToList <string>();
argsList.Add("--no-sandbox");
argss = argsList.ToArray();
}
else
{
argss = new string[] { "--no-sandbox" };
}
launchOptions.Args = argss; // 这些参数将会传递给 Chromium
#endregion
#region 设置 IgnoredDefaultArgs 参数
string[] defaultArgs = default(string[]);
if (ignoredDefaultArgs != null && ignoredDefaultArgs.Length > 0)
{
List <string> ignoredDefaultArgsList = ignoredDefaultArgs.ToList <string>();
ignoredDefaultArgsList.Add("--enable-automation");
defaultArgs = ignoredDefaultArgsList.ToArray();
}
else
{
defaultArgs = new string[] { "--enable-automation" };
}
launchOptions.IgnoredDefaultArgs = defaultArgs; // 这些参数将被 Chromium 忽略
#endregion
launchOptions.Headless = !isDisplay; // Headless : true 是无头模式，无界面；false，有界面
return launchOptions;
}));
}
