Siirry sisältöön

Laiteohjelmistokehittäjille

Lisää laiteohjelmisto Updater CE:hen.

Updater CE on mukautetun laiteohjelmiston yhteisön luettelo ja asennusohjelma. Kehitä projektisi alustasta ROM, julkaise se julkisena tietovarastona oikeilla julkaisuresursseilla, lisää mallimerkinnät slidia_manifest.xml, testaa mallisuodattimet ja avaa vetopyyntö. Yksi arkisto voi palvella jokaista tukemaansa mallia.

Aloita alustasta ROM

PerusROM-levyt antavat mukautetuille laiteohjelmistokehittäjille puhtaan Android-perustan langattoman radiosirun ollessa käytössä. Y1:ssa ne mahdollistavat Wi-Fi:n ja GPS:n tehtaan Bluetoothin ja FM:n rinnalla; Y2:ssa ne mahdollistavat Wi-Fin, GPS:n ja FM:n tehdas Bluetoothin rinnalla.

Peruslataukset ROM mukautetun laiteohjelmiston kehittämiseen, joissa Android-versio ja langattomat ominaisuudet ovat kukin mahdollistavat
LataaLaiteAndroidLangattomat ominaisuudet
rom.zipY1 · Type AAndroid 4.2.2Lisää Wi-Fin ja GPS:n tehdasasetuksiin Bluetoothin ja FM:n kanssa (FM toimii jo tehtaalla Y1:ssa). Y1 pelaajille, joiden mukana toimitettiin OS 2.0.0 tai uudempi.
rom_type_b.zipY1 · Type BAndroid 4.2.2Lisää Wi-Fin ja GPS:n tehdasasetuksiin Bluetoothin ja FM:n kanssa (FM toimii jo tehtaalla Y1:ssa). Y1 pelaajille, joiden käyttöjärjestelmä on vanhempi kuin 2.0.0.
rom_y2.zipY2Android 4.4.2Lisää Wi-Fin, GPS:n ja FM:n tehtaan Bluetoothiin. Y2 radiosiru on täysin käytössä, joten FM on saatavilla myös täällä.

Nämä kuvat ovat Android-pohjaisia ​​(AOSP) -laitteita, joissa laitteen langattomat radiot ovat käytössä, joten mukautettu laiteohjelmisto voi lisätä verkkoominaisuuksia radiopinon korvaamisen sijaan. Ne ovat käytännön lähtökohta alla oleville julkaisuvaiheille.

Käytä näitä julkaisukohteiden nimiä

Tiedostonimi on osa yhteensopivuussignaalia. Pidä nimet tarkasti ja laita ZIP-tiedostot projektin julkaisuresursseihin, ei vain arkiston lähdepuuhun.

Firmware ZIP-resurssien nimet ja tuetut laitteet
OmaisuusLaiteLaitteistoMerkitys
rom.zipY1Type AY1 laitteita, joiden mukana toimitettiin OS 2.0.0 tai uudempi.
rom_type_b.zipY1Type BY1 laitteita, joiden käyttöjärjestelmä on vanhempi kuin 2.0.0.
rom_y2.zipY2Y2Täysi asennuspaketti Y2. Pidä se erillään Y1 sisällöstä.
Älä nimeä pakettia uudelleen, jotta se sopisi toiseen malliin. Y1 ja Y2 käyttävät erilaisia ​​MediaTek alustatiedostoja ja vilkkuvia määrityksiä. Julkaise paketti sille laitteistolle, jota se todella tukee.

Miten yhteys toimii

Updater CE lukee manifestin luettelokseen. Jokainen <package> rivi kertoo projektin nimen, arkiston, mallin ja käsittelijän. Kun käyttäjä valitsee kyseisen projektin, Updater tarkistaa arkiston julkaistut julkaisut ja etsii a rom*.zip omaisuus.

Selvä

Nimeää projektin ja kartoittaa sen malliksi. Y1 ja Y2 tarvitsevat erilliset rivit, vaikka niillä olisi yhteinen tietovarasto.

Julkaistu julkaisu

Sisältää asennettavat ZIP-materiaalit. Yksi julkaisu voi sisältää paketit Y1 Type A, Y1 Type B ja Y2 yhdessä.

Updater CE asennus

Käyttää valittua mallia valitsemaan vastaavan paketin ja mallikohtaisen vilkkupolun. Käyttäjän ei pitäisi joutua arvaamaan tiedostonimeä.

