24.3 Package Manager

The Package Manager is Origin's new replacement for OPK files. The old OPK files are binary files and were limited when it came to being used for module installation. The new OPX files are XML and have been designed with the goal of making module installation simpler for the user. You access the Package Manager dialog from the Tools menu.

The Package Manager dialog has a single File menu. This menu contains the following items:

 New Create a new package. This will cause the current package, if one is open, to be closed. If the current package has been changed but not saved then you will be prompted to save or discard the changes or cancel the creation of a new package. Open an existing package file. This will cause the current package, if one is open, to be closed. If the current package has been changed but not saved then you will be prompted to save or discard the changes or cancel the creation of a new package. Save the current package to disk using it's current file name. If the package is new and does not yet have a file name then you will be prompted for a file name. Save the current package using a new file name. You will be prompted with a file dialog to choose a package file. After choosing a package file and clicking Open the package will be installed. This item will show you the "Installed Packages" dialog. This dialog lists all the packages currently installed. Simply select the packages you want to uninstall and click the Uninstall button. Extracting a package is different than installing a package. Extracting a package is used when you only want to get the files out of the package. The before and after scripts will not be executed. You also will be prompted to choose the target folder which can be any folder you choose. The target folder does not have to be Origin's user nor system folder. Close the dialog. If changes were made to current package and have not been saved you will be prompted.

Dialog: Tree View

The tree view is where the package settings are edited. The following describes the settings.

Dialog: Buttons

Below the tree view are six buttons. The following describes the buttons.

The right-most button is used to show and hide the File List.

Dialog: File List

The file list shows all the files that are currently in the package. The number of files in the list and the number of selected files will change the state of the buttons as described above.

OriginC

The Package Manager dialog is handled by OriginC code in OriginC\OriginLab\XMLPackage.c

The XMLPackage.c file calls a collection of Origin exported functions for working with packages. The following functions are declared in oUtils.h and exported from Origin's okUtil80.dll:

• okutil_create_package_tree
• okutil_create_package_file
• okutil_install_package_file
• okutil_uninstall_package_file
• okutil_get_installed_package_names
• okutil_remove_files_from_package
• okutil_get_packed_file_names
• okutil_repack_files

See OriginC's oUtils.h for the function's return type and the argument accepted by each function.

Internal Behavior

When installing a package Origin will first check to see if the package has already been installed. If it has already been installed then Origin will inform the user that the package is already installed and ask if the installing should continue. If the user chooses to continue the installation then Origin will first uninstall the previous installation and then continue to install the current package.

For each package that gets installed Origin will copy the package, without the packed files, to a package list file. The package list file is OPXList.xml and is stored in the User Files folder.

Silent Install

To make an OPX that can be silently installed you need to have the following settings:

• Set the LabTalk Script > Before Installation setting to blank or any script that does not provoke a user prompt.
• Set the LabTalk Script > After Installation setting to any script that does not provoke a user prompt followed by the following two additional commands:
doc -s;
exit;

After making the necessary changes to the OPX it is now possible to launch Origin, install the OPX, and exit Origin without any human interaction. The following command line demonstrates how to perform the silent install of the OPX.

Origin8.exe -h -R "instOPX OPXFileName.opx"

The above command line will need to be edited to use the file name of your OPX.