Gå til innhold

For fastvareutviklere

Legg til fastvaren til Updater CE.

Updater CE er fellesskapskatalogen og installasjonsprogrammet for tilpasset fastvare. Utvikl prosjektet ditt fra en base ROM, publiser det som et offentlig depot med de riktige utgivelseselementene, legg til modelloppføringene i slidia_manifest.xml, test modellfiltrene og åpne en pull-forespørsel. Ett depot kan betjene hver modell den støtter.

Start fra en base ROM

Base-ROM-er gir tilpassede fastvareutviklere et rent Android-grunnlag med de trådløse radiobrikkene aktivert. 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 fabrikkens Bluetooth.

Base ROM nedlastinger for tilpasset fastvareutvikling, med Android-versjonen og trådløse funksjoner som hver muliggjør
Last nedEnhetAndroidTrådløse funksjoner
rom.zipY1 · Type AAndroid 4.2.2Legger til Wi-Fi og GPS til fabrikkens Bluetooth og FM (FM fungerer allerede på Y1 fra fabrikken). For Y1 spillere som ble levert med OS 2.0.0 eller nyere.
rom_type_b.zipY1 · Type BAndroid 4.2.2Legger til Wi-Fi og GPS til fabrikkens Bluetooth og FM (FM fungerer allerede på Y1 fra fabrikken). For Y1 spillere som ble levert med et OS tidligere enn 2.0.0.
rom_y2.zipY2Android 4.4.2Legger til Wi-Fi, GPS og FM til fabrikkinstallert Bluetooth. Radiobrikken Y2 er fullt aktivert, så FM er også tilgjengelig her.

Disse bildene er standard Android-base (AOSP) med enhetens trådløse radioer aktivert, slik at en tilpasset fastvare kan legge til nettverksfunksjoner i stedet for å erstatte radiostabelen. De er det praktiske utgangspunktet for publiseringstrinnene nedenfor.

Bruk disse navnene på utgivelseselementer

Filnavnet er en del av kompatibilitetssignalet. Hold navnene nøyaktige og plasser ZIP-filene i prosjektets utgivelsesressurser, ikke bare i kildetreet for depotet.

Firmware ZIP-aktivanavn og støttede enheter
EiendelEnhetMaskinvareMening
rom.zipY1Type AY1 enheter som ble levert med OS 2.0.0 eller nyere.
rom_type_b.zipY1Type BY1 enheter som ble levert med et OS tidligere enn 2.0.0.
rom_y2.zipY2Y2Y2 fullinstalleringspakken. Hold den atskilt fra Y1 eiendeler.
Ikke gi nytt navn til en pakke for å få den til å passe til en annen modell. Y1 og Y2 bruker forskjellige MediaTek plattformfiler og blinkende konfigurasjon. Publiser pakken for maskinvaren den faktisk støtter.

Hvordan tilkoblingen fungerer

Updater CE leser manifestet som sin katalog. Hver <package> linje forteller den prosjektnavnet, depotet, modellen og behandleren. Når en bruker velger det prosjektet, sjekker Updater depotets publiserte utgivelser og ser etter en rom*.zip eiendel.

Manifest

Navngir prosjektet og tilordner det til en modell. Y1 og Y2 trenger separate linjer, selv når de deler et depot.

Publisert utgivelse

Inneholder de installerbare ZIP-elementene. En enkelt utgivelse kan inneholde pakkene Y1 Type A, Y1 Type B, og Y2 sammen.

Updater CE installering

Bruker den valgte modellen til å velge matchende pakke og modellspesifikk blinkbane. Brukeren skal ikke måtte gjette et filnavn.

