Wkhtmltopdf.NetCore使用总结

序言

环境要求：在centos7的docker上，.NETCORE 3.1
目标：将HTML转为PDF导出
相关测试：
Select.HtmlToPdf.NetCore，兼容性很好，使用也挺简单的，但是只支持windows系统；
DinkToPdf、Haukcode.WkHtmlToPdfDotNet等类库在centos要支持各种类库，最后放弃了；
还有个itextsharp没有测试，有文章表示它对css的支持比较弱。

Haukcode.WkHtmlToPdfDotNet简介

地址：https://github.com/HakanL/WkHtmlToPdf-DotNet
它使用P/invoke方式将wkhtmltopdf打包为linux的libwkhtmltox.so库来调用；
相关技术文章：https://www.cnblogs.com/kelelipeng/p/10654315.html

HTML页面编写

样式注意要点：要有实际内容，转为PDF才会展示；

陷阱1：宽度百分比无效；
陷阱2：同行DIV要使用display:inline-block；
陷阱3：div内容要垂直居中，通过高度控制，在内部添加2个div,第二个为空内容( )；

类库使用

github：https://github.com/fpanaccia/Wkhtmltopdf.NetCore

示例：https://github.com/fpanaccia/Wkhtmltopdf.NetCore.Example

引用类库

在nuget添加Wkhtmltopdf.NetCore，在Startup.cs添加引用

    // This method gets called by the runtime. Use this method to add services to the container.
    public void ConfigureServices(IServiceCollection services)
    {            
        services.AddControllers();
        services.AddWkhtmltopdf();
    }

然后，将示例的文件夹Rotativa文件夹拷贝到WEB项目，包含不同操作系统的wkhtmltopdf

dockerfile配置

将windows下的字体拷到到wwwroot/fonts下的微软雅黑和宋体拷到docker里面，并授权wkhtmltopdf；
donetcore3是自己封装的镜像，已添加libgdiplus；

FROM  donetcore3:v1 
WORKDIR /app
COPY . .

COPY ./wwwroot/fonts/simsun.ttc /usr/share/fonts/ty/simsun.ttf
COPY ./wwwroot/fonts/msyh.ttc /usr/share/fonts/ty/msyh.ttf
COPY ./wwwroot/fonts/msyhl.ttc /usr/share/fonts/ty/msyhl.ttf
COPY ./wwwroot/fonts/msyhbd.ttc /usr/share/fonts/ty/msyhbd.ttf

EXPOSE 80/tcp

ENV ASPNETCORE_ENVIRONMENT Production

#测试多语言 启用下面参数 指示docker默认环境的语言为utf8
ENV LC_ALL zh-Hans.UTF-8
ENV LANG zh-Hans.UTF-8
ENV LANGUAGE zh-Hans.UTF-8

RUN chmod 755 /app/Rotativa/Linux/wkhtmltopdf

ENTRYPOINT ["dotnet", "Monitor.Web.dll"]

使用

按A4横向生成PDF

 [HttpGet]
        [Route("GetPage")]
        public IActionResult GetPage()
        {
            var options = new ConvertOptions
            {
                //HeaderHtml = "http://localhost/header.html",
                HeaderSpacing = 0,
                FooterSpacing = 0,
                IsGrayScale = true,                
                PageSize = Wkhtmltopdf.NetCore.Options.Size.A4,
                PageMargins = new Wkhtmltopdf.NetCore.Options.Margins() { Bottom = 0, Left = 0, Right = 0, Top = 0 },
                PageOrientation = Wkhtmltopdf.NetCore.Options.Orientation.Landscape
            };
            _generatePdf.SetConvertOptions(options);

            string htmlCode = "";
            using (WebClient client = new WebClient())
            {
#if DEBUG
                htmlCode = client.DownloadString("http://localhost:5020/print/DyColdStoragePrint");
#else

                htmlCode = client.DownloadString("http://127.0.0.1/print/DyColdStoragePrint");
#endif
            }

            var pdf = _generatePdf.GetPDF(htmlCode);

            var path = Path.Combine("wwwroot", DateTime.UtcNow.Ticks.ToString() + ".pdf");
            using (var stream = new FileStream(path, FileMode.Create))
            {
                stream.Write(pdf, 0, pdf.Length);
            }

            return Content(path);
        }