Skip to content

Commit

Permalink
docs: Rewrite component installation for HACS v2
Browse files Browse the repository at this point in the history
  • Loading branch information
dext0r committed Nov 23, 2024
1 parent 875dbce commit 2d1df05
Show file tree
Hide file tree
Showing 7 changed files with 28 additions and 19 deletions.
Binary file modified docs/assets/images/install/hacs-1.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file modified docs/assets/images/install/hacs-2.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file removed docs/assets/images/install/reinstall-1.png
Binary file not shown.
Binary file removed docs/assets/images/install/reinstall-2.png
Binary file not shown.
Binary file removed docs/assets/images/install/reinstall-3.png
Binary file not shown.
Binary file added docs/assets/images/install/reinstall.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
47 changes: 28 additions & 19 deletions docs/install/component.md
Original file line number Diff line number Diff line change
@@ -1,30 +1,39 @@
## Через HACS (рекомендованный способ) { id=hacs }
* Установите [HACS](https://hacs.xyz/docs/setup/download)
* Откройте HACS --> Интеграции
* Нажмите кнопку `Исследуйте и устанавливайте репозитории` в правом нижнем углу
* В поиске введите `Yandex` и выберите `Yandex Smart Home`
* Нажмите `Загрузить этот репозиторий с помощью HACS` --> `Скачать`
## Установка через HACS { id=hacs }

!!! success "Рекомендованный способ"

* [Установите](https://hacs.xyz/docs/use/download/download/) компонент HACS --> Перезагрузите Home Assistant --> [Добавьте интеграцию](https://hacs.xyz/docs/use/configuration/basic/) HACS
* Откройте HACS через боковую панель
* В поиске введите `Yandex Smart Home`
* Нажмите :fontawesome-solid-ellipsis-vertical: в строчке с интеграцией --> `Скачать`
* Для завершения установки перезагрузите Home Assistant

![](../assets/images/install/hacs-1.png){ width=750 }
![](../assets/images/install/hacs-2.png){ width=750 }

## Вручную (не рекомендуется) { id=manual }
* Вручную скопируйте папку `custom_components/yandex_smart_home` из [latest release](https://github.com/dext0r/yandex_smart_home/releases/latest) в директорию `/config/custom_components`
* Перезапустите Home Assistant
## Установка вручную { id=manual }

!!! warning "Не рекомендуется!"

## Переход на бета-версию { id=change-version }
Для перехода на бета-версию компонента или установки другой версии:
!!! hint "Обновление выполняется аналогично установке"

* Откройте HACS, найдите компонент `Yandex Smart Home` и кликните по нему
* Нажмите три точки в правом верхнем углу
* Нажмите `Обновить информацию`, затем `Скачать повторно`
* Поставьте галочку `Показывать бета-версии` и выберите нужную версию
* Скачайте архив `yandex_smart_home.zip` из [последнего релиза](https://github.com/dext0r/yandex_smart_home/releases/latest)
* Создайте подкаталог `custom_components/yandex_smart_home` в каталоге где расположен файл `configuration.yaml`
* Распакуйте содержимое архива в `custom_components/yandex_smart_home`
* Перезапустите Home Assistant

## Обновление через HACS { id=update }

При выпуска новой версии компонента информация о необходимости обновления появится в разделе Настройки. Если этого не произошло, проверьте обновления вручную через Настройки --> Система --> [Обновления](https://my.home-assistant.io/redirect/updates/) --> :material-refresh:

Если по какой-то причине обновление не появляется, скачайте компонент повторно через HACS:

* Откройте HACS через боковую панель
* В поиске введите `Yandex Smart Home`
* Нажмите :fontawesome-solid-ellipsis-vertical: в строчке с интеграцией --> `Скачать повторно`
* Для завершения обновления перезагрузите Home Assistant

!!! hint "Не беспокойтесь"
Повторное скачивание компонента **не удаляет** уже настроенную интеграцию
Повторное скачивание компонента **не удаляет** уже настроенную интеграцию.

![](../assets/images/install/reinstall-1.png){ width=750 }
![](../assets/images/install/reinstall-2.png){ width=750 }
![](../assets/images/install/reinstall-3.png){ width=750 }
![](../assets/images/install/reinstall.png){ width=750 }

0 comments on commit 2d1df05

Please sign in to comment.