podofo下載 - podofo源代碼下載

podofo

C/C++

Version 0.10.4

下載

podofo

什麼是podofo？
要求
許可
開發快速啟動
doxygen文檔
字符串編碼和緩衝慣例
API穩定性
Podofo工具
托多
常問問題
沒有保修
貢獻
作者

什麼是podofo？

Podofo是一個免費的便攜式C ++庫，可使用PDF文件格式。

Podofo提供了解析PDF文件並將其內容修改為內存的類。更改可以輕鬆地寫回磁盤。除了PDF解析，Podofo還提供了從頭開始創建自己的PDF文件的設施。目前，它不支持渲染PDF內容。

要求

要構建podofo lib，您需要一個C ++ 17編譯器，CMAKE 3.16和以下庫（指示的暫定最小版本）：

Freetype2（2.11）
fontconfig（2.13.94，Unix平台所需的，Windows的可選）
OpenSSL（支持1.1和3.0）
libxml2（2.9.12）
Zlib
libjpeg（9d，可選）
libtiff（4.0.10，可選）
libpng（1.6.37，可選）
Libidn（1.38，可選）

對於最受歡迎的工具鏈，Podofo需要以下最低版本：

MSVC ++ 14.16（vs 2017 15.9）
GCC 9.0
clang/llvm 7.0

它經常使用以下IDE/工具鏈版本進行測試：

Visual Studio 2017 15.9
Visual Studio 2019 16.11
Visual Studio 2022 17.3
GCC 9.3.1
XCode 13.3
NDK R23B

GCC 8.x的支持最近破裂了，但可能是重新建立的。

許可

Podofo庫是根據LGPL 2.0或更高版本的條款許可的。 Podofo工具是根據GPL 2.0或更高版本的條款許可的。

開發快速啟動

眾所周知，Podofo可以通過眾多軟件包管理器（包括apt-get ，Brew，VCPKG，Conan）進行編譯，並具有在Ubuntu Linux，MacOS和Windows中使用的公共連續集成，並引導CMAKE項目，構建和測試庫。強烈建議使用此類包裝管理人員建造Podofo。

存儲庫中還有一個遊樂場區域，您可以訪問某些流行的建築/操作系統的前構建依賴項：操場是推薦開發庫和重現錯誤的推薦設置，而不建議使用Podofo部署應用程序。看看那裡的讀書文件。

警告：眾所周知，Podofo正在從事交叉補償工具鏈（例如Android/iOS開發），但在這種情況下可能無法提供支持。如果您決定手動構建依賴關係，則假定您知道如何身份庫庫衝突/不匹配以及如何處理系統中可能出現的彙編/鏈接問題。

構建適當的範圍

從源根運行：

 sudo apt-get install -y libfontconfig1-dev libfreetype-dev libxml2-dev libssl-dev libjpeg-dev libpng-dev libtiff-dev libidn11-dev
mkdir build
cd build
cmake -DCMAKE_BUILD_TYPE=Debug ..
cmake --build . --config Debug

用啤酒建造

安裝啤酒，然後從源根運行：

 brew install fontconfig freetype openssl libxml2 jpeg-turbo libpng libtiff libidn cmake
mkdir build
cd build
cmake  -DCMAKE_BUILD_TYPE=Debug -DCMAKE_FIND_FRAMEWORK=NEVER -DCMAKE_PREFIX_PATH=`brew --prefix` -DFontconfig_INCLUDE_DIR=`brew --prefix fontconfig`/include -DOPENSSL_ROOT_DIR=`brew --prefix openssl@3` ..
cmake --build . --config Debug

與柯南建造

安裝柯南，然後從源根運行：

 mkdir build
cd build
conan install ..
cmake -DCMAKE_BUILD_TYPE=Debug ..
cmake --build . --config Debug

使用VCPKG構建

請按照VCPKG QuickStart指南進行設置，以設置軟件包管理器存儲庫。在Windows中，將環境變量VCPKG_DEFAULT_TRIPLET設置為x64-windows可能也很有用，以默認安裝64位依賴關係並定義一個VCPKG_INSTALLATION_ROOT變量，並在QuickStart中使用Repository的位置定義了Repository的位置。

然後從源根運行：

 vcpkg install fontconfig freetype libxml2 openssl libjpeg-turbo libpng tiff zlib
