在移动应用生态中，电子签名已成为合同签署、业务审批等场景的刚需功能。将Docusign的签名能力嵌入自有App，能够显著提升用户体验与业务流转效率。本文将从零开始，系统讲解如何在iOS与Android应用中集成Docusign SDK，覆盖环境准备、核心API调用、回调处理与安全策略。

一、集成前的环境与账号准备

在开始编码之前，需要完成三项基础工作。第一，注册Docusign开发者账号并创建集成密钥（Integration Key）。登录Docusign开发者后台，在“Apps and Keys”页面生成应用密钥，同时记录下Account ID与Base URL。第二，配置OAuth 2.0授权模式。推荐使用授权码授予（Authorization Code Grant）或JWT授予（JWT Grant），前者适合有服务端配合的场景，后者适合纯客户端或服务端自动化的场景。第三，下载对应平台的SDK包。iOS端可通过CocoaPods引入DocusignSDK，Android端则通过Maven依赖com.docusign:esignature-sdk。注意，SDK版本需与目标系统版本匹配，例如iOS 14+、Android 8.0+。

二、iOS端集成核心步骤

在Xcode项目中，首先在Podfile中添加pod 'DocusignSDK', '~> 3.0'，执行pod install。接着在AppDelegate中初始化SDK，传入之前获取的Integration Key与环境参数（演示环境为https://demo.docusign.net/restapi）。初始化代码如下：

``swift

let config = DSMManagerConfiguration(

integrationKey: "YOUR_INTEGRATION_KEY",

environment: .demo

)

DSMManager.shared.configure(with: config)`

然后创建签名会话。调用DSMEnvelopeManager的createEnvelope方法，传入文档PDF数据、签署人邮箱与姓名、签署位置坐标。SDK会返回一个envelopeId，用于后续状态查询。为了在App内直接展示签名界面，需使用DSMEnvelopeViewController，并设置代理DSMEnvelopeDelegate。当用户完成签名或拒绝签署时，代理方法envelopeViewController(_:didFinishWithStatus:)会被触发。此时应关闭控制器并向后端同步状态。

三、Android端集成核心步骤

在build.gradle中添加依赖：`gradle

implementation 'com.docusign:esignature-sdk:3.2.0'`

在Application类中初始化DSMClient，配置DSMClientConfig，包含Integration Key、OAuth Token与Base URL。获取Token的方式推荐使用JWT Grant，在服务端生成JWT后返回给客户端，避免密钥硬编码。创建信封时，使用DSMEnvelopeDefinition构建文档与签署人信息。注意Android端需要动态申请存储权限与网络权限。签名界面通过DSMEnvelopeActivity启动，使用startActivityForResult接收结果。在onActivityResult中解析DSMEnvelopeResult，根据status字段判断签署完成、拒绝或过期。

四、回调处理与状态同步

无论iOS还是Android，签名完成后必须将envelopeId与终状态回传至业务服务器。推荐使用Docusign的Connect Webhook机制：在开发者后台配置HTTPS回调地址，订阅envelope-completed、envelope-declined`等事件。服务器收到通知后，再通过Docusign REST API拉取签署后的PDF与证书。客户端则轮询或监听本地广播，更新UI状态。注意处理网络中断场景：SDK会缓存未完成的信封，待网络恢复后自动重试。

五、安全与合规注意事项

第一，永远不要在客户端硬编码Integration Key的私钥。JWT Grant的私钥必须保存在服务端。第二，使用PKCE（Proof Key for Code Exchange）增强授权码流程的安全性。第三，对本地缓存的文档进行加密，推荐使用Android的EncryptedFile或iOS的Data Protection。第四，遵循GDPR与eIDAS等法规，在用户签署前展示明确的同意条款。第五，定期轮换Integration Key与OAuth Secret，并监控Docusign开发者后台的API调用日志。

*

集成Docusign SDK到自有App并非复杂工程，关键在于正确配置OAuth授权、区分平台调用签名界面、以及通过Webhook实现状态闭环。建议先在演示环境跑通完整流程，再切换至生产环境。务必重视密钥管理与用户隐私合规。掌握上述步骤后，你可以在两天内为App增加符合法律效力的电子签名能力，从而加速合同签署周期，降低纸质文档的运营成本。