انتقل إلى المحتوى

لمطوري البرامج الثابتة

أضف البرامج الثابتة الخاصة بك إلى Updater CE.

Updater CE هو كتالوج المجتمع ومثبت البرامج الثابتة المخصصة. قم بتطوير مشروعك من القاعدة ROM، وانشره كمستودع عام بأصول الإصدار الصحيحة، وأضف إدخالات النموذج إلى slidia_manifest.xmlواختبر مرشحات النموذج وافتح طلب سحب. يمكن لمستودع واحد أن يخدم كل نموذج يدعمه.

البدء من القاعدة ROM

توفر ذاكرة القراءة فقط (ROM) الأساسية لمطوري البرامج الثابتة المخصصة أساسًا نظيفًا لنظام Android مع تمكين شرائح الراديو اللاسلكية. على Y1 يقومون بتمكين Wi-Fi وGPS جنبًا إلى جنب مع Bluetooth وFM في المصنع؛ على Y2 يقومون بتمكين Wi-Fi وGPS وFM جنبًا إلى جنب مع بلوتوث المصنع.

التنزيلات الأساسية ROM لتطوير البرامج الثابتة المخصصة، مع إصدار Android والميزات اللاسلكية التي يتيحها كل منها
تنزيلجهازAndroidميزات لاسلكية
rom.zipY1 · Type AAndroid 4.2.2يضيف Wi-Fi وGPS إلى Bluetooth وFM في المصنع (يعمل FM بالفعل على Y1 من المصنع). بالنسبة إلى Y1 اللاعبين الذين تم شحنهم بنظام التشغيل OS 2.0.0 أو الأحدث.
rom_type_b.zipY1 · Type BAndroid 4.2.2يضيف Wi-Fi وGPS إلى Bluetooth وFM في المصنع (يعمل FM بالفعل على Y1 من المصنع). بالنسبة إلى Y1 اللاعبين الذين تم شحنهم بنظام تشغيل أقدم من 2.0.0.
rom_y2.zipY2Android 4.4.2يضيف Wi-Fi وGPS وFM إلى بلوتوث المصنع. تم تمكين شريحة الراديو Y2 بالكامل، لذا يتوفر FM هنا أيضًا.

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

استخدم أسماء أصول الإصدار هذه

اسم الملف جزء من إشارة التوافق. حافظ على دقة الأسماء وضع ملفات ZIP في أصول إصدار المشروع، وليس فقط في شجرة مصدر المستودع.

أسماء أصول البرامج الثابتة بتنسيق ZIP والأجهزة المدعومة
أصلجهازالأجهزةمعنى
rom.zipY1Type AY1 الأجهزة التي تم شحنها بنظام التشغيل OS 2.0.0 أو الأحدث.
rom_type_b.zipY1Type BY1 الأجهزة التي تم شحنها بنظام تشغيل أقدم من 2.0.0.
rom_y2.zipY2Y2حزمة التثبيت الكامل Y2. أبقها منفصلة عن Y1 الأصول.
لا تقم بإعادة تسمية الحزمة لجعلها تناسب طرازًا آخر. Y1 وY2 يستخدمان ملفات النظام الأساسي MediaTek وتكوينات وامضة مختلفة. قم بنشر الحزمة الخاصة بالأجهزة التي تدعمها بالفعل.

كيف يعمل الاتصال

يقرأ Updater CE البيان باعتباره الكتالوج الخاص به. كل <package> يخبره السطر باسم المشروع والمستودع والنموذج والمعالج. عندما يختار المستخدم هذا المشروع، يتحقق المحدث من الإصدارات المنشورة للمستودع ويبحث عن ملف rom*.zip أصل.

يظهر

يقوم بتسمية المشروع وتعيينه إلى نموذج. يحتاج Y1 وY2 إلى أسطر منفصلة، ​​حتى عند مشاركة المستودع.

الاصدار المنشور

يحتوي على أصول ZIP القابلة للتثبيت. قد يحتوي الإصدار الفردي على الحزم Y1 Type A وY1 Type B وY2 معًا.

تثبيت المحدث CE

يستخدم النموذج المحدد لاختيار الحزمة المطابقة والمسار الوامض الخاص بالطراز. لا يجب على المستخدم تخمين اسم الملف.

