Сначала про рамку. Дальше — модуль Magisk, который выставляет отпечаток устройства, и верификатор, который доказывает, что модуль собран правильно. На телефоне он не запускался: у меня Windows, ни adb, ни Magisk, ни аппарата под рукой. Поэтому весь текст про контракт модуля и структуру zip, а не про то, как красиво он поднимается на живом Android.
Зачем вообще трогать отпечаток
После GSI, порта или сборки vendor с чужого аппарата build.prop превращается в лоскутное одеяло. Модель от донора, build id от рома, security patch невнятный, а ro.build.fingerprint собран из двух разных устройств — половину строк кто-то поправил, вторую забыл. Система работает. Ломается другое: такси говорит «устройство не поддерживается», маркет отдаёт версии под другой экран, банк смотрит на свойства и уходит в отказ.
Правится это тривиально — resetprop по списку. Сложность не в применении, а в том, что почти каждый самодельный «фикс отпечатка» ломается на трёх вещах: значения разъехались между файлом и скриптом, свойства применились рано и init их переписал, и самое весёлое — телефон ушёл в бутлуп, а вытащить его нечем.
Что именно правится
Один файл, одна копия значений. Скрипты читают из него — это отдельная проверка в верификаторе, потому что разъехавшиеся копии и есть самая частая причина, по которой «в прошлый раз работало».
# system.prop — единственное место, где лежат значения
ro.product.brand=google
ro.product.manufacturer=Google
ro.product.model=Pixel 5
ro.product.device=redfin
ro.product.name=redfin
ro.product.board=redfin
ro.boot.hardware=redfin
ro.build.id=RQ1A.201105.002
ro.build.version.release=11
ro.build.version.incremental=6825462
ro.build.type=user
ro.build.tags=release-keys
ro.build.description=redfin-user 11 RQ1A.201105.002 6825462 release-keys
ro.build.fingerprint=google/redfin/redfin:11/RQ1A.201105.002/6825462:user/release-keys
ro.build.version.security_patch=2020-11-05
ro.vendor.build.security_patch=2020-11-05
ro.system.build.fingerprint=google/redfin/redfin:11/RQ1A.201105.002/6825462:user/release-keys
ro.vendor.build.fingerprint=google/redfin/redfin:11/RQ1A.201105.002/6825462:user/release-keysВосемнадцать свойств. Половина из них — те, которые все забывают: ro.product.manufacturer, ro.product.board, ro.boot.hardware, ro.build.version.security_patch. Отпечаток в каноническом формате brand/product/device:release/build_id/incremental:type/tags. Сборка RQ1A.201105.002 и incremental 6825462 — публичный factory image Pixel 5 (redfin), Android 11, ноябрь 2020; это демонстрационный набор, а не «последняя прошивка», и для другого аппарата правится только этот файл.
Два прохода, а не один
system.prop Magisk применяет сам на стадии post-fs-data. Для половины устройств этого хватит. На второй половине часть ro.* перезаписывается init уже после того, как модуль отработал, и вы получаете телефон, у которого отпечаток «правильный», но не тот, что в файле.
Поэтому проходов два. post-fs-data.sh — до zygote, пока свойства никто не прочитал. service.sh — после того, как система дошла до sys.boot_completed=1, второй раз тем же набором, и потом чтение обратно.
i=0
while [ "$(getprop sys.boot_completed)" != "1" ]; do
i=$((i + 1))
if [ "$i" -ge "$WAIT_MAX" ]; then
log -t fpfix "service: boot_completed timeout after ${WAIT_MAX}s"
exit 0
fi
sleep 1
done
want=$(grep -m1 '^ro\.build\.fingerprint=' "$MODDIR/system.prop" | cut -d= -f2-)
"$MODDIR/bin/fpfix_apply.sh" "$MODDIR/system.prop" "$STATE/service.log" || true
got=$(getprop ro.build.fingerprint)
tries=0
while [ "$got" != "$want" ] && [ "$tries" -lt "$RETRIES" ]; do
tries=$((tries + 1))
sleep 5
"$MODDIR/bin/fpfix_apply.sh" "$MODDIR/system.prop" "$STATE/service.log" || true
got=$(getprop ro.build.fingerprint)
doneСмысл read-back простой: скрипт не верит, что resetprop сработал, — он идёт и смотрит. Не совпало — до трёх повторов с паузой, результат в /data/adb/fpfix/status, и этот файл можно просто cat-нуть вместо гадания.
И про сам вызов: везде resetprop -n, где -n — «не дёргать property triggers». Без флага смена ro.* триггерит init-действия, часть сервисов перезапускается по ходу загрузки. Из этого «перезапуска на полпути» и растут истории про телефон, уходящий в ребут на логотипе. Флаг — половина разницы между «работает» и «бутлуп».
Защита от бутлупа: счётчик, а не надежда
Скрипт, который может уронить загрузку, обязан уметь отключаться сам. Тут это счётчик в /data/adb/fpfix/boot_count: post-fs-data.sh инкрементит его на каждой загрузке, service.sh сбрасывает в 0 только после того, как система дошла до boot_completed и отпечаток совпал. Порог — три неудачных старта подряд. На четвёртом props не применяются вообще, и устройство обязано подняться без них.
Логика простая до неприличия, и именно поэтому работает: не дошло до boot_completed — счётчик не сбросился. Три раза не дошло — модуль выключается сам. Всё равно нужен выход руками: Magisk Safe Mode, зажать громкость вверх при загрузке, модуль отключается на один старт. Об этом почему-то пишут мелким шрифтом в конце, хотя это первое, что нужно знать до, а не после.
Теперь то, ради чего это всё писалось
Модуль без проверки — это набор файлов, про который автор говорит «должно работать». У меня нет телефона, значит единственный способ не врать — проверить то, что проверяется: контракт модуля и структуру zip.
Верификатор — tools/verify.py, проверки — чистые функции в tools/checks.py, каждая возвращает имя, PASS/FAIL и причину. По дереву модуля их 22, все PASS: файлы и относительные пути, разбор module.prop, формат id и versionCode, разбор system.prop, дубликаты ключей, формат отпечатка, сходимость его полей с ro.product.* и description, патч безопасности, shebang, CRLF, set -e, executable-бит, шаблон update-binary, хуки customize.sh, уборка в uninstall, единственный источник значения, синтаксис.
$ python cli.py verify module/
PASS layout.required_files 9 обязательных файлов на месте
PASS module_prop.parse 6 ключей разобрано, дубликатов нет
PASS system_prop.parse 18 пар, все 11 обязательных есть
PASS system_prop.fingerprint_format google/redfin/redfin:11/RQ1A.201105.002/6825462:user/release-keys
PASS system_prop.cross_fields 8 полей + description сходятся с отпечатком
PASS scripts.crlf 8 текстовых файлов, ни одного CR
PASS scripts.syntax sh -n прошёл по 6 файлам (sh.exe)
итого 22 проверок: 22 PASS, 0 FAIL (sh -n: C:\Program Files\Git\usr\bin\sh.exe)Про sh -n отдельно: это единственная проверка, которая не моя выдумка, а настоящий парсер — нашёлся POSIX sh из Git for Windows, им и парсится каждый скрипт. Если sh не найден, верификатор не делает вид, что синтаксис проверен: пишет, что работал встроенный лексер (кавычки и пары if/fi, case/esac, do/done). Лексер ловит забытый fi и незакрытую кавычку, но не всё остальное.
Архив проверяется двадцатью пятью: те же 22 по распакованному дереву плюс три своих — имена записей (относительные пути, прямые слэши, без __MACOSX и .DS_Store), mode 0755 у скриптов и CRC. Девять файлов, 8106 байт zip против 14656 байт исходников.
$ python cli.py pack module/ _run/fp.zip
записей: 9 сырых байт: 14656 zip: 8106 байт
сжатие: 55.3% от исходного
$ python cli.py verify _run/fp.zip
PASS zip.entries 9 записей, пути относительные
PASS zip.modes 6 скриптов с mode 0755, всего 9 записей
PASS zip.integrity CRC ок, файлов 9, нулевой размер: нет
итого 25 проверок: 25 PASS, 0 FAILСборщик отказывается собирать мусор: CRLF в скрипте, скрипт без shebang, пустой файл, дубликат ключа — отказ с причиной, а не zip, который «ну вроде поставится». Архив детерминированный: фиксированное время записей, сортировка, никакой зависимости от порядка обхода файловой системы; два прогона дают побайтово одинаковый файл, на это есть тест.
Как я убедился, что это не штамп
Верификатор, который всегда говорит PASS, бесполезен, и отличить его от настоящего по одному зелёному прогону нельзя. Поэтому в прогоне отдельный шаг: копия модуля портится четырьмя способами — удалён uninstall.sh, post-fs-data.sh переведён в CRLF, в system.prop добавлен второй ro.build.tags, в service.sh открыт if без fi. Прогон по копии даёт шесть FAIL с конкретными причинами.
FAIL layout.required_files нет: uninstall.sh
FAIL system_prop.duplicate_keys повторяются: ro.build.tags
FAIL scripts.crlf post-fs-data.sh: CR в строках [1, 2, 3]
FAIL scripts.set_e uninstall.sh: файла нет
FAIL uninstall.cleanup uninstall.sh отсутствует
FAIL scripts.syntax service.sh: line 52: syntax error: unexpected end of file
итого 22 проверок: 16 PASS, 6 FAILШесть, а не четыре: диагностика честно каскадится — удалённый файл валит и set -e, и уборку в uninstall. Это три разных утверждения про один отсутствующий файл. Лучше так, чем один FAIL «модуль сломан».
И тот же битый модуль на сборке:
$ python cli.py pack _run/broken/module _run/broken.zip
PACK ОТКАЗ: нет uninstall.sh; post-fs-data.sh: CRLF в строках [1, 2, 3] — скрипт упадёт с 'not found'; system.prop: дубликаты ro.build.tagsАрхив не создан. Вот это уже похоже на проверку, а не на ритуал.
Тестов 59, и они не только про «зелёное на хорошем модуле»: 20 из них — намеренно испорченные копии, по одному-два на каждый вид поломки, плюс проверка, что одна поломка не валит половину проверок, плюс детерминизм отчёта и побайтовое равенство двух сборок zip.
Чего это не делает
Главное, что нужно сказать прямо: подмена отпечатка сама по себе не проходит Play Integrity. Ни MEETS_DEVICE_INTEGRITY, ни тем более MEETS_STRONG_INTEGRITY: вердикт зависит от состояния загрузчика, verified boot и наличия root, а STRONG требует железячного ключа, которого у разлоченного устройства нет. Модуль чинит то, что приложения читают из build.prop — регион, модель, доступность фич. Аттестацию он не лечит и не пытается.
Дальше по списку, без порядка важности. Модуль не устанавливался: ни разу, ни на одном устройстве. Бутлуп не воспроизводился — guard проверен чтением кода и тестами на тексте, а не тремя ребутами. resetprop на живом property service не вызывался, read-back через getprop не выполнялся. Всё, что выше про два прохода и -n, — это как должно работать по устройству Android и по докам Magisk, а не отчёт с телефона.
Как поставить, если всё-таки ставите
Magisk → Modules → Install from storage → выбрать zip → перезагрузка. Проверка после загрузки: getprop ro.build.fingerprint и cat /data/adb/fpfix/status. Если там MISMATCH — в service.log построчно видно, что применилось и что resetprop отверг. Если телефон не поднялся: Safe Mode громкостью вверх при старте, модуль отключается.
Ставить это стоит не «чтобы прошёл банк», а когда конкретное приложение конкретно из-за модели или отпечатка отказывается работать. В остальных случаях вы меняете одну ложь в системе на другую, более аккуратную, и рискуете загрузкой ради этого.
Всё, что в тексте в виде чисел, — из transcript.txt этого же прогона: 59 тестов, 22 и 25 проверок, 9 файлов, 8106 байт, 6 скриптов через настоящий sh -n. Цифры не переписывались руками, это вывод прогона; при повторном запуске на этой машине они совпадут, кроме времени в pytest.