PATH Contents > Customizing component settings
Customizing component settings

When you create a new component, by creating a new project or adding a component to a metapackage, its information and options are set by default. This documents shows what these settings are and how to change them.

Customizing the component description

The information in the Description section is used by Installer for its main window.

This section allows to customize the following pieces of information:

All this information can be localized. By default, the description is the same for every language. To make Installer display a localized description, you will need to add one.

To customize a component description:

1Select the component in the Packages & Metapackages list.
2Choose View > Settings.
3Type the new values in the text fields of the Description section.

To add a localization:

1Select the component in the Packages & Metapackages list.
2Choose View > Settings.
3Choose Add Localization… from the localization pop-up menu.
4Type the name of the localization and click Add.
5Type the new values in the text fields of the Description section.

To edit a localization:

1Select the component in the Packages & Metapackages list.
2Choose View > Settings.
3Choose the localization from the localization pop-up menu.
5Change the information

To remove a localization:

1Select the component in the Packages & Metapackages list.
2Choose View > Settings.
3

Choose the localization to remove from the localization pop-up menu.

Note: The International localization can't be removed. If you do not wish to use an international localization, just leave the text f ields empty for this localization.
4Choose Remove… from the localization pop-up menu.
5Click Remove.

Customizing the component display information

Display information is used by the Finder for the Get Info window.

Here is the description of the attributes in the Display Information section:

Notes:
  • By default, the icon file is referenced by an absolute path name. You can switch to a relative path name using the pop-up menu of the text field.

  • This document shows how to change the file reference with the standard open dialog. You can also directly type the path or drag and drop an icon file in the text field (as long as it's not being edited).

  • If the reference points to a file which does not exist (any more), the path name will be displayed red.

To customize the display Information of a component:

1Select the component in the Packages & Metapackages list.
2Choose View > Settings.
3Type the values.

To use a customized icon:

1Select the component in the Packages & Metapackages list.
2Choose View > Settings.
3Choose Choose… from the Action pop-up menu of the Display Information section.
5

Select the icon file to use for the component.

Note: The only supported format for icons is: icns.
6Click Choose.

Customizing the component version

The information in the Version section are used by Installer to know the version of the component.

Installer can then determine if a package older than the installed one is going to be installed and prevents the installation if the Allow Revert to Previous Version flag is not enabled. Additionally, if the same version of a required component is being installed within a metapackage, it will become selectable.

This section allows to customize the following pieces of information:

To customize the component version:

1Select the component in the Packages & Metapackages list.
2Choose View > Settings.
3Type the values for the major and minor versions in their respective text fields.

Tweaking component options

The Options section is only availble for packages. These options define the behavior of the package before, during and after the installation.

The Restart mode defines the behavior Installer shall follow if the installation is successful.

You can choose amongst five modes:

Important: the behavior will only be applied if the component is installed on the root volume. With metapackages, the more restrictive behavior of the children component will be applied.

The authorization mode specifies which category of users can install a package. Additionally, this dtermines the user id which will be used to run installation scripts.

Three authorization mode are available:

Authorization  Current User  Authentication required  Installation Privileges 
No Authorization Required Standard No Current User
Administrator   No Administrator
root No root
Admin Authorization   Standard Yes Administrator
Administrator No Administrator
root No root
Root Authorization Standard Yes root
Administrator Yes root
root No root

The flags options defines the Installer behavior regarding the component and the installation of its files. All flags are disabled by default.

Eight flags can be changed:

To change the restart mode:

1Select the package in the Packages & Metapackages list.
2Choose View > Settings.
3Choose the mode from the Restart pop-up menu.

To change the authorization requirement:

1Select the package in the Packages & Metapackages list.
2Choose View > Settings.
3Choose the required authorization from the Authorization pop-up menu.

To enable or disable a flag:

1Select the package in the Packages & Metapackages list.
2Choose View > Settings.
3Select or unselect the flag checkbox.


Author: Stéphane Sudre