Document Revision History

This table describes the changes to Cocoa Scripting Guide.

DateNotes
2008-03-11Minor 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-31Added 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 Foundation Release Notes for OS X v10.9.

 

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-23Added 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-04Added 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-08Combines 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").