Publiser et prosjekt i fem trinn

  1. Fork Updater CE-depotet. Lag din egen gaffel av ryan-specter/updater-ce-neo, klone deretter gaffelen lokalt.
  2. Forbered et offentlig fastvarelager. Sørg for at depotet er offentlig og at utgivelsen inneholder de riktige ZIP-elementene. Du kan sette rom.zip, rom_type_b.zip, og rom_y2.zip på samme utgivelse når de tilhører samme versjon.
  3. Rediger manifestet. Åpne slidia_manifest.xml i roten av din Updater CE-gaffel. Legg til én linje for hver modell utgivelsen støtter (Y1 og Y2 er det vanlige paret). Den repo verdien er depotets owner/repository; url er den offentlige prosjektsiden.
  4. Test katalogen. Kjør Updater fra den redigerte kassen. Velg Y1 og bekreft at prosjektet viser Y1 eiendeler. Velg Y2 og bekreft at det viser Y2-utgivelsen. Sjekk Type A og Type B separat når begge er publisert.
  5. Åpne en pull-forespørsel. Skyv manifestendringen til gaffelen din og åpne en pull-forespørsel mot oppstrøms Updater CE-lageret. Inkluder prosjektkoblingen, støttede modeller, utgivelsesmerke, ressursnavn og enhetene du testet.

Generer manifestlinjene dine

Fyll ut depotet og merk av for hver modell utgivelsen støtter. Generatoren skriver en <package> linje per modell og inkluderer kun attributtene du angir, slik at resultatet samsvarer med gjeldende slidia_manifest.xml format. Hvert attributt Updater CE leser er tilgjengelig nedenfor - de valgfrie er under Flere alternativer.

Det offentlige GitHub depotet. Generatoren trekker ut owner/repository fra URL-en.
Vist i appen og nettstedskatalogen.
Menneskevendt side for prosjektet eller dets utgivelsesnotater.
Fjern dette for å bruke modellens standardmerke. SR1, Q3, Q5 og Q3e er Timmkoo modeller.
Enheter (en linje hver)
For en modell som ikke er oppført ovenfor. Kjente modeller beholder stavemåten i katalogen.
Flagg

Keep Data tilbys kun når den innkommende fastvaren og den installerte fastvaren er den samme eller deler en derivative rot. Bruk flagget kun når brukerdata virkelig ikke kan overføres.

Flere alternativer: ikon, kunstverk, utgivelseselementer, etterinstallering og speil

Ikon og kunstverk

Velg bildet du vil forplikte til depotet. Dette forhåndsviser den og bygger dens rå URL; den laster ikke opp noe.
Banen til det forpliktede bildet, i forhold til depotroten.
En direkte bilde-URL. Når den er tom, bruker appen utgivelsens updater.png eller et generert ikon.

Valgfritt mørkt tema-ikon. image_dark er et akseptert alias.
Sekundært kunstverk, prøvd etter utgivelsesbildet og icon.

Frigjør eiendeler

Ett navn for hver valgt modell. La stå tomt for bruk rom.zip på Y1 og rom_<model>.zip andre steder.
Glob brukes når utgivelsens glidelåser ikke er navngitt rom*.zip.
Glob for Y1 Type A-pakken når navnet ikke sier det.
Glob for Y1 Type B-pakken når navnet ikke sier det.
Skjul oppføringen fra eldre Updater CE-bygg.

Lenker, speil og Keep Data-familie

Åpnet etter vellykket installasjon.
Valgfritt andre trinn for en flersidig oppsettveiledning.
Kommaseparert *-mirror repositories som bygger Portable Flashing Zip-pakker.
Fastvaren denne utgivelsen er bygget fra. Relaterte fastvare deler en datapartisjon, som er det Keep Data sjekker.
App-repo hvis utgivelser beskriver appene i denne fastvaren. Den trenger også en side etter installasjon.
App-repo hvis APK appen laster ned og installerer etter fastvaren.

Katalog ekstrautstyr

Stabil identifikator for koblinger og lagrede installasjonsposter. Modellen legges til automatisk når flere modeller velges.
<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" />

Laster det siste manifestet …

Én linje er ikke nok for et delt depot. Hvis Y2-linjen mangler, vil ikke Y2-brukere få en modelltilpasset oppføring selv når rom_y2.zip finnes i prosjektets utgivelse. Det samme gjelder for alle andre modeller utgivelsen din støtter.

