Gå til indhold

For firmwareudviklere

Tilføj din firmware til Updater CE.

Updater CE er fællesskabskataloget og installationsprogrammet til tilpasset firmware. Udvikl dit projekt fra en base ROM, udgiv det som et offentligt lager med de korrekte udgivelsesaktiver, tilføj modelposterne til slidia_manifest.xml, test modelfiltrene, og åbn en pull-anmodning. Et lager kan betjene hver model, det understøtter.

Start fra en base ROM

Base ROM'er giver brugerdefinerede firmwareudviklere et rent Android-grundlag med de trådløse radiochips aktiveret. På Y1 aktiverer de Wi-Fi og GPS sammen med fabrikkens Bluetooth og FM; på Y2 aktiverer de Wi-Fi, GPS og FM sammen med fabriks Bluetooth.

Grundlæggende ROM downloads til tilpasset firmwareudvikling, med Android-versionen og trådløse funktioner, som hver enkelt muliggør
DownloadEnhedAndroidTrådløse funktioner
rom.zipY1 · Type AAndroid 4.2.2Tilføjer Wi-Fi og GPS til fabrikkens Bluetooth og FM (FM fungerer allerede på Y1 fra fabrikken). For Y1 spillere, der blev leveret med OS 2.0.0 eller nyere.
rom_type_b.zipY1 · Type BAndroid 4.2.2Tilføjer Wi-Fi og GPS til fabrikkens Bluetooth og FM (FM fungerer allerede på Y1 fra fabrikken). For Y1 spillere, der blev leveret med et OS tidligere end 2.0.0.
rom_y2.zipY2Android 4.4.2Tilføjer Wi-Fi, GPS og FM til fabrikkens Bluetooth. Radiochippen Y2 er fuldt aktiveret, så FM er også tilgængelig her.

Disse billeder er standard Android-basen (AOSP) med enhedens trådløse radioer aktiveret, så en brugerdefineret firmware kan tilføje netværksfunktioner i stedet for at erstatte radiostakken. De er det praktiske udgangspunkt for udgivelsestrinene nedenfor.

Brug disse udgivelsesaktivnavne

Filnavnet er en del af kompatibilitetssignalet. Hold navnene nøjagtige, og sæt ZIP-filerne i projektets udgivelsesaktiver, ikke kun i lagerkildetræet.

Firmware ZIP-aktivnavne og understøttede enheder
AktivEnhedHardwareBetydning
rom.zipY1Type AY1 enheder, der blev leveret med OS 2.0.0 eller nyere.
rom_type_b.zipY1Type BY1 enheder, der blev leveret med et OS tidligere end 2.0.0.
rom_y2.zipY2Y2Y2 fuldinstallationspakken. Hold det adskilt fra Y1 aktiver.
Omdøb ikke en pakke for at få den til at passe til en anden model. Y1 og Y2 bruger forskellige MediaTek platformsfiler og blinkende konfiguration. Udgiv pakken for den hardware, den faktisk understøtter.

Hvordan forbindelsen fungerer

Updater CE læser manifestet som sit katalog. hver <package> linje fortæller projektets navn, lager, model og handler. Når en bruger vælger det pågældende projekt, tjekker Updater depotets offentliggjorte udgivelser og leder efter en rom*.zip aktiv.

Manifest

Navngiver projektet og knytter det til en model. Y1 og Y2 har brug for separate linjer, selv når de deler et lager.

Udgivet udgivelse

Indeholder de installerbare ZIP-aktiver. En enkelt udgivelse kan indeholde pakkerne Y1 Type A, Y1 Type B og Y2 sammen.

Updater CE installation

Bruger den valgte model til at vælge den matchende pakke og den modelspecifikke blinksti. Brugeren skal ikke gætte et filnavn.

Udgiv et projekt i fem trin

  1. Fork Updater CE-lageret. Lav din egen gaffel af ryan-specter/updater-ce-neo, og klon derefter din gaffel lokalt.
  2. Forbered et offentligt firmwarelager. Sørg for, at lageret er offentligt, og at dets udgivelse indeholder de korrekte ZIP-aktiver. Du kan sætte rom.zip, rom_type_b.zip, og rom_y2.zip på samme udgivelse, når de tilhører samme version.
  3. Rediger manifestet. Åbn slidia_manifest.xml i roden af din Updater CE-gaffel. Tilføj en linje for hver model, som udgivelsen understøtter (Y1 og Y2 er det fælles par). Den repo værdien er depotets owner/repository; url er den offentlige projektside.
  4. Test kataloget. Kør Updater fra den redigerede kasse. Vælg Y1, og bekræft, at projektet viser aktiverne Y1. Vælg Y2, og bekræft, at det viser Y2-udgivelsen. Tjek Type A og Type B separat, når begge er udgivet.
  5. Åbn en pull-anmodning. Skub manifestændringen til din gaffel, og åbn en pull-anmodning mod upstream Updater CE-lageret. Inkluder projektlinket, understøttede modeller, frigivelsesmærke, aktivnavne og de enheder, du har testet.

Generer dine manifestlinjer