نشر مشروع في خمس خطوات

  1. شوكة مستودع Updater CE. قم بإنشاء شوكة خاصة بك ryan-specter/updater-ce-neo، ثم انسخ شوكتك محليًا.
  2. قم بإعداد مستودع عام للبرامج الثابتة. تأكد من أن المستودع عام وأن إصداره يحتوي على أصول ZIP الصحيحة. يمكنك وضع rom.zip, rom_type_b.zip، و rom_y2.zip على نفس الإصدار عندما ينتمون إلى نفس الإصدار.
  3. تحرير البيان. مفتوح slidia_manifest.xml في جذر شوكة Updater CE الخاصة بك. أضف سطرًا واحدًا لكل نموذج يدعمه الإصدار (Y1 و Y2 هما الزوجان المشتركان). ال repo القيمة هي المستودع owner/repository; url هي صفحة المشروع العامة.
  4. اختبر الكتالوج. قم بتشغيل Updater من الخروج المحرر. حدد Y1 وتأكد من أن المشروع يعرض الأصول Y1. حدد Y2 وأكد أنه يعرض الإصدار Y2. تحقق من Type A و Type B بشكل منفصل عند نشرهما.
  5. افتح طلب السحب. ادفع التغيير الواضح إلى مفترقك وافتح طلب سحب مقابل مستودع Updater CE الأساسي. قم بتضمين رابط المشروع والنماذج المدعومة وعلامة الإصدار وأسماء الأصول والأجهزة التي اختبرتها.

قم بإنشاء خطوط البيان الخاصة بك

املأ المستودع وحدد كل نموذج يدعمه الإصدار. المولد يكتب واحد <package> سطر لكل نموذج ويتضمن فقط السمات التي قمت بتعيينها، وبالتالي فإن النتيجة تتطابق مع التيار slidia_manifest.xml شكل. كل سمة يقرأها Updater CE متاحة أدناه - السمات الاختيارية موجودة أدناه المزيد من الخيارات.

المستودع العام GitHub. المولد يستخرج owner/repository من عنوان URL.
يظهر في التطبيق وكتالوج الموقع.
الصفحة التي تواجه الإنسان للمشروع أو ملاحظات الإصدار الخاصة به.
قم بمسح هذا لاستخدام العلامة التجارية الافتراضية للنموذج. SR1، Q3، Q5 وQ3e هي نماذج Timmkoo.
الأجهزة (سطر واحد لكل منهما)
لنموذج غير المذكورة أعلاه. تحتفظ النماذج المعروفة بتهجئة الكتالوج الخاص بها.
أعلام

يتم تقديم الاحتفاظ بالبيانات فقط عندما تكون البرامج الثابتة الواردة والبرامج الثابتة المثبتة متماثلة أو تشترك في ملف واحد derivative جذر. استخدم العلامة فقط عندما لا يمكن نقل بيانات المستخدم بشكل حقيقي.

المزيد من الخيارات: الأيقونة والعمل الفني وأصول الإصدار وما بعد التثبيت والمرايا

أيقونة والأعمال الفنية

اختر الصورة التي ستلتزم بها في المستودع. يؤدي ذلك إلى معاينته وإنشاء عنوان URL الأولي الخاص به؛ لا يتم تحميل أي شيء.
المسار إلى الصورة الملتزمة، بالنسبة إلى جذر المستودع.
عنوان URL المباشر للصورة. عندما يكون التطبيق فارغًا، يستخدم الإصدار updater.png أو أيقونة تم إنشاؤها.

أيقونة اختيارية ذات مظهر داكن. image_dark هو اسم مستعار مقبول.
عمل فني ثانوي، تمت تجربته بعد إصدار الصورة و icon.

الافراج عن الأصول

اسم واحد لكل نموذج محدد. اتركها فارغة للاستخدام rom.zip على Y1 و rom_<model>.zip في مكان آخر.
يتم استخدام Glob عندما لا تتم تسمية الملفات المضغوطة الخاصة بالإصدار rom*.zip.
Glob للحزمة Y1 Type A عندما لا يشير اسمها إلى ذلك.
Glob للحزمة Y1 Type B عندما لا يشير اسمها إلى ذلك.
إخفاء الإدخال من إصدارات Updater CE الأقدم.

الروابط والمرايا وعائلة Keep Data

تم فتحه بعد التثبيت الناجح.
الخطوة الثانية الاختيارية لدليل الإعداد متعدد الصفحات.
مفصولة بفواصل *-mirror المستودعات التي تقوم بإنشاء حزم Flashing Zip المحمولة.
البرامج الثابتة التي تم إنشاء هذا الإصدار منها. تشترك البرامج الثابتة ذات الصلة في قسم البيانات، وهو ما يتحقق منه Keep Data.
مستودع التطبيقات الذي تصف إصداراته التطبيقات الموجودة في هذه البرامج الثابتة. ويحتاج أيضًا إلى صفحة ما بعد التثبيت.
مستودع التطبيقات الذي APK يتم تنزيل التطبيق وتثبيته بعد البرنامج الثابت.

إضافات الكتالوج

