How To Package Gambas
This file won't explain you how to make the packages, but the structure they
must follow.
Gambas
must be packaged the way described in this document, because the
development environment relies on this structure when it creates a package
of a gambas project.
If a distribution does not follow this requirement, then the packages
generated by the development environment won't be able to be installed,
and the user will be very unhappy.
Not all distributions make correct gambas binary packages at the moment.
So, if you are a packager from these distributions, and if you read this
text, please try to help Gambas work on your distribution.
Thanks in advance,
Benoît.
SPECIFICATIONS FOR GAMBAS 3
REVISION: 10-27-2012
 |
Here are the noticeable changes between Gambas 3 and Gambas 2 specifications:
- Now components can have control icons. These are PNG files that must be installed in a $(INSTALL)/share/gambas3/control/$(COMPONENT) directory, where $(COMPONENT) is the name of the component.
- There is no help packages anymore.
- The gb.debug component does not have its own package anymore. It is located in the runtime package instead.
|
Gambas binary packages must have the following names and contents:
The runtime package
This package includes the Gambas interpreter needed to run Gambas
applications.
It contains:
- The interpreter: gbx3.
- The symbolic link on gbx3: gbr3.
- The internal component description: gb.component, gb.info and gb.list.
- The readme files, TODO files, and so on.
And the following components:
- The gb.debug component: gb.debug.info, gb.debug.list, gb.debug.component, gb.debug.so.*, gb.debug.la.
- The gb.eval component: gb.eval.info, gb.eval.list, gb.eval.component, gb.eval.so.*, gb.eval.la.
- The gb.draw component: gb.draw.info, gb.draw.list, gb.draw.component, gb.draw.so.*, gb.draw.la.
- The gb.gui component: gb.gui.info, gb.gui.list, gb.gui.component, gb.gui.so.*, gb.gui.la.
- The gb.gui.opengl component: gb.gui.opengl.info, gb.gui.opengl.list, gb.gui.opengl.component, gb.gui.opengl.so.*, gb.gui.opengl.la.
- The gb.gui.base component: gb.gui.base.info, gb.gui.base.list, gb.gui.base.component, gb.gui.base.gambas.
Its name must be
gambas3-runtime.
This package must register the
application/x-gambas3 mime type as specified by the
application-x-gambas3.xml file and
the
application-x-gambas3.png icon.
|
Note that gb.la, gb.so, gb.so.0 and gb.so.0.0.0
do not need to be distributed. They are temporary files used for generating
gb.info and gb.list only.
|
 |
