Adobe Acrobat DC SDK Overview 1/28/21 Adobe, Inc. Adobe Acrobat SDK Documentation. © 2020 Adobe Inc. All rights reserved. If this guide is distributed by Adobe with software that includes an end user agreement, this guide, as well as the software described in it, is furnished under license and may be used or copied only in accordance with the terms of such license. Except as permitted by any such license, no part of this guide may be reproduced, stored in a retrieval system, or transmitted, in any form or by any means, electronic, mechanical, recording, or otherwise, without the prior written permission of Adobe. Please note that the content in this guide is protected under copyright law even if it is not distributed with software that includes an end user license agreement. This guide is governed by the Adobe Acrobat SDK License Agreement and may be used or copied only in accordance with the terms of this agreement. Except as permitted by any such agreement, no part of this guide may be reproduced, stored in a retrieval system, or transmitted, in any form or by any means, electronic, mechanical, recording, or otherwise, without the prior written permission of Adobe. Please note that the content in this guide is protected under copyright law. Please remember that existing artwork or images that you may want to include in your project may be protected under copyright law. The unauthorized incorporation of such material into your new work could be a violation of the rights of the copyright owner. Please be sure to obtain any permission required from the copyright owner. Any references to company names, company logos, and user names in sample material or sample forms included in this documentation and/or software are for demonstration purposes only and are not intended to refer to any actual organization or persons. Adobe, the Adobe logo, Acrobat, Distiller, and Reader are either registered trademarks or trademarks of Adobe the United States and/or other countries. All other trademarks are the property of their respective owners. Notice to U.S. Government End Users. The Software and Documentation are “Commercial Items,” as that term is defined at 48 C.F.R. §2.101, consisting of “Commercial Computer Software” and “Commercial Computer Software Documentation,” as such terms are used in 48 C.F.R. §12.212 or 48 C.F.R. §227.7202, as applicable. Consistent with 48 C.F.R. §12.212 or 48 C.F.R. §§227.7202-1 through 227.7202-4, as applicable, the Commercial Computer Software and Commercial Computer Software Documentation are being licensed to U.S. Government end users (a) only as Commercial Items and (b) with only those rights as are granted to all other end users pursuant to the terms and conditions herein. Unpublished-rights reserved under the copyright laws of the United States. Adobe Inc., 345 Park Avenue, San Jose, CA 95110-2704, USA Contents 1 Introduction ................................................................................................................................. 7 Developer support......................................................................................................................................................................... 7 Samples provided with the Acrobat SDK .............................................................................................................................. 7 Developing for Acrobat Reader ................................................................................................................................................ 7 Acrobat vs. Reader................................................................................................................................................................... 7 Acrobat Reader plug-in guidelines.................................................................................................................................... 8 Reader enabled plugins......................................................................................................................................................... 8 SDK technologies and options .................................................................................................................................................. 8 JavaScript.................................................................................................................................................................................... 9 Plug-ins........................................................................................................................................................................................ 9 Plug-in development environments ........................................................................................................................10 Acrobat core API ..............................................................................................................................................................10 Extended APIs for plug-ins...........................................................................................................................................11 JavaScript vs. plugins: pros and cons..............................................................................................................................11 Implementation comparison ......................................................................................................................................11 Feature comparison........................................................................................................................................................12 Interapplication communication .....................................................................................................................................13 Viewing PDF documents from an external application ...........................................................................................13 Controlling Acrobat from an external application.....................................................................................................14 Plug-ins for IAC .................................................................................................................................................................14 JavaScript support...........................................................................................................................................................14 Windows support ............................................................................................................................................................14 Apple event support.......................................................................................................................................................14 Adobe PDF Library.................................................................................................................................................................15 2 Sandbox Broker Extensibility ...................................................................................................16 Extending broker APIs at run time...................................................................................................................................16 Components ............................................................................................................................................................................17 Plugin (PI)............................................................................................................................................................................17 Sandbox process..............................................................................................................................................................17 Broker process (The broker process running with full rights) .........................................................................17 Plugin broker (The plugin broker process that extends the broker APIs at runtime).............................17 SandboxHFT (Public HFT provided by sandbox for broker extensibility) ...................................................17 IPC channel between plugin and plugin broker, 1->6->4................................................................................18 simple-ipc-lib and SandboxPISDK.............................................................................................................................18 Building a plug-in ............................................................................................................................................................18 Building a plugin’s broker process ............................................................................................................................19 Handshake between plugin and plugin broker..........................................................................................................19 Implement CrossCalls (make calls from plug-in to plug-in’s broker process)..................................................20 Changes required in the plugin (client)...................................................................................................................20 Changes required in the plugin’s broker (server) ................................................................................................22 Individual policy configuration for 3rd parties..................................................................................................................23