11 Building Escale
Escale is Open Source. This means that developers can modify it with ease. This section explains how to build Escale with or without modifications. Regular users do not need to build Escale. Just double-click the Escale application.
Source code is in the source folder. Escale can be built with ProjectBuilder and CodeWarrior. Please note that only the ProjectBuilder project lets you build a multi-lingual version of Escale.
11.1 Building with ProjectBuilder
ProjectBuilder is Apple's free development tool. To build Escale, you need Apple's latest development tools (the December 2002 release) which you can download from the Internet on Apple's ADC website. Registration is required but it is free (ADC Online). Please consult Apple's website at http://developer.apple.com.
Once you have installed ProjectBuilder, just open Escale's project and click the build button. The project is at:
source/Desktop Connection Library/Sample Code/Escale/Escale.pbproj
Please note that there is a bug in ProjectBuilder that affects relative paths with ../ in them such as the ones in Escale. Be sure that Escale's source code has no accent in its path.
11.2 Building with CodeWarrior
CodeWarrior is a commercial development environment by Metrowerks. You can obtain it from their website (http://www.metrowerks.com). We use the academic version, but it does not differ from the regular version. To build Escale, you need CodeWarrior 8.3 for Macintosh.
Once CodeWarrior 8.3 is installed, just open Escale's project, choose the Debug or the Final target from the pulldown menu and select Make in the Project menu. The project is at:
source/Desktop Connection Library/Sample Code/Escale/Escale.mcp
Please note that CodeWarrior will only build English versions of Escale. We did not figure out how to localize the application properly as in ProjectBuilder (there is surely a way, we mostly used CodeWarrior to ensure that two compilers can compile the code and for debugging purposes).
11.3 Building the AppleScript applets
The AppleScript applets do not need to be built. Just open them with the Script Editor. Please note that there is a bug in Apple's Script Editor Beta, it will lose the description of the script.
11.4 Building the documentation
To build the documentation, you need pdflatex. We got it from TeX i-Packages (http://www.rna.nl/tex.html). The documentation was edited with TeXShop (freeware, http://www.uoregon.edu/ koch/texshop/texshop.html) and BBEdit (commercial editor, http://www.barebones.com).
The PDF can be generated by invoking pdflatex twice in source/Desktop Connection Library/Documentation/latex with: pdflatex EscaleUserGuide.tex
The documentation can be viewed with Acrobat Reader (free, provided with MacOS X) and Preview (built into MacOS X).