A Genero Archive is a zip archive containing a MANIFEST
file providing installation instructions and the list of application
and services to make available.
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
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.