Setting up Wizard project files

In the following steps, use letter case and extensions exactly as stipulated. The instructions result in you creating an executable Mac OS 'bundle' that runs your wizard. Now:

• Create a folder and name it with your project title, e.g. My First Wizard - or a name of your choice. At the end of the process this folder will become your bundle so the folder name is the name of the wizard file you will distribute,
• Inside this create a folder called Contents.
• Inside Contents, create...
  • a new plain text file called PkgInfo. Edit the latter so it contains the text (without quotes) "TwizCere" with no line return after it. Save the text file. The file has no extension; the Mac 'type' should be "TEXT" and the 'creator' can be anything including a blank (no setting). If you have Apple Development tools and understand them, you can create an Info.plist instead of PkgInfo, but the first seems to work fine and is easier for less tech-savvy users.
  • a folder called MacOS (all one word). Inside MacOS go a file and at least 2 folders:
    • Your wizard configuration file wizard.twiz. Exactly how this file is compiled is covered in the next note - for now save a blank plain text file of the correct name in this location.
    • The first folder is optional - a folder to hold any assets, normally images, used by the wizard's UI; a sensible default for this is resources but you can choose something different. If your configuration file (above) is already written you must use the folder name used in that file.
    • The second folder is a folder containing the TB assets (TBX, templates, etc.) that your project needs. Convention in wizards thus far is that this folder has a name relating to the project. If your configuration file (above) is already written you must use the folder name used in that file. The content is up to you, but should includes all files and support resources (e.g. documentation) that your project needs
• Now navigate back to your start folder My First Wizard and edit the name to add the extension '.twiz' thus: My First Wizard.twiz. The folder should now show a TB wizard icon and double-clicking the icon will open the wizard (if you've completed your wizard's configuration file).

From now on, to open your bundle, e.g. to add or edit assets, Ctrl+click or right-click the icon and select the pop-up menu item "Show package contents". A new Finder window opens allowing you to navigate in a normal Finder manner around your wizard project's files.

Licensed under Creative Commons Attribution-Noncommercial-Share Alike 3.0 License
[See aTbRef CC licence Attribution/Waiver info info]