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

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

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

Программа делает портативные браузеры: такие, которые лежат папкой, запускаются
откуда угодно и не ставятся в Windows. Закладки, пароли и вкладки хранятся внутри
этой же папки, поэтому её можно унести на флешке или отдать другому человеку.

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

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

Выбор везде делается кнопками. Выбранная подсвечивается синим, невыбранная
остаётся с цветной окантовкой. Браузеры окантованы каждый своим цветом, чтобы
ряд читался по названиям, а не по порядку.

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

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

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

Каждый браузер - это от 120 до 240 МБ загрузки и около полугигабайта на диске.
Готовые сборки появятся в папке назначения (`output\Portable`), запускать -
файлом `<Браузер> Portable.cmd` в корне каждой.

Если один браузер не собрался, остальные всё равно соберутся: неудачи
перечисляются в конце.

## Какие браузеры есть и почему только они

В списке те, у кого нет своей портативной сборки с автообновлением:

- **Google Chrome** - портативной версии не существует;
- **Yandex Browser** - портативной нет, зато сертификаты Минцифры уже внутри;
- **Brave** - портативные сборки только чужие, и они не обновляются;
- **Chromium-Gost** - умеет ГОСТ-шифрование, нужное на госпорталах;
- **Ungoogled Chromium** - Chromium без сервисов Google.

Нет и не будет: **Vivaldi**, **Cent Browser** и **Opera** - у них своя портативная
установка, которая сама обновляется, программа им ничего не добавит.
**Thorium** пробовали и убрали: сборки только 32-битные, а расширения из
магазина в нём не ставятся.

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

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

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

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

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

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

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

Если в `Источнике` сборки нет, программа посмотрит в `output\Portable` - то, что
собрала сама.

## Сертификаты Минцифры

Российские госсайты подписаны удостоверяющим центром, которому Windows по
умолчанию не доверяет, поэтому такой сайт открывается с предупреждением.
Шаги разделены, чтобы ничего не происходило само.

**При сборке** - галка `Сертификаты госсайтов`. Кладёт в сборку файлы и два
ярлыка, установить и отозвать. Сама ничего не устанавливает.

**Вкладка `СЕРТИФИКАТ` → `УСТАНОВИТЬ`** - добавляет сертификаты в хранилище
вашей учётной записи Windows, откуда их читает любой браузер на Chromium. Права
администратора не нужны, другие пользователи компьютера ничего не заметят.

**`ОТОЗВАТЬ`** - удаляет ровно эти два сертификата по отпечатку, чужие остаются
на месте.

**`ПРОВЕРИТЬ`** показывает, установлены они или нет, и ничего не меняет.

Яндекс.Браузеру сертификаты не нужны: они у него уже встроены.

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

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

**Разрядность обёртки.** Оставьте `АВТО`. Программа сама смотрит, 32- или
64-битный браузер, и кладёт подходящую обёртку Chrome++. Это не формальность:
32-битный браузер с 64-битной обёрткой запускается как ни в чём не бывало, но
профиль уезжает в систему, и сборка перестаёт быть портативной.

**Не оставлять следов в Windows.** По умолчанию выключено. С этой галкой браузер
при выходе стирает свою ветку реестра. Ветка общая с установленной копией того
же браузера, поэтому включайте только там, где этот браузер не установлен.

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

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

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

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

Портативная сборка и установленный браузер того же имени спокойно работают
одновременно и друг другу не мешают.