Additioner 1.1

Features
Additioner

Scripting additions popup menu
Selected addition path text field
Version display text fields
Install a scripting addition
Remove a scripting addition
Delete or re-install a scripting addition
Reveal scripting additions in Finder


Scripting additions popup menu   
When you launch the Additioner, it fills the popup menu with as many scripting additions as it can locate. From the Additioner's point of view, there are three categories of scripting additions: ready to install, currently installed, and recently removed, and the popup displays them in that order. Currently installed and recently removed scripting additions are each subdivided into sub-categories, User, Local and System. The Additioner removes empty categories from the menu. Here is an example of how the popup might appear with nearly all categories present:



The Additioner looks in various places for ready to install scripting additions: first, in the same folder as the Additioner. At launch time, if any are found there, the Additioner selects the first one alphabetically. Second, in a structured folder named Installable Additions, also in the same folder as the Additioner. Version 1.0.2 of the Additioner also allows you to drag and drop installable scripting additions from Finder onto the Additioner window.


The Installable Additions folder has the same structure as a Removed folder. At the first level it contains folders with the displayed name of the scripting addition, without its file extension. Inside these are other folders, each corresponding to a version of that scripting addition. Each version folder contains one copy of the scripting addition, which has that name and version. By using this structure, the Additioner can keep track of multiple versions of each scripting addition, without having to delete any.

The Additioner recognizes three common locations for currently installed scripting additions, designated User, Local and System. Here are their paths:

User:
yourHomeDirectory/Library/ScriptingAdditions/

Local:
/Library/ScriptingAdditions/

System:
/System/Library/ScriptingAdditions/

User scripting additions load into scriptable applications you launch, not those launched by other users. By default, users do not yet have their own scripting additions folder. The Additioner creates it when necessary. You can open this folder by choosing the menu item "File : Reveal In Finder : Installed User Additions".

Local scripting additions are shared by all scriptable applications launched by all users of this machine. Before you can make changes to this folder, you must authenticate with an administrator password. By default, machines do not have a Local scripting additions folder. The Additioner creates it when necessary. You can open this folder by choosing the menu item "File : Reveal In Finder : Installed Local Additions".

System scripting additions are also shared by all scriptable applications launched by all users, and include those scripting additions supplied with Mac OS X, such as "Standard Additions". Before you can make changes to this folder, you must authenticate with an administrator password. You can open this folder by choosing the menu item "File : Reveal In Finder : Installed System Additions". For greatest system stability, avoid changing the System folder. Change the Local domain instead by clicking Local Install.

The Additioner copies recently removed scripting additions into a Removed folder within the ScriptingAdditions folder where it was installed. Each has the same structure described above for the Installable Additions folder.

To refresh the popup menu, click the Rescan button. Whenever the Additioner completes a User Install, Local Install, System Install, Remove or Delete, it automatically updates the popup menu and returns all the controls to the default state.

If the popup contains many scripting additions, you can save time if you click once to display the popup menu, then type the name while the menu is displayed, and press the return or enter key to finish your selection. You can also use the up and down arrow keys to move between displayed menu items.


Selected addition path text field   
After you select a scripting addition from the popup menu, the Additioner displays its path. You can copy this path from the field, but you can not edit the text.




Version display text fields   
The version of the selected addition, and the versions of currently installed Local and User additions with the same name are displayed in the fields below the selected addition path.




Install a scripting addition   
When you select a ready to install scripting addition from the popup, the Additioner enables the Local Install and User Install buttons. The User Install becomes the default button, helping you to avoid disturbing applications launched by other users on the same machine.



If you click the Local Install button, you must be an administrator user and you must enter your password. The Additioner uses the standard Unix authentication timestamp. For the next few minutes, you can make other changes to the Local scripting additions folder without re-entering the password. However, as soon as you quit the Additioner, it cancels the timestamp to provide better security. (Note: if the timestamp was already active when you launch the Additioner, it leaves the timestamp active when you quit). If you have never installed a Local scripting addition before, the Additioner creates a folder at /Library/ScriptingAdditions/.