mkdir build
cd build
cmake -DCMAKE_TOOLCHAIN_FILE=C:vcpkgscriptsbuildsystemsvcpkg.cmake -DCMAKE_BUILD_TYPE=Debug ..
cmake --build . --config Debug

CMAKE開關

PODOFO_BUILD_TEST ：構建單元測試，默認為true；
PODOFO_BUILD_EXAMPLES ：構建示例，默認為true；
PODOFO_BUILD_UNSUPPORTED_TOOLS ：構建podofo工具，默認為false。請參閱README中的相關部分；
PODOFO_BUILD_LIB_ONLY ：如果為true，它將僅構建庫組件。這種無條件禁用建築測試，示例和工具；
PODOFO_BUILD_STATIC ：如果為true，則將庫作為靜態對象構建，並將其用於測試，示例和工具。默認情況下，建立了共享庫。

靜態鏈接

如果您想使用Podofo的靜態版本，並且包括Podofo Cmake項目，則非常簡單。在CMAKE項目中執行以下操作：

 set(PODOFO_BUILD_LIB_ONLY TRUE CACHE BOOL "" FORCE)
set(PODOFO_BUILD_STATIC TRUE CACHE BOOL "" FORCE)
add_subdirectory(podofo)
# ...
target_link_libraries(MyTarget podofo::podofo)

如果您要針對Podofo預先編譯的靜態構建鏈接，這是一個方案，支持支持是有限的，因為您真的應該能夠識別和修復鏈接錯誤。一般步驟是：

將PODOFO_STATIC彙編定義添加到您的項目，或者在包括podofo.h之前添加；
鏈接庫podofo.a ， podofo_private.a （或podofo.lib ， podofo_private.lib與msvc）和所有因庫。

doxygen文檔

可以在https://podofo.github.io/podofo/documentation/上找到API文檔。

生成doxygen文檔

先決條件：確保您的機器上安裝了Doxygen。如果沒有，請訪問Doxygen的官方網站以下載並安裝它。
生成文檔：完成開發QuickStart章節中詳細介紹的構建過程後，導航到Podofo源代碼的根目錄。打開終端或命令提示符並運行以下命令：
```
doxygen build/Doxyfile
```
查看文檔：文檔生成完成後，您將找到一個包含生成文檔的documentation目錄。在您喜歡的Web瀏覽器中打開index.html以查看API文檔。
```
 cd build/doxygen/documentation
open index.html
```

字符串編碼和緩衝慣例

庫中的所有std::strings或std::string_view旨在保存UTF-8編碼的字符串內容。默認情況下， PdfString和PdfName構造函數接受UTF-8編碼字符串（儘管PdfName僅接受PdfDocEncoding char集中的字符）。 charbuff ABD bufferview代表一個通用的八位位緩衝區。

API遷移

Podofo具有不穩定的API，這是對Podofo 0.9.x的廣泛API審查的結果。在此鏈接上，您可以找到有關遷移0.9.8代碼為0.10.0的不完整指南。預計Podofo將在審查過程完成後立即收斂到穩定的API。有關更多詳細信息，請參見API穩定性。

Podofo工具

警告：工具目前是未經支持的，未經測試和未受到的。

Podofo工具仍在源樹中可用，但是由於它們是未固定/未固定的，默認情況下將禁用其編譯，並且在清除狀態之前不會獲得支持。不建議將它們包含在軟件分佈中。如果要構建它們，請確保使用-DPODOFO_BUILD_UNSUPPORTED_TOOLS=TRUE來引導CMAKE項目。在操場上很方便地啟用工具，至少可以確保圖書館更改不會破壞其編譯。

托多

有一個待辦事項列表，或者查看問題跟踪器。

常問問題

問：如何簽署文檔？

答： Podofo Head現在提供一個非常強大的高級簽名程序，該程序允許簽名文檔而無需手動提供CMS結構。默認情況下，它支持使用Modern PAdES-B合規性配置文件簽署文檔，但也支持Legacy PKCS7簽名。如果您同時擁有ASN.1編碼X509證書和RSA私鑰，則可以簽署具有以下代碼的文檔：

 auto inputOutput = std::make_shared<FileStreamDevice>(filepath, FileMode::Open);

PdfMemDocument doc;
doc.Load(inputOutput);

