Sommaire
Cet article est une traduction de l'annonce de la nouvelle version de HACS publiée sur le site Home Assistant.
Joakim Sørensen
TL;DR : HACS 2.0 est un grand pas en avant, ajoutant une méthode d'installation plus facile, des mises à jour plus rapides, une nouvelle interface utilisateur, et des notifications de mise à jour/réparation propres à Home Assistant.
Le magasin communautaire de Home Assistant, HACS, vient de passer à la version 2.0, avec des améliorations importantes qui en font le meilleur moyen de trouver, d'installer et de mettre à jour des intégrations et des éléments d'interface utilisateur géniaux créés par la communauté. Cela fait suite à l'ajout de HACS en tant que partenaire de collaboration de l'Open Home Foundation, reconnaissant ainsi son rôle important dans l'écosystème ouvert de Home Assistant.
Notez simplement que HACS est un outil avancé qui peut ajouter du code personnalisé à votre installation de Home Assistant, ce qui peut causer des problèmes sur votre système Home Assistant. Si vous êtes débutant ou si vous privilégiez la stabilité avant tout, HACS n'est peut-être pas fait pour vous.
HACS passe à la version 2.0
Il s'agit de l'une des plus importantes mises à jour de HACS, mais si vous n'êtes pas sûr de savoir ce qu'est HACS ou pourquoi vous pourriez envisager de l'utiliser, consultez notre explication ci-dessous.
Nouvel affichage
Le tableau de bord principal de HACS 2.0 s'inspire de celui de Home Assistant et s'apparente désormais à l'aspect et aux fonctionnalités des tableaux de données que vous trouverez sur les pages consacrées aux entités ou à l'automatisation. Cela inclut les options de filtrage, de regroupement, de tri et de recherche.
Téléchargements plus rapides
Auparavant, HACS s'appuyait à 100% sur GitHub pour récupérer des informations, de l'emplacement des fichiers au nombre d'étoiles, nous devions donc limiter l'API (car il y a beaucoup d'utilisateurs de HACS). Pour accélérer les choses, nous avons créé un ensemble de données distant stocké dans les buckets R2 de Cloudflare, qui sont mis à jour à intervalles réguliers. Les fichiers sont toujours téléchargés à partir de GitHub et leur API est toujours contactée, mais il y aura beaucoup moins d'appels, et l'amélioration de la vitesse est massive. En coulisses, il s'agissait d'un gros travail, qui a des coûts permanents, et qui montre le type de soutien que la Fondation Open Home peut apporter à un projet communautaire comme HACS.
Mise à jour et correction
Plus besoin de visiter la page HACS tous les jours pour vérifier les mises à jour. Elles apparaîtront désormais aux mêmes endroits que les mises à jour du système et des modules complémentaires dans le format natif du Home Assistant. De plus, une fois les mises à jour terminées, elles vous suggéreront des corrections (par exemple, recharger les tableaux de bord ou redémarrer Home Assistant).
Autres améliorations
Nous avons également renommé certains éléments pour leur donner plus de sens, notamment en remplaçant « catégorie » par « type » et « Lovelace » par « tableau de bord » (Lovelace a besoin de faire de la place pour Grace). Nous avons également inclus la gestion des modèles, qui utilise le nouveau type de modèle pour améliorer vos modèles Jinja.
Modifications incompatibles - Il y a eu quelques modifications incompatibles, tels que la suppression de la configuration YAML, la suppression du type NetDaemon, et le déplacement de la sélection beta vers une entité switch. Beaucoup de ces changements sont plus susceptibles d'affecter ceux qui partagent leur code via HACS, consultez les notes de version pour la liste complète.
Qu'est-ce que HACS ?
Home Assistant est construit sur la possibilité d'avoir le choix, et HACS en est la quintessence, vous donnant accès à des centaines d'intégrations, de cartes, de thèmes, et plus encore, créés par la communauté. HACS n'est pas vraiment un hack, car Home Assistant vous a toujours permis d'ajouter des intégrations personnalisées et des éléments d'interface utilisateur - HACS ajoute simplement une interface simplifiée pour les trouver, les installer et les mettre à jour.
HACS est l'acronyme de Home Assistant Community Store, et malgré son nom, il ne vend rien - tout est gratuit et open-source. HACS est là pour les membres de la communauté qui écrivent un code personnalisé pour combler une lacune de Home Assistant. Cela leur permet de partager facilement ce code avec la communauté sans restriction en soumettant leur dépôt GitHub à HACS. Cela signifie que ces codes sont maintenus par les membres de la communauté qui les téléchargent, et non par HACS ou Home Assistant. Si vous voulez en savoir plus sur ce que vous installez, ou signaler des problèmes, il y a toujours un lien vers le code original.
Pour dissiper le plus grand malentendu à propos de HACS, il n'installe pas de modules complémentaires. Home Assistant OS possède nativement son propre magasin intégré pour les modules complémentaires de Home Assistant. Les modules complémentaires fonctionnent avec Home Assistant, tandis que HACS installe du code personnalisé qui peut fonctionner dans Home Assistant (ce qui a des conséquences sur la stabilité du système, nous y reviendrons plus loin).
Pourquoi utiliser HACS ?
Plus d'intégrations - Tous les appareils et services ne sont pas supportés par Home Assistant, et HACS aide à combler les lacunes. Il y a des centaines d'intégrations sur HACS, certaines sont là parce que les auteurs n'ont pas eu le temps de répondre aux exigences de Home Assistant, tandis que d'autres font quelque chose qui n'est pas autorisé par Home Assistant, comme le web scraping (ce qui est parfois la seule façon, mais pas une bonne idée). Il faut savoir que ces décisions peuvent se faire au détriment de la stabilité.
Intégrations avancées - Certaines intégrations HACS sont des versions plus complexes et plus avancées de leurs homologues Core, tandis que d'autres intégrations combinent plusieurs capteurs pour fournir de nouveaux points de données. Certaines de ces « intégrations » offrent même à Home Assistant de nouvelles fonctions et paramètres avancés. Elles permettent également un développement rapide car elles autorisent des mises à jour en dehors du cycle de rafraîchissement de Home Assistant.
Cartes et thèmes - Des cartes, des interfaces utilisateur et des thèmes étonnants sont créés par les développeurs et les concepteurs de la communauté - d'ailleurs, si vous en faites partie, notre équipe frontale a besoin de votre aide. HACS a rendu l'installation et la mise à jour de ces designs très simples et rapides.
Scripts et modèles - C'est le moyen le plus simple de partager des scripts et des modèles, tout en ajoutant la possibilité d'apporter de nouvelles améliorations aux utilisateurs par le biais de mises à jour.
Un court historique de HACS
HACS a commencé en 2019 comme ma (Joakim Sørensen) troisième tentative de construire un magasin communautaire. Il a commencé petit et est rapidement devenu la norme de facto, avec tant de créateurs communautaires talentueux soumettant leurs projets. L'équipe de Home Assistant nous a soutenus dès le premier jour, et même si HACS a gagné des centaines de milliers de téléchargements, nous étions tous d'accord pour qu'il reste un ajout optionnel à Home Assistant. En donnant aux utilisateurs le choix d'ajouter de nouvelles fonctionnalités à Home Assistant au détriment de la stabilité.
J'ai rejoint Nabu Casa en 2020, en partie grâce au travail que j'ai effectué sur HACS, mais j'ai été embauché pour travailler sur Home Assistant de manière plus générale, et non pour travailler sur HACS. D'ailleurs, je ne suis pas le seul développeur travaillant chez Nabu Casa à avoir débuté sur HACS : Paul Bottein de l'équipe frontend a créé Mushroom Cards, et Marcel van der Veldt qui soutient actuellement le développement de Matter a créé Music Assistant.
Au fil des années, j'ai continué à travailler sur HACS pendant mon temps libre, mais il y avait toujours des aspects de la version originale qui limitaient sa capacité à se développer. Récemment, la Fondation Open Home a demandé à ce que HACS devienne un partenaire de collaboration et a fourni un soutien au développement. De nombreuses personnes de Nabu Casa et de la communauté ont été sollicitées pour apporter leur soutien, ce qui a permis d'obtenir la longue liste d'améliorations que vous voyez aujourd'hui.
Juste avant la sortie de cette grande mise à jour, elle a dépassé les 5 000 étoiles sur GitHub ! Ce sont les projets sur HACS qui en font ce qu'il est aujourd'hui, et j'aimerais remercier sincèrement tous ceux qui continuent à contribuer leur code sur le magasin.
Comment l'installer
Procédez avec prudence - HACS n'est pas pour tout le monde. Si vous êtes un débutant de Home Assistant ou si vous recherchez l'expérience la plus stable dans votre maison intelligente, HACS n'est probablement pas pour vous. Il s'agit de projets réalisés par la communauté qui ne font pas l'objet des mêmes évaluations rigoureuses que les projets soumis à Home Assistant. Il est possible que certains projets ne fonctionnent pas ou, pire encore, qu'ils cassent votre système. Contrairement aux modules complémentaires qui fonctionnent séparément et parallèlement à Home Assistant, les projets HACS exécutent leur code directement dans Home Assistant, ce qui augmente les risques de plantage ou d'endommagement de votre système. Avant d'utiliser HACS, faites toujours une sauvegarde de votre système et téléchargez cette sauvegarde sur un autre appareil.
HACS devrait fonctionner sur n'importe quelle version à jour de Home Assistant, il fonctionne même sur les installations de base. Il nécessite également un compte GitHub. Si vous avez déjà installé HACS 1.X, faites une sauvegarde, allez dans HACS et cliquez sur le bouton de mise à jour de HACS (note : si vous mettez à jour, il n'y a pas de retour en arrière possible).
Si vous utilisez Home Assistant OS, voici un guide rédigé par HACF. Sinon, suivi le guide officiel Home Assistant (si vous n'utilisez pas notre système d'exploitation, visitez cette page) :
- Faites une sauvegarde de votre système et téléchargez-la sur un autre appareil pour la conserver.
- Installez le module complémentaire : En utilisant ce lien, ajoutez le dépôt de modules complémentaires HACS et installez le module complémentaire auquel il est lié,
- Lancez le module complémentaire (il n'est pas nécessaire de cocher « démarrer au démarrage », vous ne devriez avoir à le faire qu'une seule fois).
- Naviguez jusqu'au « Journal » du module complémentaire et suivez les instructions qui y sont données.
- Une fois terminé, redémarrez Home Assistant et accédez à la page des périphériques. Ajoutez l'intégration HACS et suivez les instructions pour la lier à votre compte GitHub.
C'est installé, et maintenant ? Commencez à télécharger des intégrations personnalisées et des éléments d'interface utilisateur. Il existe de nombreuses ressources communautaires qui répertorient les meilleures intégrations personnalisées, cartes, thèmes et autres.
Conclusion
Il y a trop de personnes à remercier dans ce blog qui ont aidé au développement de HACS au fil des ans. Merci d'avoir soumis vos projets, d'avoir signalé des problèmes, d'avoir corrigé le code et d'avoir tout simplement utilisé ce petit projet parallèle amusant. Mais surtout, merci aux abonnés de Home Assistant Cloud. Ils ont rendu cette mise à jour possible, non seulement parce qu'ils paient mon salaire, mais aussi parce qu'ils financent l'Open Home Foundation, dont le soutien a été essentiel.
