Skip to content

💻 Un guide en français pour contribuer au projet Home Assistant

License

Notifications You must be signed in to change notification settings

hacf-fr/homeassistant-guide-du-developpeur

Repository files navigation

Home Assistant - Guide du développeur

Présentation

Ce guide a pour vocation de présenter le développement de composants de Home Assistant.

Pour ce faire nous présenterons indépendamment chacun des environnements de développement :

  • le backend qui concerne les intégrations (entités/sensors)

  • le frontend qui concerne l'interface utilisateur (Lovelace et ses composants)

La boîte à outils

Chaque environnement a ses outils spécifiques et seront précisés dans chaque section.

Néanmoins voici quelques éléments communs aux deux :

Obligatoires:

  • git pour la gestion de version.
  • Un compte Github

Recommandés:

  • Docker pour tester vos contributions dans un environement local et dédié (conteneur).
  • Visual Studio Code (VSC). Tout autre editeur peut convenir. VSC offre plusieurs addons qui facilitent le développemnent avec Home Assistant.
  • L'Addon Remote - Containers pour VSC. Il permet d'utiliser les conteneurs de développement via Docker.

Participer aux projets

Avant de présenter plus en avant le développement sous Home Assistant, nous allons faire un point sur la gestion d'un projet (un développement).

Si vous êtes familier avec GitHub, vous pouvez passer ce chapitre. Pour les autres ...

Les environnements

Il y a deux environnements distincts :

  • Le backend ou le coeur de Home Assistant
  • Le frontend ou l'interface utilisateur

Suivant ce que vous allez travailler, vous n'aurez pas besoin des mêmes langages, compétences et ressources.

Les ressources

Ci-dessous un ensemble de ressources qui compléteront votre apprentissage.