TweetFollow Us on Twitter

Introduction To AppleScript Studio

Volume Number: 21 (2005)
Issue Number: 4
Column Tag: Programming

AppleScript Essentials

by Benjamin S. Waldie

Introduction To AppleScript Studio

In past articles, we have discussed many AppleScript-related topics. However, one of the topics that we have yet to touch on is AppleScript Studio, which is quickly becoming the tool of choice for AppleScript developers.

What Is AppleScript Studio

AppleScript Studio, contrary to what some of you may think, is not an application itself. Rather, it is the AppleScript development environment that is part of the Mac OS X developer tools.


Figure 1. The Interface Builder and Xcode Applications

The two main developer tools that AppleScript developers need to be concerned with in order to get started with AppleScript Studio are Interface Builder and Xcode. If you don't have these applications on your machine, you need to install the Mac OS X developer tools, which you should have gotten along with your Mac OS X system software.

Interface Builder, as the name implies, is what you may use to build interfaces for your scripts. Your interfaces may range from the very simple, to the extremely complex, depending on your programming skill, and the requirements of the task you want to automate. When building an interface in Interface Builder, you will have access to most of the standard interface elements that you see in Mac OS X, allowing you to design your interface with the look and feel of a regular application.

Xcode is the application in which you will write your AppleScript code, and link it to the objects in your interface. Xcode is not for the faint of heart. It is a real, live, professional development environment, and it has a learning curve. However, during this article, we will get started with some basics by creating a very simple AppleScript Studio application. Then, I'll make some suggestions for next steps in the learning process, and in future articles, we'll return to AppleScript Studio to discuss additional topics.

Building a Simple AppleScript Studio Application

For this initial project, we are going to build a fairly basic AppleScript Studio application, complete with an interface. This particular script will be used to select a random number that falls between two user-specified numbers.

Step 1 - Prepare Your Project

First, launch the Xcode application. Depending on whether or not you have launched Xcode before, you may see an initial dialog. Go ahead and dismiss any dialogs that may appear. Next, select New Project from the File menu, and you will be presented with a list of templates from which to choose. In the list, under Application, you will notice that there are a few types of templates with the word AppleScript in the name. In order to develop an AppleScript Studio application, you will want to select one of these. For this initial project, select AppleScript Application, and click the Next button.

The next interface will allow you to specify a name for your project, as well as a location. Enter the name Number Picker, specify a location, and click the Next button. At this time, Xcode will create your project in the specified location, and open the project in an interface window. Depending on the way your Xcode application has been configured, your window may look similar to figure 2.


Figure 2. An Xcode Project Window

An Xcode project contains a variety of components. However, at this initial stage, we are only going to be concerned about the following two:

    Number Picker.applescript - This file, located under the Scripts folder in your project, is your main AppleScript file. Here, you will write the AppleScript code we will be linking to your interface.

    MainMenu.nib - This file, located under the Resources folder in your project, is your interface file. This is where you will design your interface.

Step 2 - Design Your Interface

For this particular project, the next thing we are going to do is build our interface. To begin editing the project's interface, double click on the MainMenu.nib file in Xcode. This should automatically launch Interface Builder, and load the interface. If all goes well, you should see a MainMenu.nib window in Interface Builder, as well as a blank window titled Window. Click on the blank window.

Depending on the way your Interface Builder application is configured, you may or may not see an Info palette. To make this window visible, select Show Info from the Tools menu in the menu bar. If not already selected, choose Attributes from the popup menu at the top of the Info palette. Enter the text Number Picker into the Window Title field in the Info palette.


Figure 3. The Info Palette

Now, it is time to begin adding some interface elements to the window. Depending on the way your Interface Builder application is configured, you may or may not see a palette of interface elements. If this palette is not visible, you can make it visible by selecting Show Palettes from the Tools > Show Palettes menu in the menu bar.


Figure 4. The Interface Builder Object Palette