auto & page = doc.GetPages().GetPageAt( 0 );
auto & signature = page.CreateField<PdfSignature>( " Signature " , Rect ());

auto signer = PdfSignerCms(x509certbuffer, pkeybuffer);
PoDoFo::SignDocument (doc, *inputOutput, signer, signature);

還支持外部簽名服務和/或在內存緩衝區中籤署文檔。請參閱單元測試中的各種簽名示例。

問：我仍然可以使用基於事件的過程簽署文檔嗎？

是的，舊的低級過程沒有更改，並且仍然可用。要簡要描述該過程，必須完全實現PdfSigner ，檢索或創建PdfSignature字段，創建輸出設備（請參閱下一個問題），然後使用PoDoFo::SignDocument(doc, device, signer, signature) 。簽名時， PdfSignature的調用順序以這種方式工作： PdfSigner::Reset()首先稱為PdfSigner::ComputeSignature(buffer, dryrun) ，用空的緩衝區和dryrun參數設置為true 。在此呼叫中，只需調整緩衝區大小，高估了簽名所需的尺寸，或者只計算必須保存在緩衝區上的假簽名。然後調用一系列PdfSigner::AppendData(buffer) ，接收要簽名的所有文檔數據。最終的PdfSigner::ComputeSignature(buffer, dryrun)被稱為dryrun參數設置為false 。該呼叫的緩衝區已清除（未更改容量）或不相應地與PdfSigner::SkipBufferClear()的價值相應。

問： PdfMemDocument::SaveUpdate()或PoDoFo::SignDocument()僅寫一個部分文件：為什麼沒有機制可以無縫處理遞增更新，因為它在podofo 0.9.9 x中？應該怎麼做才能正確更新/簽署文檔？

答： podofo 0.9.x中的先前機制需要啟用文檔以進行增量更新，這是一個決策步驟，我認為這是不必要的。也:

如果要在文件加載的文檔中，仍然需要在同一文件中執行更新，並且在要操作的文件的路徑上執行檢查，這是不安全的；
如果緩衝區用於一個更新/簽名操作，但對以下操作不起作用，則意味著該機制被漏洞/不可靠。

一種替代策略，可以清楚地表明，必須在加載文檔的同一文件上執行增量更新，或者在隨後的操作後，如果使用緩衝文檔，則基礎緩衝區將在後續操作後增長其紀念消耗。它按照幾個示例，顯示了正確的操作以更新文件或緩衝區加載的文檔：

通過在同一位置上加載和保存文檔來保存已加載文檔的更新：

 auto inputOutput = std::make_shared<FileStreamDevice>(filename, FileMode::Open);

PdfMemDocument doc;
doc.Load(inputOutput);

doc.SaveUpdate(*inputOutput);

通過首先將源複製到緩衝區來保存緩衝區的更新，該緩衝區也將用於加載文檔：

charbuff outputBuffer;
FileStreamDevice input (filepath);
auto inputOutput = std::make_shared<BufferStreamDevice>(outputBuffer);
input.CopyTo(*inputOutput);

PdfMemDocument doc;
doc.Load(inputOutput);

doc.SaveUpdate(*inputOutput);

可以通過相同的技術完成簽名文檔，閱讀其他問題以獲取更多示例。

問：我可以第二次簽署文檔嗎？

答：是的，這是對此進行了測試，但是為了確保這將有效，您將第二次重新使用該文檔，因為重新使用已加載的文檔仍未經過測試（稍後可能會更改）。例如，您可以按照以下操作：

 auto inputOutput = std::make_shared<FileStreamDevice>(filepath, FileMode::Open);

{
    PdfMemDocument doc;
    doc. Load (inputOutput);
    auto & page = doc. GetPages (). GetPageAt ( 0 );
    auto & signature = page. CreateField <PdfSignature>( " Signature1 " , Rect ());

    PdfSignerCms signer (x509certbuffer, pkeybuffer);
    PoDoFo::SignDocument (doc, *inputOutput, signer, signature);
}

{
    PdfMemDocument doc;
    doc. Load (inputOutput);
    auto & page = doc. GetPages (). GetPageAt ( 0 );
    auto & signature = page. CreateField <PdfSignature>( " Signature2 " , Rect ());
    PdfSignerCms signer (x509certbuffer, pkeybuffer);
    PoDoFo::SignDocument (doc, *inputOutput, signer, signature);
}