Welcome!

Please read this entire document.

Welcome to StuffIt InstallerMakerª 8.0, the first version of InstallerMaker to run native in Mac OS X (10.2 or higher) while still providing support for creation of installers which will run on earlier systems. Installation will provide you with the StuffIt InstallerMaker 8.0 (build 21)  application and its associated files along with preliminary documentation.  You will soon find that StuffIt InstallerMaker is the most powerful and easy to use installer available for the Mac OSª.  

InstallerMaker builds:

In an effort to keep InstallerMaker up-to-date and free of issues which might delay developers' release of their products, InstallerMaker is updated as the need arises. Each new build will have the build number incremented. This is build 21. When logging bugs, or contacting our Developer Technical Support, it will help to let us know which build you're working with. Check our site at: http://www.stuffit.com/mac/installermaker/preview.html regularly for updates, newly discovered issues and workarounds, and to report bugs.

System Requirements:

InstallerMaker 8.0
	Mac OS 10.2 or higher

Installers built with IM 8.0
	Mac OS 8.1 with Carbonlib 1.0.4 and Navigation Services 1.0.1 or higher
	or Mac OS 8.5 or higher (without Carbonlib, build as "Classic" installer)
	or Mac OS 10.1 or higher 

There are a few important files that we would like to bring to your attention.  These are:

Read Me First!

This is the document you are now reading.  

Documentation

THESE DOCUMENTS ARE IN THE PROCESS OF BEING UPDATED FOR INSTALLERMAKER 8.0. The earlier copies are included for general reference in the meantime as the User Interface and options have remained substantially similar with the exception of those items noted as added, changed, or removed below. When available updated guides will be available at: 

		http://www.stuffit.com/mac/installermaker/preview.html

The Documentation has been organized into three separate documents Ñ Getting Started, Tutorials, and Reference to speed access to specific information. They can be found in the ÒDocumentation & License AgreementÓ folder.  

How to License StuffIt InstallerMaker

StuffIt InstallerMaker is a licensable product. The software you have now is ready to create product installers. All that is required to distribute your installer is to license InstallerMaker and receive your registration code for your installer. 

Information on how to license StuffIt InstallerMaker can be found in the file named ÒHow To License InstallerMaker.Ó The actual License Agreement can be found in the ÒDocumentation & License InfoÓ folder "InstallerMaker License."

Thanks!

We at Aladdin Systems would like to thank you for choosing Aladdin StuffIt InstallerMaker and for your continued support. 

==========================================
What's New:

¥ The InstallerMaker application runs natively under Mac OS X (10.2 or higher).
¥ The "Authentication Wrapper" an unsupported external addition in IM 7.x to enable installers to require an Administrator password and subsequently install to protected locations has been incorporated into IM itself.
¥ Results of "Find" tasks are retained and can be reused by subsequent tasks.
¥ "Find" tasks can now look for partial paths such as ApplicationName/Plug-ins streamlining the "Find" task and reducing the chance of multiple false hits.
¥ InstallerMaker now recognizes Packages/Bundles and can replace one by overwriting it rather than merging contents as it does with Folders that already exist.
¥ Mac OS X specific Locations have been added and Locations re-organized into "Classic Locations" "OS X Locations" and "Misc. Locations."
¥ Shell scripts can now be installed then launched with a "Launch" task and either preserved or removed from the system at the end of an install for Mac OS X installers. Scripts must installed by the installer and must be named either scriptname.imscript (will be deleted after running) or scriptname.imscriptk (will be kept after running). The following Environment Variables are set by the Installer under Mac OS X to help streamline your scripts:
All Installers:
- IMUSF, "InstallerMaker User Specified Folder,"  stores the full path to the folder selected by the user selected by the user during installation.
Authenticated Installers Only:
- IMLAUNCHINGUSERNAME stores the username of the user who launched the installer.
- IMLAUNCHINGUSERID stores the userid of the user who launched the installer.
- IMHOMEDIR stores the full path to the Home directory of the user who launched the installer.
¥ Permissions of installed files can be set in InstallerMaker. Default permission are _rwxrwxr_x, or: Read, Write, Execute for Owner and Group; Read and Execute only for All. Changes are made in the GetInfo dialog within InstallerMaker. NOTE: When an existing file is overwritten by a newly installed file the installed file will have the same permissions as the file its replacing. If the new file requires different privileges the existing file must first be removed with a "Delete" task prior to installing the new file. 


Things to Note, Possible Conflicts, and Workarounds

¥  When working with existing archives, please work on a copy to avoid any possibility of data loss or corruption.

¥ Though there is an option to make Classic Installers in the build dialog, this function currently does works only for Mac OS 8.5 and above. Please continue to use IM 7.x to build these installers for earlier System versions.