Hvert attributt manifestet leser

Dette er attributtene som nåværende Updater CE-bygg forstår. Generatoren skriver kun de du fyller inn; appen faller tilbake til fornuftige standardverdier for resten.

slidia_manifest.xml-pakkeattributter og deres betydning
AttributtTrengsHva den gjør
nameJaProgramvarenavn vist i katalogen og på installasjonskort.
repoJaowner/repo. Appen leser det depotets GitHub utgivelser.
deviceJaMålmodell, store bokstaver (Y1, Y2, G1, Q3e, …). Behold én oppføring per modell.
urlAnbefaltProsjektside eller utgivelsesnotater åpnet fra katalogen.
type, handlerJa i praksistype="img" og handler="Custom Firmware". Andre typer og ikke-fastvarebehandlere hoppes over.
brandValgfrittKatalog merke (Innioasis, Timmkoo). Empty bruker modellens standardmerke.
package_nameValgfrittFrigi filnavnet på ressursen. Standard til rom.zip på Y1 og rom_<model>.zip på andre modeller.
asset_patternValgfrittGlob som ikke skiller mellom store og små bokstaver for utgivelser hvis fastvare-zips ikke er navngitt rom*.zip (for eksempel my-firmware-*.zip).
type_a_asset, type_b_assetValgfrittGlobs som identifiserer zip-ene Y1 Type A og Type B når filnavnene deres ikke inneholder de vanlige markørene.
iconValgfrittLogo URL. Brukt etter utgivelsens egen updater.png / updater.jpg, og som reserve for hver utgivelse.
icon_darkValgfrittLogo med mørkt tema. image_dark er et akseptert alias.
imageValgfrittSekundært lys kunstverk, prøvd etter icon.
post_install, post_install2ValgfrittSiden(er) åpnet etter vellykket installasjon. Den andre dekker en flertrinnsguide.
portable_zipsValgfrittKommaseparert *-mirror repos som publiserer klare til å kjøre bærbare pakker.
derivativeValgfrittRepository firmwaren er bygget fra. Fastvare med samme avledede rot kan beholde brukerdata.
info_repoValgfrittApplager hvis utgivelser beskriver hva fastvaren distribuerer. Krever post_install eller post_install2.
apk_repoValgfrittApplager hvis APK appen installeres etter fastvaren.
min_versionValgfrittSkjul oppføringen når Updater CE er eldre enn denne versjonen.
do_not_keep_dataValgfritttrue (også 1 / yes) blokkerer Behold data fullstendig for denne fastvaren.
slugValgfrittStabil identifikator for koblinger og lagrede installasjonsposter. Generert fra navnet og modellen når den er tom.
descriptionValgfrittKort katalogbeskrivelse. Det kan være attributtverdien eller elementets tekst.

Eldre navn leses fortsatt for kompatibilitet: model, package, portable_zip, post_install_2, min_app_version og image_dark. Nye oppføringer bør bruke de gjeldende navnene ovenfor.

Send inn linjene som en pull-forespørsel

  1. Kopier de genererte linjene ovenfor. De samsvarer allerede med det nyeste manifestformatet.
  2. Rediger slidia_manifest.xml i depotet. Bruk redigeringslenken nedenfor; depotverten oppretter automatisk en gaffel og en gren for deg.
  3. Lim inn linjene rett før </slidia>, holde de eksisterende oppføringene uendret.
  4. Forplikte seg til en ny filial (for eksempel add-your-firmware), åpne deretter en pull-forespørsel mot Updater CE-depotet.
  5. I PR, inkluderer prosjektkoblingen, støttede modeller, utgivelsestag, aktivanavn og enhetene du testet.

Behold modellnavnene med store bokstaver, bruk den nøyaktige URL-en til det offentlige depotet ditt, og behold type="img" og handler="Custom Firmware" for en fastvareoppføring.

Gjør utgivelsen enkel å verifisere