If you have never worked with Interface Builder before, you may want to browse through the various interface elements under each toolbar button in this palette. This should give you some idea of the types of interfaces you will be able to build in the future.

    NOTE: Holding your mouse over a toolbar button in the interface elements palette will display a tool tip identifying the category of objects associated with the button. Likewise, holding your mouse over an interface object in the palette will display its name.

For this interface, we're going to add only a few basic elements to our Number Picker window. We'll start by adding two text fields. To do this, click on the Cocoa Text Controls button, and select and drag the NSTextField object from the upper left of the palette into your window. Do this again, and you should have two text fields on your window.


Figure 5. Text Fields Added to an Interface Window

Next, select the NSTextField object labeled System Font Text, located in the lower right of the palette, and drag it twice into your window. Double click on each of these text fields that you have added to your window, and set their text to Starting Number and Ending Number.

Select the Cocoa Controls and Indicators button in the toolbar of the interface elements palette, select the NSButton object in the upper left corner of the palette, and drag it into your window. Double click on the button that has been added to the window, and change its name to Pick.

At this point, you may drag the various elements around the window until they are in the desired location. Notice as you drag elements around the window, that Interface Builder will display dashed lines suggesting proper placement of the objects, in relationship to other objects on the window. Try to arrange your interface similar to the one displayed in figure 6.


Figure 6. Interface Window Design

Step 3 - Add AppleScript Names to Inte face Objects

In order for the AppleScript code we are about to write to interact with the objects in our interface, we will first need to assign names to these objects. Sure, we could interact with objects by their index reference, such as text field 1 of window 1. However, when you start getting lots of interface elements, it becomes difficult to keep track of which objects are which. To assign a name to an object, first, select the object. Next, select AppleScript from the popup menu in the Info palette. You may then enter the desired name for the object into the Name field in the Info palette. For our interface, assign the name Main Window to the window. Next, assign the names Starting Number and Ending Number to the two empty text fields. Finally, assign the name Pick Number to the button in the window.

Step 4 - Link Interface Objects to AppleScript Code

Since we would like AppleScript code to trigger when we click the Pick button in our interface, we now need to link the button to our script. To do this, select the Pick button in the interface. Next, select AppleScript from the popup menu in the Info palette. You may have noticed already that when you have selected AppleScript from this popup menu, various event handlers appear below the Name field in the Info palette. These event handlers are actions that may be configured to cause the corresponding object to trigger specific AppleScript code. For example, for a button, the clicked event handler would cause the button to trigger AppleScript code whenever it is clicked by a user. Select the checkbox next to the clicked option.

Once you have selected the clicked event handler, you need to specify which AppleScript file to which the event handler will link. In this case, we only have one AppleScript file. However, for complex projects, we may have multiple files from which to choose. To specify our AppleScript file, select the checkbox next to Number Picker.applescript under Script at the bottom of the Info palette.


Figure 7. The Properly Configured Info Window for the Pick Button

Step 5 - Adding AppleScript Code

Now that we have created our interface, and linked the interface elements to our AppleScript file, it is time to begin editing our AppleScript code. Since we have configured our interface to trigger code when a user clicks the Pick button, we are going to edit the code that will trigger when this action occurs. To get started, ensure that the Pick button is still selected, and click the Edit Script button at the bottom of the Info palette. This should bring Xcode back to the front, and display the Number Picker.applescript script. You should notice that the script already contains some initial AppleScript code.

The first thing that we need to do is get the values entered by the user into the Starting Number and Ending Number fields in our interface. Next, we are going to want to select a number in between those two numbers.

tell window "Main Window"
   set theStartingNumber to contents of text field "Starting Number"
   set theEndingNumber to contents of text field "Ending Number"
   set theNumberList to {}
   repeat with i from theStartingNumber to theEndingNumber
      set end of theNumberList to i
   end repeat
   display dialog "And the number is... " & some item of theNumberList
end tell

Add the above code to the on clicked theObject event handler in your script.


Figure 8. AppleScript Code in the Xcode Script

Step 6 - Building and Testing the Project