معرف ثابت للروابط وسجلات التثبيت المحفوظة. يتم إلحاق النموذج تلقائيًا عند تحديد عدة نماذج.
<package name="Your Firmware" brand="Innioasis" repo="your-account/your-firmware" device="Y1" url="https://github.com/your-account/your-firmware" type="img" handler="Custom Firmware" />
<package name="Your Firmware" brand="Innioasis" repo="your-account/your-firmware" device="Y2" url="https://github.com/your-account/your-firmware" type="img" handler="Custom Firmware" />

جارٍ تحميل أحدث بيان...

سطر واحد لا يكفي لمستودع مشترك. إذا كان السطر Y2 مفقودًا، فلن يحصل المستخدمون Y2 على إدخال مطابق للنموذج حتى عندما rom_y2.zip موجود في إصدار المشروع. وينطبق الشيء نفسه على كل الطراز الآخر الذي يدعمه إصدارك.

كل سمة يقرأها البيان

هذه هي السمات التي يفهمها Updater CE الحالي. المولد يكتب فقط تلك التي تملأها؛ يعود التطبيق إلى الإعدادات الافتراضية المعقولة بالنسبة للباقي.

سمات الحزمة slidia_manifest.xml ومعناها
يصفضروريماذا يفعل
nameنعميظهر اسم البرنامج في الكتالوج وعلى بطاقات التثبيت.
repoنعمowner/repo. يقرأ التطبيق إصدارات GitHub الخاصة بهذا المستودع.
deviceنعمالنموذج المستهدف، كبير (Y1, Y2, G1, Q3e،…). احتفظ بإدخال واحد لكل نموذج.
urlمُستَحسَنصفحة المشروع أو ملاحظات الإصدار المفتوحة من الكتالوج.
type, handlerنعم في الممارسة العمليةtype="img" و handler="Custom Firmware". يتم تخطي الأنواع الأخرى والمعالجات غير الثابتة.
brandاختياريالعلامة التجارية للكتالوج (Innioasis, Timmkoo). يستخدم فارغ العلامة التجارية الافتراضية للنموذج.
package_nameاختياريالافراج عن اسم ملف الأصول. الافتراضات ل rom.zip على Y1 و rom_<model>.zip على نماذج أخرى.
asset_patternاختياريالكرة الأرضية غير حساسة لحالة الأحرف للإصدارات التي لم يتم تسمية ملفات مضغوطة للبرامج الثابتة الخاصة بها rom*.zip (على سبيل المثال my-firmware-*.zip).
type_a_asset, type_b_assetاختياريالكرات التي تحدد الملفات المضغوطة Y1 Type A و Type B عندما لا تحتوي أسماء الملفات الخاصة بها على العلامات المعتادة.
iconاختياريعنوان URL للشعار. تستخدم بعد الإصدار الخاص updater.png / updater.jpg، وكاحتياطي لكل إصدار.
icon_darkاختياريشعار ذو مظهر داكن. image_dark هو اسم مستعار مقبول.
imageاختياريعمل فني ضوئي ثانوي، تمت تجربته بعد ذلك icon.
post_install, post_install2اختياريتم فتح الصفحة (الصفحات) بعد التثبيت الناجح. يغطي الجزء الثاني دليلاً متعدد الخطوات.
portable_zipsاختياريمفصولة بفواصل *-mirror اتفاقيات إعادة الشراء التي تنشر حزمًا محمولة جاهزة للتشغيل.
derivativeاختياريالمستودع الذي تم إنشاء البرامج الثابتة منه. يمكن للبرامج الثابتة التي لها نفس الجذر المشتق الاحتفاظ ببيانات المستخدم.
info_repoاختياريمستودع التطبيقات الذي تصف إصداراته ما تنشره البرامج الثابتة. يتطلب post_install أو post_install2.
apk_repoاختياريمستودع التطبيقات الذي يتم تثبيت التطبيق APK عليه بعد البرنامج الثابت.
min_versionاختياريقم بإخفاء الإدخال عندما يكون Updater CE أقدم من هذا الإصدار.
do_not_keep_dataاختياريtrue (أيضًا 1 / yes) يحظر الاحتفاظ بالبيانات بالكامل لهذه البرامج الثابتة.
slugاختياريمعرف ثابت للروابط وسجلات التثبيت المحفوظة. يتم إنشاؤه من الاسم والطراز عندما يكون فارغًا.
descriptionاختياريوصف قصير للكتالوج. يمكن أن تكون قيمة السمة أو نص العنصر.

لا تزال تتم قراءة الأسماء القديمة من أجل التوافق: model, package, portable_zip, post_install_2, min_app_version و image_dark. يجب أن تستخدم الإدخالات الجديدة الأسماء الحالية أعلاه.