Julkaise projekti viidessä vaiheessa

  1. Haarukka Updater CE -arkisto. Luo oma haarukkasi ryan-specter/updater-ce-neo, kloonaa sitten haarukkasi paikallisesti.
  2. Valmistele julkinen laiteohjelmistovarasto. Varmista, että arkisto on julkinen ja että sen julkaisu sisältää oikeat ZIP-sisällöt. Voit laittaa rom.zip, rom_type_b.zip, ja rom_y2.zip samassa julkaisussa, kun ne kuuluvat samaan versioon.
  3. Muokkaa luetteloa. Avaa slidia_manifest.xml Updater CE -haarukan juuressa. Lisää yksi rivi jokaiselle mallille, jota julkaisu tukee (Y1 ja Y2 ovat yhteinen pari). The repo arvo on arkiston owner/repository; url on projektin julkinen sivu.
  4. Testaa luetteloa. Suorita Updater muokatusta kassalta. Valitse Y1 ja vahvista, että projekti näyttää Y1 resurssit. Valitse Y2 ja vahvista, että se näyttää Y2-vapautuksen. Tarkista Type A ja Type B erikseen, kun molemmat on julkaistu.
  5. Avaa vetopyyntö. Työnnä luettelomuutos haarukkaan ja avaa vetopyyntö ylävirran Updater CE -tietovarastoa vastaan. Liitä mukaan projektilinkki, tuetut mallit, julkaisutunniste, resurssien nimet ja testaamasi laitteet.

Luo manifestirivit

Täytä arkisto ja valitse jokainen malli, jota julkaisu tukee. Generaattori kirjoittaa yhden <package> riviä mallia kohti ja sisältää vain asettamasi attribuutit, joten tulos vastaa nykyistä slidia_manifest.xml muoto. Jokainen Updater CE:n lukema attribuutti on saatavilla alla – valinnaiset ovat alla Lisää vaihtoehtoja.

Julkinen GitHub arkisto. Generaattori purkaa owner/repository URL-osoitteesta.
Näkyy sovelluksessa ja sivustoluettelossa.
Ihmisille suunnattu sivu projektille tai sen julkaisutiedotteille.
Poista tämä, jos haluat käyttää mallin oletusmerkkiä. SR1, Q3, Q5 ja Q3e ovat Timmkoo malleja.
Laitteet (yksi rivi kukin)
Mallille, jota ei ole mainittu yllä. Tunnetut mallit säilyttävät luettelonsa oikeinkirjoituksen.
Liput

Keep Data on tarjolla vain, kun saapuva laiteohjelmisto ja asennettu laiteohjelmisto ovat samat tai jakavat a derivative juuri. Käytä lippua vain, kun käyttäjätietoja ei todellakaan voi siirtää.

Lisää vaihtoehtoja: kuvake, kuvitus, julkaisumateriaali, asennuksen jälkeen ja peilit

Ikoni ja taideteos

Valitse kuva, jonka siirrät arkistoon. Tämä esikatselee sitä ja muodostaa sen raaka-URL-osoitteen; se ei lataa mitään.
Polku sitoutuneeseen kuvaan suhteessa arkiston juureen.
Suora kuvan URL-osoite. Kun sovellus on tyhjä, se käyttää julkaisua updater.png tai luotu kuvake.

Valinnainen tumman teeman kuvake. image_dark on hyväksytty alias.
Toissijainen taideteos, kokeiltu julkaisun jälkeen kuva ja icon.

Vapauta omaisuus

Yksi nimi jokaiselle valitulle mallille. Jätä tyhjäksi käytettäväksi rom.zip Y1 ja rom_<model>.zip muualla.
Globia käytetään, kun julkaisun vetoketjuja ei ole nimetty rom*.zip.
Globaali paketille Y1 Type A, kun sen nimi ei sano niin.
Globaali paketille Y1 Type B, kun sen nimi ei sano niin.
Piilota merkintä vanhemmista Updater CE -versioista.

Linkit, peilit ja Keep Data -perhe

Avattu onnistuneen asennuksen jälkeen.
Valinnainen toinen vaihe monisivuiselle asennusoppaalle.
Pilkuilla erotettuna *-mirror arkistot, jotka rakentavat kannettavia Flashing Zip -paketteja.
Laiteohjelmisto, josta tämä julkaisu on rakennettu. Aiheeseen liittyvät laiteohjelmistot jakavat tietoosion, jonka Keep Data tarkistaa.
Sovellusvarasto, jonka julkaisut kuvaavat tämän laiteohjelmiston sovelluksia. Se tarvitsee myös asennuksen jälkeisen sivun.
Sovellusrepo, jonka APK sovellus lataa ja asentaa laiteohjelmiston jälkeen.

Katalogin lisäosat

Linkkien ja tallennettujen asennustietueiden vakaa tunniste. Malli liitetään automaattisesti, kun useita malleja valitaan.
<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" />

