Siirry sisältöön
Tarkistettu

Versiointi

Lisäosan versio on pelkkä merkkijonovertailu katalogidokumentin ja projektiin asennetun version välillä. Semver-aluevertailua ei ole.

Lisäosan versio on kahdessa paikassa: doc.version katalogidokumentissa (viimeksi ladattu versio) ja app_plugins_purchased[plugin_name].version jokaisessa sen asentaneessa projektissa (versio, joka projektissa todella on). Mikään ei pidä näitä automaattisesti synkronoituna.

Mistä versio tulee

upload_plugin asettaa doc.version-arvon eri tavoin sen mukaan, missä paketti sijaitsee:

  • npm-pakettilähde: versio luetaan suoraan rekisteristä funktiolla getPackageManifest(plugin_name), eli se on se, minkä npm version tuotti, kun tekijä viimeksi ajoi npm publish. Jokaisen ensimmäisen osapuolen lisäosan package.json-tiedostossa on tätä varten pub-skripti: npm version patch --force && npm publish --access public.
  • xuda_hosted-pakettilähde (npm-julkaisua ei tarvita, työkopio pakataan ja isännöidään alustalla itsellään): doc.version on se, mikä pyynnössä lähetettiin, tai 0.1.0, jos mitään ei lähetetty.

install_plugin kopioi doc.version-arvon projektin app_plugins_purchased-merkintään asennushetkellä. Myöhempi upload_plugin, joka nostaa katalogidokumentin versiota, ei koske projekteihin, jotka ovat jo asentaneet aiemman version. Ne pitävät asentamansa version, kunnes jokin asentaa uuden sen päälle.

Miten vanhentunut asennus tuodaan esiin

Automaattista päivitystä ei ole. On vain visuaalinen vertailu: lisäosakortin versiomerkki vertaa arvoa app_plugins_purchased[plugin_name].version (asennettu) katalogidokumentin arvoon version (uusin) ja näyttää asennetun numeron vihreänä, kun ne täsmäävät, ja keltaisena, kun ne eivät täsmää. Mikään ei pakota uudelleenasennukseen. Uudemman version tuo mukanaan se, että omistaja (tai asentaja) ajaa install_plugin-metodin uudelleen samassa projektissa, samalla kutsulla kuin ensimmäisessä asennuksessa.

Omistamasi lisäosan päivittäminen

Hallintapaneelin Päivitä AI:lla -painike, joka näkyy lisäosan kortissa sen omistajalle, ei nosta versiota itse. Se avaa Kysy AI:lta -avustajan valmiiksi täytettynä: metadata: { plugin_action: 'modify', plugin_name, widget_type: plugin.plugin_type } sekä lisäosan nimeävä kehote (updateWithAi() tiedostossa Tab_plugins.vue). Tämä ohjaa AI-lisäosarakentajaa (ai_module.create_plugin_via_ai, sama generaattori, jota utils/create_plugin_via_ai.mjs kutsuu suoraan) muokkaamaan lisäosan koodia ja lataamaan sen uudelleen. Juuri tämä lataus nostaa doc.version-arvoa.

Koodi- tai npm-päivitys ei koskaan palaa tarkistukseen

upload_plugin käsittelee jokaisen päivityksen, jossa visibility on jo 'private' tai skip_publish_review on asetettu, yksityisenä koodimuutoksena: se kuljettaa lisäosan nykyisen visibility- ja publish_stat-arvon koskemattomina eteenpäin sen sijaan, että lähettäisi sen uudelleen marketplace-tarkistukseen. Siirtyminen yksityisestä julkiseen tapahtuu vain publish_plugin-metodilla, joka on erillinen, nimenomainen toiminto. Katso julkaiseminen.