HACS 2.0 – La meilleure façon de partager des projets communautaires s’est améliorée

Œuvre de Clelia Rella

En résumé : HACS 2.0 est un grand pas en avant, ajoutant une méthode d’installation plus simple, des mises à jour plus rapides, une nouvelle interface utilisateur et des notifications de mise à jour/réparation appropriées de Home Assistant.

La boutique communautaire de Home Assistant, HACS, est désormais en v2.0, bénéficiant de quelques améliorations importantes qui continuent d’en faire le meilleur moyen de trouver, d’installer et de mettre à jour des intégrations et des éléments d’interface utilisateur créés par la communauté. Cela fait suite à l’ajout de HACS en tant que fondation Open Home partenaire de collaboration, reconnaissant 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 Home Assistant, ce qui peut entraîner 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.

Accéder aux sections

Vous souhaitez ignorer le blog et commencer à jouer avec HACS 2.0 ? N’oubliez pas de procéder avec prudence et de ne pas sauter l’étape de sauvegarde avant l’installation.

HACS atteint la version 2.0

Il s’agit de l’une des mises à jour les plus importantes à ce jour pour HACS, mais si vous n’êtes pas sûr de ce qu’est HACS ou pourquoi vous pourriez envisager de l’utiliser, consultez notre explication ci-dessous.

Nouveau frontend

Tableau de bord principal HACS 2.0 s’inspire de Home Assistant et correspond désormais étroitement à l’apparence et aux fonctionnalités natives des tables de données que vous trouvez sur les entités ou les pages d’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, depuis l’emplacement des fichiers jusqu’au nombre d’étoiles. Nous avons donc dû 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 Les fichiers sont stockés dans des buckets Cloudflare R2, qui sont mis à jour à intervalles réguliers. Les fichiers sont toujours téléchargés depuis GitHub et leur API est toujours contactée, mais les appels seront considérablement réduits et l’amélioration de la vitesse est massive. En coulisses, il s’agissait d’un travail de grande envergure, 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 réparation

Plus besoin de consulter 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 au format natif de Home Assistant. De plus, une fois la mise à jour terminée, elles vous proposeront des réparations (par exemple, recharger les tableaux de bord ou redémarrer Home Assistant).

Autres améliorations

Nous avons également renommé les éléments pour les rendre plus compréhensibles, notamment en remplaçant « catégorie » par « type » et « Lovelace » par « tableau de bord » (Lovelace doit 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.

Qu’est-ce que HACS ?

Home Assistant est conçu autour du choix, et HACS en est l’incarnation, 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 réellement un hackcomme 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 rechercher, les installer et les mettre à jour.

HACS signifie Boutique communautaire Home Assistantet malgré son nom, il ne vend rien : il est entièrement gratuit et open source. HACS est là pour les membres de la communauté qui écrivent du code personnalisé pour résoudre un problème qui, selon eux, manque à Home Assistant. Il leur permet de partager facilement ce code avec la communauté sans restriction en soumettant leur dépôt GitHub à HACS. Cela signifie que ceux-ci sont maintenus par les membres de la communauté qui les téléchargent, et non par HACS ou Home Assistant. Si vous souhaitez en savoir plus sur ce que vous installez ou signaler des problèmes, il existe toujours un lien vers le code d’origine.

Juste pour dissiper la plus grande idée fausse sur les HACS, il n’installe pas de modules complémentaires. Home Assistant OS dispose nativement de son propre magasin intégré pour les modules complémentaires de Home Assistant. Les modules complémentaires fonctionnent en parallèle de Home Assistant, tandis que HACS installe du code personnalisé qui peut s’exécuter dans Home Assistant (ce qui a des implications sur la stabilité du système, plus d’informations à ce sujet ci-dessous).

Pourquoi utiliser HACS ?

Plus d’intégrations – Tous les appareils et services ne sont pas pris en charge par Home Assistant dès leur sortie, et HACS permet de combler les lacunes. Il existe 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 scraping Web (qui est parfois le seul moyen, mais pas une bonne idée)). Soyez simplement conscient 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 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 fonctionnalités et de nouveaux paramètres avancés. Elles permettent également un développement rapide car elles permettent des mises à jour en dehors du cycle de rafraîchissement de Home Assistant.

Cartes et thèmes – Il existe des cartes, des interfaces utilisateur et des thèmes incroyables créés par des développeurs et des concepteurs de la communauté. D’ailleurs, si vous en faites partie, notre équipe frontend a besoin de votre aide. HACS a rendu l’installation et la mise à jour de ces conceptions 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é de proposer de nouvelles améliorations aux utilisateurs via des mises à jour.

Une brève histoire du HACS

HACS a débuté en 2019 sous le nom de mon (Joakim Sørensen ) troisième tentative de création d’une boutique communautaire. Elle a commencé modestement et est rapidement devenue la norme de facto, avec de nombreux 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 avons tous convenu qu’il devait rester un ajout facultatif à Home Assistant. Donner 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 fait 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 commencé sur HACS : Paul Bottein sur l’équipe frontend qui a construit Mushroom Cardset 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é de croissance. Récemment, la Fondation Open Home HACS a fait appel à nos services pour collaborer avec nous et nous a apporté un soutien au développement. De nombreuses personnes ont été mobilisées pour apporter leur soutien, de l’ensemble de Nabu Casa et de la communauté, ce qui a donné lieu à la longue liste d’améliorations que vous pouvez constater aujourd’hui.

Juste avant la sortie de cette grosse mise à jour, elle a dépassé les 5 000 étoiles sur GitHub ! Ce sont les projets sur HACS qui en font ce qu’elle est aujourd’hui, et je tiens à remercier sincèrement tous ceux qui continuent à contribuer avec leur code sur la boutique.

Comment installer

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, effectuez une sauvegarde, accédez à HACS, puis cliquez sur le bouton de mise à jour de HACS (remarque : si vous effectuez une mise à jour, il n’y a pas de rétrogradation).

Si vous êtes un utilisateur du système d’exploitation Home Assistant, voici la méthode d’installation (si vous n’utilisez pas notre système d’exploitation, visitez cette page),

1. Faites une sauvegarde de votre système et téléchargez-la sur un autre appareil pour la conserver en lieu sûr.

2. Installer le module complémentaire : à l’aide de ce lien, ajoutez le référentiel de modules complémentaires HACS et installez le module complémentaire auquel il est lié,

3. Démarrez le module complémentaire (pas besoin de « démarrer au démarrage », vous ne devriez avoir besoin de l’exécuter qu’une seule fois).

4. Accédez au « Journal » du module complémentaire et suivez les instructions qui y sont fournies.

5. Une fois terminé, redémarrez Home Assistant et accédez à la page des appareils. 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 intéressantes répertoriant les meilleures intégrations personnalisées, cartes, thèmes et bien plus encore.

Conclusion

Il y a trop de gens à remercier sur ce blog qui ont contribué au développement de HACS au fil des ans. Merci d’avoir soumis vos projets, signalé des problèmes, corrigé du code et simplement utilisé ce petit projet parallèle amusant. Plus important encore, merci aux abonnés de Home Assistant Cloud. Ils ont rendu cette mise à jour possible, non seulement ils paient mon salaire, mais ils financent également la Fondation Open Home, dont le soutien a été essentiel.