Ladataan viimeisintä luetteloa…

Yksi rivi ei riitä jaettuun arkistoon. Jos rivi Y2 puuttuu, Y2-käyttäjät eivät saa mallivastaavaa merkintää, vaikka rom_y2.zip on olemassa projektin julkaisussa. Sama pätee kaikkiin muihin julkaisusi tukemiin malleihin.

Jokainen luettelon attribuutti lukee

Nämä ovat attribuutit, jotka nykyiset Updater CE:n koontiversiot ymmärtävät. Generaattori kirjoittaa vain ne, jotka täytät; sovellus palaa järkeviin oletusasetuksiin muilta osin.

slidia_manifest.xml-paketin attribuutit ja niiden merkitys
AttribuuttiTarvitaanMitä se tekee
nameKylläOhjelmiston nimi luettelossa ja asennuskorteissa.
repoKylläowner/repo. Sovellus lukee kyseisen arkiston GitHub julkaisut.
deviceKylläKohdemalli, isot kirjaimet (Y1, Y2, G1, Q3e, …). Säilytä yksi merkintä mallia kohti.
urlSuositeltavaProjektisivu tai julkaisutiedot avattu luettelosta.
type, handlerKyllä käytännössätype="img" ja handler="Custom Firmware". Muut tyypit ja muut kuin laiteohjelmiston käsittelijät ohitetaan.
brandValinnainenTuotemerkki (Innioasis, Timmkoo). Tyhjä käyttää mallin oletusmerkkiä.
package_nameValinnainenVapauta sisällön tiedostonimi. Oletuksena rom.zip Y1 ja rom_<model>.zip muissa malleissa.
asset_patternValinnainenKirjainkoolla ei ole merkitystä julkaisuille, joiden laiteohjelmiston zip-tiedostoja ei ole nimetty rom*.zip (esimerkiksi my-firmware-*.zip).
type_a_asset, type_b_assetValinnainenMaapallot, jotka tunnistavat Y1 Type A ja Type B zipsin, kun niiden tiedostonimet eivät sisällä tavallisia merkkejä.
iconValinnainenLogon URL-osoite. Käytetty oman julkaisun jälkeen updater.png / updater.jpg, ja jokaisen julkaisun varavaihtoehtona.
icon_darkValinnainenTumman teeman logo. image_dark on hyväksytty alias.
imageValinnainenToissijainen valotaide, kokeiltu jälkeenpäin icon.
post_install, post_install2ValinnainenSivu(t) avattu onnistuneen asennuksen jälkeen. Toinen kattaa monivaiheisen oppaan.
portable_zipsValinnainenPilkuilla erotettuna *-mirror repot, jotka julkaisevat valmiita kannettavia paketteja.
derivativeValinnainenArkisto, josta laiteohjelmisto on rakennettu. Laiteohjelmisto, jolla on sama johdannaisjuuri, voi säilyttää käyttäjätiedot.
info_repoValinnainenSovellusarkisto, jonka julkaisut kuvaavat, mitä laiteohjelmisto ottaa käyttöön. Vaatii post_install tai post_install2.
apk_repoValinnainenSovellusarkisto, jonka APK sovellus asentaa laiteohjelmiston jälkeen.
min_versionValinnainenPiilota merkintä, kun Updater CE on tätä versiota vanhempi.
do_not_keep_dataValinnainentrue (myös 1 / yes) estää tämän laiteohjelmiston tietojen säilyttämisen kokonaan.
slugValinnainenLinkkien ja tallennettujen asennustietueiden vakaa tunniste. Luodaan nimestä ja mallista tyhjänä.
descriptionValinnainenLyhyt luettelokuvaus. Se voi olla attribuutin arvo tai elementin teksti.

Vanhat nimet luetaan edelleen yhteensopivuuden vuoksi: model, package, portable_zip, post_install_2, min_app_version ja image_dark. Uusien merkintöjen tulee käyttää yllä olevia nykyisiä nimiä.

Lähetä rivit vetopyyntönä

  1. Kopioi yllä luodut rivit. Ne vastaavat jo viimeisintä luettelomuotoa.
  2. Muokkaa slidia_manifest.xml arkistossa. Käytä alla olevaa muokkauslinkkiä; arkiston isäntä luo haarukan ja haaran sinulle automaattisesti.
  3. Liitä rivit juuri ennen </slidia>, pitää nykyiset merkinnät ennallaan.
  4. Sitoudu uuteen haaraan (esimerkiksi add-your-firmware), avaa sitten noutopyyntö Updater CE -tietovarastoa vastaan.
  5. Sisällytä PR:ään projektilinkki, tuetut mallit, julkaisutunniste, resurssien nimet ja testaamasi laitteet.

