رفتن به محتوا

برای توسعه دهندگان سیستم عامل

سیستم عامل خود را به Updater CE اضافه کنید.

Updater CE کاتالوگ انجمن و نصب کننده سیستم عامل سفارشی است. پروژه خود را از پایه ROM توسعه دهید، آن را به عنوان یک مخزن عمومی با دارایی های انتشار صحیح منتشر کنید، ورودی های مدل را به آن اضافه کنید slidia_manifest.xml، فیلترهای مدل را تست کنید و درخواست کشش را باز کنید. یک مخزن می تواند به هر مدلی که پشتیبانی می کند سرویس دهد.

شروع از یک پایه ROM

رام های پایه به توسعه دهندگان سیستم عامل سفارشی، پایه اندرویدی تمیزی را با تراشه های رادیویی بی سیم فعال می کنند. در Y1 Wi-Fi و GPS را در کنار بلوتوث کارخانه و FM فعال می کنند. در Y2 Wi-Fi، GPS و FM را در کنار بلوتوث کارخانه فعال می کنند.

دانلودهای پایه ROM برای توسعه سفت‌افزار سفارشی، با نسخه Android و ویژگی‌های بی‌سیم که هر کدام فعال می‌شوند
دانلوددستگاهAndroidویژگی های بی سیم
rom.zipY1 · Type AAndroid 4.2.2Wi-Fi و GPS را به بلوتوث و FM کارخانه اضافه می کند (FM از قبل روی Y1 کارخانه کار می کند). برای Y1 بازیکنانی که با سیستم عامل 2.0.0 یا بالاتر ارسال شده اند.
rom_type_b.zipY1 · Type BAndroid 4.2.2Wi-Fi و GPS را به بلوتوث و FM کارخانه اضافه می کند (FM از قبل روی Y1 کارخانه کار می کند). برای Y1 بازیکنانی که با سیستم عامل زودتر از 2.0.0 ارسال شده اند.
rom_y2.zipY2Android 4.4.2Wi-Fi، GPS و FM را به بلوتوث کارخانه اضافه می کند. تراشه رادیویی Y2 به طور کامل فعال است، بنابراین FM در اینجا نیز در دسترس است.

این تصاویر پایه اندروید (AOSP) با رادیوهای بی‌سیم دستگاه هستند، بنابراین یک سیستم عامل سفارشی می‌تواند به جای جایگزین کردن پشته رادیویی، ویژگی‌های شبکه را اضافه کند. آنها نقطه شروع عملی برای مراحل انتشار زیر هستند.

از این نام‌های دارایی انتشار استفاده کنید

نام فایل بخشی از سیگنال سازگاری است. نام ها را دقیق نگه دارید و فایل های ZIP را نه تنها در درخت منبع مخزن، در دارایی های انتشار پروژه قرار دهید.

نام دارایی های ZIP میان افزار و دستگاه های پشتیبانی شده
داراییدستگاهسخت افزارمعنی
rom.zipY1Type AY1 دستگاه‌هایی که با سیستم‌عامل 2.0.0 یا بالاتر ارسال شده‌اند.
rom_type_b.zipY1Type BY1 دستگاه‌هایی که با سیستم‌عامل زودتر از 2.0.0 عرضه شده‌اند.
rom_y2.zipY2Y2بسته نصب کامل Y2. آن را جدا از دارایی های Y1 نگه دارید.
یک بسته را تغییر نام ندهید تا متناسب با مدل دیگری باشد. Y1 و Y2 از فایل‌های پلتفرم مختلف MediaTek و پیکربندی چشمک‌زن استفاده می‌کنند. بسته را برای سخت افزاری که واقعاً پشتیبانی می کند منتشر کنید.

نحوه کار اتصال

Updater CE مانیفست را به عنوان کاتالوگ خود می خواند. هر کدام <package> خط نام پروژه، مخزن، مدل و کنترلر را به آن می گوید. هنگامی که کاربر آن پروژه را انتخاب می کند، Updater نسخه های منتشر شده مخزن را بررسی می کند و به دنبال یک 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 مدل هستند.
دستگاه ها (هر کدام یک خط)
برای مدلی که در بالا ذکر نشده است. مدل های شناخته شده املای کاتالوگ خود را حفظ می کنند.
پرچم ها

Keep Data تنها زمانی ارائه می‌شود که میان‌افزار ورودی و میان‌افزار نصب‌شده یکسان باشند یا به اشتراک گذاشته شوند 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 مخازنی که بسته های فشرده فلش قابل حمل می سازند.
سیستم عامل این نسخه از آن ساخته شده است. سیستم عامل های مرتبط یک پارتیشن داده را به اشتراک می گذارند، که 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). Empty از مارک پیش فرض مدل استفاده می کند.
package_nameاختیارینام فایل دارایی را منتشر کنید. پیش فرض به rom.zip در Y1 و rom_<model>.zip در مدل های دیگر
asset_patternاختیاریglob حساس به حروف کوچک و بزرگ برای نسخه‌هایی که زیپ‌های میان‌افزار آنها نامی ندارد rom*.zip (مثلا my-firmware-*.zip).
type_a_asset, type_b_assetاختیاریGlob هایی که زیپ های Y1 Type A و Type B را زمانی که نام فایل آنها حاوی نشانگرهای معمولی نباشد، شناسایی می کنند.
iconاختیارینشانی وب لوگو. پس از انتشار خود استفاده می شود 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) Keep Data را به طور کامل برای این سیستم عامل مسدود می کند.
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. Updater آنها را به طور جداگانه طبقه بندی می کند و از بین مدل ها و فیلترهای سخت افزاری انتخاب می کند.

حدس و گمان ها را به هم نزنید

بسته Y1 را در نام فایل Y2 وارد نکنید، یا داده‌های scatter، preloader یا پارتیشن آزمایش‌نشده را فقط برای نمایش یک دارایی اضافه نکنید.

چرا ورودی های مدل در هنگام چشمک زدن اهمیت دارند

مانیفست فقط یک منوی دانلود نیست. پس از استخراج، 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 آناتومی، فایل های پراکنده، قراردادهای به روز رسانی کلاس A و چک لیست انتشار.

همه مهارت ها

پوشه skills را مرور کنید

Rockbox Y1/Y2، رام‌های موجود اندروید، Y2Linux، برنامه‌های اندروید، راه‌اندازها، یادداشت‌های انتشار و انتشار سایت.