PRO1VPN Android / Android TV 1.0.23

Нативный Android-клиент на основе v2rayNG 2.2.6 (GPL-3.0).
Минимальная версия Android: 7.0 (API 24).
Идентификатор приложения: ru.pro1vpn.android.

УСТАНОВКА
Для современных телефонов используйте PRO1VPN_1.0.23_arm64-v8a.apk.
Если архитектура неизвестна, используйте PRO1VPN_1.0.23_universal.apk.
Разрешите установку APK для приложения, из которого открываете файл.
Откройте PRO1VPN → «Подписка» → «Добавить подписку» → вставьте свою ссылку.
После первой загрузки выбран верхний пункт «Автоматический выбор».
Нажмите «Подключиться» или выберите другой сервер. Ручной выбор сохраняется при обновлении списка.
При первом подключении Android запросит разрешение на VPN.
Список профилей, QR-импорт, журнал, маршрутизация и приложения-исключения
доступны отдельными кнопками в разделе «Ещё».
Для обновления подписки или смены сервера сначала отключите VPN.
Обычный v2rayNG можно оставить установленным: пакет приложения другой.

ВОЗМОЖНОСТИ И ГРАНИЦЫ
Одна подписка PRO1VPN: HTTPS-ссылка на один из доверенных доменов сервиса.
При недоступности адреса приложение проверяет ту же подписку через резервные
домены. Код подписки, настройки устройства и выбранные профили сохраняются.
Другие провайдеры и отдельные ключи не импортируются.
Поддержка VLESS/Reality, VMess, Trojan, Shadowsocks и конфигураций Xray
зависит от встроенного ядра и конкретной конфигурации.
«Продлить подписку» открывает страницу вашей подписки в браузере.
Код входа в ЛК виден в карточке и копируется кнопкой. Ссылку можно менять и удалять.
На карточке отображаются трафик и срок, если их присылает сервер.
Есть проверка отклика, сортировка, поиск, доступные и избранные серверы.
Автоматическая проверка и загрузка APK с pro1updates.ru/updates/android/
и cabinet.pro1technology.ru/updates/android/ с переключением при сбое.
Установка подтверждается пользователем. Подробности — UPDATE-SERVER.txt.
Данные подписки не предустановлены. Для работы нужна личная действующая ссылка.
Рассылки, промопредложения и напоминания за 3 дня и 1 день приходят в раздел
«Уведомления». Разрешите уведомления в настройках Android. См. NOTIFICATIONS.txt.
Состояние «VPN включён» означает работающий VPN-сервис; оно не является
проверкой доступности всех сайтов и маршрутов.

ССЫЛКИ ИМПОРТА
pro1vpn://install-sub?url=<URL-кодированная ссылка подписки>
Старый install-config распознаётся, но принимает только ссылку PRO1VPN.
Поддерживается Android «Поделиться» для текста.
Для внешней ссылки запрашивается подтверждение импорта.

ПОВТОРНАЯ СБОРКА
Требуются Java 21, Android command-line tools, SDK platform android-37.0,
build-tools 37.0.0, NDK 29.0.14206865, Python 3, curl, openssl, unzip.
Gradle 9.5.1 загружается штатным gradlew.
1. Установить перечисленные компоненты SDK с помощью sdkmanager.
2. В исходном Git checkout выполнить git submodule update --init --recursive.
   В архиве исходников содержимое подмодулей уже включено.
3. ANDROID_SDK_ROOT=/путь/к/sdk PRO1VPN_SIGN_DIR=/закрытый/каталог/подписи \
   bash scripts/build-release.sh
4. Результат находится в release/. Контрольные суммы — release/SHA256SUMS.

Скрипт собирает нативный туннель из исходников и использует официальный
libv2ray.aar из AndroidLibXrayLite v26.7.5 — версии подмодуля v2rayNG 2.2.6.
SHA-256 библиотеки закреплён в scripts/libv2ray.sha256.
Для самостоятельной сборки AAR см. AndroidLibXrayLite/.github/workflows/main.yml
и AndroidLibXrayLite/go.mod: Go 1.26, gomobile bind, Android API 24.
Географические базы включены в официальный AAR.

КЛЮЧ ПОДПИСИ
На рабочей VPS ключ и пароль хранятся отдельно от проекта:
/home/work/.pro1vpn-android-signing/
Файлы release.jks и password необходимы для последующих обновлений.
Не включайте их в архив исходников и не публикуйте.
При новой сборке на другом компьютере передайте тот же ключ безопасным способом.
Новый ключ не позволит обновить уже установленный APK без удаления приложения.

