HaikuDépôt

HaikuDepot is the central application when it comes to managing your software packages. With it you can browse and search through package repositories and install and uninstall packages. By default, HaikuDepot starts up with a list of "Featured packages", software that's deemed interesting to many users.

The second tab shows All packages, the display changes to smaller icons and more information arranged in columns:

Le filtre

Au dessus de la liste des paquets, on trouve des critères pour filtrer ceux visibles :

• Le menu déroulant Category (catégorie) permet de limiter la liste à une catégorie, comme « Audio » ou « Jeux ».

• Le champs de texte Search terms permet de filtrer la liste aux paquets qui contiennent tout les chaînes saisies (séparée par des espaces) soit dans leur nom soit dans leur description.

• The Repositories menu of the menu bar determines which repos are being queried. "Local" packages are the ones that were installed from somewhere other than an online repo; maybe from a USB thumb drive or downloaded from some website or a package that you've built yourself.

La liste

Comme dans une fenêtre du Tracker, il est possible de choisir quels colonnes afficher avec un clic droit sur l’entête de la colonne. Un clic gauche trie la liste en fonction de la colonne. Bien sûr, il est possible de réorganiser les colonnes en les glissant vers une nouvelle position.

The Date column shows when a packge was added or updated. Sort by this column to see what's new or updated at the top of the list.

The Status column of a package can have one of several states:

• Active: le paquet est déjà installé et prêt à être utilisé.

• Available: The package exists in that repository and can be downloaded and installed. If there are any dependencies on other packages, you'll be informed of that while installing and get the choice of downloading/installing all that's necessary.

• Pending / %: Pending is shown for a package that is queued for download/installation. While a package is downloaded, the progress is shown as percentage.

The date column shows when the server system recorded the specific version of the package. Owing to possible delays in the publishing process, this date may not be entirely accurate.

Vous pouvez attraper la ligne en pointillé entre la liste des paquets et la zone d’information pour redimensionner verticalement la liste des paquets.

La zone d'information

At the bottom is an area that displays information on the package that is currently selected in the list above it.
To the right of package name, author, rating and version is a button, that – depending on the current state of the package – lets you Install or Uninstall it. If a package is already installed, you'll find an additional button there to Open the application.

Au dessous il y a les 4 onglets À propos, Évaluations, et Journal des modifications et Contenu.

• À propos

  Le premier onglet comporte une description détaillée du paquet, accompagné d'une copie d'écran, une adresse de contact et l'URL de l'équipe qui maintient ce paquet logiciel, quand l'information est disponible. En cliquant sur la copie d'écran, la vignette s'ouvrira en taille réelle dans une nouvelle fenêtre

• Ratings

  The second tab shows ratings and comments of users, if available.

  

  To the left is a statistic, showing the number of stars (1 to 5) the package got from how many users.
  In the middle are user comments with their nickname, the number of stars they gave the package and which version of the package they were rating or commenting on. You'll find more on how to rate a package yourself further down.
  

• Journal des modifications

  Le dernier onglet montre l'historique détaillé de toutes les versions du paquet qui ont été publiées jusqu'à maintenant, si le mainteneur du pacquet fournit cette information.

• Contents

  The last tab shows all the files and folders a package contains. This only works for already downloaded packages.

HaikuDepot and Show menu

In the HaikuDepot menu at the top of the window, you'll find an item to Refresh repositories. This will request an up-to-date list of all available packages from the repositories.
The second item is to Manage repositories…. It opens the Repositories preferences, to add/remove or disable and enable repositories.
Check for updates… opens the SoftwareUpdater to search and install updated packages.
Settings… opens a window with the currently only option: Share anonymous usage data with HaikuDepotServer. The data is used to, for example, increase a counter on how often a package is viewed and installed, which then can determine if a package is promoted to the "Featured packages" list.

Under Show you can choose to also display Develop packages and Source packages in the packages list. For the normal user those are of no interest and would only clutter the list. They are important, however, for people who need the libraries, headers etc. of a package to develop and compile programs depending on them.

Les deux autres éléments, ceux pour n'afficher que les paquets disponibles et les Paquets installés, sont d'un plus grand intérêt.

Créer un compte utilisateur

To be able to rate a package, you need a user account at the Haiku Depot Server that serves all the packages and keeps track of ratings and user comments. You can create an account within the HaikuDepot application by clicking on the menu in the far right of the menu bar that shows your current status: Not logged in. Choosing Log in… opens a window with two tabs; one to enter your user name and password (once you have those) to log in, and the other to create a new account:

Pour créer un compte vous avez besoin de :

• choisir un nom d'utilisateur, en minuscules et sans caractères spéciaux.
• définir un mot de passe long d'au moins 8 caractères avec au moins 2 majuscules et 2 chiffres
• fournir une adresse email valide (si vous avez besoin qu'un nouveau mot de passe vous soit envoyé)
• résoudre le captcha
• tick the checkboxes to confirm you're over 16 and have read the usage conditions linked below them.

After logging in, the top-right menu of the HaikuDepot window will now say Logged in as (…), showing your user name. The menu now offers you to Switch account... or Log out.

As a reminder of what you actually agreed to when you ticked the above mentioned checkbox, there are menu items to View latest/agreed usage conditions…

Noter et Commenter

After you've created a user account and are logged in, you can rate a package and leave a comment, if you want. Just hover the mouse over the rating stars in the info area of a package and they turn into a Rating... button. Click it to open the rating window:

Here you move the mouse over the stars to light them up and choose your rating, you can also choose from a number of levels to judge the stability of the application and pick the language of your optional comment. To make a comment meaningful, you should have worked with the application you're about to rate for a while to become familiar with its features, bugs and quirks. And don't write the next great American novel... keep it short, sweet and polite. :)
After you click Send the data is transmitted to the server. You may have to go to the Tools menu to Refresh repositories before you can see your changes.

At any time, you can come back and edit your comment and re-rate it. You can also hide your rating from other users by deactivating a checkbox This rating is visible to other users, that appears in this window once you've rated a package.

Diagnostic Logs

As HaikuDepot is used, it interacts with network as well as local services. Things can go wrong, sometimes in ways that were not anticipated when the application was written. In those cases the error message may be quite unspecific. To help diagnosing a given problem, HaikuDepot can provide a log of what the application does.

An error message may suggest to view the logs to get further in-depth information or you may be asked to provide the log when you file an issue at the Haiku bug tracking system.

To see the diagnostic logs, HaikuDepot needs to be started from Terminal:

HaikuDepot -v debug

The command uses the -v flag to control the verbosity of the diagnostic logs. Possible values are: off, info, debug and trace. Using off will do only a small amount of logging, while trace does it in the highest detail.

As HaikuDepot starts up and when interacting with the application, you will see text scroll by in the Terminal window; this is the diagnostic log.

Tips

There is another way to keep track of new and updated packages besides sorting the Date column of the list of packages. For that, you need to create an RSS ATOM feed at the Haiku Depot Server website. Click the "hamburger" widget at the top right, and choose Build Feed URL under Data.
Most interesting of the few settings on that page: Besides getting a feed for all new/updated packages, you are also able to add just the names of the packages you're interested in. Click the Build Feed URL button and you get an RSS URL that you can paste into an RSS feed reader like BePodder, QuiteRSS, fRiSS etc.