The HPKG Creator is a program that allows you to create Haiku package files. At the time of this tutorial, there were, besides the HPKG Creator, only the possibility HPKG files on the commandline to create.
The HPKG Creator is a GUI (General User Interface) for the command line program package.
This is not an official program of the Haiku team, but a project of the BeSly Software Solutions.
The program should not be a substitute for an official installer.
To start the HPKG Creator, you can find this, after installation, at: /boot/home/config/apps/HPKGCreator
If you have never created a HPKG, will be a little overwhelmed at the sight of the program, what has to be done now. Therefore this tutorial.
In the Upper field data indicated that the package management system (Haiku Depot) tells what kind of program it is.
In the lower part are two file listings. The left shows the system and the rights the package folder.
back to Index
We start with the details of the HPKG. Fill out all input fields at the top and choose the appropriate system type (Architecture).
- Name: Here the name is specified for the program.
The program name must be the same as that of the program (executable file). A distinction must be paid to the correct spelling (upper-lower case, character, etc) and can not contain free spaces (the command line tool does not support it).
- Version: Here enter the version of the program into the front input field and a revision number in the second field.
- Architecture: Select the system type on that the program are created.
- Summary: Add here a short description of the program.
- Description: Add here a detailed description of the program.
- Vedor: Add here the owner/creator of the program.
- Copyrights: Add here the copyright owner.
- Licenses: Add the license of the program.
For experienced package creator there is an editor that allows you to expand the package information. To open the editor select in the Package- menu the option Editor.
How does the Editor works will be descript on a later part of this Tutorial.
Next, we create a new folder in the Package Folder. To do this, select in the File menu the option New Folder.
|Please note that the development of the package management System is not yet complete and there may be variations here later. Please always inform only about the provisions herein.|
Next press on Create to create the folder.
Now the directory apps in the directory listing Package Folder is displayed.
Now go with a double click into the apps folder and make there another directory with the name of the program (here HPKGCreator). Then change into this directory.
Next, choose in the system directory listing one by one all the program belonging files and directories and copy them via the corresponding menu File, Copy from the program directory into the package Directory.
|For some discussions on IRC, I've heard that the data in the HPKG files can not be changed, so you should, if you have the possibility to it, ensure that changeable files are saved into another location of the system.|
If in addition to the program files or other accessories to be installed, create directories in this regard (eg add-ons) in the Package Folder directory and copy these files into it.
Then press on Create to create the HPKG package.
The created HPKG file will be stored on the Desktop with the specified Name.
back to Index
At any time you can save the current processing status of a project. Again the specified Name is now the name of the project.
To save a project, select in the Package menu the option Save project.
Open a Projekt
To open a project, select one in the Package menu at Open project.
Delete a Projekt
To delete a project, select one in the Package menu at Delete project.
back to Index
The operation of the editor will be unfamiliar to the most.
In the upper part of the Editor the content of the package file .PackageInfo are displayed.
If you want to edit a line, select it from the corresponding row and edit this in the lower editing area.
To accept the change, press on Edit.
|If you write multiple lines in the editing, they are inserted from the selected row.|
When you're done editing, changing back to the main view by pressing the Back button.
back to Index
Translated by Christian Albrecht (Lelldorin) April 2014
Made available by BeSly, the BeOS, Haiku and Zeta knowledge base.