ИСХОДНИКИ И ЛИЦЕНЗИИ
Основа: https://github.com/2dust/v2rayNG/tree/2.2.6
Коммит: 15b4fff8e45da9bc0acaa5cc1d80a1d3531e8712
Ядро: https://github.com/2dust/AndroidLibXrayLite/tree/v26.7.5
Лицензия приложения: LICENSE (GPL-3.0), уведомления зависимостей сохранены.
Изменения PRO1VPN от 01.10.2026: отдельный package ID и версия; русский
главный экран; импорт/обновление подписок; собственная иконка; отключение
системного резервного копирования и пункта обновлений upstream; исправление
жизненного цикла импорта внешних ссылок и исключение их из журнала;
исправление распознавания IPv6 с портом и проверки IPv4/IPv6 CIDR,
дополнительные тесты неверных портов, масок и адресных семейств;
ярлыки Android и определение Xray адаптированы к идентификатору PRO1VPN.
В версии 1.0.1 добавлены автообновления с HTTPS-сервера, проверка APK и экран
управления обновлениями. Публикация APK и исходников выполняется отдельно от Windows.
В версии 1.0.2 оформление согласовано с Windows: светлый фон, фиолетовые
акценты, карточки, круглая кнопка VPN, нижняя навигация и поиск серверов.
Изменение интерфейса не требует удаления старой версии или повторного импорта.
В версии 1.0.3 исправлен конфликт FileProvider при передаче APK установщику.
Перенесены текущий стиль Windows 0.3.6, отдельный экран серверов, фильтры,
проверка пинга, карточки подписок и управление ссылками.
Обновите старую версию через браузер поверх установленной, без удаления.
При передаче APK передавайте также соответствующий архив исходников.

ПРОВЕРКА В ЭМУЛЯТОРЕ
scripts/smoke-emulator.py предназначен только для отдельного тестового
эмулятора emulator-5554. Он очищает данные установленного PRO1VPN, использует
искусственные ключи и локальный HTTP-сервер и проверяет импорт и запуск
VPN-службы. Он не проверяет доступ в интернет через настоящую подписку.

Версия 1.0.4: установка через Android PackageInstaller
--------------------------------------------------
APK целиком записывается в системную сессию и проверяется повторным чтением.
Установку подтверждает пользователь. Ошибки нехватки места, конфликта, запрета
и несовместимости отображаются отдельно; доступно повторное скачивание.
При ошибке в старом приложении откройте ссылку новой версии в браузере.
Для POCO Pad M1 используйте ARM64; не удаляйте старое приложение.
Перед публикацией scripts/verify-apk.py проверяет сертификат, ZIP, DEX,
выравнивание ресурсов и ELF64-библиотек под страницы 16 КБ.

Версия 1.0.7: интерфейс телефона и планшета
----------------------------------------
На широком экране — боковая навигация, на узком — нижние вкладки с иконками.
На главной появилась сводка подписки и быстрые действия; на больших планшетах
они расположены рядом с подключением. Сервер выбирается нажатием на карточку,
пинг выделен цветом. Поиск и фильтры сохраняются при повороте устройства.
Есть очистка поиска, сброс фильтров, шкала расхода трафика при известном лимите
и отдельные кнопки маршрутизации, приложений VPN и журнала.

Параллельные проверки и диагностика 1.0.7
В «Серверы» выберите 2/4/8/16 потоков (по умолчанию 8).
«Ещё → Диагностика и отчёты»: журнал подключений и ошибок, ручной отчёт,
подтверждение приёма и очередь отправки при отсутствии сети.
Измерения качества включены по умолчанию; можно выключить.
Подробные автоотчёты при ошибках включаются отдельно, как на ПК.
Адрес приёмника: https://cabinet.pro1technology.ru/client-reports/v1
Измерения: https://cabinet.pro1technology.ru/client-reports/metrics
Ссылки, пароли, ключи, исходные логи и посещённые сайты не передаются.
Фоновая отправка допускает мобильный интернет и может откладываться Android.

НАСТРОЙКИ 1.0.7
Ещё → Все настройки PRO1VPN. Подробное соответствие присланным экранам:
FEATURES-ANDROID.md. Включены темы, иконки, правила по типу сети, методы пинга,
параметры туннеля, провайдеров и производительности. Автоматическая облачная
синхронизация пока не реализована. Девять языков из INCY добавлены; см. LANGUAGES.md.

ЯЗЫКИ
Выбор: Ещё → Все настройки PRO1VPN → Тема, стиль подключения и иконка → Язык интерфейса.
Русский, English, 中文简体, فارسی, 한국어, Türkmen, O‘zbek, Azərbaycan, Қазақ и язык системы.
Переводы встроены в APK и работают без интернета.