Gi utgivelsen en tydelig kode og utgivelsesnotat. Taggen er nyttig for folk, men ZIP-aktivanavnene er det Updater CE bruker for å identifisere installasjonspakkene.

Slipp sjekkliste

  • Publiser utgivelsen offentlig.
  • Legg ved ZIP-filene som utgivelseselementer.
  • Oppgi den støttede modellen og Type A eller Type B i merknadene.
  • List opp eventuelle nødvendige forberedelser eller kjente grenser.

En utgivelse, tre eiendeler

En delt utgivelse kan inneholde rom.zip, rom_type_b.zip, og rom_y2.zip. Updater klassifiserer dem separat og velger fra modell- og maskinvarefiltre.

Ikke sett sammen gjetninger

Ikke inkluder en Y1-pakke under Y2-filnavnet, eller legg til ikke-testet scatter-, forhåndslaster- eller partisjonsdata bare for å få en ressurs til å vises.

Hvorfor modelloppføringene betyr noe under blinking

Manifestet er ikke bare en nedlastingsmeny. Etter utvinning bruker Updater CE den løste modellen for å klargjøre den matchende installasjonsbanen. Y1 og Y2 har forskjellige plattformfiler, forhåndslastere, spredningskonfigurasjon og enhetsoppsett.

Bidragsytere bør oppgi korrekte fastvarefiler, ikke flash-forskyvninger. Ikke rediger scatter-adresser, forhåndslastere, DA-filer eller partisjonskommandoer for å omgå en dårlig pakke. Fiks utgivelseselementet og test på den tiltenkte modellen.

Før du ber om en sammenslåing

  1. Valider XML med en XML-parser. Et manglende tilbud eller avslutning /> kan skjule hver oppføring etter den.
  2. Start oppdateringsprogrammet fra kassen slik at det laster det lokale manifestet før den eksterne oppdateringen.
  3. Sjekk Y1 og Y2 uavhengig. Bekreft at prosjektet bare vises der pakken støttes.
  4. Sjekk utgivelseslisten for rom.zip, rom_type_b.zip, og rom_y2.zip som aktuelt.
  5. Test selve installasjonen på den tiltenkte enheten, med en pålitelig USB datakabel og en gjenopprettingsplan for retur til original programvare.
  6. Forklar hva du testet i pull-forespørselen. Ikke beskriv en uprøvd modell som støttet.
python -c "from xml.etree import ElementTree as ET; ET.parse('slidia_manifest.xml'); print('manifest ok')"

For en lokal sjekk, kjør den kommandoen fra depotroten. Den verifiserer kun XML-syntaks; det beviser ikke at en utgivelse inneholder gyldig fastvare eller at en enhet er trygg å flashe.

Moddingsferdigheter for AI-agenter

Depotets skills/ katalogen er en kildebasert kunnskapsbase for agenter som jobber med Y1 og Y2 maskinvare, fastvare, temaer og apper. Hver ferdighet navngir prosjektfilene kravene kommer fra, slik at en agent kan sjekke et faktum før du endrer en enhet.

Maskinvare

Y1 maskinvare

MT6572, hjulet som nøkkelhendelser, 480x360 skjerm, FM/lydbaner, lagring og partisjonskartet Type A/B.

Maskinvare

Y2 maskinvare

MT6582-kort, enhetstre, GC9503V/ST7701S-paneler, PMIC/DAC-skinner, partisjoner og oppstartsbildet.

Fastvare

Firmware-pakker

rom.zip anatomi, scatter-filer, klasse A-oppdateringskontrakter og utgivelsessjekklisten.

Temaer

Tema- og hudforfatting

Y1 config.json-temaer, Rockbox WPS/SBS, Reborn skins og Y2Player skin format v2.

Alle ferdigheter

Bla gjennom ferdighetsmappen

Rockbox Y1/Y2, lager Android-ROM, Y2Linux, Android-apper, lanseringer, utgivelsesnotater og nettstedspublisering.