Now that we have added our AppleScript code, it's time to build and test our project. To do this, click the Build and Go button in the toolbar of your Xcode window. If all goes well, your application should build and launch. Test the application by entering a starting number and an ending number, and then click the Pick button.


Figure 9. Our Completed Application

Step 7 - Expand Your Application

Obviously, the example application we created during this article is very simple, to say the least. In a real-world solution, you would want to add much more functionality. For example, we did not add any kind of protection to ensure that a user actually enters a number into the Starting Number and Ending Number text fields. Right now, a user could enter text, and the solution would produce an error.

There are many other things you could do to make this solution more robust, and I encourage you to explore ways that you can expand and enhance it. I also invite you to download an application that I created and released as a freeware tool. My application, titled Ticket Picker, was the basis for this exercise. I created the application to distribute to Macintosh User Groups for use during raffles and drawings. You can download the application from the Freeware Products section of my website at http://www.automatedworkflows.com.

Next Steps

So, where do you go from here? Well, as I mentioned before, AppleScript Studio has a lot to learn. However, there are some good resources that can help you in your journey. For one, when you install the Mac OS X developer tools, Apple provides numerous AppleScript Studio examples. These examples are completely unlocked and fully editable, and I encourage you to explore them. They can be found in the Developer > Examples > AppleScript Studio folder. Additional example scripts can be found on the AppleScript website at http://www.apple.com/applescript/studio/.

Another good way to learn about AppleScript Studio is to look over the extensive documentation provided by Apple. For the most up to date documentation, visit http://developer.apple.com/documentation/AppleScript/.

I've said it before, and I'll say it again. One of the best resources for learning about AppleScript is the growing community of developers. If you are interested in learning AppleScript Studio, you should consider joining the AppleScript Studio Mailing List, hosted by Apple at http://lists.apple.com/mailman/listinfo/applescript-studio. The thousands of developers who currently subscribe to this list will no doubt be a valuable resource as you get started.

In Closing

As the title of this article indicates, this article is by no means meant to serve as a comprehensive tutorial on AppleScript Studio. It is simply meant to serve as an introduction, and to show how it is not too complicated to begin putting together your own applications with interfaces. Of course, creating more complex applications in AppleScript Studio requires some hard work and dedication. However, with a little practice, you will be on your way in no time. In future articles, we'll delve deeper into the AppleScript Studio world, and explore some more exciting things that you can do.

Until next time, keep scripting!


Benjamin Waldie is president of Automated Workflows, LLC, a firm specializing in AppleScript and workflow automation consulting. In addition to his role as a consultant, Benjamin is an evangelist of AppleScript, and can frequently be seen presenting at Macintosh User Groups, Seybold Seminars, and MacWorld. For additional information about Benjamin, please visit http://www.automatedworkflows.com, or email Benjamin at applescriptguru@mac.com.

 

Community Search:
MacTech Search:

Software Updates via MacUpdate

