如何通过网络部署 Chromium 二进制文件

在某些情况下，安装程序或部署包需要尽可能小，例如，发布应用程序的服务可能会受到限制。

另一方面，DotNetBrowser 使用自己的 Chromium 引擎，二进制文件必须部署在目标环境中。最直接的方法是将二进制文件作为安装程序的一部分提供，但是，这将会导致安装程序本身的大小增加。

可能的解决方案之一是在 DotNetBrowser 尝试定位它们时通过网络提供 Chromium 二进制文件。 DotNetBrowser 使用默认的 .NET 程序集加载逻辑来定位和加载二进制 DLL，因此可以使用 AppDomain.AssemblyResolve 事件来自定义整个过程并以非标准方式提供 DLL。

以下是对这一想法的一般描述：

注册 AppDomain.AssemblyResolve 事件的自定义处理程序。
在此处理程序中，筛选出与 DotNetBrowser 二进制文件相关的尝试。
当接收到相应的 AssemblyResolve 事件时，使用完全限定的程序集名称准备网络请求。
执行请求并获取字节数组形式的 DLL。
从字节加载 DLL 并从处理程序返回它。

执行所述操作以加载二进制文件 DLL 的示例应用程序的代码在 GitHub 存储库中作为 Visual Studio 项目提供： C#, VB.NET

该示例本身是一个 WPF 应用程序，但该方法并非特定于 WPF ，也可以在 WinForms 和控制台应用程序中使用。

下文将详细介绍该示例的实现过程，并解释其中最重要的部分。

实现

BinariesResolverBase 类

BinariesResolverBase 抽象类提供二进制解析器的一般实现。该类的构造函数初始化 RequestUri 属性，该属性稍后可用于准备请求，创建 HttpClient 实例以发出这些请求并订阅应用程序域的 AssemblyResolve 事件。

    protected BinariesResolverBase(string requestUri, AppDomain domain = null)
{
    if (domain == null)
    {
        domain = AppDomain.CurrentDomain;
    }

    RequestUri = requestUri;
    client = new HttpClient();
    domain.AssemblyResolve += Resolve;
}

  

Resolve(object sender, ResolveEventArgs args) 方法处理 AssemblyResolve 事件，并筛选出名称以”DotNetBrowser.Chromium”开头的程序集的请求。对于这些程序集，它会调用私有的 Resolve 方法重载以进行进一步处理。

    public Assembly Resolve(object sender, ResolveEventArgs args)
    => args.Name.StartsWith("DotNetBrowser.Chromium") ? Resolve(args.Name).Result : null;

Resolve(string binariesAssemblyName)方法重载创建一个 AssemblyName 实例并将其传递给抽象的 PrepareRequest(AssemblyName assemblyName) 方法以准备 URL 请求字符串。之后，URL 请求字符串用于通过 HttpClient 执行实际请求。响应流应包含 Chromium 二进制程序集的字节。然后，这些字节被传递给抽象的 ProcessResponse(Stream responseBody, AssemblyName assemblyName) 方法，该方法返回程序集本身。

    private async Task<Assembly> Resolve(string binariesAssemblyName)
{
    //注意：程序集通常在 UI 应用程序的后台线程中解析。
    try
    {
        //使用完全限定程序集名称构造请求。
        AssemblyName assemblyName = new AssemblyName(binariesAssemblyName);
        string request = PrepareRequest(assemblyName);

        //执行请求并下载响应。
        OnStatusUpdated("Downloading Chromium binaries...");
        Debug.WriteLine($"Downloading {request}");
        HttpResponseMessage response = await client.GetAsync(request);

        response.EnsureSuccessStatusCode();
        OnStatusUpdated("Chromium binaries package downloaded");
        Stream responseBody = await response.Content.ReadAsStreamAsync();

        //处理响应字节并加载程序集。
        return ProcessResponse(responseBody, assemblyName);
    }
    catch (Exception e)
    {
        Debug.WriteLine("Exception caught: {0} ", e);
    }

    return null;
}

  

