Przejdź do treści

Dla twórców oprogramowania sprzętowego

Dodaj swoje oprogramowanie do Updater CE.

Updater CE to katalog społecznościowy i instalator niestandardowego oprogramowania sprzętowego. Opracuj swój projekt od bazy ROM, opublikuj go jako publiczne repozytorium z odpowiednimi zasobami wersji, dodaj wpisy modelu do slidia_manifest.xml, przetestuj filtry modelu i otwórz żądanie ściągnięcia. Jedno repozytorium może obsługiwać każdy model, który obsługuje.

Zacznij od bazy ROM

Podstawowe pamięci ROM zapewniają twórcom niestandardowego oprogramowania sprzętowego czystą podstawę systemu Android z włączonymi bezprzewodowymi chipami radiowymi. W Y1 umożliwiają Wi-Fi i GPS wraz z fabrycznym Bluetooth i FM; w Y2 umożliwiają Wi-Fi, GPS i FM obok fabrycznego Bluetooth.

Podstawowe ROM pliki do pobrania w celu opracowania niestandardowego oprogramowania sprzętowego, z wersją Androida i funkcjami bezprzewodowymi dostępnymi w każdym z nich
PobierzUrządzenieAndroidFunkcje bezprzewodowe
rom.zipY1 · Type AAndroid 4.2.2Dodaje Wi-Fi i GPS do fabrycznego Bluetooth i FM (FM działa już fabrycznie na Y1). Dla Y1 odtwarzaczy z systemem operacyjnym 2.0.0 lub nowszym.
rom_type_b.zipY1 · Type BAndroid 4.2.2Dodaje Wi-Fi i GPS do fabrycznego Bluetooth i FM (FM działa już fabrycznie na Y1). Dla Y1 graczy z systemem operacyjnym starszym niż 2.0.0.
rom_y2.zipY2Android 4.4.2Dodaje Wi-Fi, GPS i FM do fabrycznego Bluetooth. Układ radiowy Y2 jest w pełni włączony, więc FM jest dostępny również tutaj.

Te obrazy przedstawiają standardową wersję systemu Android (AOSP) z włączoną łącznością bezprzewodową urządzenia, więc niestandardowe oprogramowanie sprzętowe może dodawać funkcje sieciowe zamiast zastępować stos radiowy. Stanowią one praktyczny punkt wyjścia dla poniższych etapów publikowania.

Użyj tych nazw zasobów wersji

Nazwa pliku jest częścią sygnału zgodności. Zachowaj dokładne nazwy i umieść pliki ZIP w zasobach wersji projektu, a nie tylko w drzewie źródłowym repozytorium.

Nazwy oprogramowania sprzętowego ZIP i obsługiwane urządzenia
ZaletaUrządzenieSprzętOznaczający
rom.zipY1Type AY1 urządzenia dostarczone z systemem operacyjnym 2.0.0 lub nowszym.
rom_type_b.zipY1Type BY1 urządzenia dostarczone z systemem operacyjnym starszym niż 2.0.0.
rom_y2.zipY2Y2Pakiet pełnej instalacji Y2. Trzymaj go oddzielnie od Y1 zasobów.
Nie zmieniaj nazwy pakietu, aby pasował do innego modelu. Y1 i Y2 używają różnych plików platformy MediaTek i konfiguracji flashowania. Opublikuj pakiet dla sprzętu, który faktycznie obsługuje.

Jak działa połączenie

Updater CE odczytuje manifest jako swój katalog. Każdy <package> line podaje nazwę projektu, repozytorium, model i procedurę obsługi. Gdy użytkownik wybierze ten projekt, Updater sprawdza opublikowane wersje repozytorium i szuka pliku rom*.zip zaleta.

Oczywisty

Nazywa projekt i przypisuje go do modelu. Y1 i Y2 wymagają oddzielnych wierszy, nawet jeśli współdzielą repozytorium.

Opublikowane wydanie

Zawiera instalowalne zasoby ZIP. Pojedyncze wydanie może zawierać razem pakiety Y1 Type A, Y1 Type B i Y2.

Instalacja aktualizatora CE

Używa wybranego modelu do wybrania pasującego pakietu i ścieżki flashowania specyficznej dla modelu. Użytkownik nie powinien zgadywać nazwy pliku.

