跨平台導PDF,結合wkhtmltopdf很順手


前言

好東西要分享,之前一直在使用wkhtmltopdf進行pdf文件的生成,常用的方式就是先安裝wkhtmltopdf,然后在程序中用命令的方式將對應的html生成pdf文件,簡單而且方便;但重復的編碼使得想在wkhtmltopdf基礎上進行封裝,偶然間發現有小伙伴已經封裝的還不錯啦,常用的功能都已經實現,源碼地址:https://github.com/fpanaccia/Wkhtmltopdf.NetCore。

作者將其打包成Nuget包(Wkhtmltopdf.NetCore),直接引入使用即可;

正文

既然用到了.NetCore,肯定就要考慮到跨平台兼容性,對於wkhtmltopdf之前一直是在Windows上使用,還沒有在其他平台嘗試;這個包封裝的行不行,拉出來遛遛就知道啦,接下來就試試:

1. 建個API項目,引入包和兼容對應平台的wkhtmltopdf執行文件

image-20210120162314648

注: 默認依賴的wkhtmltopdf執行文件需要存放在Rotativa目錄下,可以自定義名稱,如果自定義,需要再注冊服務時指定對應的文件名;這里的wkhtmltopdf已經根據不同平台進行編譯打包了,無需安裝,這些文件在源碼那就有;

2.創建PDFTestController控制器,添加如下接口進行測試

首先把生成pdf的服務注入進來,后續直接使用就可以啦:

image-20210120162846169

接下來就開始寫接口啦,這里只是測試,代碼冗余沒有考慮,在實際項目中小伙伴可以根據自己需求進行封裝;

  • ExportPDFByHtml 接口,用html直接生成pdf文件,但這里沒有保存,以文件流的形式訪問,通過瀏覽器查看文件,可以自行下載;html模板在實際開發過程中可以單獨用文件存儲;

    image-20210120163444523

  • SavePDFByHtml接口,直接保存文件,文件名可以根據需要進行自定義;

    image-20210120163838699

  • TestMarginAndPageSize接口,設置Margin和PageSize參數,其他參數也可以設置;

    image-20210120164237413

    ConvertOptions默認封裝了以下屬性,小伙伴也可以自定義擴展,只要繼承IConvertOptions即可,這里就不演示的,因為官方有對應的案例,下伙伴下去搞搞,wkhtmltopdf的參數挺多的,都可以進行封裝使用。

    image-20210120170024098

  • ExportByRazorView使用Razor視圖的方式進行pdf文件生成,此庫已經支持cshtml文件的讀取

    image-20210120164613249

    根據指定視圖生成對應的pdf效果,如下:

    image-20210120164735123

  • ExportByRazorViewData數據動態綁定,既然支持視圖,那就應該支持Razor語法,一般常用的就是數據綁定了,上面是靜態的,接下來來個動態綁定的。

    image-20210120165238787

    根據指定視圖生成對應的pdf效果,如下:

    image-20210120165449173

    如上基本的使用演示就說那么多,使用還是很簡單,小伙伴后續可以根據自己的需要進行相關擴展;當然還有其他功能,比如設置頁眉/頁腳等,作者提供有對應的案例;這里不說那么多,不然又是長文。

3. 小伙伴用的時候可能會遇到的問題

  • 在開發調試運行項目時,會報找不到wkhtmltopdf文件,那是因為運行時的確找不到對應的文件,將對應Rotativa下的文件設置為始終復制即可:

    image-20210120170946016

  • 在Windows下怎么玩都沒問題啦,開始發布到Linux(我用的centos 7),我擦,莫名其妙的錯。

    image-20210120171410682

    看見這個錯我懵的,一頓搜索猛如虎,還是沒找到答案;冷靜下來,重新捋捋,原來是自己在犯傻;

    兩個問題需要解決,1.上傳到Linux下的wkhtmltopdf沒有給執行權限;2.可能環境缺少對應的依賴庫;

    設置可執行權限

    在Linux環境下,可以通過ll命令查看權限,剛開始是沒有權限的,只需要執行chmod 777 wkhtmltopdf 命令,執行權限就有了,如下圖中紅框中的x就是可執行權限;

    image-20210120171951473

    安裝缺少的依賴庫

    可執行權限開啟之后,別急着去訪問頁面,這樣可能還是錯誤。因為可能缺少依賴庫,那咋知道缺少呢,我是直接執行wkhtmltopdf,執行成功就沒啥,不成功就會報缺少相關依賴,然后直接安裝就行啦;執行./wkhtmltopdf https://www.baidu.com ./test.pdf試試就知道啦,因為wkhtmltopdf本身是可以單獨運行的,並不依賴我們寫的程序。

  • 當執行成功之后,然后開始訪問接口導出功能,如果不出意外,遇到中文就產生亂碼啦,那是因為Linux環境下缺少相關的字體文件,將對應的字體文件拷貝到Linux上即可,字體我找好了,下載地址如下:

    鏈接: https://pan.baidu.com/s/1jikC0DUkpEzpXL5ysjEQPA 提取碼: tn4j

    將下載下來的字體解壓,然后拷貝到Linux下的 /usr/share/fonts目錄下即可

image-20210120173348468

最后這樣應該就沒啥問題啦,剩下的就交給小伙伴自己摸索搞實踐吧;

​此文源碼地址:https://github.com/zyq025/DotNetCoreStudyDemo

​wkhtmltopdf官網地址​:https://wkhtmltopdf.org/

總結

使用還是很簡單的,常規的需求沒啥問題,如果需要功能定制化,小伙伴可以參考源碼,自己封裝一個(封裝思路不難的); 如果小伙伴有比較好的導出庫,免費開源的那種,一起分享出來玩玩。

一個被程序搞丑的帥小伙,關注"Code綜藝圈",識別關注跟我一起學~~~


免責聲明!

本站轉載的文章為個人學習借鑒使用,本站對版權不負任何法律責任。如果侵犯了您的隱私權益,請聯系本站郵箱yoyou2525@163.com刪除。



 
粵ICP備18138465號   © 2018-2025 CODEPRJ.COM