Repository navigation
ar 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 بالفعل. مع بصمة تعمل بشكل صحيح لن تحتاج إلى 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 services وعمليته غير المستقرة ومتجر Play. |
global |
الجهاز بأكمله: كل عملية. |
whitelist |
التطبيقات المدرجة في scope_whitelist فقط. |
blacklist |
كل تطبيق باستثناء تلك الموجودة في scope_blacklist. |
ابدأ بـ playstore. إنه الخيار الأخف والذي يجتاز Play Integrity
دون كشف الانتحال لتطبيقات غير ذات صلة.
كل محرك مستقل ويمكن إيقاف تشغيله. جميعها مفعّلة افتراضياً باستثناء DRM.
-
حقول Build (
motor_jni): يعيد كتابةandroid.os.Build.*في العمليات المستهدفة. هذا ما تقرأه معظم التطبيقات. -
خطّاف الخصائص (
motor_prop_hook): يقدّم خصائص النظام المنتحَلة إلى العمليات المستهدفة، عبر إعادة تخطيط نظيفة (clean-room) لمنطقة الخصائص لكل عملية على حدة (بدون خطّاف دالة). -
resetprop: يعيد كتابة خصائص النظام على مستوى الجهاز بأكمله، حسب المجموعة (الهوية،
الإصدار، حالة الإقلاع، SELinux، adb/usb، مكافحة المحاكي، وتمريرة تنظيف). في وضع ذي نطاق
تبقى مجموعتا الهوية والإصدار خارج التمريرة على مستوى الجهاز (يسلّمها Zygisk لكل عملية)؛
وتبقى مجموعات الإقلاع والقفل وSELinux عامة. بدّله في
COPG-VD-Settings.resetprop. -
DRM / Widevine (
motor_drm، معطّل افتراضياً): يبلّغ عن مستوى أمان Widevine مختار (L1 أو L3) للتطبيقات التي تقرأه. راجع قسم DRM أدناه.
تتقادم البصمة: تُدوّر Google صور المصنع، وتفقد البصمة القديمة قيمتها ببطء.
يُبقي fingerprint-update.sh بصمتك حديثة، من أحدث صورة مصنع من Google.
- من الـ WebUI (تبويب Tools): Check Update وUpdate Now.
- بمفرده، مرة واحدة لكل إقلاع: Auto-update JSON on boot (مفعّل افتراضياً). يعمل في الخلفية، ويستمر في إعادة المحاولة لحوالي عشر دقائق لأن الواي-فاي عادةً لا يكون جاهزاً بعد عند الإقلاع، ولا يؤخّر الإقلاع أبداً.
- يعيد كتابة حقول الـ build فقط (fingerprint، ID، incremental، timestamp، security
patch، SDK، UUID، host، user). يُحتفظ بكل ما خصّصته، ويُحفظ المحتوى
السابق كـ
.bak. - لا يتراجع أبداً (يُرفض أي build أقدم من الـ upstream)، وإذا كان ملفك الشخصي ينتحل جهازاً مختلفاً فإنه لا يطبّق شيئاً: بصمة Pixel على ملف تعريف آخر أسوأ من بصمة قديمة.
- تُعاد تطبيق
resetpropمباشرة بعد التحديث، لكنandroid.os.Buildيُكتب عند بدء zygote، لذا أعد التشغيل كي تصل القيم الجديدة إلى التطبيقات. السجل:/data/adb/COPG-VD/update.log.
أصعب شيء لضبطه بشكل صحيح. تصف ANDROID_VERSION وSDK_INT وSDK_FULL وCODENAME
نظام الـ ROM لديك، لا الجهاز الذي تنتحله. إخبار التطبيقات بأن الـ SDK أحدث مما هو عليه
الـ framework فعلياً يجعلها تستدعي واجهات برمجية (APIs) غير موجودة: تتعطل تطبيقات Google، ويعيد الهاتف
التشغيل، ثم يبدأ من جديد. يكتمل الإقلاع نفسه، لذا فهي حلقة soft (softloop)
لا تترك أي شيء في سجلات الإقلاع.
هذه الحقول ليست في الإعداد المرفق ولا يكتبها المحدِّث أبداً. يقرّر Spoof
Android version (COPG-VD-Settings.spoof_version) ما إذا كانت ستُطبَّق أصلاً:
-
never(الافتراضي): يُستخدم إصدار الـ ROM الخاص به. -
rom: يطبّق فقط ما لا يتجاوز الـ ROM، وهو ما يعني عملياً خفض الـ SDK. -
force: يطبّق بالضبط ما يقوله الإعداد. هذا ما يسبب الـ softloop؛ استخدمه فقط إذا كنت تعرف أن الـ framework المستهدف يدعمه.
يُقرأ الإصدار الحقيقي من /system/build.prop، لا من getprop أبداً (وهو تحديداً ما
تزوّره هذه الوحدة). كما يُرفض force عند استعادة نسخة احتياطية، بحيث لا تستطيع نسخة
احتياطية قديمة إعادة تفعيله من وراء ظهرك.
معطّل افتراضياً (motor_drm). عند تفعيله، يبلّغ عن مستوى Widevine مختار،
DRM_SECURITY_LEVEL (L1 أو L3)، للتطبيقات التي تقرأه.
افتراضياً يتبع انتحال DRM قيمة scope_mode. لتطبيقه بدلاً من ذلك على مجموعة محددة من
التطبيقات, بشكل مستقل عن النطاق الرئيسي, أدرجها في drm_targets. تبقى الوحدة عندئذٍ
محمَّلة في تطبيق مدرَج فقط من أجل خطّاف DRM، حتى عندما يكون ذلك التطبيق خارج النطاق
الرئيسي؛ وتعني القائمة الفارغة أو الغائبة اتّباع النطاق. يتطلب هذا وضعاً ذا نطاق (لا
global)، ويسري مفعوله عند إعادة التشغيل التالية.
يدقّق Analyze في الـ WebUI (أو fingerprint-update.sh analyze) الإعداد كما هو
ويخبرك بما هو خاطئ قبل أن يفعل ذلك أي تطبيق:
- الإصدار مقابل الـ ROM (هل سيسبّب softloop؟)،
- ما إذا كان الملف لا يزال يُحلَّل (الملف المعطوب يجعل الوحدة تنتحل لا شيء، ووحده logcat سيقول ذلك)،
- ما إذا كانت البصمة متوافقة مع الحقول المحيطة بها،
- المفاتيح التي لا تقرأها الوحدة، والتواريخ المشبوهة، وما إذا كانت الخصائص الحيّة تحمل بالفعل ما يطلبه الإعداد.
شغّله كلما حررت الإعداد يدوياً.
اختياري، لكنه الطريقة السهلة للتحكم في كل شيء. خمسة تبويبات:
- About: معلومات الوحدة والإصدار.
- Device: كل حقل build، مضبوط حسب الحالة ومجمَّع حسب الفئة.
- Spoofing: وضع النطاق ومفاتيح المحركات.
- System: مجموعات resetprop.
- Tools: Analyze وCheck Update وUpdate Now وBackup / Restore، والتحديث التلقائي عند الإقلاع، وتقرير Diagnostics (زر واحد لقراءة وتصدير كل ما هو مفيد لتقرير خطأ).
لا يُجري أي طلب شبكي؛ كل ما يحتاجه مرفق داخل الوحدة.
-
لا يزال تطبيق يرى الجهاز الحقيقي. افحص النطاق: في
playstoreيُغطّى مكدس Play فقط. تأكد من أن الإعداد يُحلَّل (شغّل Analyze). بعد تغيير المحركات أوdrm_targetsأو ملف التعريف، أعد التشغيل: يقرأ Zygisk النطاق عند بدء zygote. -
لا يزال Play Integrity يفشل. تأكد من أن البصمة حديثة (Check Update) وأن
SECURITY_PATCHموجود فيglobal_fieldsكي يبقى متسقاً على مستوى الجهاز بأكمله. أوقف Google Play services كي يعيد الإثبات (attest). -
يدخل الهاتف في softloop بعد تفعيل انتحال الإصدار. هذا هو فخّ إصدار Android
أعلاه: أعد ضبط
spoof_versionإلىnever. - لا يفتح الـ WebUI على Magisk. استخدم KsuWebUIStandalone أو WebUI-X Portable أو KsuWebUI-SN.
تم إنشاء هذا التوثيق باستخدام Claude (Anthropic) ويتولى صيانته VD171. التصحيحات والتحسينات مرحّب بها؛ راجع CONTRIBUTING.md.