If a scriptable application or scripting addition on which a compiled script depends is missing, the script might not run, or could refuse to open for reading and editing.

To help with this problem, Script Debugger can generate a manifest for your script — a list of the scriptable applications and scripting additions on which it depends. That way, if you intend to move the script to another machine or send it to another user, you’ll be forewarned about the script’s dependencies.

To see a script’s dependencies in the Manifest dialog:

• Choose File > Show Manifest. (You can also add a Manifest button to the script window’s toolbar.)

The script’s dependencies are listed by category (Application Dependencies and Scripting Addition Dependencies), along with commands that the script directs at each one. For example, this script:

    tell application "Finder" to beep

would list the Finder in the Application Dependencies category, and would list StandardAdditions.osax in the Scripting Addition Dependencies category along with the beep command. (To see the beep command listing, click the triangle next to the StandardAdditions.osax listing, to open the triangle.)

• You can reveal a required application or scripting addition in the Finder:

  • Select the application or scripting addition and press Reveal.

• You can view the dictionary for a required application or scripting addition:

  • Select the application or scripting addition and press Dictionary.

    If you select a command before pressing the Dictionary button, the dictionary displays the information for that command.

A special situation can arise when a script depends on a scripting addition which is now missing. The scripting addition’s terminology can’t be resolved during decompilation, so raw Apple event codes appear, and AppleScript has no way to tell you what the trouble is or what scripting addition is missing (because, unlike applications, scripting additions are not explicitly targeted by name). To help with this problem, the manifest also lists Apple events in your script that can’t be resolved (Unknown Apple Events). You can select such an Apple event in the list and Script Debugger will search for the Apple event code in the online database at www.osaxen.com in an attempt to identify the missing scripting addition.

(Another solution to this problem, if the script was last saved with Script Debugger, might be to open the script as text; this will show the English-like terminology for the missing command, which might help you work out what scripting addition it comes from.)

The dialog also lets you export and save as a text file the information it presents, in either XML (Save XML Report) or plain text format (Save Text Report).

Technical Note: Script Debugger cannot detect coercions provided by scripting additions. That’s because nothing can detect them. They do not involve any terminology and are not documented in a scripting addition’s dictionary. This is an AppleScript flaw. Fortunately, the situation is unlikely to arise.