Difference between revisions of "Make Minor Modifications to a PBI Module"

From PC-BSD Wiki
Jump to: navigation, search
(Created page with "<noinclude><translate> <!--T:1--> {{UseTOC{{putVers}}|Nav}}</noinclude> <!--T:2--> The previous section indicated that new PBI modules are uploaded to the PBI build server s...")
 
 
(11 intermediate revisions by 2 users not shown)
Line 1: Line 1:
<noinclude><translate>
+
<noinclude>{{UseTOC/{{release}}|Nav<translate><!--T:20-->
 
+
|<!-- alt title here as needed --></translate>}}</noinclude>
<!--T:1-->
+
{{:{{pagenameOnly}}/{{release}}{{putLangENdef}}}}
{{UseTOC{{putVers}}|Nav}}</noinclude>
+
{{br}}
 
+
<languages />
<!--T:2-->
+
The previous section indicated that new PBI modules are uploaded to the PBI build server so that they can be built and tested. This section describes the two ways you can assist in testing PBIs.[[File:Build1d.png|thumb|393px|'''Figure 11.5a: Viewing the Status of PBIs on the Build Server''']]
+
 
+
=== Test PBIs Waiting for Approval === <!--T:6-->
+
 
+
<!--T:7-->
+
If you wish to help test a PBI before it has been approved, go to the {{citelink|url=http://pbibuild64.pcbsd.org/index.php?ver=10|txt=build server}} as shown in Figure 11.5a.
+
 
+
<!--T:15-->
+
Find the name of the PBI you wish to test in the "Module" column and click its hyperlink. You can then download the file with the ''.pbi'' extension. Once downloaded, run '''pbi_add /path/to/pbi'''  to install the PBI. If you find any problems with the PBI, send an email to the {{citelink|pcbsdlists|url=pbi-dev|txt=PBI-dev}} mailing list describing how to recreate the problem. Include the text of any error messages you receive.
+
 
+
=== Investigate or Fix a Failed Build === <!--T:8-->
+
 
+
<!--T:9-->
+
You can try to resolve PBI modules that have a "Build Status" of "FAILED". If you click on the name of a failed module, you can download the file named ''last_100.log'' for that module. This file is in ASCII text so it can be viewed in any text editor.
+
 
+
<!--T:11-->
+
If you think you know the cause of the problem after reading the error messages, you can review the PBI's module by clicking its "git" hyperlink. If you decide to copy/paste a file in order to edit it locally, click the "Raw" link for the file.
+
+
If you make an edit to correct the problem, send the modified file (or a diff) to the {{citelink|pcbsdlists|url=pbi-dev|txt=PBI-dev}} mailing list so the changes can be uploaded to the build server.
+
 
+
<!--T:12-->
+
<noinclude>
+
{{refheading}}
+
[[category:Test PBIs]]
+
[[category:Supporting PC-BSD®]]
+
[[category:handbook]]
+
</translate>
+
<languages/>
+
</noinclude>
+

Latest revision as of 18:30, 22 February 2015


If you have a GitHub account and are logged in, you can contribute minor PBI changes to the pbi-modules in the PC-BSD® repository[1] using a web browser. If you do not have a GitHub account, create one create one[2] and use a valid email address as you will need to confirm your email address.

For example, to add a screenshot for an application, upload the screenshot file to a publicly accessible site, then add the URL to the screenshot in between the quotes of the PBI_SCREENSHOTS="" line in the pbi.conf file for that module. Or, to add a similar application, put the package category and package name in between the PBI_PLUGINS="" line in the pbi.conf file for that module. As an example, refer to the pbi.conf for the www/firefox PBI module[3]. More information about the the available pbi.conf variables can be found in [[EasyPBI2#pbi.conf|Table  Is there no version? a]].

To make the edit, click on the pbi.conf file for the module, click the "Edit" button, make the change, then click the "Commit changes" button. This will issue a "git pull" request which will be reviewed by a developer who will either approve it or contact you if more information about the edit is needed. Once the request is approved, you will receive an email about the approval and the change will appear in AppCafe® when the next package set becomes available. How long that takes depends upon whether the system is set to use the PRODUCTION or EDGE package set.

References

  1. https://github.com/pcbsd/pcbsd/tree/master/pbi-modules
  2. https://github.com/
  3. https://github.com/pcbsd/pcbsd/blob/master/pbi-modules/www/firefox/pbi.conf



Other languages:German 50% • ‎English 100%
Personal tools
Namespaces

Variants
Actions
Navigation
Toolbox