Difference between revisions of "Using the PBI Builder"

From PC-BSD Wiki
Jump to: navigation, search
(Initial Import of the PBI Builder instructions)
 
 
(13 intermediate revisions by 4 users not shown)
Line 1: Line 1:
== Using the PBI Builder Software ==
+
{{givechoiceVers|PBI Module Builder Guide}}
 
+
This guide is intended to instruct developers, or simply the curious, on how to use the PBI Builder software, which compiles a FreeBSD port, and turns it into a fully-functional PBI file.
+
 
+
=== Installation ===
+
 
+
Installing the PBI Builder software relatively easy, simply download the tbz package from the [[http://www.pcbsd.org/content/view/45/30/ PBI Builder Homepage]], and place it somewhere on your system with several GB of free space. Next run these commands (as root):
+
 
+
  # tar xvjpf pbibuild*.tbz
+
  # ln -s `pwd`/pbi-build /pbi-build
+
 
+
Note: On regular FreeBSD systems, you will need to install "bash" for the builder to function, and link it to /bin/bash. This step is not required on PC-BSD.
+
 
+
  # pkg_add -r bash
+
  # ln -s /usr/local/bin/bash /bin/bash
+
 
+
+
 
+
=== Usage Instructions ===
+
 
+
Using the PBI builder to convert a port into a PBI is very simple. First, you will need to copy a module directory into the /pbi-build/modules directory. Several examples are provided in /pbi-build/docs/module-examples, or you may copy a module from our [[http://trac.pcbsd.org/browser/pbibuild/modules/ subversion repository]]. After you have done this, simply run these commands:
+
 
+
  # cd /pbi-build
+
  # ./buildpbi.sh
+
 
+
The first time you run the buildpbi.sh script, it will connect to CVS and download a copy of the ports tree. You may change the cvsup server it uses by editing /pbi-build/conf/ports-supfile. If you wish to update your ports tree, simply run "/pbi-build/cron/cvsup-nightly.sh". This script may be run from cron to ensure that your ports tree is always up to date.
+

Latest revision as of 01:45, 23 December 2013

NOTE: This page or its content was moved. The handbook portion of the wiki now primarily focuses on two versions, the most recent release and the upcoming (work-in-progress). This is an imperfect solution to a recurring problem which may not always be solved by the provided links below.

[edit] Which would you like?

Release (10.0)
PBI Module Builder Guide
Upcoming (10.1)
PBI Module Builder Guide