Assembling a File Package
- Updated2025-10-07
- 2 minute(s) read
Assemble a File package by creating a root directory that contains subdirectories, source files, and configuration files.
For detailed explanation and examples of the configuration files you include in a package, refer to the following topics:
- Control File Attributes
- Installation Target Roots for File Packages
- Instructions XML for File Packages
Before you build a File package, assemble all appropriate source files and subdirectories into a single root directory.
-
Create a root directory to hold all components of the File package.
For example: C:\temp\MyFilePkg
-
Inside the root directory, create a
control subdirectory.
For example: C:\temp\MyFilePkg\control
-
Inside the
control subdirectory, create a control file.
- Using a text editor, create a new document and name it control.
-
Enter all control file attributes and values needed for your package.
See Control File Attributes for more information about attributes for your control file.
- Enter file for the XB-Plugin attribute to indicate that the package is a File package.
- Save the file and omit the file extension.
-
Inside the root directory, create a
data subdirectory.
For example: C:\temp\MyFilePkg\data
-
Inside the
data subdirectory, create one or more installation target subdirectories.
The subdirectories you create specify where Package Manager installs the files in that subdirectory.For example, if you create C:\temp\MyFilePkg\data\Desktop, Package Manager installs any files inside that subdirectory to the Desktop.
-
(Optional) Inside the
data subdirectory, create an instructions file.
- Using a text editor, create a new document and name it instructions.
-
Enter all appropriate elements and attributes for your package.
See Instructions XML for File Packages for more information about the elements and attributes for your instructions file.
- Save the file and omit the file extension.
-
Inside the root directory, create a Debian binary file. This file declares conformity to the Debian standard. For more information, visit debian.org.
- Using a text editor, create a new document and name it debian-binary.
- Enter 2.0 .
- Save the file and omit the file extension.
The following figure shows an example File package where the installation target root is Desktop:
Related Information
- Control File Attributes
A control file is a text file without an extension that contains metadata describing properties and relationships of the package, such as its name, version, type, and dependencies. Both File packages and WinInst packages require a control file. Package Manager generates the package according to the metadata in the control file.
- Installation Target Roots for File Packages
The directories you create inside the data folder inform Package Manager where to install the files when you build packages.
- Instructions XML for File Packages
The optional Instructions XML file you create provides Package Manager with instructions for customized execution of package installation.
- Package Components
A package is comprised of a root directory containing subdirectories, payload files, and configuration files that define the result of the package's installation on the target system.
- Building a Package using the Command Line Interface
Use the command line interface to build a package with your source files.