The components included in this package have no dependency on any other components.
|
|
The gbr3 symbolic link MUST be in the PATH, otherwise executables will not work.
|
|
gb.gui.base is a component written in Gambas that is actually cannot be used on its own.
It implements many GUI controls for GUI components, and it is explicitely loaded by them (like gb.draw).
|
The development package
This package includes all tools needed to compile Gambas projects without
having to install the complete development environment.
It contains:
- The compiler: gbc3.
- The archiver: gba3.
- The informer: gbi3.
Its name must be
gambas3-devel.
|
On Debian distributions, the package is named gambas3-dev.
|
The scripter package
This package includes the scripter program that allows to write script files in
Gambas.
It contains:
- The scripter: gbs3.gambas.
- The symbolic link on it: gbs3.
Its name must be
gambas3-scripter.
It depends on the following Gambas packages:
- gambas3-runtime.
- gambas3-devel.
This package must register the
application/x-gambasscript mime type as specified by the
application-x-gambasscript.xml file and
the
application-x-gambasscript.png icon.
|
The gbs3 symbolic link MUST be in the PATH, otherwise scripts will not work.
|
The component packages
Each gambas
component must have its own package.
The package of a
component contains:
- The shared library files: gb.XXX.la, gb.XXX.so, gb.XXX.so.0, gb.XXX.so.0.0.0.
- The component file: gb.XXX.component.
- The information file: gb.XXX.info and gb.XXX.list.
- Sometimes a part written in Gambas: gb.XXX.gambas.
...where
gb.XXX is the name of the component
Then name of a component package
MUST BE gambas3-gb-XXX where
gb-XXX is
the name of the component, the point being replaced by a minus sign.
For example, the
gb.qt4 component package name is
gambas3-gb-qt4.
It must include:
- gb.qt4.la
- gb.qt4.so
- gb.qt4.so.0
- gb.qt4.so.0.0.0
- gb.qt4.component
- gb.qt4.gambas
- gb.qt4.info
- gb.qt4.list
Some component are entirely written in Gambas, i.e. they have only a Gambas part.
These components are located in the
comp directory of the source archive.
You must follow the previous rules for these components, except that there is no
shared library files inside.
|
Note that gb.debug, gb.eval, gb.draw, gb.gui, and gb.gui.opengl do not have their own package, as they are distributed with
the gambas3-runtime package.
|
The development environment package
This package includes the complete Gambas Development Environment.
It contains:
- The development environment: gambas3.gambas.
- The symbolic link on it: gambas3.
It depends on the following Gambas packages:
- gambas3-runtime.
- gambas3-devel.
- The packages of the components needed by the IDE.
- gambas3-gb-db
- gambas3-gb-db-form
- gambas3-gb-desktop
- gambas3-gb-eval-highlight
- gambas3-gb-form
- gambas3-gb-form-dialog
- gambas3-gb-form-mdi
- gambas3-gb-image
- gambas3-gb-image-effect
- gambas3-gb-qt4
- gambas3-gb-qt4-ext
- gambas3-gb-qt4-webkit
- gambas3-gb-settings
You
MAY make this package depend on all
Gambas components, so that they are all installed,
but this is not recommended.
Its name must be
gambas3-ide.
|
The IDE relies on the following external tools:
- The GNU translation tools for translating a project.
- The rpm tools for creating RPM packages.
- The deb tools for creating DEB packages.
- The ARCH tool for creating ARCH packages.
- The tar & gzip tools for creating *.tar.gz archives.
So you must add the dependencies on the packages that provide these tools. The name of these
packages depends on the distribution.
For example, on Mandriva, they are:
- gettext
- rpm-build
- gzip
- tar
|
The examples package
This package includes all the example projects provided with
Gambas.
|
When packaging the examples, be careful that a Gambas project includes some hidden files and directories.
These are:
- .project file.
- .startup file.
- .gambas directory.
- .lang directory.
- .directory file.
- .icon.png file.
|
It depends on the following Gambas packages:
- gambas3-runtime.
- gambas3-ide.
- All gambas components.
Its name must be
gambas3-examples.
Package list
Here is the list of all packages that must be made:
|
Package
|
Depends on these packages
|
|---|
|
gambas3-devel
|
|
|
gambas3-runtime
|
|
|
gambas3-ide
|
gambas3-runtime gambas3-devel gambas3-gb-db gambas3-gb-db-form
gambas3-gb-desktop gambas3-gb-eval-highlight gambas3-gb-form gambas3-gb-form-dialog
gambas3-gb-form-mdi gambas3-gb-image gambas3-gb-image-effect gambas3-gb-qt4
gambas3-gb-qt4-ext gambas3-gb-qt4-webkit gambas3-gb-settings
|
|
gambas3-scripter
|
gambas3-runtime gambas3-devel
|
|
gambas3-examples
|
gambas3-runtime
gambas3-ide
All components packages.
|
|
gambas3-gb-cairo
|
|
|
gambas3-gb-chart
|
gambas3-gb-form
|
|
gambas3-gb-complex
|
|
|
gambas3-gb-compress
|
|
|
gambas3-gb-crypt
|
|
|
gambas3-gb-data
|
|
|
gambas3-gb-db
|
|
|
gambas3-gb-db-form
|
gambas3-gb-db gambas3-gb-form
|
|
gambas3-gb-db-mysql
|
gambas3-db-db
|
|
gambas3-gb-db-odbc
|
gambas3-db-db
|
|
gambas3-gb-db-postgresql
|
gambas3-db-db
|
|
gambas3-gb-db-sqlite2
|
gambas3-db-db
|
|
gambas3-gb-db-sqlite3
|
gambas3-db-db
|
|
gambas3-gb-dbus
|
|
|
gambas3-gb-desktop
|
|
|
gambas3-gb-desktop-gnome
|
gambas3-gb-desktop
|
|
gambas3-gb-eval-highlight
|
|
|
gambas3-gb-form
|
|
|
gambas3-gb-form-dialog
|
gambas3-gb-form
|
|
gambas3-gb-form-mdi
|
gambas3-gb-form gambas3-gb-settings
|
|
gambas3-gb-form-stock
|
|
|
gambas3-gb-gsl
|
|
|
gambas3-gb-gtk
|
|
|
gambas3-gb-gtk-opengl
|
gambas3-gb-gtk gambas3-gb-opengl
|
|
gambas3-gb-image
|
|
|
gambas3-gb-image-effect
|
gambas3-gb-image
|
|
gambas3-gb-image-imlib
|
gambas3-gb-image
|
|
gambas3-gb-image-io
|
gambas3-gb-image
|
|
gambas3-gb-jit
|
|
|
gambas3-gb-libxml
|
|
|
gambas3-gb-media
|
|
|
gambas3-gb-mime
|
|
|
gambas3-gb-mysql
|
gambas3-gb-db gambas3-gb-db-mysql
|
|
gambas3-gb-ncurses
|
|
|
gambas3-gb-net
|
|
|
gambas3-gb-net-curl
|
gambas3-gb-net
|
|
gambas3-gb-net-pop3
|
gambas3-gb-net gambas3-gb-mime
|
|
gambas3-gb-net-smtp
|
|
|
gambas3-gb-opengl
|
|
|
gambas3-gb-opengl-glu
|
gambas3-gb-opengl
|
|
gambas3-gb-opengl-glsl
|
gambas3-gb-opengl
|
|
gambas3-gb-option
|
|
|
gambas3-gb-pcre
|
|
|
gambas3-gb-pdf
|
|
|
gambas3-gb-qt4
|
|
|
gambas3-gb-qt4-ext
|
gambas3-gb-qt4
|
|
gambas3-gb-qt4-opengl
|
gambas3-gb-qt4 gambas3-gb-opengl
|
|
gambas3-gb-qt4-webkit
|
gambas3-gb-qt4
|
|
gambas3-gb-report
|
|
|
gambas3-gb-sdl
|
|
|
gambas3-gb-sdl-sound
|
|
|
gambas3-gb-settings
|
|
|
gambas3-gb-signal
|
|
|
gambas3-gb-v4l
|
|
|
gambas3-gb-vb
|
|
|
gambas3-gb-web
|
|
|
gambas3-gb-xml
|
|
|
gambas3-gb-xml-html
|
gambas3-gb-xml
|
|
gambas3-gb-xml-rpc
|
gambas3-gb-xml
|
|
gambas3-gb-xml-xslt
|
gambas3-gb-xml
|
|
You may have a gambas3-debug package to store the debugging information of all previous packages.
|
> howto > package 
Previous Next Edit Rename Undo Refresh Search Administration