Pidä mallien nimet isoilla kirjaimilla, käytä julkisen arkistosi tarkkaa URL-osoitetta ja säilytä type="img" ja handler="Custom Firmware" laiteohjelmiston merkintää varten.

Tee julkaisusta helppo tarkistaa

Anna julkaisulle selkeä tunniste ja julkaisuilmoitus. Tunniste on hyödyllinen ihmisille, mutta ZIP-resurssien nimiä Updater CE käyttää asennuspakettien tunnistamiseen.

Vapauta tarkistuslista

  • Julkaise julkaisu julkisesti.
  • Liitä ZIP-tiedostot julkaisuresursseina.
  • Ilmoita tuettu malli ja Type A tai Type B huomautuksissa.
  • Luettele kaikki vaaditut valmisteet tai tunnetut rajat.

Yksi julkaisu, kolme omaisuutta

Jaettu julkaisu voi sisältää rom.zip, rom_type_b.zip, ja rom_y2.zip. Updater luokittelee ne erikseen ja valitsee malli- ja laitteistosuodattimista.

Älä niputa arvauksia

Älä sisällytä Y1-pakettia Y2-tiedostonimen alle tai lisää testaamattomia haja-, esilataus- tai osiotietoja vain saadaksesi resurssin näkyviin.

Miksi mallimerkinnöillä on merkitystä vilkkumisen aikana

Luettelo ei ole vain latausvalikko. Purkamisen jälkeen Updater CE käyttää ratkaistua mallia vastaavan asennuspolun valmistelemiseen. Y1:lla ja Y2:lla on erilaiset alustatiedostot, esilataajat, hajontakonfiguraatiot ja laiteasettelut.

Osallistujien tulee toimittaa oikeat laiteohjelmistotiedostot, ei flash-offsetit. Älä muokkaa haja-osoitteita, esilataajia, DA-tiedostoja tai osiokomentoja kiertääksesi huonon paketin. Korjaa vapautusväline ja testaa aiotulla mallilla.

Ennen kuin pyydät yhdistämistä

  1. Vahvista XML XML-jäsentimillä. Puuttuva lainaus tai sulkeminen /> voi piilottaa jokaisen merkinnän sen jälkeen.
  2. Käynnistä päivitysohjelma kassalta, jotta se lataa paikallisen luettelon ennen etäpäivitystä.
  3. Tarkista Y1 ja Y2 erikseen. Varmista, että projekti näkyy vain siellä, missä sen pakettia tuetaan.
  4. Tarkista julkaisuluettelo rom.zip, rom_type_b.zip, ja rom_y2.zip soveltuvin osin.
  5. Testaa varsinaista asennusta tarkoitetulle laitteelle luotettavalla USB-datakaapelilla ja palautussuunnitelmalla alkuperäiseen ohjelmistoon paluuta varten.
  6. Selitä vetopyynnössä, mitä testasit. Älä kuvaile testaamatonta mallia tuetuksi.
python -c "from xml.etree import ElementTree as ET; ET.parse('slidia_manifest.xml'); print('manifest ok')"

Paikallista tarkistusta varten suorita kyseinen komento arkiston juuresta. Se vahvistaa vain XML-syntaksin; se ei todista, että julkaisu sisältää kelvollisen laiteohjelmiston tai että laite on turvallinen flash-muistiin.

Tekoälyagenttien taitojen muokkaaminen

Arkiston skills/ hakemisto on lähdepohjainen tietokanta agenteille, jotka työskentelevät Y1- ja Y2-laitteistojen, laiteohjelmistojen, teemojen ja sovellusten parissa. Jokainen taito nimeää projektitiedostot, joista sen väitteet tulevat, joten agentti voi tarkistaa tosiasian ennen laitteen vaihtamista.

Laitteisto

Y1 laitteisto

MT6572, pyörä keskeisinä tapahtumina, 480 x 360 näyttö, FM/äänipolut, tallennustila ja Type A/B-osiokartta.

Laitteisto

Y2 laitteisto

MT6582-kortti, laitepuu, GC9503V/ST7701S-paneelit, PMIC/DAC-kiskot, osiot ja käynnistyskuva.

Laiteohjelmisto

Laiteohjelmistopaketit

rom.zip anatomia, scatter-tiedostot, luokan A päivityssopimukset ja julkaisun tarkistuslista.

Kaikki taidot

Selaa osaamiskansiota

Rockbox Y1/Y2, varastossa olevat Android-ROM-levyt, Y2Linux, Android-sovellukset, käynnistysohjelmat, julkaisutiedot ja sivuston julkaisu.