¥ Installers running on Mac OS X will not be able to restart the computer.

¥ When opening a 7.x  archive, the archive settings such as Destinations, Gestalts, Task options, etc may be lost or changed. It is highly recommended that you check these settings after archive conversion. (The same is true should you open an 8.x archive in IM 7.x.)

¥ Invisible files named ".DS_Store", created by Mac OS X, are now treated the same as invisible icon files when executing delete tasks on folders. If the task is set to remove only empty folders, and if the only items within the target folder are an invisible icon file and/or an invisible .DS_Store file, the task will consider the folder "empty" and remove it. You will not need to create delete tasks to remove these items in order to remove the folder.

¥ Domain settings do not apply when using Find to specify a destination for installation or a source location for tasks.  While Mac OS X provides support for obtaining a reference to a given system defined location (such as the "Application Support" folder) in a specific domain, it does not provide a means of acquiring the domain an item resides in from the item's location, nor does the system provide support for conducting disk searches limited to a specific domain.

¥ Mac OS X will not allow installers to use the Temporary Items folder or Cleanup At Startup folders for non-boot disks.

¥ Mac OS X install domains cannot be resolved in relation to non-boot system volumes.  All domains resolved by the OS correspond to the boot system only.

¥ Mac OS X does not presently support allowing Classic installers or carbon installers running in the classic environment to resolve destinations for the native OS X environment.

¥ Mac OS X does not support allowing carbon installers running in the native OS X environment to resolve system install destinations for classic environment system locations.

¥ In accordance with Mac OS 9's limitations, Limited and Panel users will not be able to install anything to the system folder or any other fixed location the user does not have access to. In Mac OS X a user can only install to locations for which they have write privileges unless the option to "Use Authentication (run as root)" option is checked in the Build dialog. Otherwise these users will get an "Access Denied" message and the install button on the user specified folder selector dialog bOS will be greyed.

¥ We do not recommend editing an installer archive over a server in general and do not support the manipulation of archives over personal filesharing volumes.

¥ At this time when adding files to an InstallerMaker archive, files with names longer than 31 characters (including any filename extension) will have their names truncated much as earlier Mac OS versions would. We realize this is an inconvenience and are examining options. In the meantime a shell script named "showlongnames" is included with this version of InstallerMaker. It can be invoked from the commandline in the Terminal with the path to your project as an argument and will output a list of paths in the project with "basenames" that exceed 31 characters. To use this command you will need to copy it to a place in one of your Unix PATH variables such as "/usr/local/bin" and logout then back in,  invoke it with its full path name, or navigate to the InstallerMaker folder and invoke it with "./showlongnames"

What's Gone:

¥ "Resource Compression" of classic application resources is no longer available in IM.

¥ Trialware is no longer provided for directly in InstallerMaker but third-party solutions are compatible. 

¥ Demoware is no longer provided for directly in InstallerMaker but third-party solutions are compatible.

¥ Online Registration is no longer provided for directly in InstallerMaker but many developers use a "Launch" action to open a webloc for this purpose.

==========================================

Upgrading to StuffIt InstallerMaker 8.0 from previous versions of StuffIt  

InstallerMaker 8.x series uses the same registration number. Please contact our Developer Licensing department if you cannot locate your registration number. They can be reached at ph:  (831)761-6200, fax: (831)761-6209, or email: dev.sales@aladdinsys.com.

InstallerMaker 8.x can open IM Archives created with IM 7.x but there are some caveats. See above for possible conflicts and workarounds.

InstallerMaker 8.x can build Carbon installers which will run on Mac OS 8.1 or newer with Carbonlib 1.0.4 (and Navigation Service 1.0.1) and Classic Installers which will run on Mac OS 8.5 and higher, but it itself will only run on Mac OS 10.2 or higher. 

If you need to run InstallerMaker on earlier systems, or build installers for systems without prior to Mac OS 8.1 (or 8.1 without Carbonlib installed), you must continue to use IM 7.1.2.

==========================================

Special Note to Developers, Product Managers, and Network Administrators

StuffIt InstallerMakerª provides many advanced features while being very easy to use in fact this installer was created in about an hour. By using InstallerMaker for this installer, we not only saved space due to AladdinÕs advanced compression technology, but also provided our users a way to easily customize installation. If you are interested in making installation easier for your users while saving download time and distribution costs; contact our licensing department at:

Aladdin Systems, Inc.
Installer Licensing
245 Westridge Dr.
Watsonville, CA 95076

ph:  831/761-6200
fax: 831/761-6209

Internet: http://www.aladdinsys.com/
email: dev.sales@aladdinsys.com

Copyright © 1993-2003 Aladdin Systems, Inc. InstallerMaker is a trademark of Aladdin Systems.  All product names are trademarks or registered trademarks of their respective holders. 