Welcome to the Adobe Bridge CS4 Software Development Kit _____________________________________________________________________________ This file contains the latest information for the Adobe Bridge CS4 SDK. The information applies to Adobe Bridge CS4. It has the following sections: 1. Introduction 2. SDK content overview 3. Development environment 4. Running snippets 5. Known issues in the SDK 6. Adobe Solutions Network ********************************************** 1. Introduction ********************************************** The SDK provides information and examples for the Adobe Bridge CS4 scripting and extensibility interface. Note that Bridge CS4 SDK can be downloaded from this URL: http://www.adobe.com/devnet/bridge/ There are a range of code snippets (names begin with Snp) and more elaborate samples, illustrating how to work with the Adobe Bridge scripting interface, both in JavaScript and how to expose your C/C++ code to scripting in Adobe Bridge. The SDK includes documentation for each snippet/ sample, and and how to run each snippet/ sample. The Adobe Bridge JavaScript Guide and Reference, and the JavaScript Tools Guide are provided as resources for development. These have all been updated for the Bridge release. ********************************************** 2. SDK content overview ********************************************** The SDK supplies these files: - /sdksamples/javascript: JavaScript code snippets and sample scripts, which exercise the scripting interface of Adobe Bridge CS4. To execute the snippets and samples, open them in the ExtendScript Toolkit and run them against the target of Adobe Bridge CS4. - /sdksamples/cpp: Sample project files, source code and sample scripts for building and loading an external object - /docs: Documentation resources such as the Adobe Bridge JavaScript Guide (CS4), the Adobe Bridge JavaScript Reference (CS4) and the Adobe JavaScript Tools Guide (CS4). ********************************************** 3. Development environment ********************************************** To execute the sample JavaScript code provided, the required development environment is the ExtendScript Toolkit (ESTK). The ESTK is an IDE with a source-level debugger for ExtendScript, a JavaScript implementation from Adobe. The ESTK is installed with Creative Suite CS4 and point products in Creative Suite CS4. It is recommended to obtain the latest release of the ESTK. From ESTK, you can execute the JavaScript snippets and sample scripts; you must set the target scripting engine to "Bridge CS4". The examples have a file extension of .jsx. Start up Adobe Bridge CS4 and open a .jsx file from within the ESTK, then inspect the list of targets in the drop-down list at the top. Many of the snippets create output to the JavaScript console in ESTK; you should execute all the snippets from the context of the ESTK. If a snippet fails to execute because its preconditions are not met, then you will typically find some trace information in the JavaScript console in the ESTK that tells you what the requirements are for the snippet to run. To compile the C++ samples that demonstrate creating external objects that can be invoked from JavaScript, you need to use the compiler tools for the platform: Microsoft Visual Studio 2005 for Windows and XCode 2.4 for Mac OS. ********************************************** 4. Running snippets/ samples ********************************************** 1. Start Adobe Bridge CS4. 2. Start ExtendScript Toolkit. 3. From ExtendScript Toolkit, open the .jsx file that you want to run. 4. In the "targets" drop-down list, select Bridge CS4/ Main Engine. 5. Check the snippet/ sample documentation; for some snippets, you need to select a thumbnail in Adobe Bridge before running the code. 6. Return to the ExtendScript Toolkit and run the snippet/ sample using the Run button (rightward-pointing triangle) above the editor window. ********************************************** 5. Known issues in the SDK ********************************************** The following are issues in this release: - SnpMoveTabbedPalette.jsx is fully functional only if you are using at least Adobe Bridge CS3 updated to the 2.1 patch release (not 2.0). - Before running the FlashDemo.jsx sample, be sure that you read its documentation on Flash security; for instance, create a Trust File to enable the sample to run as a trusted SWF file within Adobe Bridge. - There are some issues with interapplication messaging through the BridgeTalk object. Adobe Bridge CS4 uses BridgeTalk 2.0, which is not compatible with BridgeTalk 1.0 (used with CS2). Any sample scripts demonstrating interapplication messaging will *not* work as expected with CS2 products. You must use Adobe Photoshop CS4/ Adobe InDesign CS4 for some snippets, whose names begin with SnpSend... For best results use the same suite versions. - If you have ESTK 1.0 (from CS2) installed, then double-clicking any JSX file in Finder or Windows Explorer may open that tool. You cannot use a previous version of the ESTK to execute scripts against Adobe Bridge CS4. ********************************************************* 6. Adobe Partner Connection ********************************************************* To learn more about the Adobe Partner Connection Programmes, point your browser to: http://go.adobe.com/kb/cs_cpsid_50036_en-us _____________________________________________________________________________ Copyright 2008 Adobe Systems Incorporated. All rights reserved. Adobe and Flash are registered trademarks or trademarks of Adobe Systems Incorporated in the United States and/or other countries. Windows is either a registered trademark or a trademark of Microsoft Corporation in the United States and/or other countries. Macintosh is a trademark of Apple Computer, Inc., registered in the United States and other countries. _____________________________________________________________________________