Document Revision History

This table describes the changes to Cocoa Scripting Guide.

DateNotes
2008-03-11

Minor corrections for working with sdefs.

 

In the examples in Class Elements, now using the four-character code "ricT" for the rich text class.

2007-10-31

Added pointers to new information in OS X version 10.5.

 

Noted in several places that you can read about changes in Cocoa scripting support for OS X v10.5, including changes in sdef usage, in the Scripting section of OS X Tiger Developer Release Notes for Cocoa Foundation Framework.

 

Converted Evolution of Cocoa Scriptability Information to an Appendix.

 

Converted Script Suite and Script Terminology Files to an Appendix and noted that the information it contains is useful primarily if your scriptable application will run in versions of the Mac OS prior to version 10.4. (Otherwise, you can use the sdef format, described in Preparing a Scripting Definition File.)

2007-07-23

Added information on handling the open application Apple event.

 

For details, see Open Application section.

 

In the section Maintain KVC Compliance, added implementation details for your overrides of valueIn<Key>WithName: and valueIn<Key>WithUniqueID:.

2006-04-04

Added information about NSObject and the item AppleScript class. Added reference and related document links to the HTML table of contents.

 

Updated scriptability information in Table 3-1.

 

Modified test script in Listing 8-1.

2006-03-08

Combines and updates information formerly in two documents, "Sdef Scriptability Guide for Cocoa" and "Scriptable Application Programming Guide for Cocoa."

 

Revised Overview of Cocoa Support for Scriptable Applications to provide a more complete introduction to Cocoa scripting. Changes include a description of the AppleScript object model, a table of the basic data types supported by Cocoa scripting, and expanded information on scriptability information formats.

 

Provided Implementing a Scriptable Application, a revision to the former "Key Steps" chapter. It includes a revised set of implementation steps (in the section Implementation Guidelines).

 

Provided Preparing a Scripting Definition File, which revises and merges two former chapters, "Creating a Scripting Definition" and "Scripting Definition Reference."

 

Added the largely new chapters Getting and Setting Properties and Elements and Object Specifiers. The former provides many details on working with KVC (including revised accessor samples), as well as a section on the properties property. The latter includes new illustrations and code samples, and includes conceptual information previously located in NSScriptObjectSpecifier and NSScriptObjectSpecifiers.

 

Revised and expanded the chapter Script Commands, adding an illustration, sample code, and a comprehensive table that describes default support for AppleScript commands and how to customize it (Table 7-1).

 

Revised the chapter Testing, Debugging, and Performance, adding new testing tips and a section on performance.

 

Revised the chapters Cocoa Scripting Classes and Categories, How Cocoa Applications Handle Apple Events, and Evolution of Cocoa Scriptability Information (formerly a section in "Scripting Definition File Reference").

 

Merged script suite information into the chapter Script Suite and Script Terminology Files. Added tables for enumerations and deleted deprecated information (such as "Working With ASCII Script Suite Files").