XiaoMiToolV2

XiaomiToolV2

هذا هو الكود المصدري لأداة تعديل Xiaomi XiaomiTool V2 (www.xiaomitool.com)

حالة المشروع

المشروع حاليًا شبه مهجور لعدة أسباب. إذا كنت تريد إصلاح الأخطاء أو القيام بأشياء، فما عليك سوى شوكة الريبو. بدأ هذا المشروع كمشروع على مستوى الطلاب: تم ​​استخدام العديد من الممارسات السيئة وتم اتخاذ خيارات سيئة، مما يجعل صيانة هذا المشروع مكلفة. على سبيل المثال:

1. استخدام Java (1.8) بدلاً من اللغات الأخرى الأقل تفصيلاً (مثل Kotlin وPython)
2. لا يوجد CI أو قرص مضغوط، حيث يعد إصدار نسخة لجميع أنظمة التشغيل أمرًا صعبًا، كما أنه من السهل إدخال الأخطاء.
3. لا توجد وثائق
4. لا يوجد اختبار
5. بنية سيئة (لا توجد وحدات منفصلة، ​​تبعيات دائرية، فئات غير مصممة بشكل جيد، ...)
6. يقتصر على أجهزة Xiaomi

حتى لو كان من الممكن إصلاح بعض هذه النقاط بسهولة إلى حد ما، فإن المشروع الأساسي لا يزال غير جيد بما يكفي لجعله ذا قيمة بالنسبة لي. إن التغيير المطلوب جذري للغاية لدرجة أنه سيكون مكلفًا تقريبًا مثل إعادة كتابة الأمر برمته من الصفر.

البناء والتشغيل

يستخدم هذا المشروع gradle، لذلك يمكنك فقط استنساخ الريبو واستخدامه:

gradlew build gradlew run

سيؤدي البناء إلى إنشاء ملف jar فقط، وهو ما لا يكفي لتشغيل XiaoMiTool: ستحتاج أيضًا إلى تجميعه مع الموارد المطلوبة (دليل res في الريبو). تأكد من تحديد فرع المستودع المتوافق مع نظام التشغيل الأساسي المستهدف لديك (Windows وMac وLinux)، نظرًا لاختلاف ملفات الموارد.

التجميع والتوزيع

يجب أن يحتوي الدليل النسبي res/tools على الأدوات المناسبة ( adb و fastboot لكل نظام أساسي وكذلك الملفات ذات الصلة ببرنامج التشغيل لنظام التشغيل Windows) لنظام التشغيل المستهدف. يمكنك الحصول على الأدوات من الفروع المختلفة لهذا المستودع (Windows، Linux، Mac). برجاء الأخذ في الاعتبار أن adb و fastboot ليسا النوعين العامين اللذين يمكنك تنزيلهما من الإنترنت، ولكنهما مخصصان تم تجميعهما خصيصًا لـ MIUI. إذا لم تستخدم تلك الموجودة في هذا الريبو، فسوف تفقد إمكانية فتح أداة تحميل التشغيل ووميض ذاكرة MIUI rom عبر استرداد المخزون.

بالنسبة إلى Windows repo، يُنصح أيضًا بالاحتفاظ بدليل res/driver لأنه يحتوي على برنامج التشغيل الذي سيقوم XiaoMiTool بتثبيته على Windows ليتمكن من الاتصال بالأجهزة. يُنصح أيضًا ببدء تشغيل البرنامج بامتيازات إدارية (يمكنك استخدام Launch4j Launcher للقيام بذلك) لتتمكن من تثبيت برامج التشغيل.

إصدار Java المستخدم لتكوين Gradle هذا هو Java 11، ومع ذلك فإن كود المصدر متوافق مع Java 1.8، مما يجعل من الممكن تجميع إصدار لـ 32 بت jre 1.8.

يستخدم XiaoMiTool V2 JavaFX لواجهة المستخدم الرسومية، لذلك إذا كنت تريد إنشاء حزمة، فيجب عليك إنشاء صورة JRE باستخدام وحدة JavaFX. يمكنك الحصول على مزيد من التفاصيل حول كيفية القيام بذلك على دليل JavaFX الرسمي. إذا قمت بتجميع المشروع لـ JRE 1.8، فسيتم تضمين JavaFX بالفعل في JRE القياسي.

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

مشاكل

كما هو مذكور في قسم State of the project ، فإن هذا المشروع شبه مهجور. لا تقضي الكثير من الوقت معهم، فقد يتم تجاهلهم.