Repository navigation
ru ARCHITECTURE
Languages: English | العربية | Čeština | Deutsch | Español | فارسی | Français | हिन्दी | Bahasa Indonesia | Italiano | 日本語 | 한국어 | Nederlands | Polski | Português | Русский | Svenska | ไทย | Türkçe | Українська | Tiếng Việt | 中文
COPG-VD является модулем Zygisk: небольшая нативная библиотека (libspoof.so), которую загрузчик Zygisk
внедряет в zygote, а оттуда в процессы приложений. Всё, что она делает, предоставляет
выбранную идентичность устройства процессам, которые вы нацеливаете. Приложения нет, и, помимо
опциональной загрузки профиля, сети нет.
-
Старт zygote. Когда zygote загружается, загрузчик вызывает
onLoadмодуля. Он читает/data/adb/COPG-VD/COPG-VD.jsonодин раз: конфигурацию области действия и профиль. -
Fork приложения. Для каждого приложения, которое zygote форкает, модуль решает в
preAppSpecialize, попадает ли этот процесс в область действия:-
в основной области действия (
playstore/global/whitelist/blacklist), или -
в области действия DRM (перечислен в
drm_targets). Если ни то, ни другое, модуль отсоединяется от этого процесса (dlclose) и не оставляет в нём следа.
-
в основной области действия (
-
Specialize. Для процесса, который остаётся, движки применяются в
postAppSpecialize, пока процесс всё ещё привилегирован.
Поскольку форки наследуют copy-on-write копию памяти zygote, каждое приложение стартует из конфигурации,
прочитанной при загрузке. Модуль перечитывает файл для каждого целевого процесса, только когда он действительно
изменился, так что только что запущенное или заново открытое приложение подхватывает отредактированный профиль, но само
решение об области действия принимается при старте zygote, поэтому смена области действия, движков или
drm_targets требует перезагрузки.
Каждый независим и переключаем.
-
Поля Build (
motor_jni). Переписываетandroid.os.Build.*(иBuild.VERSION.*) в целевом процессе через JNI, так что Java-код читает подменённые значения. -
Хук свойств (
motor_prop_hook). Предоставляет подменённые системные свойства процессу через чистое (clean-room), для каждого процесса переотображение области свойств (prop_virtualizer). Это переотображение памяти, а не хук функции, поэтому нет следа захуканной функции. - resetprop (на уровне всего устройства). Записывает системные свойства по группам: идентичность, версия, состояние загрузки, SELinux, adb/usb, анти-эмулятор, плюс проход очистки. Их запускают загрузочные скрипты. В режиме с областью действия группы идентичности и версии оставляются в стороне (Zygisk доставляет их для каждого процесса); группы boot, lock и SELinux остаются глобальными, чтобы устройство было согласованным.
-
DRM / Widevine (
motor_drm). Хукает методыMediaDrm, которые сообщают уровень безопасности Widevine (getSecurityLevel,getPropertyString), и возвращает настроенный уровень. Хуки проверяются на null, поэтому некорректный профиль деградирует плавно, а не обрушивает приложение.drm_targetsпозволяет этому движку работать по собственному списку приложений, отвязанному от основной области действия.
Внедрённый процесс работает в SELinux-домене zygote, который по умолчанию не может достичь
/data/adb. Модуль поставляет собственный sepolicy.rule, чтобы это разрешить, и, в качестве запасного варианта,
может читать конфигурацию через свой открытый каталог модуля (getModuleDir), так что он продолжает
работать, даже если какая-то сборка Zygisk перестанет предоставлять этот путь. Файл парсится небольшим
встроенным JSON-парсером (jsmn); файл, который не парсится, означает, что модуль не подменяет ничего.
fingerprint-update.sh обновляет поля build из новейшего заводского образа Google,
из WebUI или один раз за загрузку. Он использует собственный встроенный загрузчик модуля (а не curl/wget
из PATH), проверяет каждое значение перед использованием, никогда не откатывается назад и отклоняет
профиль, который подменяет другое устройство. android.os.Build записывается при старте zygote, поэтому
новые значения доходят до приложений при следующей перезагрузке. Смотрите USER-GUIDE.md для пользовательской
стороны и CONFIGURATION.md для полей.
Повышение SDK_INT / ANDROID_VERSION выше того, чем фреймворк ROM является на самом деле, заставляет приложения
вызывать API, которых не существует, что обрушивает приложения Google и перезагружает телефон в
softloop. Поэтому группа версии по умолчанию выключена и защищена за
spoof_version. Модуль читает настоящую версию из /system/build.prop, никогда из
getprop, потому что getprop и есть именно то, что он фальсифицирует. Смотрите ловушку в
USER-GUIDE.md.
Эта документация создана с помощью Claude (Anthropic) и поддерживается VD171. Исправления и улучшения приветствуются; см. CONTRIBUTING.md.