Udfyld depotet og marker hver model, som udgivelsen understøtter. Generatoren skriver en <package> linje pr. model og inkluderer kun de attributter, du angiver, så resultatet matcher det aktuelle slidia_manifest.xml format. Hver attribut, Updater CE læser, er tilgængelig nedenfor - de valgfrie er under Flere muligheder.

Det offentlige GitHub arkiv. Generatoren udtrækker owner/repository fra URL'en.
Vist i appen og webstedskataloget.
Menneskevendt side for projektet eller dets udgivelsesbemærkninger.
Ryd dette for at bruge modellens standardmærke. SR1, Q3, Q5 og Q3e er Timmkoo modeller.
Enheder (en linje hver)
For en model, der ikke er nævnt ovenfor. Kendte modeller beholder deres katalogstavning.
Flag

Keep Data tilbydes kun, når den indgående firmware og den installerede firmware er den samme eller deler en derivative rod. Brug kun flaget, når brugerdata reelt ikke kan overføres.

Flere muligheder: ikon, kunst, frigivelsesaktiver, efterinstallation og spejle

Ikon og kunstværk

Vælg det billede, du vil forpligte til depotet. Dette viser den og bygger dens rå URL; den uploader ikke noget.
Sti til det forpligtede billede i forhold til lagerroden.
En direkte billed-URL. Når den er tom, bruger appen udgivelsens updater.png eller et genereret ikon.

Valgfrit mørkt tema-ikon. image_dark er et accepteret alias.
Sekundært kunstværk, prøvet efter udgivelsesbilledet og icon.

Frigiv aktiver

Ét navn for hver valgt model. Lad være tom til brug rom.zip på Y1 og rom_<model>.zip andre steder.
Glob bruges, når udgivelsens lynlåse ikke er navngivet rom*.zip.
Glob for Y1 Type A-pakken, når dens navn ikke siger det.
Glob for Y1 Type B-pakken, når dens navn ikke siger det.
Skjul indgangen fra ældre Updater CE builds.

Links, spejle og Keep Data-familien

Åbnet efter en vellykket installation.
Valgfrit andet trin til en flersidet opsætningsvejledning.
Kommasepareret *-mirror repositories, der bygger Portable Flashing Zip-pakker.
Firmwaren, som denne udgivelse er bygget af. Relaterede firmwares deler en datapartition, hvilket Keep Data kontrollerer.
App-repo, hvis udgivelser beskriver apps i denne firmware. Det har også brug for en side efter installation.
App-repo, hvis APK appen downloader og installerer efter firmwaren.

Katalog ekstramateriale

Stabil identifikator for links og gemte installationsposter. Modellen tilføjes automatisk, når der vælges flere modeller.
<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" />

Indlæser det seneste manifest...

En linje er ikke nok til et delt lager. Hvis Y2-linjen mangler, vil Y2-brugere ikke få en model-matchet post, selv når rom_y2.zip findes i projektets udgivelse. Det samme gælder for alle andre modeller, som din udgivelse understøtter.

Hver egenskab, som manifestet læser

Dette er de attributter, som nuværende Updater CE-bygninger forstår. Generatoren skriver kun dem du udfylder; appen falder tilbage til fornuftige standardindstillinger for resten.

slidia_manifest.xml-pakkeattributter og deres betydning
AttributTiltrængtHvad den gør
nameJaSoftwarenavn vist i kataloget og på installationskort.
repoJaowner/repo. Appen læser dette lagers GitHub udgivelser.
deviceJaMålmodel, store bogstaver (Y1, Y2, G1, Q3e, …). Behold én post pr. model.
urlAnbefalesProjektside eller release notes åbnet fra kataloget.
type, handlerJa i praksistype="img" og handler="Custom Firmware". Andre typer og ikke-firmwarehandlere springes over.
brandValgfritKatalog mærke (Innioasis, Timmkoo). Empty bruger modellens standardmærke.
package_nameValgfritFrigiv aktiv filnavn. Standard til rom.zip på Y1 og rom_<model>.zip på andre modeller.
asset_patternValgfritSkift-ufølsom glob til udgivelser, hvis firmware-zips ikke er navngivet rom*.zip (f.eks my-firmware-*.zip).
type_a_asset, type_b_assetValgfritGlobs, der identificerer Y1 Type A og Type B zips, når deres filnavne ikke indeholder de sædvanlige markører.
iconValgfritLogo URL. Brugt efter udgivelsens egen updater.png / updater.jpg, og som reserve for hver udgivelse.
icon_darkValgfritMørkt tema logo. image_dark er et accepteret alias.
imageValgfritSekundært lys kunstværk, prøvet efter icon.
post_install, post_install2ValgfritSide(r) åbnet efter en vellykket installation. Den anden dækker en vejledning med flere trin.
portable_zipsValgfritKommasepareret *-mirror reposer, der udgiver klar til at køre bærbare pakker.
derivativeValgfritRepository firmwaren er bygget fra. Firmware med samme afledte rod kan beholde brugerdata.
info_repoValgfritApplager, hvis udgivelser beskriver, hvad firmwaren implementerer. Kræver post_install eller post_install2.
apk_repoValgfritApplager, hvis APK appen installerer efter firmwaren.
min_versionValgfritSkjul indgangen, når Updater CE er ældre end denne version.
do_not_keep_dataValgfrittrue (også 1 / yes) blokerer Behold data fuldstændigt for denne firmware.
slugValgfritStabil identifikator for links og gemte installationsposter. Genereret ud fra navnet og modellen, når den er tom.
descriptionValgfritKort katalogbeskrivelse. Det kan være attributværdien eller elementets tekst.