If you click the User Install button, you do not need to enter an administrator password. If you have never installed a User scripting addition before, the Additioner creates a folder at yourHomeDirectory/Library/ScriptingAdditions/.

When you install a Local or User scripting addition, if a scripting addition of the same name already exists in the destination folder, the Additioner automatically performs a Remove on the existing scripting addition instead of deleting it.


Remove a scripting addition   
If you select a currently installed addition from the popup menu, the Additioner enables the Remove button, makes it the default, and disables the install button for the folder containing the selected scripting addition. The other install button remains enabled. For example, if you select a User scripting addition from the popup, then Remove becomes default, User Install is disabled but Local Install remains enabled. If you click Local Install it will copy the selected User addition into the Local folder, without deleting the selected User addition.



When you click the Remove button, the Additioner moves the scripting addition from its currently installed folder into the proper Removed folder, creating the Removed folder and any sub-folders as necessary. In the popup menu, the scripting addition moves from the currently installed section to the recently removed.

To remove a currently installed Local scripting addition, you must be an administrator user and you must enter your password
. The same authentication timestamp applies as when you install the scripting addition.

When you remove any Local or User scripting addition, if a recently removed copy with the same name already exists in the corresponding Removed folder, the Additioner takes one of two actions, depending on the version. If the two versions are different, then both scripting additions stay in the same Removed folder, in different version sub-folders. However, if the versions are equal, the Additioner automatically, and without warning, performs a Delete on the previously removed scripting addition.

After the Additioner removes an installed scripting addition, it selects the recently removed copy in the popup menu. This allows you to delete it, or (by default) to re-install it.

Note: you can not remove Standard Additions, because the Additioner uses it to implement these features. If you try to remove Standard Additions, it is copied into the recently removed folder, but the original always remains in the System scripting additions folder.


Delete or re-install a scripting addition   
If you select a recently removed scripting addition from the popup menu, the Additioner enables all three buttons. It makes either Local Install or User Install the default button, depending on which Removed folder contains the selected scripting addition. This allows you to re-install a recently removed scripting addition easily into its previous location. Lastly, the Additioner displays a Delete button in place of the Remove button.





When you click Delete, the Additioner displays a warning dialog allowing you to Cancel, Reveal the selected addition in Finder, or go ahead and Delete it. If you click Delete in the warning dialog, the scripting addition ceases to exist on disk. There is no Undo for Delete.

If you click Local Install or User Install to re-install a recently removed scripting addition, and a currently installed copy with the same name already exists in the destination folder, the Additioner takes one of two actions depending on the version. If the two versions are different, the Additioner automatically performs a Remove on the currently installed copy, before re-installing the one you selected. However, if the versions are equal, the Additioner automatically, and without warning, replaces the currently installed copy with the one you re-installed.

To Delete or re-install a recently removed Local scripting addition, you must provide an administrator password, or cancel the operation. The same authentication timestamp applies as when you click System Install.

If you delete or re-install the last recently removed version of a scripting addition, the Additioner also deletes the now empty sub-folder that contained it. In the same manner, the Additioner also deletes empty Removed folders. However, it will not delete an empty User scripting additions folder. The System scripting additions folder is never empty: it always contains Standard Additions.


Reveal scripting additions in Finder   
The Additioner lets you see the additions you have installed and removed. Simply choose one of the sub-menu items of Reveal In Finder under the File menu.



If the Addition can not find the item you choose, it displays an alert and shows the path it was trying to use.



           <----- BACK: Getting Started                                                      NEXT: FAQ ----->




Thursday, 07-Aug-2008 02:07:40 MST

© 2004-2007 Stuart B. Russell. All Rights Reserved.
Trademarked terms are the property of their respective owners.