Repository navigation
uk USER GUIDE
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 переписує fingerprint і build пристрою, щоб вибрані вами застосунки бачили Pixel замість вашого справжнього пристрою. Цей посібник проведе вас від встановлення до робочого налаштування й через вибори, які трапляються по дорозі. Про кожне поле та значення див. CONFIGURATION.md; про те, як це працює всередині, див. ARCHITECTURE.md.
- Прошийте zip у KernelSU, APatch або Magisk і перезавантажте.
- Zygisk має бути активним (вбудований, або ReZygisk / Zygisk Next). Користувачам Magisk: увімкніть Zygisk.
- Модуль постачається з профілем Pixel, тож одразу після перезавантаження стек Google Play вже бачить цей Pixel. З робочим fingerprint вам не потрібні PlayIntegrityFix чи GooglePhotosUnlimited.
Відкрийте WebUI зі свого root-менеджера, щоб керувати модулем. Користувачі Magisk відкривають його за допомогою
KsuWebUIStandalone або WebUI-X Portable або KsuWebUI-SN. Усе
також можна редагувати безпосередньо у /data/adb/COPG-VD/COPG-VD.json.
scope_mode визначає, які процеси отримують підмінену ідентичність. У режимі з областю
ідентичність доставляється по процесах через Zygisk і не просочується до решти
системи через глобальні властивості.
| Режим | Хто отримує підміну |
|---|---|
playstore (за замовчуванням) |
Лише стек Play: сервіси Google Play, їхній нестабільний процес і Play Store. |
global |
Весь пристрій: кожен процес. |
whitelist |
Лише застосунки, перелічені у scope_whitelist. |
blacklist |
Кожен застосунок, крім тих, що у scope_blacklist. |
Почніть з playstore. Це найлегший варіант і той, що проходить Play Integrity,
не розкриваючи підміну стороннім застосункам.
Кожен рушій незалежний і його можна вимкнути. Усі ввімкнені за замовчуванням, окрім DRM.
-
Поля Build (
motor_jni): переписуєandroid.os.Build.*у цільових процесах. Це те, що читає більшість застосунків. -
Хук властивостей (
motor_prop_hook): подає підмінені системні властивості цільовим процесам через чистий попроцесний ремап області властивостей (без хука функцій). -
resetprop: переписує системні властивості для всього пристрою, за групами (ідентичність,
версія, стан завантаження, SELinux, adb/usb, анти-емулятор і прохід очищення). У режимі з
областю групи ідентичності та версії не потрапляють до загальнопристроєвого проходу (Zygisk доставляє
їх по процесах); групи завантаження, блокування та SELinux залишаються глобальними. Перемикається у
COPG-VD-Settings.resetprop. -
DRM / Widevine (
motor_drm, вимкнено за замовчуванням): повідомляє вибраний рівень безпеки Widevine (L1 або L3) застосункам, що його читають. Див. розділ DRM нижче.
Fingerprint старіє: Google ротує заводські образи, і старий поволі втрачає цінність.
fingerprint-update.sh підтримує ваш актуальним, з найновішого заводського образу Google.
- З WebUI (вкладка Інструменти): Перевірити оновлення і Оновити зараз.
- Самостійно, раз на завантаження: Автооновлення JSON під час завантаження (ввімкнено за замовчуванням). Воно працює у фоні, продовжує спроби близько десяти хвилин, бо wifi зазвичай ще не піднятий під час завантаження, і ніколи не затримує завантаження.
- Воно переписує лише поля build (fingerprint, ID, incremental, timestamp, патч
безпеки, SDK, UUID, host, user). Усе, що ви налаштували, зберігається, а попередній
вміст зберігається як
.bak. - Воно ніколи не йде назад (старіша upstream-збірка відхиляється), і якщо ваш профіль підмінює інший пристрій, воно нічого не застосовує: fingerprint Pixel на іншому профілі гірший за старий.
-
resetpropзастосовується повторно одразу після оновлення, алеandroid.os.Buildзаписується під час старту zygote, тож перезавантажте, щоб нові значення дійшли до застосунків. Журнал:/data/adb/COPG-VD/update.log.
Найскладніше зробити правильно. ANDROID_VERSION, SDK_INT, SDK_FULL і CODENAME
описують вашу ROM, а не пристрій, який ви підмінюєте. Повідомляючи застосункам, що SDK новіший за
фреймворк, який насправді є, змушуєте їх викликати API, яких не існує: застосунки Google падають, телефон
перезавантажується, і все починається спочатку. Саме завантаження завершується, тож це softloop, що
не залишає нічого в журналах завантаження.
Цих полів немає в постаченій конфігурації, і оновлювач ніколи їх не записує. Підміняти
версію Android (COPG-VD-Settings.spoof_version) вирішує, чи застосовуються вони взагалі:
-
never(за замовчуванням): використовується власна версія ROM. -
rom: застосовує лише те, що не перевищує ROM, що на практиці означає зниження SDK. -
force: застосовує точно те, що каже конфігурація. Саме це спричиняє softloop; використовуйте його лише якщо знаєте, що цільовий фреймворк це підтримує.
Справжня версія читається з /system/build.prop, ніколи з getprop (що є
саме тим, що цей модуль фальсифікує). force також відхиляється під час відновлення резервної копії, тож
стара резервна копія не може повторно його активувати за вашою спиною.
Вимкнено за замовчуванням (motor_drm). Коли ввімкнено, воно повідомляє вибраний рівень Widevine,
DRM_SECURITY_LEVEL (L1 або L3), застосункам, що його читають.
За замовчуванням підміна DRM слідує за scope_mode. Щоб застосувати її до конкретного набору застосунків
натомість, незалежно від основної області, перелічіть їх у drm_targets. Тоді модуль
залишається завантаженим у переліченому застосунку лише заради хука DRM, навіть коли цей застосунок поза
основною областю; порожній чи відсутній список означає слідувати області. Це потребує режиму з областю (не
global) і набуває чинності після наступного перезавантаження.
Аналіз у WebUI (або fingerprint-update.sh analyze) перевіряє конфігурацію як вона
є, і каже вам, що не так, перш ніж це зробить застосунок:
- версію проти ROM (чи буде softloop?),
- чи файл досі парситься (зламаний змушує модуль не підміняти нічого, і лише logcat про це скаже),
- чи узгоджується fingerprint з полями навколо нього,
- ключі, які модуль не читає, підозрілі дати, і чи живі властивості вже несуть те, що просить конфігурація.
Запускайте його щоразу, коли редагуєте конфігурацію вручну.
Необов'язковий, але простий спосіб керувати всім. П'ять вкладок:
- Про модуль: інформація про модуль і версію.
- Пристрій: кожне поле build, задане за станом і згруповане за категоріями.
- Spoofing: режим області та перемикачі рушіїв.
- Система: групи resetprop.
- Інструменти: Аналіз, Перевірити оновлення, Оновити зараз, Резервна копія / Відновлення, автооновлення при завантаженні, і звіт Діагностики (одна кнопка, щоб прочитати й експортувати все корисне для звіту про помилку).
Він не виконує жодних мережевих запитів; усе, що йому потрібно, постачається всередині модуля.
-
Застосунок досі бачить справжній пристрій. Перевірте область: у
playstoreпокривається лише стек Play. Переконайтеся, що конфігурація парситься (запустіть Аналіз). Після зміни рушіїв,drm_targetsчи профілю перезавантажте: Zygisk читає область під час старту zygote. -
Play Integrity досі не проходить. Переконайтеся, що fingerprint свіжий (Перевірити оновлення) і
що
SECURITY_PATCHє уglobal_fields, щоб він залишався узгодженим для всього пристрою. Завершіть сервіси Google Play, щоб вони пройшли повторну атестацію. -
Телефон softloop'иться після увімкнення підміни версії. Це пастка версії Android
вище: поверніть
spoof_versionнаnever. - WebUI не відкривається на Magisk. Використайте KsuWebUIStandalone або WebUI-X Portable або KsuWebUI-SN.
Ця документація створена за допомогою Claude (Anthropic) і підтримується VD171. Виправлення та покращення вітаються; див. CONTRIBUTING.md.