Перейти до вмісту

Для розробників прошивки

Додайте мікропрограму до Updater CE.

Updater CE — це каталог спільноти та інсталятор для спеціального мікропрограмного забезпечення. Розробіть свій проект із бази ROM, опублікуйте його як загальнодоступне сховище з правильними ресурсами випуску, додайте записи моделі до slidia_manifest.xml, протестуйте модельні фільтри та відкрийте запит на отримання. Один репозиторій може обслуговувати кожну модель, яку він підтримує.

Почніть з бази ROM

Базові ПЗУ дають розробникам спеціального мікропрограмного забезпечення чисту основу Android із увімкненими мікросхемами бездротового радіо. На Y1 вони ввімкнули Wi-Fi і GPS разом із заводськими Bluetooth і FM; на Y2 вони включають Wi-Fi, GPS і FM разом із заводським Bluetooth.

База ROM завантажень для розробки нестандартної мікропрограми з версією Android і функціями бездротового зв’язку
ЗавантажитипристрійAndroidБездротові функції
rom.zipY1 · Type AAndroid 4.2.2Додає Wi-Fi та GPS до заводських Bluetooth та FM (FM уже працює на Y1 із заводу). Для Y1 програвачів, які поставляються з ОС 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 до заводського Bluetooth. Радіочіп Y2 повністю ввімкнуто, тому FM також доступний тут.

Ці зображення є стандартною версією Android (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 файли платформи та миготливу конфігурацію. Опублікуйте пакет для обладнання, яке він фактично підтримує.

Як працює підключення

Програма оновлення 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 у кореневому каталозі вашого оновлення CE. Додайте один рядок для кожної моделі, яку підтримує реліз (Y1 і Y2 — загальна пара). The repo значення є сховищем owner/repository; url є публічною сторінкою проекту.
  4. Тестуйте каталог. Запустіть Updater з відредагованої каси. Виберіть Y1 і підтвердьте, що проект показує активи Y1. Виберіть Y2 і підтвердьте, що відображається випуск Y2. Перевірте Type A і Type B окремо, коли обидва опубліковані.
  5. Відкрийте запит на отримання. Надішліть зміну маніфесту у свій форк і відкрийте запит на отримання до репозиторію CE Updater. Додайте посилання на проект, підтримувані моделі, тег випуску, назви активів і пристрої, які ви тестували.

Створіть свої рядки маніфесту

Заповніть репозиторій і відзначте кожну модель, яку підтримує випуск. Генератор записує один <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 репозиторії, які створюють пакети Portable 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). Empty використовує марку моделі за замовчуванням.
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 анатомія, файли розкиду, контракти на оновлення класу A та контрольний список випуску.

Всі навички

Перегляньте папку навичок

Rockbox Y1/Y2, стандартні ПЗУ для Android, Y2Linux, програми для Android, програми запуску, примітки до випуску та публікація на сайті.