如何将Playwright与.NET桌面应用打包分发？

方法1：应用启动时自动完成Playwright安装 #

这种方式无需提前打包浏览器文件，让应用首次运行时自动处理依赖，适配大多数场景：

• 在WinForms的启动入口（如Program.cs的Main方法）添加安装检查逻辑：

  using Microsoft.Playwright;
  using System.Diagnostics;
  using System.Windows.Forms;
  
  static async Task Main()
  {
      // 执行Playwright浏览器安装，这里以Chromium为例
      var installExitCode = await RunPlaywrightInstall();
      if (installExitCode != 0)
      {
          MessageBox.Show("Playwright依赖安装失败，请检查网络连接后重试。");
          return;
      }
  
      // 初始化Playwright并启动主窗体
      using var playwright = await Playwright.CreateAsync();
      ApplicationConfiguration.Initialize();
      Application.Run(new MainForm());
  }
  
  private static async Task<int> RunPlaywrightInstall()
  {
      var process = new Process();
      process.StartInfo.FileName = "dotnet";
      process.StartInfo.Arguments = "playwright install chromium";
      process.StartInfo.RedirectStandardOutput = true;
      process.StartInfo.RedirectStandardError = true;
      process.StartInfo.UseShellExecute = false;
      process.StartInfo.CreateNoWindow = true;
  
      process.Start();
      await process.WaitForExitAsync();
      return process.ExitCode;
  }
  

• 注意：若应用采用框架依赖部署，需确保终端用户电脑已安装对应版本的.NET运行时；若用独立部署，打包时会自动包含.NET运行时。

方法2：提前打包浏览器二进制文件（离线场景） #

如果需要用户无需联网即可使用，可提前将浏览器文件打包进应用：

1. 在开发机执行dotnet playwright install chromium（按需选择chromium/firefox/webkit），安装后的浏览器文件默认存放在%USERPROFILE%\.cache\ms-playwright
2. 将对应浏览器的文件夹（如chromium-xxxx）复制到WinForms项目目录，设置文件夹内所有文件的复制到输出目录属性为「始终复制」
3. 在应用中指定Playwright使用本地浏览器文件：

using Microsoft.Playwright;
using System.Windows.Forms;

static async Task Main()
{
    // 拼接本地浏览器路径
    var browserDir = Path.Combine(AppDomain.CurrentDomain.BaseDirectory, "chromium-xxxx");
    var executablePath = Path.Combine(browserDir, "chrome-win", "chrome.exe");

    using var playwright = await Playwright.CreateAsync();
    await using var browser = await playwright.Chromium.LaunchAsync(new BrowserTypeLaunchOptions
    {
        ExecutablePath = executablePath
    });

    ApplicationConfiguration.Initialize();
    Application.Run(new MainForm());
}

• 注意：不同操作系统的浏览器文件结构不同，跨平台部署需分别打包对应平台的文件。

方法3：集成到MSIX/ClickOnce打包流程 #

如果使用Windows专属的打包工具，可将安装逻辑嵌入部署流程：

• MSIX：在打包项目的启动任务中添加dotnet playwright install chromium命令，让安装包在部署时自动执行依赖安装
• ClickOnce：在应用的安装后脚本中添加Playwright安装逻辑，确保首次运行前完成依赖部署

关键注意事项 #

• 确保项目已安装Microsoft.Playwright NuGet包
• 独立部署时，打包工具会自动包含Playwright程序集，但浏览器文件需通过上述方法处理
• 浏览器文件体积较大（如Chromium约几百MB），需权衡安装包大小与用户体验

内容的提问来源于stack exchange，提问作者Eric Eskildsen