# Audion Yandex Portable - руководство

**Содержание**

- [Как устроено окно](#как-устроено-окно)
- [Первый запуск](#первый-запуск)
- [Что внутри собранной папки](#что-внутри-собранной-папки)
- [Обновление](#обновление)
- [Настройки сборки](#настройки-сборки)
- [Что стоит знать](#что-стоит-знать)

Программа делает портативный Яндекс.Браузер: такой, который лежит папкой,
запускается откуда угодно и не ставится в Windows. Всё, что браузер о вас
помнит - закладки, вкладки, пароли, - лежит внутри этой же папки.

## Как устроено окно

Сверху - три вкладки: `УСТАНОВКА`, `ОБНОВЛЕНИЕ`, `ОБСЛУЖИВАНИЕ`. Это и есть всё
меню: нажали вкладку - под ней сразу её команды и их настройки. Над вкладками
стоит строка `ОБСЛУЖИВАНИЕ` с очисткой рабочих папок: она относится к программе
целиком.

Выбор делается кнопками - выбранная подсвечена синим, остальные контурные.
Подписи короткие, а объяснение появляется в подсказке, если задержать на кнопке
или галке указатель мыши.

## Первый запуск

1. Вкладка `ОБСЛУЖИВАНИЕ` → `7-ZIP`. Без него распаковать дистрибутив не
   получится.
2. Вкладка `УСТАНОВКА` → `СОБРАТЬ`.

Скачается около 200 МБ, распакуется примерно 500 МБ. Готовая сборка появится в
папке назначения (`output\Portable\Yandex Browser Portable`). Запускать - файлом
`Yandex Browser Portable.cmd` в её корне.

Папку можно переносить куда угодно: на другой диск, на флешку, отдать коллеге.
Профиль поедет вместе с ней.

## Что внутри собранной папки

| Папка или файл | Что это |
| --- | --- |
| `App` | Сам браузер. При обновлении заменяется целиком. |
| `Data` | Ваш профиль: закладки, пароли, вкладки, расширения. |
| `Cache` | Кэш. Можно чистить, ничего не потеряется. |
| `Yandex Browser Portable.cmd` | Запуск браузера. |
| `Portable-Build.json` | Какие версии внутри - браузера и Chrome++. |

## Обновление

Вкладка `ОБНОВЛЕНИЕ`.

`ПРОВЕРИТЬ` показывает, что опубликовано, рядом с версией вашей сборки. Ничего не
скачивается: версия читается из ссылки на загрузку. Проверять стоит - сам
дистрибутив весит 200 МБ.

`ОБНОВИТЬ` меняет в сборке только браузер: `Data` и `Cache` остаются, профиль на
месте. Если версия уже свежая, скачивания не будет вовсе.

**Обновление идёт там же, где лежит сборка.** Укажите её папку в `Источнике` - на
флешке, в сетевой папке, где угодно - и она обновится на месте. Копировать никуда
не нужно; папка назначения при обновлении не используется, она для новых сборок.
Если в `Источнике` ничего нет, программа посмотрит в `output\Portable`.

`CHROME++` нужен, когда браузер трогать не хочется: обновляются `version.dll` и
`chrome++.ini` прямо в сборке - это 180 КБ. Обёртка выходит чаще браузера.

## Настройки сборки

**Не оставлять следов в Windows.** Браузер держит служебные счётчики не в
профиле, а в реестре Windows. Галка велит стереть эту ветку, когда браузер
закрывается, - тогда после него в системе не остаётся ничего.

Снимите её, если на этой машине установлен обычный Яндекс.Браузер: ветка у них
общая, и портативная сборка сотрёт счётчики установленного.

**Убрать встроенное обновление.** Оставьте включённой. Иначе обновление Яндекса
однажды поставит браузер в систему в обход портативной папки, и смысл сборки
пропадёт. Обновлять сборку - задача этой программы.

**Упаковать в архив.** Включите, если сборку надо кому-то отдать: вместо папки
получится один файл. Формат рядом: `ZIP` открывается везде, `7Z` меньше, но
требует 7-Zip у получателя. Для себя удобнее папка - её можно сразу запустить.

**Портативность.** Чем сборка удерживает профиль в своей папке. `CHROME++` -
обёртка, с которой программа начиналась: рядом с браузером кладётся её
`version.dll`. `ПРОКСИ БИБЛИОТЕКА` - другая такая же обёртка, авторства neyrostalker:
делает то же самое, вдобавок сразу блокирует запись в реестр, и антивирус
Microsoft её угрозой не считает. Подробности,
отличия и результаты проверки - в `docs/CHROME_PLUS_AND_DEFENDER.md`.

**Разрядность обёртки.** Оставьте `X64`. Яндекс отдаёт для Windows именно эту
сборку, и разрядность должна совпадать.

**Оставить рабочие файлы** (в `Дополнительно`). Загрузка и распакованный
дистрибутив останутся в `workspace` - нужно, если сборка не удалась и надо
разобраться.

## Что стоит знать

Сертификаты Минцифры в Яндекс.Браузере уже встроены, отдельно ставить их не
нужно, и системное хранилище браузер не меняет. Ради этого портативная сборка
обычно и нужна: доступ к сайтам с такими сертификатами есть, а система остаётся
чистой.

Первый запуск браузера дольше обычного - он раскладывает профиль. Дальше
запускается как всегда.