VOX 2.8.24 - Music player that supports...
VOX just sounds better! The beauty is in its simplicity, yet behind the minimal exterior lies a powerful music player with a ton of features and support for all audio formats you should ever need.... Read more
Dropbox 24.4.17 - Cloud backup and synch...
Dropbox is an application that creates a special Finder folder that automatically syncs online and between your computers. It allows you to both backup files and keep them up-to-date between systems... Read more
OmniPlan Pro 3.7.1 - Professional-grade...
With OmniPlan Pro, you can create logical, manageable project plans with Gantt charts, schedules, summaries, milestones, and critical paths. Break down the tasks needed to make your project a success... Read more
OmniPlan 3.7.1 - Robust project manageme...
With OmniPlan, you can create logical, manageable project plans with Gantt charts, schedules, summaries, milestones, and critical paths. Break down the tasks needed to make your project a success,... Read more
Adium 1.5.10.4 - Popular instant messagi...
Adium is a fast and free instant messaging client which supports AIM, ICQ, Jabber, MSN, Yahoo!, Google Talk, Yahoo! Japan, Bonjour, Gadu-Gadu, Novell Groupwise, SIP/SIMPLE (Text), and Lotus Sametime... Read more
SteerMouse 5.1 - Powerful third-party mo...
SteerMouse is an advanced driver for USB and Bluetooth mice. It also supports Apple Mighty Mouse very well. SteerMouse can assign various functions to buttons that Apple's software does not allow,... Read more
File Juicer 4.57 - $18.00
File Juicer is a drag-and-drop can opener and data archaeologist. Its specialty is to find and extract images, video, audio, or text from files which are hard to open in other ways. In computer... Read more
1Password 6.7 - Powerful password manage...
1Password is a password manager that uniquely brings you both security and convenience. It is the only program that provides anti-phishing protection and goes beyond password management by adding Web... Read more
CleanMyMac 3.8.1 - $39.95
CleanMyMac makes space for the things you love. Sporting a range of ingenious new features, CleanMyMac lets you safely and intelligently scan and clean your entire system, delete large, unused files... Read more
Monolingual 1.7.8 - Remove unwanted OS X...
Monolingual is a program for removing unnecesary language resources from OS X, in order to reclaim several hundred megabytes of disk space. If you use your computer in only one (human) language, you... Read more

Latest Forum Discussions

See All