Publikowanie projektu w pięciu krokach

  1. Forkuj repozytorium Updater CE. Stwórz swój własny widelec ryan-specter/updater-ce-neo, a następnie sklonuj widelec lokalnie.
  2. Przygotuj publiczne repozytorium oprogramowania sprzętowego. Upewnij się, że repozytorium jest publiczne i jego wersja zawiera prawidłowe zasoby ZIP. Możesz umieścić rom.zip, rom_type_b.zip, i rom_y2.zip w tym samym wydaniu, jeśli należą do tej samej wersji.
  3. Edytuj manifest. Otwórz slidia_manifest.xml w katalogu głównym widelca Updater CE. Dodaj jedną linię dla każdego modelu obsługiwanego przez wydanie (Y1 i Y2 to wspólna para). The repo wartością jest repozytorium owner/repository; url to publiczna strona projektu.
  4. Przetestuj katalog. Uruchom Updater z edytowanego koszyka. Wybierz Y1 i potwierdź, że projekt pokazuje zasoby Y1. Wybierz Y2 i potwierdź, że wyświetla się wersja Y2. Sprawdź osobno Type A i Type B, gdy oba zostaną opublikowane.
  5. Otwórz żądanie ściągnięcia. Wypchnij zmianę manifestu do rozwidlenia i otwórz żądanie ściągnięcia względem nadrzędnego repozytorium Updater CE. Dołącz link do projektu, obsługiwane modele, znacznik wersji, nazwy zasobów i testowane urządzenia.

Wygeneruj linie manifestu

Wypełnij repozytorium i zaznacz każdy model obsługiwany przez tę wersję. Generator zapisuje jeden <package> linii na model i zawiera tylko ustawione przez Ciebie atrybuty, więc wynik jest zgodny z bieżącym slidia_manifest.xml format. Każdy atrybut odczytany przez Updater CE jest dostępny poniżej — opcjonalne znajdują się poniżej Więcej opcji.

Repozytorium publiczne GitHub. Generator ekstraktów owner/repository z adresu URL.
Wyświetlane w aplikacji i katalogu witryny.
Strona projektu skierowana do ludzi lub informacje o jego wersji.
Wyczyść tę opcję, aby użyć domyślnej marki modelu. SR1, Q3, Q5 i Q3e to modele Timmkoo.
Urządzenia (po jednej linii każde)
Dla modelu, który nie jest wymieniony powyżej. Znane modele zachowują pisownię katalogową.
Flagi

Funkcja Keep Data jest oferowana tylko wtedy, gdy przychodzące i zainstalowane oprogramowanie sprzętowe są takie same lub udostępniają a derivative źródło. Używaj flagi tylko wtedy, gdy naprawdę nie można przenieść danych użytkownika.

Więcej opcji: ikona, grafika, zasoby wersji, instalacja poinstalacyjna i kopie lustrzane

Ikona i grafika

Wybierz obraz, który zatwierdzisz w repozytorium. Spowoduje to wyświetlenie podglądu i utworzenie surowego adresu URL; nic nie wgrywa.
Ścieżka do zatwierdzonego obrazu względem katalogu głównego repozytorium.
Bezpośredni adres URL obrazu. Gdy jest pusty, aplikacja korzysta z wersji updater.png lub wygenerowaną ikonę.

Opcjonalna ikona ciemnego motywu. image_dark jest akceptowanym pseudonimem.
Grafika wtórna, wypróbowana po wydaniu obrazu i icon.

Zwolnij zasoby

Jedna nazwa dla każdego wybranego modelu. Pozostaw puste do użycia rom.zip na Y1 i rom_<model>.zip gdzie indziej.
Glob używany, gdy zamki błyskawiczne wydania nie są nazwane rom*.zip.
Glob dla pakietu Y1 Type A, jeśli jego nazwa tego nie mówi.
Glob dla pakietu Y1 Type B, jeśli jego nazwa tego nie mówi.
Ukryj wpis w starszych kompilacjach narzędzia Updater CE.

Linki, kopie lustrzane i rodzina Keep Data

Otwarty po udanej instalacji.
Opcjonalny drugi krok w przypadku wielostronicowego przewodnika konfiguracji.
Oddzielone przecinkami *-mirror repozytoria budujące pakiety Portable Flashing Zip.
Oprogramowanie sprzętowe, z którego zbudowana jest ta wersja. Powiązane oprogramowanie sprzętowe udostępnia partycję danych, co sprawdza Keep Data.
Repozytorium aplikacji, którego wydania opisują aplikacje w tym oprogramowaniu. Potrzebuje także strony poinstalacyjnej.
Repozytorium aplikacji, którego APK aplikacja pobiera i instaluje po oprogramowaniu sprzętowym.

Dodatki do katalogu

Stabilny identyfikator linków i zapisanych rekordów instalacji. Model zostanie dodany automatycznie po wybraniu kilku modeli.
<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" />

