Package manager

The Package Manager lets you install, update, and remove SyncroSim packages. To access the Package Manager, choose Local Packages from the File menu. There is also a command-line version of the Package Manager.

Note

The Package Manager shows a list of the currently installed packages.

Installing a package

There are three ways to install a new package:

1. Using the SyncroSim online package server

To install a package directly from the SyncroSim Online Package Server, click the Install from Server... button in the lower-left of the Package Manager. This will open the Install from Server dialog where you can choose from a list of packages to install. Select the package you want to install and click OK.

Note

The Install Package dialog shows a list of the packages that are not currently installed.

2. Installing from a package file

You can also install a package that you have previously downloaded and saved to a file from the SyncroSim Online Package Server or elsewhere. SyncroSim packages are always single files with the extension .ssimpkg. To install a package from a file, click the Install from File... button in the lower-left of the Package Manager. Navigate to the package you want to install and click OK.

3. Installing from a package folder

The final way to install a package is by pointing SyncroSim to a local folder containing an XML configuration file, known as the package.xml file, as well as any model scripts or additional files required by the package. This method allows package developers to deploy a package to SyncroSim without the extra step of bundling it into a .ssimpkg file. It also allows users to install custom packages by pointing SyncroSim to local GitHub repositories or working folders. To install a package from a folder, click the Install from Folder... button in the lower-left of the Package Manager. Navigate to the package folder you want to install and click OK.

Updating a package

If a more recent version of one of your installed packages is available on the SyncroSim Online Package Server, you can update it. Navigate to File > Library Datafeeds and under the General tab, select Packages. In the bottom-left corner of the Packages window, click Change to open the Change Package window. Select the latest version of the package and click OK.

Removing a package

You can remove one of your installed packages by selecting it and clicking the Remove button.

Warning

Removing a package will prevent SyncroSim from opening any existing libraries that depend on this package. If this happens, however, you can always re-install the package.