签名

福昕 PDF SDK 安卓版通过 Core SDK 提供了数字签名的创建、验证、删除和属性管理能力。通过数字签名，接收者可验证文档来源与内容是否被篡改。

UI Extensions 内置签名功能

如果您使用的是完整阅读器（UI Extensions），已内置数字签名模块（DigitalSignatureModule）和手写签名模块（SignatureModule），以及签名面板（SignaturePanelModule）用于查看和验证文档中的签名，无需额外编码。

默认支持的签名类型

SDK 内置默认签名回调，支持以下两种 filter/subfilter 组合，无需注册自定义回调：

• Adobe.PPKLite + adbe.pkcs7.detached
• Adobe.PPKLite + adbe.pkcs7.sha1

核心类

类	说明
Signature	签名对象，管理签名的创建、签署、验证和属性。通过 PDFPage.addSignature() 创建，通过 PDFDoc.getSignature() 获取

签名键值常量

通过 setKeyValue(int key, String value) 设置签名信息：

常量	值	说明
e_KeyNameSigner	0	签名人
e_KeyNameLocation	1	签名地点
e_KeyNameReason	2	签名原因
e_KeyNameContactInfo	3	联系信息
e_KeyNameDN	4	可辨别名称
e_KeyNameText	5	自定义文本

外观标志位常量

通过 setAppearanceFlags(int flags) 控制签名外观中显示的信息：

常量	值	说明
e_APFlagLabel	0x0002	显示标签
e_APFlagReason	0x0004	显示签名原因
e_APFlagSigningTime	0x0008	显示签名时间
e_APFlagDN	0x0010	显示 DN
e_APFlagLocation	0x0020	显示签名地点
e_APFlagSigner	0x0040	显示签名人
e_APFlagBitmap	0x0080	显示图片
e_APFlagText	0x0100	显示自定义文本

摘要算法常量

常量	值	说明
e_DigestSHA1	0	SHA-1
e_DigestSHA256	1	SHA-256
e_DigestSHA384	2	SHA-384
e_DigestSHA512	3	SHA-512

常用验证状态常量

验证完成后通过 getState() 获取，使用位与判断：

常量	说明
e_StateUnsigned	未签署
e_StateSigned	已签署
e_StateVerifyValid	签名有效
e_StateVerifyInvalid	签名无效
e_StateVerifyChange	文档已被修改
e_StateVerifyNoChange	文档未被修改
e_StateVerifyIssueValid	签发者证书有效
e_StateVerifyIssueExpire	签发者证书过期

示例：签署并验证

import com.foxit.sdk.pdf.PDFDoc;
import com.foxit.sdk.pdf.PDFPage;
import com.foxit.sdk.pdf.Signature;
import com.foxit.sdk.common.Progressive;
import com.foxit.sdk.common.fxcrt.RectF;

PDFDoc doc = new PDFDoc("path/to/Sample.pdf");
doc.load(null);
PDFPage page = doc.getPage(0);

// 添加签名域
Signature signature = page.addSignature(new RectF(100, 600, 300, 700));

// 设置外观
signature.setAppearanceFlags(
    Signature.e_APFlagLabel | Signature.e_APFlagDN |
    Signature.e_APFlagReason | Signature.e_APFlagSigner |
    Signature.e_APFlagSigningTime | Signature.e_APFlagLocation
);

// 设置签名信息
signature.setKeyValue(Signature.e_KeyNameSigner, "张三");
signature.setKeyValue(Signature.e_KeyNameLocation, "北京");
signature.setKeyValue(Signature.e_KeyNameReason, "文档审批");
signature.setFilter("Adobe.PPKLite");
signature.setSubFilter("adbe.pkcs7.detached");

// 签署
Progressive progressive = signature.startSign(
    "/sdcard/cert.pfx", "123".getBytes(),
    Signature.e_DigestSHA256, "/sdcard/signed.pdf", null, null);
int state = Progressive.e_ToBeContinued;
while (state == Progressive.e_ToBeContinued) {
    state = progressive.resume();
}

// 验证已签署文档中的所有签名
PDFDoc signedDoc = new PDFDoc("/sdcard/signed.pdf");
signedDoc.load(null);

int count = signedDoc.getSignatureCount();
for (int i = 0; i < count; i++) {
    Signature sig = signedDoc.getSignature(i);
    if (sig == null || sig.isEmpty()) continue;

    Progressive verifyProgress = sig.startVerify(null, null);
    int vState = Progressive.e_ToBeContinued;
    while (vState == Progressive.e_ToBeContinued) {
        vState = verifyProgress.resume();
    }

    int verifiedState = sig.getState();
    if ((verifiedState & Signature.e_StateVerifyValid) != 0) {
        // 签名有效
    }
}

示例：设置自定义签名时间

setSignTime 当前不支持直接修改时间格式。如需设置自定义格式的时间，可将时间字符串写入签名词典：

Signature signature = page.addSignature(rect);
signature.setAppearanceFlags(Signature.e_APFlagSigningTime | Signature.e_APFlagSigner);

PDFDictionary dict = signature.getSignatureDict();
dict.setAtString("M", "2025/01/14 10:30:00");

API 参考

Signature 的完整接口说明请参阅 API 手册。