Difference between revisions of "AppCafe®/9.2"

From PC-BSD Wiki
Jump to: navigation, search
 
(76 intermediate revisions by 2 users not shown)
Line 1: Line 1:
<noinclude>{{NavHeader|back=Installing Applications and Keeping PC-BSD® Updated|forward=PBI Manager|custompagename=Using AppCafe{{r}}|custompagecategory={{PAGENAME}}}}</noinclude>
+
<noinclude><translate>
  
PC-BSD® provides a unique file format known as a PBI (push button installer). PBI files end with the ''.pbi'' extension and are
+
<!--T:1-->
self-contained installation programs. When a PBI is installed using AppCafe®, even novice users are protected from the risk of inadvertently overwriting or deleting files needed by the operating system or other applications. [[File:Appcafe1e.png|thumb|'''Figure 7.1a: Browsing for Software Using AppCafe®''']]
+
{{UseTOC{{putVers}}|Nav|title=AppCafe{{r}}}}</noinclude>
  
 +
<!--T:2-->
 +
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. When a PBI is installed using AppCafe®, even novice users are protected from the risk of inadvertently overwriting or deleting files needed by the operating system or other applications. [[File:Appcafe1f.png|thumb|'''Figure 7.1a: Browsing for Software Using AppCafe®''']]
 +
 +
<!--T:3-->
 
A PBI file includes all the runtime and library dependencies required by the application. This means that the initial download of a PBI is a large file; but this does not necessarily mean that same amount of space will be used. 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. Subsequent downloads to upgrade a PBI are significantly smaller as only what has changed in the new version will be downloaded.
 
A PBI file includes all the runtime and library dependencies required by the application. This means that the initial download of a PBI is a large file; but this does not necessarily mean that same amount of space will be used. 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. Subsequent downloads to upgrade a PBI are significantly smaller as only what has changed in the new version will be downloaded.
  
AppCafe® provides an intuitive, graphical method for installing and managing PBI software. AppCafe® does not require the root password to install most of the applications that users require, such as web browsers, games, mail clients, and productivity software. This means that you do not have to give out the root password on multi-user systems. However, server applications, such as web servers or databases, will prompt for the root password. This is to prevent a regular user from installing server software.
+
<!--T:4-->
{{note|width=47%|align=left|icon64=at this time, AppCafe® does not keep a copy of the downloaded ''.pbi'' file. If you would like to retain a copy of this file on disk, use '''pbi_add -R''' which will download the PBI file to the current directory.}}
+
AppCafe® provides an intuitive, graphical method for installing and managing PBI software. AppCafe® does not require the root password to install software. This means that you do not have to give out the root password on multi-user systems. However, server applications, such as web servers or databases, will prompt for the user's password and will fail if that user is not a member of the ''wheel'' group. This allows you to control which users are able to install server software.
When a regular user installs an application, they have the option to "Install Menu Icons (All Users)", meaning that an application only needs to be installed once on a multi-user system.
+
  