Ældre navne læses stadig for kompatibilitet: model, package, portable_zip, post_install_2, min_app_version og image_dark. Nye poster skal bruge de nuværende navne ovenfor.

Indsend linjerne som en pull-anmodning

  1. Kopier de genererede linjer ovenfor. De matcher allerede det seneste manifestformat.
  2. Rediger slidia_manifest.xml i depotet. Brug redigeringslinket nedenfor; lagerværten opretter automatisk en gaffel og en gren til dig.
  3. Indsæt linjerne lige før </slidia>, bevare de eksisterende poster uændrede.
  4. Forpligt dig til en ny afdeling (f.eks add-your-firmware), åbn derefter en pull-anmodning mod Updater CE-lageret.
  5. I PR skal medtages projektlinket, understøttede modeller, release-tag, aktivnavne og de enheder, du testede.

Hold modelnavnene med store bogstaver, brug den nøjagtige URL på dit offentlige lager, og behold type="img" og handler="Custom Firmware" for en firmware-indgang.

Gør udgivelsen nem at verificere

Giv udgivelsen et tydeligt mærke og udgivelsesnote. Tagget er nyttigt for folk, men ZIP-aktivnavnene er, hvad Updater CE bruger til at identificere installationspakkerne.

Frigiv tjekliste

  • Offentliggør udgivelsen offentligt.
  • Vedhæft ZIP-filerne som udgivelsesaktiver.
  • Angiv den understøttede model og Type A eller Type B i bemærkningerne.
  • Angiv alle nødvendige præparater eller kendte grænser.

En udgivelse, tre aktiver

En delt udgivelse kan indeholde rom.zip, rom_type_b.zip, og rom_y2.zip. Updater klassificerer dem separat og vælger fra model- og hardwarefiltre.

Undlad at samle gæt

Medtag ikke en Y1-pakke under Y2-filnavnet, eller tilføj ikke-testede scatter-, preloader- eller partitionsdata bare for at få et aktiv til at dukke op.

Hvorfor modelindtastningerne betyder noget under blink

Manifestet er ikke kun en downloadmenu. Efter ekstraktion bruger Updater CE den løste model til at forberede den matchende installationssti. Y1 og Y2 har forskellige platformsfiler, forudindlæsere, scatter-konfiguration og enhedslayout.

Bidragydere skal levere korrekte firmwarefiler, ikke flash-offsets. Rediger ikke scatter-adresser, forudindlæsere, DA-filer eller partitionskommandoer for at omgå en dårlig pakke. Ret frigivelsesaktivet og test på den tilsigtede model.

Før du anmoder om en fletning

  1. Valider XML med en XML-parser. Et manglende tilbud eller afslutning /> kan skjule hver post efter den.
  2. Start opdateringsprogrammet fra din kassen, så det indlæser det lokale manifest før fjernopdateringen.
  3. Kontroller Y1 og Y2 uafhængigt. Bekræft, at projektet kun vises, hvor dets pakke understøttes.
  4. Tjek udgivelseslisten for rom.zip, rom_type_b.zip, og rom_y2.zip efter behov.
  5. Test den faktiske installation på den tilsigtede enhed med et pålideligt USB datakabel og en genopretningsplan for tilbagevenden til original software.
  6. I pull-anmodningen skal du forklare, hvad du testede. Beskriv ikke en ikke-testet model som understøttet.
python -c "from xml.etree import ElementTree as ET; ET.parse('slidia_manifest.xml'); print('manifest ok')"

For en lokal kontrol, kør den kommando fra lagerroden. Det verificerer kun XML-syntaks; det beviser ikke, at en udgivelse indeholder gyldig firmware, eller at en enhed er sikker at flashe.

Modding færdigheder for AI-agenter

Depotets skills/ directory er en kildebaseret videnbase for agenter, der arbejder med Y1 og Y2 hardware, firmware, temaer og apps. Hver færdighed navngiver projektfilerne, dens krav kommer fra, så en agent kan tjekke en kendsgerning, før han ændrer en enhed.

Hardware

Y1 hardware

MT6572, hjulet som nøglebegivenheder, 480x360 display, FM/lydstier, lagring og Type A/B partitionskortet.

Hardware

Y2 hardware

MT6582-kort, enhedstræ, GC9503V/ST7701S-paneler, PMIC/DAC-skinner, skillevægge og boot-imaget.

Firmware

Firmware-pakker

rom.zip anatomi, scatter-filer, klasse A-opdateringskontrakter og udgivelsestjeklisten.

Alle færdigheder

Gennemse færdighedsmappen

Rockbox Y1/Y2, lager Android ROM'er, Y2Linux, Android apps, launchers, release notes og webstedsudgivelse.