Ładowanie najnowszego manifestu…

Jedna linia nie wystarczy na wspólne repozytorium. Jeśli brakuje wiersza Y2, użytkownicy Y2 nie otrzymają wpisu dopasowanego do modelu, nawet jeśli rom_y2.zip istnieje w wydaniu projektu. To samo dotyczy każdego innego modelu obsługiwanego przez Twoją wersję.

Każdy atrybut odczytywany przez manifest

Są to atrybuty zrozumiałe dla obecnych wersji Updater CE. Generator zapisuje tylko te, które wypełnisz; w pozostałej części aplikacja powraca do rozsądnych ustawień domyślnych.

Atrybuty pakietu slidedia_manifest.xml i ich znaczenie
AtrybutWymaganyCo to robi
nameTakNazwa oprogramowania pokazana w katalogu i na kartach instalacyjnych.
repoTakowner/repo. Aplikacja odczytuje wydania GitHub tego repozytorium.
deviceTakModel docelowy, wielkie litery (Y1, Y2, G1, Q3e,…). Zachowaj po jednym wpisie na model.
urlZaleconyStrona projektu lub informacje o wydaniu otwarte z katalogu.
type, handlerTak w praktycetype="img" i handler="Custom Firmware". Inne typy i procedury obsługi inne niż oprogramowanie sprzętowe są pomijane.
brandOpcjonalneMarka katalogowa (Innioasis, Timmkoo). Pusty używa domyślnej marki modelu.
package_nameOpcjonalneZwolnij nazwę pliku zasobu. Domyślnie rom.zip na Y1 i rom_<model>.zip w innych modelach.
asset_patternOpcjonalneGlob nieuwzględniający wielkości liter dla wydań, których kody zip oprogramowania sprzętowego nie są nazwane rom*.zip (Na przykład my-firmware-*.zip).
type_a_asset, type_b_assetOpcjonalneGloby identyfikujące zamki Y1 Type A i Type B, gdy ich nazwy plików nie zawierają zwykłych znaczników.
iconOpcjonalneAdres URL logo. Używane po wydaniu własnym updater.png / updater.jpgi jako rozwiązanie awaryjne dla każdego wydania.
icon_darkOpcjonalneLogo z ciemnym motywem. image_dark jest akceptowanym pseudonimem.
imageOpcjonalneWtórna grafika świetlna, wypróbowana icon.
post_install, post_install2OpcjonalneStrony otwarte po pomyślnej instalacji. Drugi obejmuje wieloetapowy przewodnik.
portable_zipsOpcjonalneOddzielone przecinkami *-mirror repozytoria publikujące gotowe do uruchomienia pakiety przenośne.
derivativeOpcjonalneRepozytorium, z którego zbudowane jest oprogramowanie sprzętowe. Oprogramowanie sprzętowe z tym samym pochodnym katalogiem głównym może przechowywać dane użytkownika.
info_repoOpcjonalneRepozytorium aplikacji, którego wydania opisują wdrażane oprogramowanie sprzętowe. Wymaga post_install lub post_install2.
apk_repoOpcjonalneRepozytorium aplikacji, którego APK aplikacja instaluje po oprogramowaniu sprzętowym.
min_versionOpcjonalneUkryj wpis, jeśli Updater CE jest starszy niż ta wersja.
do_not_keep_dataOpcjonalnetrue (Również 1 / yes) całkowicie blokuje funkcję Keep Data dla tego oprogramowania sprzętowego.
slugOpcjonalneStabilny identyfikator linków i zapisanych rekordów instalacji. Generowane na podstawie nazwy i modelu, gdy jest puste.
descriptionOpcjonalneKrótki opis katalogu. Może to być wartość atrybutu lub tekst elementu.

Starsze nazwy są nadal odczytywane pod kątem zgodności: model, package, portable_zip, post_install_2, min_app_version i image_dark. Nowe wpisy powinny używać aktualnych nazw podanych powyżej.

Prześlij linie jako żądanie ściągnięcia

  1. Skopiuj wygenerowane linie powyżej. Pasują już do najnowszego formatu manifestu.
  2. Redagować slidia_manifest.xml w repozytorium. Skorzystaj z poniższego linku do edycji; Host repozytorium automatycznie tworzy dla Ciebie rozwidlenie i gałąź.
  3. Wklej linie tuż przed </slidia>, pozostawienie istniejących wpisów bez zmian.
  4. Zaangażuj się w nowy oddział (Na przykład add-your-firmware), a następnie otwórz żądanie ściągnięcia względem repozytorium Updater CE.
  5. W PR uwzględnij łącze do projektu, obsługiwane modele, znacznik wersji, nazwy zasobów i testowane urządzenia.