If you prefer to install PBIs from the command line, see the section on using [[PBI Manager#pbi add(1) | '''pbi_add''']].
+
<!--T:60-->
 +
After a regular user installs an application, they have the option to install menu icons for all users, meaning that an application only needs to be installed once on a multi-user system.  
  
PBIs are the recommended software installation method on PC-BSD®. [[Update Manager]] will automatically notify you when newer versions of software installed through the PBI system are available. PBIs will also be preserved over system upgrades and system meta-package changes.
+
<!--T:5-->
 +
If you prefer to install PBIs from the command line, see the section on using '''{{local|link=PBI Manager|anchor=pbi add(1)|pbi_add}}'''.
  
=== Installing and Uninstalling PBI Software ===
+
=== Installing and Managing Software === <!--T:7-->
  
To install a PBI, start AppCafe® by double-clicking its icon on the Desktop, going to ''[[Control Panel]]'' ➜ ''[[Using AppCafe®|AppCafe®]]'', or by typing '''appcafe''' from a command prompt. The "Browse" tab in AppCafe® can be used to browse for available software, as seen in Figure 7.1a, also shows that 1021 PBIs are available and 3 are currently installed on this system.
+
<!--T:8-->
 +
To install a PBI, start AppCafe® by double-clicking its icon on the Desktop, going to {{traverse|Control Panel|AppCafe®|here=AppCafe®}}, or by typing '''appcafe''' from a command prompt. The "Browse for Apps" tab in AppCafe® can be used to browse for available software, as seen in Figure 7.1a. In the example shown in Figure 7.1a, 1153 PBIs are currently available. The names and versions of the PBIs which were added or updated in the last 10 days are listed in the “View Recent Additions” pane.
  
If you know the name of the application you would like to install, type its name into the "Search" bar. Alternately, you can click on a software category (for example, "Archivers") to browse for available software. Use the back arrow or home icon to navigate within the browser. In the example shown in Figure 7.1b, the user searched for the "gimp" application then clicked on the "Gimp" search result.[[File:Appcafe3d.png|thumb|393px|'''Figure 7.1b: Browsing the Information Available for a PBI''']]
+
<!--T:9-->
 +
If you know the name of the application you would like to install, type its name into the "Search Here" bar. Alternately, you can click on a software category (for example, "Archivers") to browse for available software. Use the home icon to return to the main screen. In the example shown in Figure 7.1b, the user searched for the "gimp" application. The search has found that PBI as well as two others that may match the search term.
  
Figure 7.1b shows an example of the information that is available for each PBI:
+
<!--T:43-->
 +
[[File:Appcafe3e.png|thumb|393px|'''Figure 7.1b: Browsing the Information Available for a PBI''']]
  
* Name and icon of the application; in this example, it is Gimp.
+
<!--T:10-->
 +
In Figure 7.1c, the user has clicked on the "gimp" PBI and can now view the following information:
  
* A hyperlink to the application's website; in this example, clicking on "The GIMP Team" will open gimp.org in the user's default web browser.
+
<!--T:11-->
 +
* Name and icon of the application.
  
* Either a Download icon (if the application is not currently installed) or an Installed icon if it is already installed.
+
<!--T:12-->
 +
* A hyperlink to the application's website. In this example, clicking "The GIMP Team" will open gimp.org in the user's default web browser.
  
 +
<!--T:13-->
 +
* An "Install Now!" icon. If the application is already installed, this will either be an "Upgrade" icon (if a newer version is available) or a "Downgrade" button (if the latest version is already installed).
 +
 +
<!--T:14-->
 
* The version of the application.
 
* The version of the application.
  
* The platform (i386 for 32-bit applications and amd64 for 64-bit applications). If you are on a 64-bit system and there is only a 32-bit application, AppCafe® will install the 32-bit application and PC-BSD® will still be able to run the program.
+
<!--T:44-->
 
+
* The size of the initial download of the PBI.
* The type will indicate whether the application is graphical or text (command line).
+
  
* Whether or not the installation requires the root (administrative) password.
+
<!--T:15-->
 +
* The platform (i386 for 32-bit applications and amd64 for 64-bit applications). If the application only provides a 32-bit version, AppCafe® will install the 32-bit application and PC-BSD® will still be able to run the program.  
  
 +
<!--T:45-->
 
* The license used by the software.
 
* The license used by the software.
  
* The size of the initial download of the PBI.
+
<!--T:16-->
 +
* The type will indicate whether the application is graphical or text (command line).
  
 +
<!--T:20-->
 
* A description of the application.
 
* A description of the application.
  
Once you find a PBI that you would like to install, click on its Download icon. AppCafe® will automatically detect your PC-BSD® version and architecture and install the correct PBI for you. When the installation is complete, the new PBI will be displayed in the "Installed" tab. Figure 7.1c shows a screenshot of this tab from a system with several PBIs installed.
+
<!--T:46-->
 +
AppCafe® will also suggest similar applications which may meet the user's needs.
  
<div style="overflow: hidden">[[File:Appcafe4c.png|left|thumb|393px|'''Figure 7.1c: Viewing the List of Installed PBIs in AppCafe®''']][[File:Appcafe5c.png|right|thumb|393px|'''Figure 7.1d: Viewing an Installed PBI's Details''']]</div>[[File:Preferences.png|thumb|393px|'''Figure 7.1f: AppCafe® Preferences''']]
+
<!--T:47-->
[[File:Pbiupdate1.png|thumb|393px|'''Figure 7.1e: Using the Installed Tab to Upgrade Installed PBIs''']]
+
[[File:Appcafe6a.png|thumb|393px|'''Figure 7.1c: Details for a Selected PBI''']]
If you right-click an installed PBI you can:
+
* '''View details:''' Figure 7.1d shows an example of a PBI's details. In addition to the information usually available for a PBI in the "Browse" tab, the details will indicate that the PBI is installed and a checkbox is added for "Automatic Updating". Check this box if you would like Update Manager to automatically update this PBI, rather than just notify you that a newer version is available.
+
  
* '''Install PATH links:''' select this option if you will be starting the application from the command line as it will add the command's location to your $PATH.  
+
<!--T:21-->
 +
Once you find a PBI that you would like to install, click on its “Install Now!” icon. AppCafe® will switch focus to the "Installed" tab so that you can watch the status of the download and installation. Figure 7.1d shows a screenshot of this tab after “gimp” is successfully installed.
  
* '''Install PATH links (All Users):''' adds the command's location to the $PATH of all users so that they can start the application from the command line. Requires the administrative password.
+
<!--T:48-->
 +
<div style="overflow: hidden">[[File:Appcafe4e.png|left|thumb|393px|'''Figure 7.1d: Viewing an Installed PBI in AppCafe®''']]</div>
 +
[[File:Pbiupdate1a.png|thumb|393px|'''Figure 7.1e: Using the Installed Tab to Upgrade Installed PBIs''']]
  
 +
<!--T:49-->
 +
If you highlight an installed PBI and click the “Actions”button,  the following actions become available:
 +
 +
<!--T:50-->
 +
* '''Update:''' if the “Status” column indicates that a newer version is available, click this action to upgrade to the newer version. Once clicked, it will change to a cancel button should you decide to cancel the operation while the new version is still being downloaded.
 +
 +
<!--T:51-->
 +
* '''Desktop Icons:''' used to add or remove a shortcut to the application on any installed and supported desktop (GNOME4, KDE, LXDE, and XFCE4).
 +
 +
<!--T:52-->
 +
* '''Menu Icons:''' used to add or remove an entry for the application to the menu of any installed and supported desktop (GNOME4, KDE, LXDE, and XFCE4). Menu icons can be for that user only or for all users. Adding for all users requires you to be in the ''wheel'' group and to input your password.
 +
 +
<!--T:23-->
 +
* '''Path Links:''' used to add or remove the command's location to your $PATH or to the $PATH of all users. Adding for all users requires you to be in the ''wheel'' group and to input your password. This option is useful if users will be starting the application from the command line.
 +
 +
<!--T:53-->
 +
* '''File Associations:''' installs any xdg-mime type file associations from the PBI. For example,*.odt files are associated with OpenOffice and LibreOffice.
 +
 +
<!--T:25-->
 
* '''Uninstall:''' will uninstall the PBI. Once the PBI removal is complete, it will be removed from the Installed list.
 
* '''Uninstall:''' will uninstall the PBI. Once the PBI removal is complete, it will be removed from the Installed list.
  
If you highlight a PBI and click the "More" button, the following actions will be added to that list of options:
+
<!--T:54-->
 +
* '''Cancel Actions:''' cancels any currently pending or running PBI operations such as uninstallation, updating, or installation.
  
* '''Install Desktop Icons:''' will create a shortcut to the application on the user's desktop.
+
<!--T:61-->
 +
The buttons in the “Application Details” can be used to:
  
* '''Install Menu Icons:''' will add an entry for the application to the supported desktop's application menu.
+
<!--T:62-->
 +
* start the application; if the application has multiple start modes, such as graphical or command-line, a drop-down menu will provide the available ways to start the application
  
* '''Install Menu Icons (All Users):''' will add an entry for the application to the application menu of every user. Requires the administrative password.
+
<!--T:63-->
 +
* uninstall the application
  
=== Updating Installed PBIs ===
+
<!--T:64-->
 +
* open the application's website in the default web browser
  
The "Installed" tab will also indicate if there are any newer versions available for the PBIs that you have installed. PBIs are created from the original FreeBSD package and automatically become available as an upgrade whenever the underlying package version changes. Figure 7.1e provides an example of a PBI that has a newer version available:
+
<!--T:65-->
 +
* have the application automatically update itself when a newer version is available. By default, this option is unchecked, meaning that AppCafe® will indicate when a new version is available in the "Status" column, but will wait for you to start the update.
  
In this example, the currently installed version of Firefox is 16.0.1_1 and version 16.0.2 is available. To upgrade this PBI, highlight its entry and click the "Update" button. Alternately, if updates are available for multiple PBIs and you wish to upgrade them all, click the "Update All" button. If the PBI "Requires Root", it will prompt you for the administrative password before starting the upgrade.
+
=== Updating Installed PBIs === <!--T:30-->
  
A status bar will indicate the progress of the download and upgrade process. When the upgrade is complete, the entry will be updated to show the new version. The upgrade process will save all of the current version's settings. For example, when you upgrade Firefox, it will keep all of your bookmarks, history, and cache.[[File:Appcafe2a.png|thumb|393px|'''Figure 7.1g: Managing Available Repositories''']]
+
<!--T:31-->
 +
The "Status" column of the "Installed" tab will indicate if there are any newer versions available for the PBIs that you have installed. PBIs are created from the original FreeBSD package and automatically become available as an upgrade whenever the underlying package version changes. Figure 7.1e provides an example of a system that has newer PBI versions available.
  
=== Preferences ===
+
<!--T:32-->
 +
In this example, newer versions are available for firefox-esr and Thunderbird. Check the box for each PBI that you wish to update then click Actions ➜ Update. If any of the selected PBIs require root, AppCafe® will prompt for your password before starting the upgrade.
  
If you click ''File'' ➜ ''Preferences'', you will see the screen shown in Figure 7.1f.
+
<!--T:33-->
 +
A status bar will indicate the progress of the download and upgrade process. When the upgrade is complete, the entry will be updated to show the new version. The upgrade process will save all of the current version's settings. For example, when you upgrade Firefox, it will keep all of your bookmarks, history, and cache.
  
By default, an icon is added to the desktop (for window managers that support icons) whenever you install a PBI. Uncheck the box  "Create desktop icons at install" to disable desktop icon creation. You can still elect to install a desktop icon on a per-PBI basis by right-clicking the PBI and selecting "Install Desktop Icons" as shown in Figure 7.1c.
+
=== Importing and Exporting PBI Lists=== <!--T:73-->
  
=== Repositories ===
+
<!--T:74-->
 +
PC-BSD® has the ability to import and export PBI lists. A PBI list is an ASCII text file that contains the names of PBIs (without a version number), one per line. An example is as follows:
  
If you click ''Repositories'' ➜ ''Configure Repository'' from within AppCafe®, you will see the screen shown in Figure 7.1g:
+
<!--T:75-->
 +
{{txtbox|box=apacheopenoffice{{nbsp|64}}
 +
thunderbird
 +
firefox
 +
qtcreator
 +
scite
 +
gimp
 +
pithos
 +
quassel
 +
ksnapshot
 +
openjdk7}}
  
This screen will list the official PC-BSD® repositories. AppCafe® reads this list, in order, when connecting to the software repository. You can use the up and down arrows to reorder the list. If you have created your own software repository of PBIs, use the "Add" button to add the URL of the repository.
+
<!--T:76-->
 +
If you import a PBI list into AppCafe®, it will add those applications to the installation queue so that they can be installed. To do so, create the list and save it with a ''.pbilist'' extension. Then, go to <span class=traverse>''File''{{rarr}}''Import PBI List''</span> and browse to the location of the list. A pop-up menu will ask if you would like to install the applications in the list. AppCafe® will ignore any invalid lines and PBIs which are already installed.
  
If you have created your own ''.rpo'' file using the [[PBI Manager#pbi makerepo(1) | '''pbi_makerepo''']] command, you can use ''Repositories'' ''Add Repository'' to browse to the location of the ''.rpo'' file. This is the equivalent of manually running the [[PBI Manager#pbi addrepo(8) | '''pbi_addrepo''']] command.
+
<!--T:77-->
 +
Alternately, if you export a PBI list on a system that already has PBIs installed, you can then import that list into another PC-BSD® system. To do so, click <span class=traverse>''File''{{rarr}}''Export PBI''</span> List and save the file to the desired location. By default, it will be saved as ''exportfile.pbilist''.
  
 +
=== Configuring AppCafe®=== <!--T:34-->
 +
 +
<!--T:35-->
 +
Figure 7.1f shows the screen that opens when you click  <span class=traverse>Configure{{rarr}}AppCafe Settings</span>.
 +
 +
<!--T:58-->
 +
'''Figure 7.1f: AppCafe® Settings Menu'''
 +
 +
<!--T:66-->
 +
[[File:Appcafe7a.png]]
 +
 +
<!--T:67-->
 +
The settings in the "Configuration" tab apply to all PBIs, whereas the settings in a highlighted application's "Actions" button only apply to that PBI. This tab adds an extra option to store a copy of the downloaded PBI. If you check this box, it will expand to let you select the directory to store the downloaded ''.pbi'' files. If you change a setting in the "Configuration" tab, it will not affect PBIs which are already installed.
 +
 +
<!--T:68-->
 +
Figure 7.1g shows the "Repositories" tab.
 +
 +
<!--T:69-->
 +
'''Figure 7.1g: Repositories Tab'''
 +
 +
<!--T:70-->
 +
[[File:Appcafe8a.png]]
 +
 +
<!--T:71-->
 +
By default, AppCafe® is configured to connect to the official PC-BSD® PBI repository which uses a CDN (Content Delivery Network) to provide the fastest possible download, regardless of geographic location.
 +
 +
<!--T:72-->
 +
If you have access to a custom PBI repository, click the “+” button next to "001 - Official PC-BSD Repository" to add the URL of the repository.
 +
 +
If you have {{local|link=Create_Your_Own_PBI_Repository|created your own PBI repository}}, click the “+” button next to "PCBSDCDN" to browse to the location of your ''.rpo'' file.
 +
 +
<!--T:59-->
 
<noinclude>
 
<noinclude>
[[category:handbook]]
 
[[category:Maintaining and Extending PC-BSD®]]
 
 
[[category:Using AppCafe®]]
 
[[category:Using AppCafe®]]
 +
[[category:Maintaining and Extending PC-BSD®]]
 +
[[category:handbook]]
 +
</translate>
 +
<languages/>
 
</noinclude>
 
</noinclude>

Latest revision as of 23:47, 15 December 2013


Contents


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. When a PBI is installed using AppCafe®, even novice users are protected from the risk of inadvertently overwriting or deleting files needed by the operating system or other applications.
Figure 7.1a: Browsing for Software Using AppCafe®

A PBI file includes all the runtime and library dependencies required by the application. This means that the initial download of a PBI is a large file; but this does not necessarily mean that same amount of space will be used. 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. Subsequent downloads to upgrade a PBI are significantly smaller as only what has changed in the new version will be downloaded.

AppCafe® provides an intuitive, graphical method for installing and managing PBI software. AppCafe® does not require the root password to install software. This means that you do not have to give out the root password on multi-user systems. However, server applications, such as web servers or databases, will prompt for the user's password and will fail if that user is not a member of the wheel group. This allows you to control which users are able to install server software.

After a regular user installs an application, they have the option to install menu icons for all users, meaning that an application only needs to be installed once on a multi-user system.

If you prefer to install PBIs from the command line, see the section on using pbi_add.

[edit] Installing and Managing Software

To install a PBI, start AppCafe® by double-clicking its icon on the Desktop, going to Control Panel → AppCafe®, or by typing appcafe from a command prompt. The "Browse for Apps" tab in AppCafe® can be used to browse for available software, as seen in Figure 7.1a. In the example shown in Figure 7.1a, 1153 PBIs are currently available. The names and versions of the PBIs which were added or updated in the last 10 days are listed in the “View Recent Additions” pane.

If you know the name of the application you would like to install, type its name into the "Search Here" bar. Alternately, you can click on a software category (for example, "Archivers") to browse for available software. Use the home icon to return to the main screen. In the example shown in Figure 7.1b, the user searched for the "gimp" application. The search has found that PBI as well as two others that may match the search term.

Figure 7.1b: Browsing the Information Available for a PBI

In Figure 7.1c, the user has clicked on the "gimp" PBI and can now view the following information:

  • Name and icon of the application.
  • A hyperlink to the application's website. In this example, clicking "The GIMP Team" will open gimp.org in the user's default web browser.
  • An "Install Now!" icon. If the application is already installed, this will either be an "Upgrade" icon (if a newer version is available) or a "Downgrade" button (if the latest version is already installed).
  • The version of the application.
  • The size of the initial download of the PBI.
  • The platform (i386 for 32-bit applications and amd64 for 64-bit applications). If the application only provides a 32-bit version, AppCafe® will install the 32-bit application and PC-BSD® will still be able to run the program.
  • The license used by the software.
  • The type will indicate whether the application is graphical or text (command line).
  • A description of the application.

AppCafe® will also suggest similar applications which may meet the user's needs.

Figure 7.1c: Details for a Selected PBI

Once you find a PBI that you would like to install, click on its “Install Now!” icon. AppCafe® will switch focus to the "Installed" tab so that you can watch the status of the download and installation. Figure 7.1d shows a screenshot of this tab after “gimp” is successfully installed.

Figure 7.1d: Viewing an Installed PBI in AppCafe®
Figure 7.1e: Using the Installed Tab to Upgrade Installed PBIs

If you highlight an installed PBI and click the “Actions”button, the following actions become available:

  • Update: if the “Status” column indicates that a newer version is available, click this action to upgrade to the newer version. Once clicked, it will change to a cancel button should you decide to cancel the operation while the new version is still being downloaded.
  • Desktop Icons: used to add or remove a shortcut to the application on any installed and supported desktop (GNOME4, KDE, LXDE, and XFCE4).
  • Menu Icons: used to add or remove an entry for the application to the menu of any installed and supported desktop (GNOME4, KDE, LXDE, and XFCE4). Menu icons can be for that user only or for all users. Adding for all users requires you to be in the wheel group and to input your password.
  • Path Links: used to add or remove the command's location to your $PATH or to the $PATH of all users. Adding for all users requires you to be in the wheel group and to input your password. This option is useful if users will be starting the application from the command line.
  • File Associations: installs any xdg-mime type file associations from the PBI. For example,*.odt files are associated with OpenOffice and LibreOffice.
  • Uninstall: will uninstall the PBI. Once the PBI removal is complete, it will be removed from the Installed list.
  • Cancel Actions: cancels any currently pending or running PBI operations such as uninstallation, updating, or installation.

The buttons in the “Application Details” can be used to:

  • start the application; if the application has multiple start modes, such as graphical or command-line, a drop-down menu will provide the available ways to start the application
  • uninstall the application
  • open the application's website in the default web browser
  • have the application automatically update itself when a newer version is available. By default, this option is unchecked, meaning that AppCafe® will indicate when a new version is available in the "Status" column, but will wait for you to start the update.

[edit] Updating Installed PBIs

The "Status" column of the "Installed" tab will indicate if there are any newer versions available for the PBIs that you have installed. PBIs are created from the original FreeBSD package and automatically become available as an upgrade whenever the underlying package version changes. Figure 7.1e provides an example of a system that has newer PBI versions available.

In this example, newer versions are available for firefox-esr and Thunderbird. Check the box for each PBI that you wish to update then click Actions ➜ Update. If any of the selected PBIs require root, AppCafe® will prompt for your password before starting the upgrade.

A status bar will indicate the progress of the download and upgrade process. When the upgrade is complete, the entry will be updated to show the new version. The upgrade process will save all of the current version's settings. For example, when you upgrade Firefox, it will keep all of your bookmarks, history, and cache.

[edit] Importing and Exporting PBI Lists

PC-BSD® has the ability to import and export PBI lists. A PBI list is an ASCII text file that contains the names of PBIs (without a version number), one per line. An example is as follows:

apacheopenoffice                                                                

thunderbird firefox qtcreator scite gimp pithos quassel ksnapshot

openjdk7

If you import a PBI list into AppCafe®, it will add those applications to the installation queue so that they can be installed. To do so, create the list and save it with a .pbilist extension. Then, go to File → Import PBI List and browse to the location of the list. A pop-up menu will ask if you would like to install the applications in the list. AppCafe® will ignore any invalid lines and PBIs which are already installed.

Alternately, if you export a PBI list on a system that already has PBIs installed, you can then import that list into another PC-BSD® system. To do so, click File → Export PBI List and save the file to the desired location. By default, it will be saved as exportfile.pbilist.

[edit] Configuring AppCafe®

Figure 7.1f shows the screen that opens when you click Configure → AppCafe Settings.

Figure 7.1f: AppCafe® Settings Menu

Appcafe7a.png

The settings in the "Configuration" tab apply to all PBIs, whereas the settings in a highlighted application's "Actions" button only apply to that PBI. This tab adds an extra option to store a copy of the downloaded PBI. If you check this box, it will expand to let you select the directory to store the downloaded .pbi files. If you change a setting in the "Configuration" tab, it will not affect PBIs which are already installed.

Figure 7.1g shows the "Repositories" tab.

Figure 7.1g: Repositories Tab

Appcafe8a.png

By default, AppCafe® is configured to connect to the official PC-BSD® PBI repository which uses a CDN (Content Delivery Network) to provide the fastest possible download, regardless of geographic location.

If you have access to a custom PBI repository, click the “+” button next to "001 - Official PC-BSD Repository" to add the URL of the repository.

If you have created your own PBI repository, click the “+” button next to "PCBSDCDN" to browse to the location of your .rpo file.

Other languages:German 24% • ‎English 100% • ‎French 47%