ПОДПИСКИ 1.0.8
Загрузка полного JSON как Happ, с автовыбором и маршрутизацией.
После установки: Подписки → Обновить подписки. См. SUBSCRIPTIONS.md.

ОБНОВЛЕНИЯ 1.0.9
Подписки обновляются при открытии и возвращении в приложение (включено по умолчанию).
Проверка новых версий в любой сети; уведомление и кнопка на главном экране.
Автоматическое скачивание APK — только в сети без тарификации; установка с подтверждением.
См. AUTO-UPDATES.md.

ЛОГОТИП И ТЕМЫ 1.0.11
Новый знак и надпись PRO1VPN по изображению владельца. Быстрый выбор темы
на главном экране: Как в системе (по умолчанию), Светлая, Тёмная.
Сохранённый ручной выбор сохраняется. Подробности BRANDING.txt.

ИНТЕРФЕЙС 1.0.13
Главная страница: подключение, выбор сервера, пинг, обновление и продление.
Серверы, данные подписки и остальные функции находятся в отдельных вкладках.
Компактные строки серверов, раскрываемые фильтры и сгруппированные настройки.
Фон с глобусом, единые светлая/тёмная палитры, отступ нижнего меню над областью жестов.
Первый импорт выбирает верхний автоматический профиль. Ручной выбор сохраняется.

ИЗМЕНЕНИЯ 1.0.13
Плоское нижнее меню с выделением значка и шириной до 560dp. Отступ над
системной навигацией сохранён. Подписка: срок и трафик, одно продление,
управление в раскрываемом блоке. Код входа показывается только по нажатию.
Выбор другого сервера при включённом VPN автоматически перезапускает службу.
Во время переключения повторный выбор блокируется; таймаут освобождает управление.

ANDROID TV 1.0.14
Версия для ТВ: отдельный пакет ru.pro1vpn.tv, APK PRO1VPN_TV_1.0.14_*.apk.
Экран для пульта: Подключение, Серверы, Подписка / код ТВ, обновления приложения.
Телефон: Подписка или Ещё → Подключить телевизор → QR / ввод кода → подтвердить.
Кабинет: Устройства → Ввести код с телевизора; прямой адрес https://lk.pro1technology.ru/tv.
Код из восьми символов действует 10 минут, передаёт существующую подписку,
не покупает дополнительную подписку и не увеличивает лимит устройств тарифа.
Телефон и ТВ могут использовать разные сети. Перед заменой подписки отключите VPN.
На ТВ допустим ручной ввод ссылки PRO1VPN. VPN запускается после системного согласия.
Сборка TV: в V2rayNG ./gradlew :app:assembleTvRelease;
подпись: bash scripts/sign-release.sh tv; исходники общие с мобильным приложением.
Фид ТВ: https://cabinet.pro1technology.ru/updates/android-tv/update.json.
Сервер привязки: server/tv_pairing.py; подключение к существующему pro-lk
описано в /home/work/VPSPRO1VPN/android-tv-20261006/prepare-server.py.

УСТАНОВКА НА ТВ ЧЕРЕЗ DOWNLOADER
На телевизоре установите Downloader by AFTVnews из Google Play.
Введите код 6300701 и нажмите Go. Разрешите установку из Downloader,
затем установите PRO1VPN. Откройте приложение и привяжите свою подписку.
Прямая ссылка актуального APK: https://lk.pro1technology.ru/tv.apk.
Инструкция и привязка: https://lk.pro1technology.ru/tv.

ANDROID TV 1.0.16
Экран ТВ оформлен как PRO1VPN на Android: фирменный фон и логотип,
круглая кнопка VPN, карточка выбранного сервера, список серверов в две колонки,
код и QR подписки в общей карточке. Меню без внешней рамки, кнопки без
постоянных обводок. Кнопка VPN использует один круг; контур появляется только
при фокусе пульта. Статус подключения обозначается текстом и цветной точкой.
Фирменный фон сохранён. Для узких экранов карточки располагаются вертикально;
меню прокручивается. TV-элементы не меняют внешний вид мобильного приложения.
Функции остаются прежними: VPN, выбор сервера, подписка и обновление приложения.
Баннер запуска: PRO1VPN TV, фирменный логотип, 320x180 PNG; исходник SVG
brand/pro1vpn-tv-banner.svg, генератор scripts/generate-tv-banner.cjs.
«Авто LTE» исключён из импорта и списка ТВ. Старый выбор этой группы при
обновлении заменяется доступным сервером. Мобильный клиент принимает LTE.
Обновление ТВ: раздел «Обновление» или Downloader, код 6300701.