Nazwy modeli zachowaj wielkimi literami, użyj dokładnego adresu URL swojego publicznego repozytorium i zachowaj type="img" i handler="Custom Firmware" dla wpisu oprogramowania sprzętowego.

Spraw, aby wydanie było łatwe do sprawdzenia

Nadaj wydaniu wyraźny tag i informację o wydaniu. Znacznik jest przydatny dla ludzi, ale nazwy zasobów ZIP są tym, czego program Updater CE używa do identyfikacji pakietów instalacyjnych.

Lista kontrolna wydania

  • Opublikuj publikację.
  • Dołącz pliki ZIP jako zasoby wersji.
  • Podaj obsługiwany model oraz Type A lub Type B w uwagach.
  • Wymień wszelkie wymagane preparaty lub znane limity.

Jedno wydanie, trzy zasoby

Udostępniona wersja może zawierać rom.zip, rom_type_b.zip, i rom_y2.zip. Updater klasyfikuje je osobno i wybiera spośród filtrów modelowych i sprzętowych.

Nie łącz domysłów

Nie dołączaj pakietu Y1 pod nazwą pliku Y2 ani nie dodawaj nieprzetestowanych danych rozproszenia, modułu wstępnego ładowania lub partycji tylko po to, aby pojawił się zasób.

Dlaczego wpisy modelu mają znaczenie podczas flashowania

Manifest to nie tylko menu pobierania. Po wyodrębnieniu Updater CE wykorzystuje rozwiązany model do przygotowania pasującej ścieżki instalacji. Y1 i Y2 mają różne pliki platformy, programy wstępnego ładowania, konfigurację rozproszoną i układy urządzeń.

Współautorzy powinni dostarczyć poprawne pliki oprogramowania sprzętowego, a nie offsety flash. Nie edytuj adresów rozproszonych, preloaderów, plików DA ani poleceń partycji, aby obejść uszkodzony pakiet. Napraw zasób wersji i przetestuj na zamierzonym modelu.

Zanim poprosisz o połączenie

  1. Sprawdź poprawność XML za pomocą parsera XML. Brakujący cytat lub zamknięcie /> może ukryć każdy wpis po nim.
  2. Uruchom aktualizator ze swojej kasy, aby załadować lokalny manifest przed zdalnym odświeżeniem.
  3. Sprawdź niezależnie Y1 i Y2. Upewnij się, że projekt pojawia się tylko tam, gdzie obsługiwany jest jego pakiet.
  4. Sprawdź listę wydań rom.zip, rom_type_b.zip, i rom_y2.zip stosownie do przypadku.
  5. Przetestuj rzeczywistą instalację na zamierzonym urządzeniu, korzystając z niezawodnego kabla do transmisji danych USB i planu odzyskiwania umożliwiającego powrót do oryginalnego oprogramowania.
  6. W żądaniu ściągnięcia wyjaśnij, co przetestowałeś. Nie opisuj nieprzetestowanego modelu jako obsługiwanego.
python -c "from xml.etree import ElementTree as ET; ET.parse('slidia_manifest.xml'); print('manifest ok')"

Aby sprawdzić lokalnie, uruchom to polecenie z katalogu głównego repozytorium. Weryfikuje tylko składnię XML; nie dowodzi, że wersja zawiera prawidłowe oprogramowanie sprzętowe lub że urządzenie można bezpiecznie flashować.

Umiejętności modowania dla agentów AI

Repozytorium skills/ katalog to oparta na źródłach baza wiedzy dla agentów pracujących na sprzęcie, oprogramowaniu sprzętowym, motywach i aplikacjach Y1 i Y2. Każda umiejętność nazywa pliki projektu, z których pochodzą jej roszczenia, dzięki czemu agent może sprawdzić fakt przed zmianą urządzenia.

Sprzęt

Y1 sprzęt

MT6572, koło jako kluczowe zdarzenia, wyświetlacz 480x360, ścieżki FM/audio, pamięć i mapa partycji Type A/B.

Sprzęt

Y2 sprzęt

Płytka MT6582, drzewo urządzeń, panele GC9503V/ST7701S, szyny PMIC/DAC, partycje i obraz rozruchowy.

Wszystkie umiejętności

Przeglądaj folder umiejętności

Rockbox Y1/Y2, standardowe ROMy na Androida, Y2Linux, aplikacje na Androida, programy uruchamiające, informacje o wydaniu i publikowanie witryn.