Skip to content
github-actions[bot] edited this page Nov 17, 2026 · 6 revisions

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، ومن هناك في عمليات التطبيقات. كل ما تفعله هو تقديم هوية جهاز مختارة للعمليات التي تستهدفها. لا يوجد تطبيق، وباستثناء جلب ملف التعريف الاختياري، لا توجد شبكة.

دورة الحياة

  1. بدء zygote. عندما يُقلع zygote، يستدعي المُحمِّل الدالة onLoad الخاصة بالوحدة. تقرأ /data/adb/COPG-VD/COPG-VD.json مرة واحدة: إعداد النطاق وملف التعريف.
  2. تفريع (fork) التطبيق. لكل تطبيق يفرّعه zygote، تقرّر الوحدة في preAppSpecialize ما إذا كانت هذه العملية ضمن النطاق:
    • في النطاق الرئيسي (playstore / global / whitelist / blacklist)، أو
    • في نطاق DRM (مدرَجة في drm_targets). إذا لم تكن في أيٍّ منهما، تفصل الوحدة نفسها عن تلك العملية (dlclose) ولا تترك فيها أي أثر.
  3. Specialize. بالنسبة لعملية تبقى، تُطبَّق المحركات في postAppSpecialize، بينما لا تزال العملية ذات امتيازات.

ولأن التفريعات ترث نسخة ذاكرة zygote بآلية copy-on-write، يبدأ كل تطبيق من الإعداد المقروء عند الإقلاع. تعيد الوحدة قراءة الملف لكل عملية مستهدفة فقط عندما يكون قد تغيّر فعلاً، بحيث يلتقط تطبيق بدأ حديثاً أو أُعيد فتحه ملف تعريف محرَّراً: لكن قرار النطاق نفسه يُتخذ عند بدء 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 لكل عملية)؛ وتبقى مجموعات الإقلاع والقفل و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 للحقول.

لماذا لا يُنتحَل إصدار Android افتراضياً

رفع SDK_INT / ANDROID_VERSION فوق ما هو عليه الـ framework في الـ ROM فعلياً يجعل التطبيقات تستدعي واجهات برمجية (APIs) غير موجودة، مما يعطّل تطبيقات Google ويعيد تشغيل الهاتف في softloop. لذلك تكون مجموعة الإصدار معطّلة افتراضياً ومحمية خلف spoof_version. تقرأ الوحدة الإصدار الحقيقي من /system/build.prop، لا من getprop أبداً، لأن getprop هو تحديداً ما تزوّره. راجع الفخّ في USER-GUIDE.md.


تم إنشاء هذا التوثيق باستخدام Claude (Anthropic) ويتولى صيانته VD171. التصحيحات والتحسينات مرحّب بها؛ راجع CONTRIBUTING.md.

Clone this wiki locally