منشئ خصائص Pixel: تحويل مبسط من OTA إلى build.prop

استخرج وأدر خصائص النظام بسهولة من تحديثات OTA لأجهزة Pixel باستخدام هذه المجموعة الآلية القوية. مصممة للمطورين والمتحمسين على حد سواء، فهي تبسط عملية الوصول إلى خصائص بناء Android وتخصيصها.

🚀 بداية سريعة

المتطلبات الأساسية

• بيئة شبيهة بـ Unix: Linux أو macOS مع Bash.

• الأدوات الأساسية: تأكد من تثبيت ما يلي:

  • dos2unix, aria2, zip, unzip, p7zip, curl

• Python ^3.8:

  root@kitploit:~

  sudo apt-get update -y
  sudo apt-get install python3 python3-pip python3-venv -y
  

التثبيت

1. استنساخ المستودع (بما في ذلك الوحدات الفرعية):

   root@kitploit:~

   git clone --recurse https://github.com/Pixel-Props/build.prop && cd build.prop
   

2. إنشاء وتفعيل بيئة افتراضية (اختياري لكن موصى به):

   root@kitploit:~

   python3 -m venv .venv
   . .venv/bin/activate
   

3. تثبيت التبعيات:

   root@kitploit:~

   python3 -m pip install payload_dumper --break-system-packages
   

الاستخدام

1. الحصول على صور Pixel: قم بتنزيل صور المصنع أو OTA المطلوبة من صور Android من Google أو صفحات OTA التجريبية.
2. البقاء على اطلاع:
   • احصل على أحدث صور OTA باستخدام ./download_latest_ota_build.sh <device_name1> <device_name2> ... (مثل: husky, felix_beta, cheetah, akita_beta15).
3. استخراج سلس:
   • ضع ملفات الصور التي تم تنزيلها داخل مساحة عمل المشروع.
   • نفذ ./extract_images.sh لاستخراج الصور وخصائص بنائها تلقائيًا إلى result/Codename_ID ....
4. دمج الوحدات بسهولة:
   • نفذ ./build_module.sh لدمج وبناء الوحدة الخاصة بك تلقائيًا من دليل result/.

✨ الميزات الرئيسية

• الحصول الآلي على OTA: يقوم بتنزيل أحدث الإصدارات مباشرة من مصادر Google الرسمية.
• استخراج صور سلس: يستخرج صور النظام من كل من صور المصنع وتحديثات OTA.
• توليد خصائص البناء: يقوم تلقائيًا بإنشاء ملفات build.prop من صور النظام المستخرجة.
• ميزات وحدة Magisk:
  • service.sh:
    • الوضع الآمن: يمنع التعديل العرضي للإعدادات الحرجة للنظام من خلال مقارنة خصائص الوحدة مع قيم النظام الحالية.
    • ميزات تعديل Sensitive Props المدمجة: يدمج جميع ميزات تعديل Sensitive Props ويعطلها إذا كانت الوحدة المستقلة موجودة أيضًا، لتجنب التعارضات.
    • PIHooks (PropImitationHooks): نظام محاكاة خصائص داخلي قوي يقوم بتعيين الخصائص الأساسية ديناميكيًا بناءً على خصائص الوحدة المعرفة في MOD_PROP_CONTENT التي يتم محاكاتها.
      • تعطيل PIHooks التلقائي: يقوم PIHooks بتعطيل نفسه بذكاء عند اكتشاف وحدة Play Integrity Fix مهيأة بشكل صحيح.
      • دمج انتقائي لـ build.prop: يستخدم PIHooks القيم من ملف build.prop الفعلي لجهازك فقط عند تعيين خصائص محددة، مثل إصدار SDK الأولي، عندما تعتبر تلك القيم آمنة وضرورية.
  • action.sh:
    • PlayIntegrityFix: يقوم تلقائيًا ببناء ملف PIF.json عند استخدام OTA تجريبي. يوفر خيارات لتنزيل تهيئات مبنية مسبقًا أو الزحف إلى صفحات OTA من Google لتوليد قائمة بالأجهزة لبناء التهيئة.
    • TrickyStore: يقوم تلقائيًا ببناء قائمة حزم التطبيقات المستهدفة والتعامل مع حالة TEE المعطلة.
• دمج إجراءات GitHub:
  • سير العمل المجدولة: أتمتة التحديثات والبناء والإصدارات وفقًا لجدول زمني.
  • منع الإصدارات المكررة: يمنع الإصدارات المكررة من خلال فحوصات ذكية.
  • إشعارات Telegram: تلقي تحديثات في الوقت المناسب حول عمليات البناء.
• التحسينات المستقبلية:
  • Pixel.Features: إضافة دعم لبناء ميزات خاصة بـ Pixel (تتضمن حاليًا sysconfigs).

📝 إرشادات الاستخدام المسؤول

هذا المشروع مقدّم للأغراض التعليمية والتجريبية. على الرغم من تصميمه لتحقيق الكفاءة، إلا أنه من الضروري استخدام هذه الأداة بمسؤولية.

• مراجعة الكود: قم بمراجعة وفهم الكود جيدًا قبل نشره في أي بيئة.
• أفضل ممارسات الأمان: الالتزام بمعايير الصناعة للأمان والامتثال القانوني.

منشئو هذا المشروع غير مسؤولين عن أي سوء استخدام أو أضرار ناتجة عن استخدامه.

---

هل أنت مستعد لتبسيط سير عمل تخصيص Android؟ ابدأ الآن وأطلق العنان لقوة استخراج build.prop الآلي! المساهمات مرحب بها لتعزيز وظائف المشروع ونطاقه.