---

Introduction to AppleScript Studio Programming Guide

Contents:

Who Should Read This Document
Organization of This Document
Conventions
See Also

AppleScript Studio Programming Guide provides the key information you’ll need to create AppleScript Studio applications.

AppleScript Studio is a powerful tool for quickly creating native Mac OS X applications that support the Aqua user interface guidelines. It combines features from AppleScript, Xcode, Interface Builder, and the Cocoa application framework. With AppleScript Studio, you can work in a full-featured development environment to create applications that use AppleScript scripts to control a broad range of Cocoa user-interface objects.

AppleScript Studio has something to offer both to scripters and to those with Cocoa development experience:

• It provides access to AppleScript’s ability to control multiple applications, including parts of the Mac OS itself.

• Scripters can create applications with a complex user interface, including windows, buttons, menus, text fields, tables, and much more. Scripts have full access to user interface objects.

• Cocoa developers can use AppleScript Studio to speed up prototyping, testing, and deploying of applications.

Who Should Read This Document

This document assumes that you have some familiarity with AppleScript and know how to write and execute scripts.

Previous experience building applications with an integrated development environment is also recommended—familiarity with Xcode and Interface Builder is especially useful.

Previous experience with Cocoa is not required, but can be helpful in understanding some of AppleScript Studio’s underlying mechanisms.

For documentation and other resources for these technologies, see “See Also.”

For information on whether AppleScript Studio is appropriate to your task, see “Strengths and Limitations.”

Organization of This Document

This document contains the following chapters:

• “Introduction to AppleScript Studio Programming Guide” briefly describes AppleScript Studio, provides a description for each chapter, and lists some related documentation.

• “About AppleScript Studio” introduces AppleScript Studio’s key features and shows how to create a simple “Hello World” application.

• “AppleScript Studio Components” provides a detailed description of AppleScript Studio, including descriptions of the key features in Xcode and Interface Builder, as well as overviews of the Cocoa and AppleScriptKit frameworks.

• “Programming With AppleScript Studio” describes additional features and issues you’ll want to know more about as you work with AppleScript Studio. It also describes the scripting terminology you need to write scripts and provides tips for programming with AppleScript Studio.

• “AppleScript Studio Cookbook” provides step-by-step instructions for performing some common AppleScript Studio tasks.

• “Currency Converter Tutorial” provides a simple tutorial that introduces the tools and processes you’ll use in most AppleScript Studio development.

• “Mail Search Tutorial: Design the Application” is the first of several chapters that make up a tutorial for a more complex AppleScript Studio application. This chapter describes the process of designing the application.

• “Mail Search Tutorial: Create the Interface” describes how to create the interface for the Mail Search application.

• “Mail Search Tutorial: Connect the Interface” shows how to connect Mail Search’s interface to event handlers in the application’s scripts.

• “Mail Search Tutorial: Write the Code” describes the handlers and script statements for the Mail Search application.

• “Mail Search Tutorial: Build and Test the Application” provides information on how to build and test the Mail Search application.

• “Mail Search Tutorial: Customize the Application” provides steps for customizing menus, icons, and version and copyright information in the Mail Search application.

• “AppleScript Studio System Requirements and Version Information” describes the system requirements for building and running AppleScript Studio applications.

• “Mail Search Tutorial, Full Script Listing” contains a complete listing of the Mail Search application’s script file.

• “Document Revision History” describes changes made to this document.

• “Glossary” defines key terms for working with AppleScript Studio.

Conventions

You’ll see the AppleScript continuation character (¬, which you create by typing Option-l) in some of the script listings in this document. When a line in a script ends with a continuation character, the next line is considered to be part of that line. You shouldn’t need the continuation character when you actually compile the scripts in AppleScript Studio, because you can use Xcode’s ability to wrap text instead. For more information, see “How Xcode Formats Scripts.”

Some listings in this document may use wrapped text, rather than the continuation character.

See Also

You can find getting started and overview documentation for AppleScript, AppleScript Studio, and related technologies, with links to all the available Apple documentation and resources (including mailing lists), here:

• Getting Started With AppleScript

• AppleScript Overview

Because AppleScript Studio relies heavily on the Cocoa application framework, you may also want to visit the Cocoa Documentation area, particularly these documents:

• Application Architecture Overview

• Cocoa Scripting Guide

You can also use any web search engine to many third-party books, products, and websites for AppleScript and AppleScript Studio.

---