إرسال الخطوط كطلب سحب

  1. انسخ الأسطر التي تم إنشاؤها أعلاه. إنها تتطابق بالفعل مع أحدث تنسيق للبيان.
  2. يحرر slidia_manifest.xml في المستودع. استخدم رابط التعديل أدناه؛ يقوم مضيف المستودع بإنشاء شوكة وفرع لك تلقائيًا.
  3. لصق الخطوط قبل ذلك بقليل </slidia>, الحفاظ على الإدخالات الموجودة دون تغيير.
  4. الالتزام بفرع جديد (على سبيل المثال add-your-firmware)، ثم افتح طلب سحب مقابل مستودع Updater CE.
  5. في العلاقات العامة، تشمل رابط المشروع والنماذج المدعومة وعلامة الإصدار وأسماء الأصول والأجهزة التي اختبرتها.

احتفظ بأسماء النماذج بأحرف كبيرة، واستخدم عنوان URL الدقيق لمستودعك العام، واحتفظ بها type="img" و handler="Custom Firmware" لإدخال البرامج الثابتة.

اجعل من السهل التحقق من الإصدار

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

إصدار القائمة المرجعية

  • نشر الإصدار علنا.
  • قم بإرفاق ملفات ZIP كأصول الإصدار.
  • اذكر النموذج المدعوم وType A أو Type B في الملاحظات.
  • قم بإدراج أي تحضيرات مطلوبة أو حدود معروفة.

إصدار واحد، ثلاثة أصول

يمكن أن يحتوي الإصدار المشترك على rom.zip, rom_type_b.zip، و rom_y2.zip. يقوم المحدث بتصنيفها بشكل منفصل ويختار من بين عوامل تصفية الطراز والأجهزة.

لا حزمة التخمينات

لا تقم بتضمين حزمة Y1 ضمن اسم الملف Y2، أو إضافة بيانات مبعثرة أو أداة تحميل مسبق أو بيانات قسم لم يتم اختبارها فقط لإظهار الأصل.

لماذا تعتبر إدخالات النموذج مهمة أثناء الوميض

البيان ليس مجرد قائمة تنزيل. بعد الاستخراج، يستخدم Updater CE النموذج الذي تم حله لإعداد مسار التثبيت المطابق. Y1 وY2 لديهما ملفات منصة مختلفة، وأدوات تحميل مسبقة، وتكوين مبعثر، وتخطيطات جهاز.

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

قبل أن تطلب الدمج

  1. التحقق من صحة XML باستخدام محلل XML. اقتباس مفقود أو إغلاق /> يمكن إخفاء كل إدخال بعده.
  2. قم بتشغيل المحدث من صفحة الدفع الخاصة بك حتى يقوم بتحميل البيان المحلي قبل التحديث عن بعد.
  3. تحقق من Y1 وY2 بشكل مستقل. تأكد من أن المشروع يظهر فقط عندما تكون الحزمة الخاصة به مدعومة.
  4. تحقق من قائمة الإصدار ل rom.zip, rom_type_b.zip، و rom_y2.zip حسب الاقتضاء.
  5. اختبر التثبيت الفعلي على الجهاز المقصود، باستخدام كابل بيانات USB موثوق به وخطة استرداد للعودة إلى البرنامج الأصلي.
  6. في طلب السحب، اشرح ما قمت باختباره. لا تصف نموذجًا لم يتم اختباره على أنه مدعوم.
python -c "from xml.etree import ElementTree as ET; ET.parse('slidia_manifest.xml'); print('manifest ok')"

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

مهارات التعديل لوكلاء الذكاء الاصطناعي

المستودع skills/ الدليل عبارة عن قاعدة معرفية قائمة على المصدر للوكلاء الذين يعملون على Y1 وY2 الأجهزة والبرامج الثابتة والموضوعات والتطبيقات. تقوم كل مهارة بتسمية ملفات المشروع التي تأتي منها مطالباتها، حتى يتمكن الوكيل من التحقق من الحقيقة قبل تغيير الجهاز.

الأجهزة

Y1 الأجهزة

MT6572، العجلة كأحداث رئيسية، شاشة عرض 480x360، مسارات FM/الصوت، التخزين وخريطة التقسيم Type A/B.

الأجهزة

Y2 الأجهزة

لوحة MT6582، وشجرة الجهاز، ولوحات GC9503V/ST7701S، وقضبان PMIC/DAC، والأقسام وصورة التمهيد.

البرامج الثابتة

حزم البرامج الثابتة

rom.zip التشريح والملفات المتناثرة وعقود التحديث من الفئة أ وقائمة مراجعة الإصدار.

جميع المهارات

تصفح مجلد المهارات

Rockbox Y1/Y2، أقراص Android ROM، Y2Linux، تطبيقات Android، المشغلات، ملاحظات الإصدار ونشر الموقع.