How to add new files?

An introduction on how to add new files to the product package.

This description assumes, that the OEM customer requires to add new files that are specific to their product solution. This allows the OEM to add their custom projects and extensions to WinCC OA.

CAUTION: Files that are added to the product must be unique and therefore exist only within one of the installer components. Using the same file (file name and path) in multiple components will result in conflicts during installation and additional unforeseeable errors!
  1. Add your additional files within the oem/add folder.
    • Files can be added as-is within the oem/add/folders/<ManifestName> directory. Depending on the used <ManifestName> the files will be added to different installer components.
    • Files can be added as zipped package within the oem/add/zips/<ManifestName> directory . In this case a separate .zip package must be created for the individual components, e.g. Addons.zip. An empty Base.zip file is already included here.
    • Note: The <ManifestName> corresponds to the install manifest files found in Pipeline > manifestsand with it to the .msi packages of the standard installation.
  2. Update the file Pipeline > BuildProduct.yml.
    1. Adjust the function AddFolderToManifest to add the edited folder to the corresponding manifest. By default only the Base folder is added.
    2. Multiple folders can be added if necessary. (By default only the Base folder will be added.) This is done by making a copy of the function AddFolderToManifest and setting the needed folder and manifest.
  3. Start your build. See How to Start a Build?.