home *** CD-ROM | disk | FTP | other *** search
/ Apple WWDC 1996 / WWDC96_1996 (CD).toast / Technology Materials / PlainTalk Developer / Text-to-Speech / Installer Source / How to build < prev    next >
Encoding:
Text File  |  1995-06-07  |  4.3 KB  |  113 lines  |  [TEXT/MPS ]
  1.  
  2.  
  3.                     How to build the Installers for TTS
  4.  
  5. This document describes how to build the Installer scripts and set up disk sets,
  6. for the developer to test.  This is not how SCM builds.  The scripts here build
  7. a Net Install style set of files.  A main folder holds the Installer and the
  8. Installer script and a folder corresponding to each disk of the disk set.  You
  9. can copy the contents of each disk folder to a floppy if you want to test that
  10. way.  The first disk also has the Installer and Installer script.
  11.  
  12. You will need to get some pieces from the Installer SDK in order to build:
  13.  
  14.     Installer                    The application to distribute
  15.     ScriptCheck                    MPW tool to complete and verify scripts
  16.     FileAndRsrcSplitterTool        MPW tool to split files or resources into pieces
  17.     InstaCompOneTool            MPW tool to compress multiple files
  18.     InstaCompOneSCExt.rsrc        Used by ScriptCheck to verify compressed files
  19.     
  20. Put these files in the ExternalPieces folder that's in the main folder.
  21.  
  22. You will also need to get any other externally generated files needed and put
  23. them in the ExternalPieces folder.  Currently:
  24.  
  25.     SimpleText
  26.  
  27. There will already be some files in the ExternalPieces folder.  These files came
  28. from SCM.  The SCM person should be contacted occasionally to get any later
  29. versions of these files.
  30.  
  31. Build all the files that are going to be installed and put them all in one folder
  32. inside the Installer folder.  I called mine BuiltPieces so for building Mexican 
  33. Spanish TTS, the contents are, e.g.:
  34.  
  35.     HD:Installer:BuiltPieces:MacinTalk Español Mexicano
  36.     HD:Installer:BuiltPieces:Carlos
  37.     HD:Installer:BuiltPieces:Catalina
  38.     HD:Installer:BuiltPieces:Speech Manager
  39.     HD:Installer:BuiltPieces:Speech
  40.     HD:Installer:BuiltPieces:Using Mexican Spanish TTS
  41.     HD:Installer:BuiltPieces:MexicanSpanishDefault.rsrc
  42.  
  43. Change directory to the main folder with all the Installer source files and run
  44. the appropriate build script.  Current scripts:
  45.  
  46.     BuildMexicanSpanishTTS
  47.     BuildEnglishTTS
  48.     
  49. There is a mandatory argument of the name of the folder that has all the files
  50. that you built (e.g. BuiltPieces).  There is also an optional -s argument that
  51. says to rebuild the script only.  The -s argument can only be used if you've
  52. already run the script without -s in order to set up the folders and all the
  53. other files besides the script.  For example, to build the first time you could:
  54.  
  55.     BuildMexicanSpanishTTS BuiltPieces
  56.     
  57. and to update a minor change to the Installer script you could:
  58.  
  59.     BuildMexicanSpanishTTS -s BuiltPieces
  60.     
  61. If you make a signficant change to the script, such as adding, deleting, moving,
  62. or renaming a file, then you need to start over building without -s.
  63.  
  64.  
  65.  
  66.             Splash Screens
  67.  
  68. The source file for a splash screen is just the .rsrc file that holds the
  69. PICT.  Currently:
  70.  
  71.     MexicanSpanishTTS.rsrc
  72.     EnglishTTS.rsrc
  73.  
  74. To edit a splash screen you can use ResEdit to copy the PICT into a color
  75. paint program, edit away, and then paste back into the .rsrc file.  For the
  76. 1.4 build, Don Lindsay used PhotoShop to do the editing.
  77.  
  78. The text is done using the Help Screen Fonts from the Installer SDK, as the
  79. manual recommends.  So you'll want to install those fonts before editing.
  80. However, the user won't have these fonts, so the text needs to be bitmapped.
  81. If the paint program doesn't make this easy (maybe they all do), copy the
  82. text to MacPaint, and then lasso it and copy it back.
  83.  
  84. A problem to avoid is that some picture elements don't display properly
  85. under System 6.  For example, I created the icons for the black and white
  86. splash screen by copying then out of the ResEdit editing window for an
  87. ICN# resource, and pasting into MacDraw Pro.  The icons displayed as
  88. garbage under System 6.  Copying the icons to MacPaint and back fixed
  89. the problem.
  90.  
  91.  
  92.  
  93.             Help Pages
  94.             
  95. We use the additional help pages that came with the Installer SDK.  These
  96. are PICT's that were copied into the resource files that are part of the
  97. build for each Installer script.  Currently:
  98.  
  99.     MexicanSpanishTTS.rsrc
  100.     EnglishTTS.rsrc
  101.  
  102. The PICT ID's are specified in an 'inpr' resource.
  103.  
  104.  
  105.  
  106.             Icons
  107.         
  108. When the icon for any of the built files changes (e.g. the Speech Manager) then
  109. there are two places in the Installer files that might need updating.  The
  110. splash screens have some icons in them.  Also, some icons are included in
  111. resource files so that they show up in the info window for packages in the
  112. Custom Install and Custom Remove panels of the Installer.
  113.