Руководство по установке и эксплуатации ПО «ERG»

Часть 1. Установка

1. Состав поставки

Пакет содержит программу /usr/bin/erg, ярлык в меню приложений, значок, регистрацию типа файлов .ipa и перечень сторонних компонентов /usr/share/doc/erg/THIRD_PARTY_LICENSES.md.

Установочные пакеты и контрольные суммы SHA-256 доступны на странице продукта: https://techsolution.ru/products/erg

2. Установка

Для установки нужны права администратора. Зависимости (графические библиотеки X11/OpenGL) устанавливаются из стандартных репозиториев ОС автоматически.

Astra Linux

sudo apt install ./erg_0.1.0-1_amd64.deb

РЕД ОС

sudo dnf install ./erg-0.1.0-1.x86_64.rpm

macOS

Распакуйте архив ERG-0.1.0-macos.zip и перенесите ERG.app в папку «Программы». При первом запуске щёлкните по значку правой кнопкой мыши и выберите «Открыть».

Проверка установки

erg --version

Ожидаемый вывод: ERG 0.1.0 (ООО «Тех Солюшен»).

После установки ERG доступна в меню приложений в разделе «Разработка» под названием «ERG — аудит iOS-сборок».

3. Первый запуск и активация

1. Запустите ERG. Начнётся пробный период: 5 дней, проверка одного приложения.
2. Откройте на вкладке «Проверка» сборки приложений, которые планируете проверять. ERG запомнит их идентификаторы (bundle ID) — уникальные имена приложений вида ru.company.app, по которым выдаётся лицензия. Идентификатор запоминается, даже если в пробном периоде сборка не будет проверена.
3. Откройте вкладку «Лицензия» и нажмите «Скопировать запрос на ключ» — в буфер обмена попадут код компьютера и список bundle ID. Вставьте текст в письмо в ООО «Тех Солюшен», допишите организацию и контакт.
4. Полученный файл ключа .erglicense перетащите в окно программы (или вставьте текст ключа в поле и нажмите «Активировать»).
5. Ежемесячно после оплаты устанавливайте полученный ключ продления тем же способом.

4. Где хранятся данные

Сетевые соединения программа не выполняет; межсетевой экран настраивать не нужно.

5. Обновление и удаление

• Обновление: установка пакета новой версии той же командой. История, настройки и лицензия сохраняются.
• Удаление: sudo apt remove erg (Astra Linux) или sudo dnf remove erg (РЕД ОС). Данные пользователя в домашнем каталоге не удаляются.

6. Перенос на другой компьютер

Лицензия привязана к компьютеру. При замене компьютера или переустановке ОС передайте в ООО «Тех Солюшен» (sales@techsolution.ru) новый код компьютера — будет выпущен ключ для нового компьютера.

Часть 2. Эксплуатация

1. Общие сведения

ERG проверяет сборку iOS-приложения перед корпоративным выпуском и выдаёт отчёт с замечаниями. Программа работает без подключения к сети. Окно программы содержит четыре вкладки: «Проверка», «История», «Настройки», «Лицензия».

2. Проверка сборки

1. Откройте вкладку «Проверка».
2. Перетащите в окно файл сборки: .ipa, .zip, .xcarchive или .app. Также можно открыть файл через контекстное меню файлового менеджера «Открыть с помощью → ERG».
3. По желанию перетащите дополнительные файлы:
   • профили распространения .mobileprovision (для приложения и каждого расширения) — включают проверку совместимости с профилем (блок B);
   • entitlements.plist от разработчика — точный перечень возможностей приложения;
   • manifest.plist — включает проверку файла установки по ссылке (блок D).
4. Проверка запускается автоматически и повторяется при добавлении или удалении файлов (кнопка «убрать» рядом с файлом).

2.1. Как читать результат

Вердикт:

• ГОТОВО — замечаний, препятствующих выпуску, нет;
• ГОТОВО С ПРЕДУПРЕЖДЕНИЯМИ — выпуск возможен после осознанного решения по каждому предупреждению;
• НЕ ГОТОВО — есть блокеры; выпускать сборку нельзя.

Уровни замечаний: ✖ блокер, ⚠ предупреждение, ℹ для сведения.

Для каждого замечания указаны код правила, описание, место в сборке и строка «Исправить (разработчику)» или «Исправить (нам)» — кто и как устраняет проблему.

Строки «✔» — правило пройдено. Строки «— не проверялось» — для правила нет исходных данных (например, не приложен профиль); указана причина.

Описание всех правил — в документе «Справочник правил».

2.2. Отчёты

• Сохранить полный отчёт — все проверки и замечания.
• Сохранить отчёт для разработчика — только замечания, исправляемые в сборке; предназначен для передачи подрядчику.
• Папка отчётов — открыть каталог ~/ERG-отчёты.

Отчёт сохраняется в формате HTML и открывается в любом браузере. Для получения PDF выберите в браузере «Печать → Сохранить как PDF».

3. История

Вкладка «История» содержит перечень выполненных проверок: дата, файл, приложение, версия и номер сборки, вердикт, число блокеров и предупреждений. При проверке новой сборки программа сравнивает её с последней проверкой того же приложения: номер сборки, состав SDK, размер.

4. Настройки

Нажмите «Сохранить». Настройки применяются к следующим проверкам.

5. Лицензия

Вкладка показывает состояние лицензии:

• Пробный период — 5 дней, проверка одного приложения; отчёты отмечаются надписью «ПРОБНАЯ ВЕРСИЯ».
• Лицензия — номер лицензии, заказчик и таблица приложений: оплачено до, состояние («оплачен», «заканчивается через N дн.», «льготный срок», «не оплачен»).

Как получить ключ. Для ключа нужны код компьютера (определяется автоматически) и bundle ID приложений — уникальные имена вида ru.company.app. ERG запоминает bundle ID всех проверенных сборок и показывает их на вкладке «Лицензия»; чтобы добавить приложение, проверьте его сборку. Кнопка «Скопировать запрос на ключ» формирует готовый текст письма в ООО «Тех Солюшен».

Ключ лицензии или продления вставляется в поле или перетаскивается в окно файлом .erglicense.

Если приложение не входит в лицензию или период оплаты и льготный срок (3 дня) закончились, проверка этого приложения не выполняется; программа сообщает причину.

6. Типовые ситуации