OnStatusUpdated 方法会引发带有特定信息的 StatusUpdated 事件，然后可利用该信息了解应用程序其他部分的进度。

BinariesResolverBase 抽象实现随后由BinariesResolver 类扩展，该类提供 PrepareRequest 和 ProcessResponse 方法的实现。

BinariesResolver 类

BinariesResolver 通过下载 DotNetBrowser 分发存档并从中即时提取所需的程序集来解析 Chromium 二进制程序集。此类派生自 BinariesResolverBase 并提供其抽象成员的实现。

下面是 PrepareRequest 的实现：

    protected override string PrepareRequest(AssemblyName assemblyName)
{
    //如果构建组件为 0，则只使用主要和次要版本组件。
    int fieldCount = assemblyName.Version.Build == 0 ? 2 : 3;
    return string.Format(RequestUri, assemblyName.Version.ToString(fieldCount));
}


  

此实现重用 RequestUri 属性，根据 DotNetBrowser 版本准备对分发存档的直接引用。本例中的 RequestUri 设置为 UriTemplate ，如下所示：

    private const string UriTemplate =
    "https://storage.googleapis.com/cloud.teamdev.com/downloads/"
    +"dotnetbrowser/{0}/dotnetbrowser-net45-{0}.zip";

  

以流的形式接收分发归档后，会调用 ProcessResponse 方法。该方法的实现方式是在运行过程中提取 DLL，并将其直接加载到当前应用程序域中。然后将加载的程序集用作返回值。

    protected override Assembly ProcessResponse(Stream responseBody, AssemblyName assemblyName)
{
    // 下载的字节表示一个 ZIP 存档。 在此存档中找到我们需要的 DLL。
    ZipArchive archive = new ZipArchive(responseBody);
    ZipArchiveEntry binariesDllEntry 
        = archive.Entries
                .FirstOrDefault(entry => entry.FullName.EndsWith(".dll")
                                        && entry.FullName.Contains(assemblyName.Name));
    if (binariesDllEntry == null)
    {
        return null;
    }

    // 解压找到的条目，并加载 DLL。
    OnStatusUpdated("Unzipping Chromium binaries");
    Stream unzippedEntryStream;
    using (unzippedEntryStream = binariesDllEntry.Open())
    {
        using (MemoryStream memoryStream = new MemoryStream())
        {
            unzippedEntryStream.CopyTo(memoryStream);
            OnStatusUpdated("Loading Chromium binaries assembly");
            Assembly assembly = Assembly.Load(memoryStream.ToArray());
            OnStatusUpdated("Chromium binaries assembly loaded.", true);
            return assembly;
        }
    }
}

  

将 DLL 加载到应用程序域后，DotNetBrowser 将二进制文件从此 DLL 解压到通过 EngineOptions.Builder.ChromiumDirectory 配置的目录，然后照常启动 Chromium 进程。

此处的 DotNetBrowser 分发存档仅用作示例。如果您计划在应用程序中实现类似的方法，您应该考虑实现自己的服务，提供所需的 DLL，以避免过度的内存使用并减少初始化时间。

优点

建议方法的主要优点是最大限度地减小了分布式应用程序包的大小-不需要将 DotNetBrowser.Chromium DLL 作为安装程序或分发包的一部分提供。

缺点

初始化时间增加。当 Chromium 二进制文件通过网络提供时，初始化过程包括下载二进制文件 DLL，即使连接良好，这通常也需要一些时间。如果连接不佳，可能需要重试几次，并且初始化时间会显着增加。
需要连接互联网。如果没有连接互联网，则无法下载二进制文件和初始化 DotNetBrowser 引擎。
内存使用量增加。如果 DotNetBrowser.Chromium DLL 从字节数组中加载，DotNetBrowser 会在内存中解压缩二进制文件，初始化过程中内存使用量会增加。如果内存使用率太高，甚至会导致 32 位环境中内存不足的问题。

总结

所描述的方法似乎对特定类型的解决方案很有用，但是，在做出最终决定之前，有必要全面考虑其优缺点。

Go Top