Sudoku Sweeper (Games)
Sudoku Sweeper 1.0 Device: iOS Universal Category: Games Price: $2.99, Version: 1.0 (iTunes) Description: A minimalist mashup of Minesweeper and Sudoku. Logic puzzle perfection. Every row, column and zone contains a bomb and one of... | Read more »
Under Leaves (Games)
Under Leaves 1.0.0 Device: iOS Universal Category: Games Price: $1.99, Version: 1.0.0 (iTunes) Description: Journey into the forest, the jungle or the depths of the deep blue sea. Find chestnuts for the pigs, a caterpillar for the... | Read more »
Ninja Pizza Girl (Games)
Ninja Pizza Girl 1.0 Device: iOS Universal Category: Games Price: $2.99, Version: 1.0 (iTunes) Description: In the not-so-distant future, rampart traffic congestion has resulted in only one way to deliver pizzas across town in thirty... | Read more »
SCRAP (Games)
SCRAP 1.0 Device: iOS Universal Category: Games Price: $2.99, Version: 1.0 (iTunes) Description: That day, for no apparent reason, SCRAP decided to wake up and run. He had to, because his activation was a mistake the "Factory" could... | Read more »
The Bunker (Games)
The Bunker 1.1 Device: iOS Universal Category: Games Price: $3.99, Version: 1.1 (iTunes) Description: The critically acclaimed console hit "The Bunker" comes to iOS, The groundbreaking live-action thriller adventure set in a real... | Read more »
Die With Glory (Games)
Die With Glory 1.2.0 Device: iOS Universal Category: Games Price: $2.99, Version: 1.2.0 (iTunes) Description: Die with Glory is an epic adventure game where your goal is to die in glorious fashion. You must help Sigurd, a brave old... | Read more »
Get Ike in the new Fire Emblem: Heroes u...
One of the most popular Fire Emblem characters is finally available in a new update to Nintendo'sFire Emblem: Heroes. [Read more] | Read more »
Die With Glory in a new viking adventure...
If you're a fan of classic adventure games you'll do well to pick upDie With Glory, the gorgeous new title from Cloud Castle inc. Die With Glory updatesthe gameplay of the same kind of adventure classics such asMonkey Island for modern, mobile... | Read more »
Get up to speed with everything you need...
In case you haven’t heard, MU Origin just got a colossal new update with new all-server events, battle modes, and systems making their way to the land of MU. Here’s a handy guide to everything you need to know about the latest content. [Read... | Read more »
Minimalist puzzle game, Cuts, free on iO...
If you're looking for a gorgeous puzzle experience on iOS devices, developer Gamebra.in's aesthetically interesting puzzler, Cuts, is discounted to free on the iOS App Store right now. [Read more] | Read more »

Price Scanner via MacPrices.net

New System Clock for macOS by B-Eng Now Avail...
Fehraltorf, Switzerland based B-Eng has announced the release and immediate availability of System Clock, the company’s new system monitor and information app developed exclusively for macOS. System... Read more
DEVONtechnologies Celebrates 15th Anniversary...
DEVONtechnologies celebrates its 15th company anniversary with a 30% discount on all its software products from May 1st through 5th, 2017. In spring 2002, DEVONtechnologies opened its website and... Read more
WaterField Designs Invites Customers to Help...
San Francisco based WaterField Designs invites customers and air travelers to participate in developing the next generation in-flight travel case, the Air Porter. Frustrated with limited legroom,... Read more
Save up to $260 with Apple refurbished 12-inc...
Apple has Certified Refurbished 2016 12″ Retina MacBooks available for $200-$260 off MSRP. Apple will include a standard one-year warranty with each MacBook, and shipping is free. The following... Read more
Digital Paper Tablet Offers Distraction Free...
I typically spend 8-10 hours a day gazing at the screens in my laptops and iPad, as tools of my livelihood, I don’t as a rule use electronic devices for pleasure reading. I subscribe to a daily... Read more
“Today at Apple” Bringing New Educational Ses...
Apple has announced plans to launch dozens of new educational sessions next month in all 495 Apple Stores ranging in topics from photo and video to music, coding, art and design, and more. The hands-... Read more
Smart Finance Free Comprehensive Personal Fin...
Moscow-based indie developer, Alexander Survillo has announced the release and immediate availability of Smart Finance: Personal Finance, Budget & Money 1.1.4, an update to his comprehensive... Read more
12-inch 1.1GHz Retina MacBooks on sale for $1...
B&H has 12″ 1.1GHz Retina MacBooks on sale for $100 off MSRP. Shipping is free, and B&H charges NY & NJ sales tax only: - 12″ 1.1GHz Space Gray Retina MacBook: $1199.99 $100 off MSRP - 12... Read more
13-inch 2.7GHz Retina MacBook Pro on sale for...
B&H Photo has the 13″ 2.7GHz Retina MacBook Pro on sale for $130 off MSRP. Shipping is free, and B&H charges NY & NJ tax only: - 13″ 2.7GHz/128GB Retina MacBook Pro (MF839LL/A): $1169 $... Read more
15-inch 2.2GHz Retina MacBook Pros available...
B&H Photo has the 15″ 2.2GHz Retina MacBook Pro available for $200 off MSRP including free shipping plus NY & NJ sales tax only: - 15″ 2.2GHz Retina MacBook Pro (MJLQ2LL/A): $1799.99 $200 off... Read more

Jobs Board

*Apple* Systems Engineer - California Polyte...
Cal Poly, San Luis Obispo Apple Systems Engineer Department: ITS - Customer & Tech Support (134900) College/Division: Academic Affairs Salary Range: Position Read more
*Apple* Mobile Master - Best Buy (United Sta...
**501042BR** **Job Title:** Apple Mobile Master **Location Number:** 000416-East Lansing-Store **Job Description:** **What does a Best Buy Apple Mobile Master Read more
Best Buy *Apple* Computing Master - Best Bu...
**501195BR** **Job Title:** Best Buy Apple Computing Master **Location Number:** 000211-Colorado Blvd-Store **Job Description:** **What does a Best Buy Apple Read more
*Apple* Mac Computer Technician - GeekHampto...
…complex computer issues over the phone and in person? GeekHampton, Long Island's Apple Premium Service Provider, is looking for you! Come work with our crew Read more
Product Manager, *Apple* Platforms - Viacom...
…Product Manager to drive the execution of its iOS and AppleTV experiences. The Apple Platform Product Manager will be a leader in our Agile/Scrum environment and Read more
All contents are Copyright 1984-2011 by Xplain Corporation. All rights reserved. Theme designed by Icreon.