Difference between revisions of "Create PBIs/9.2"
(in progress - example submission added.)
(→Submit the PBI: example will need to be trimmed and need to adjust txtbox format method)
|Line 43:||Line 43:|
== Submit the PBI ==
== Submit the PBI ==
From: nemysis <email@example.com>
From: nemysis <firstname.lastname@example.org>
|Line 144:||Line 145:|
Revision as of 15:25, 31 March 2013
(Sorry for the inconvenience)
PC-BSD® provides a unique file format known as a PBI (push button installer). PBI files end with the .pbi extension and are self-contained installation programs. This means that even novice users can safely install and uninstall PBIs without inadvertently overwriting or deleting files needed by the operating system or other applications.
A PBI file includes all the runtime and library dependencies required by the application. This means that a PBI is a large file, but this does not necessarily mean that the installed PBI will be that large. During installation, the PBI system compares the currently installed libraries and files with the ones contained within the PBI file and only installs the ones that are not already installed on the system. A hash database is used to eliminate dependency problems while allowing the computer to share libraries between different programs.
In order to create a PBI, the software must already be ported to FreeBSD. The easiest way to confirm whether or not a FreeBSD port exists is to search for the software at. If a port does not exist, you can issue a port request at the PC-BSD® Port Requests forum using . Alternately, if you have ported software before, the contains detailed instructions for porting software to FreeBSD.
Creating a PBI from an existing FreeBSD port is a mostly automated process that does not require development skills. Some ports are effortless to convert while more complex ports may require some thought and simple scripting. Two utilities are available for converting a FreeBSD port into a PBI:
- pbi_makeport: provides a command line utility as part of the PBI Manager suite.
Testing the PBI
Once your PBI has built, test the PBI to ensure that it installs and that the application works.
As the superuser, use the pbi_add command with the --no-checksig option:
Once installed, start the application from the command line to determine if there are any error messages at application launch. When testing the executable, use the one located in /usr/pbi/(pbi-name)/bin/ so all the linking will be properly set up. Otherwise you can get some interesting errors about missing files.
If the executable does not start the application, the executable may actually be a wrapper script rather than a binary file. If so, check the first line of the script to make sure that it is using the right path for the scripting language. For example, #!/bin/python is an incorrect path which should be changed to #!/usr/pbi/(pbi-name)/bin/python.
The suggested path works because each program is packaged with the proper version of the language it uses and you want to make sure it uses that one. This is usually accomplished by putting a quick sed line in the post-install.sh script to fix the first line as seen in the post install script for.
If the application starts and it is a GUI application, go through the various menus to see if they produce any errors.
If you encounter any error messages in either starting or using the application, record them. If the fix for resolving the error messages is not clear to you, send the error report to the.
If your PBI works and you would like to submit its module to be included on the build server, compress it after changing to your module directory (%%PBI_APPDIR%%):
>tar czvf ~/your_pbi_name.tar.gz .
This will create a compressed tarball named your_pbi_name.tar.gz in your home directory. Send this file to the.
Submit the PBI
Here is an example submission as seen on the mailing list:
To: email@example.com Cc: Date: Thu, 17 Jan 2013 20:29:23 +0100 Subject: [PC-BSD Pbi-dev] PBI submissions Epiar. IceBreaker, Rocks'n'Diamonds, gonvert This are mine new or adopted FreeBSD Ports
Epiar (ep-ee-are) is an open source computer game, in which the player navigates space from planet to planet, saving money to buy ship upgrades and new ships. The player can also join mercenary missions, attack other ships to steal their money and technology, and explore the universe. The game combines the action/arcade elements of aircraft dogfighting and the openness of role playing games to create this experience.
Epiar is a space exploration/combat/trading game. The Escape Velocity (EV) series for the Mac was the major point of inspiration for this game. Other notable games of this genre include:
- Elite (the original game EV was based on) - Star control 1/2 (and it's now open source successor Ur-Quan masters) - Star Flight - Solar Winds
Is a game similar to JezzBall or Barrack. So, uh, there's a bunch of penguins on an iceberg in Antarctica. You have been selected to catch them so they can be shipped to Finland, where they are essential to a secret plot for world domination.
A Boulder Dash clone
A scrolling tile-based computer puzzle game that can be described as a combined Boulder Dash, Supaplex, Emerald Mine and Sokoban clone.
A game for Unix/X11 by Holger Schemel, (c) 1995-99 by Holger Schemel.
This is a nice little game with color graphics and sound for your Unix system with color X11. You need an 8-Bit color display or better. It will not work on black&white systems, and maybe not on gray scale systems.
If you know the game Boulder Dash (Commodore C64) or Emerald Mine (Amiga), you know what Rocks'n'Diamonds is about.
gonvert is a conversion utility that allows conversion between many units like CGS, Ancient, Imperial with many categories like length, mass, numbers, etc. All units converted values shown at once as you type. Easy to add/change your own units.
- 51 categories, 981 units. See the entire list here. - All units converted values shown at once as you type. - Descriptions for many units. - Sort by Unit Name, Value, or Unit symbol. - Find Units. - Fully OPEN source so that you can add your own custom calculations and descriptions.
Please update Zenmap PBI to 6.25
Please read Description, this Port use pc-su from PC-BSD :)
_______________________________________________ Pbi-dev mailing list Pbifirstname.lastname@example.org http://lists.pcbsd.org/mailman/listinfo/pbi-dev 4 attachments — Download all attachments epiar.tar.gz epiar.tar.gz