Adobe InDesign CS4 Products Software Development Kit (Build 578, September 2009) ReadMe File ______________________________________________________________________ This SDK provides the information you need to develop software modules that plug into and extend the functionality of Adobe InDesign CS4 pre-release products. ______________________________________________________________________ This file has the following sections: 1. Legal 2. Changes 3. Development Environments 4. Porting 5. Documentation Overview 6. Known Issues 7. AGL Headers and Libraries 8. SDK Support and Adobe Partner Programs *********************************************************** 1. Legal *********************************************************** You may use this SDK only in a manner consistent with the included End User License Agreement: \legalnotices\EULAs.pdf Other notices, terms and conditions pertaining to third-party software are located at: http://www.adobe.com/go/thirdparty *********************************************************** 2. Changes *********************************************************** Version 6.0.4 ============= * One interface is now public for getting smart-dimension. It is used in tracker to snap the object being resized to the exact dimensions of another page item before smart- dimension matching occurs. - ISmartDimensions.h * Added a new interface to get the page item used for anchored object alignment according to its options. - IAnchoredObjectAlternateFrameAlign.h Version 6.0.3 ============= * Two interfaces are now public. They are required for creating custom resize tracker. - IDynamicTransformData.h - ICursorUtils.h * Added new interface for setting the attributes of a StaticMultiLineTextAttr widget. - IStaticMultiLineTextAttr2.h * Added new sample FlexScriptUIDialog that demonstrate the interaction of Flex UI with JavaScript. This sample is in: /source/sdksamples * Bug fixes in ConditionalText.jsx. This script is in: /scripting/indesign/scriptingguide/scripts/JavaScript * Fixed a Mac OS crash in ExtendedLink (SDKLib). Also updated setup instructions for using the Filemaker Pro database. * Enhancements to reference documentation. Version 6.0.2 ============= * Added two samples that demonstrate working with IDML in Adobe AIR and Flex/ActionScript. These samples are in: /idml flex samples See the Readme.txt files for each sample. * Several JavaScript files were added to the Scripting Guide scripts. /scripting/indesign/scriptingguide/scripts/JavaScript This includes two new scripts that demonstrate things that were not covered elsewhere: - documents/MakeCalendarAndExportAsSWFOrXFL.jsx -- This script generates a calendar that uses dynamic document features (buttons and event handlers) and exports to SWF or XFL. - preflight/BasicPreflightDemonstration.jsx -- This script demonstrates how to interact with InDesign's new preflight feature using JavaScript. * Fixed Assert in CHLinguistics when adding a word to a custom dictionary. * ExtendedLink bug fixes and enhancements. There is a new option to control how and when links update. You can choose to make links update automatically. The ExtendedLinkUI panel now supports updating the status and re-linking all links in the document with just one action. The SDK now includes a CJK database sample to exercise the double-byte support. See idsdk-cjk.sql in the ExtendedLink example files. * Added SDKFileOpenMultipleFileChooser subclass to SDKFileHelper.h. This class provides an open file dialog that handles multiple file selections. * Bug fix in SnapSelectionSuiteCSB.cpp. Pasteboard coordinates were used; spread coordinates are required. There were no significant API changes. Version 6.0.1 ============= * The CHLinguistic sample was added back into the SDK. * Added SnpCreateCrossReferences, a new code snippet for creating cross references. * Enhancements to SnpExportDynamicDocuments. You can now choose between SWF and XFL export, as well as a destination file. * Bug fixes in InDesign Server Corba generation scripts and plug-in code. * Bug fixes in InDesign Server SampleClient. * Bug fixes in the ExtendedLinks sample. The code in the sample now supports double-byte text. * Added performance metrics calls to the Hyphenator sample. This is an example of how to provide performance metrics in your plug-in. * Minor fixes to PDF and HTML documentation. There were no significant API changes. *********************************************************** 3. Development Environments *********************************************************** Windows: Microsoft Windows XP with service pack 2 or higher Microsoft Visual Studio 2005 SP 1. Mac OS: Mac OS 10.4 or higher XCode 2.4.1 for Mac OS 10.4.x - OR - XCode 3.1 for Mac OS 10.5.x Download from: http://developer.apple.com/tools/download/ NOTE: To run InDesign in the Japanese feature set, you must have an operating system with Japanese-language support. NOTE: For the requirements to run InDesign and InCopy, see the ReadMe files for those products. *********************************************************** 4. Porting *********************************************************** For detailed porting instructions, see "Adobe InDesign CS4 Porting Guide": /docs/guides/porting-guide.pdf *********************************************************** 5. Documentation Overview *********************************************************** If you are new to InDesign development, see "Getting Started with the Adobe InDesign CS4 Products SDK": /getting-started.pdf PDF versions of our written documentation are in the following directory: /docs/guides These documents also are built into the API reference, which is provided in the following two files: \docs\references\index.chm \docs\references\sdkdocs.tar.gz Both contain reference documentation for all public APIs and SDK sample code, as well as an HTML version of the PDF documentation listed above. The index.chm file is a compressed HTML file, for use on Windows. To view its contents, double-click the file icon on Windows. The sdkdocs.tar.gz archive is for use on Mac OS. To expand this archive on Mac OS, double-click the file. It decompresses to a subfolder named sdkdocs. To view the reference, double-click index.html. *********************************************************** 6. Known Issues *********************************************************** * If you installed security update 896358 or Microsoft Windows Server 2003 Service Pack 1 (SP1), you may experience broken links and missing text while viewing the /docs/references/index.chm file. Use one of the following workarounds: Method 1 -------- 1. Double-click the index.chm file. 2. In the "Open File-Security Warning" dialog box, clear the "Always ask before opening this file" check box. 3. Click Open. Method 2 -------- 1. Right-click the index.chm file, then click Properties. 2. Click Unblock. 3. Double-click the index.chm file to open the file. For details, see http://support.microsoft.com/kb/902225. * The debug target of the SpellingPanel project will not build. This is due to some debug-only code that contains private dependencies. The release target builds successfully. * Mac OS SDK: Depending on how you set your PATH variable, you may need to prepend "sh " before some of the Bourne shell scripts. For example, you may need to run the IDMLTools samples as follows: sh run.sh * A version of SDKLib.dylib is installed by the Mac product installer in the application folder. The SDK version of this plug-in contains some changes needed to support improvements to the ExtendedLink sample. To run the ExtendedLink sample, you must replace the installed SDKLib.dylib a version build from the SDK. * The ExtendedLink and ExtendedLinkUI depend on SDKLib.sdk. In Mac OS, SDKLib.sdk must be available in the application's package folder; otherwise, you get CFBundleLoadExecutableFile errors for ExtendedLink and ExtendedLinkUI on launch. You can either copy the SDKLib.sdk file or create a symbolic link to the file at this location: /Contents/MacOS/SDKLib.dylib. To create a symbolic link, use the "ln -s" command: ln -s /build/mac/debug/packagefolder/contents/macos/SDKLib.dylib /Contents/MacOS/SDKLib.dylib The path to the built version () of SDKLib.dylib must be either absolute or relative to the symbolic link file. *********************************************************** 7. AGL Headers and Libraries *********************************************************** AGL (Adobe Globalization Library) is based on ICU (International Components for Unicode), developed by IBM. InDesign CS4 exposes some public APIs that allow third-party developers to get the ICU locale for a language. The version that InDesign CS4 uses is based on ICU version 3.4 headers and Windows libraries in \external\icu, available for your use. For more information on ICU open source, see: http://www-306.ibm.com/software/globalization/icu/index.jsp *********************************************************** 8. SDK Support and Adobe Partner Programs *********************************************************** If you require SDK support for the Version Cue CS4 SDK, you may purchase single or multi-pack SDK support cases. Information on purchasing SDK support cases can be found at: http://partners.adobe.com/public/developer/support/index.html Information on Adobe support, in general, may be found at: http://www.adobe.com/support/programs/ If you are a partner who extends, markets, or sells Adobe products or solutions, you should consider membership in the Adobe Partner Connection Solution Partner Program. The Solution Partner Program provides development support, access to timely product information, as well as various marketing benefits. To learn more about the program, point your browser to: http://wwww.adobe.com/partners or contact one of the following locations. In the U.S., Canada, and Mexico: Adobe Solution Partner Program Adobe Systems Incorporated PO Box 2205 Beaverton, OR 97005 Tel: 1-800-685-3510 (toll free in the US and Canada only) or 206-675-6145 Fax: 206-675-6872 E-mail: solutionpartner@adobe.com In Europe, Middle East, and Africa: Adobe Solution Partner Program Adobe Systems Incorporated Postbus 20623 1001 NP Amsterdam The Netherlands Tel: +31 20 582 0850 Fax: +31 20 582 0851 E-mail: eurosolutionpartner@adobe.com In Japan: Adobe Solution Partner Program Adobe Systems Co., Ltd. Shinjuku Oak Tower 16F 6-8-1 Nishishinjuku, Shinjuku-ku, Tokyo 163-6016 Japan Tel: 03-5740-2620 Fax: 03-5740-2621 E-mail: japanpartner@adobe.com _____________________________________________________________________________ Copyright 2009 Adobe Systems Incorporated. All rights reserved. Adobe and InDesign are registered trademarks or trademarks of Adobe Systems, Incorporated in the United States and/or other countries. Microsoft and Windows are registered trademarks or trademarks of Microsoft Corporation in the United States and/or other countries. Apple and Mac OS are trademarks of Apple Computer, Incorporated, registered in the United States and other countries. IBM is a trademark of International Business Machines Corporation, registered in the United States and other countries. All other trademarks are the property of their respective owners. Adobe legal audits: 0000712 0000426 _____________________________________________________________________________