Compiling global functions

This utility is used to compile specified global functions in an application dictionary. If your application uses global functions, you may need to use this utility under the following circumstances:

• If you transferred global functions using the Transfer Resources utility, but didn’t have the Compile Scripts option marked, use the Compile Global Functions utility to compile those global functions.
• If you transferred global functions into a dictionary using the Transfer Resources utility, but some global functions couldn’t be compiled because resources were missing from the destination dictionary, use the Compile Global Functions utility to compile the uncompiled global functions after the missing resources have been included.
• Before you send out your application, it’s a good idea to compile all global functions using the Compile Global Functions utility. This ensures that all resources referenced by the global functions are included in the dictionary, that the latest version of scripts are being used, and that the global functions don’t contain any syntax errors.

To begin compiling global functions, select an editable dictionary, then choose Compile Global Functions from the Scripts menu to display the Compile Global Functions window, shown in the following illustration.

1. Select a series.

Select the series that includes the global functions being compiled. The global functions in that series will appear in the Scripts list.

2. Select compiling options.

The following options control how scripts will be compiled.

Compiler Errors Only   Mark this option to include only compiler error messages in the status report that is printed after the global functions are compiled. Otherwise, all status messages will be saved to the report.

Compile Debug   Mark this option to include debugging information in scripts, and to compile the debug and assert statements in your code. If you don’t mark this option, you won’t be able to use the Script Debugger, and the debug and assert statements won’t be executed. We recommend unmarking this option in the final version of your application to ensure optimal script performance.

3. Select scripts to compile.

Select the global functions to compile by selecting each one and clicking Insert to add it to the list of selected scripts. Double-clicking a script performs the same function. You can select and compile functions from several series at one time. To compile all global functions in the selected series, click Insert All. Use the Remove and Remove All buttons to remove scripts from the Selected Scripts list.

4. Compile scripts.

Click the Compile button to compile the selected global functions. The Report File Name dialog box will appear. Enter the name and location for the Compile Global Functions Status Report file, then click OK to continue the compiling process, or click Cancel to return to the Compile Global Functions window.

5. Use the status report to verify that scripts compiled.

Once compiling is complete, the status report will be printed to a text file. This report lists each global function along with a message that indicates whether it was compiled successfully. If the global function wasn’t compiled successfully, the message indicates the compiler error that occurred. If you mark Compiler Errors Only, only information about scripts that couldn’t be compiled will appear in the report.

Documentation Feedback

---