Create a Genero Archive

A Genero Archive is a zip archive containing a MANIFEST file providing installation instructions and the list of application and services to make available.

As a prerequisite, all of your application files, along with your application configuration (xcf) file, must sit under one directory. For example, this would be a valid organization of files:

./fuzzy/modules/app.42m
./fuzzy/modules/app.42r
./fuzzy/forms/app.42f
./fuzzy/xcf/app.xcf
./fuzzy/appPublicImages/

Note: Public images need to go in a dedicated directory, for more information on deploying images see Resource deployment overview.

Follow these steps to create a Genero Archive from the contents of a directory. All folders and files in the directory are included in the archive.

Note: When you use the fglgar tool to create an archive, you are creating a zip file. The tool is designed to take a single directory as its parameter. If you need a more sophisticated archive tool (to add only specific files to the archive, for example), you can use any other zip tool to create your GAR archive.

Create a MANIFEST file. See The MANIFEST file.
Update the application's configuration file (xcf). All resources must be set relative to the resource res.deployment.path. For example, if your compiled files were in the /bin directory of your archive, you would update <PATH> to:
```
<PATH>$(res.deployment.path)/bin</PATH>
```
Complete this change for all resources used in the configuration file: pictures, templates, forms, modules, and so on.
Use the fglgar tool to create a Genero Archive.
If you are in the directory containing your MANIFEST file and your program files:

fglgar --gar

This creates an archive (gar) file with the same name as the archive directory.

If you need to specify the directory where the archive content is located, include the --input-source option:

fglgar --gar --input-source ./fuzzy

This creates an archive file with the same name as your program, drawing its content from the ./fuzzy directory.

If you wish to specify a name for your archive, use the --output option:

fglgar --gar --input-source ./fuzzy --output myfuzzy.gar

This creates an archive file with the name myfuzzy.gar, drawing its content from the ./fuzzy directory.
Note: The archive name has no importance.