Juttasd el a kereskedőkhöz
Hogyan jut el az appod a kereskedőkhöz. Közzététel, független felülvizsgálat, telepítés, mit látnak a kereskedők, frissítések és verziózás, költségek és a partnerprogram.
Ezen az oldalon
Minden app ugyanazon az úton jut el egy boltba: közzéteszel egy release-t, a Poltura egy olyan munkatársa vizsgálja felül, aki nem a te csapatod tagja, a kereskedő pedig jóváhagyja az igényelt jogosultságokat. Mindkét lépés nélkül semmi sem kerülhet be egy boltba.
| Lépés | Ki | Hol | Mi történik |
|---|---|---|---|
| Build és ellenőrzés | Te | A saját géped | A poltura app build és a poltura app validate becsomagolja a workereket és ellenőrzi a manifestet |
| Közzététel | Te | poltura app publish | A release feltöltődik, és felülvizsgálatra vár |
| Felülvizsgálat | A Poltura felülvizsgálója | A felülvizsgálati sor az adminfelületen | A felülvizsgáló átnézi a jogosultságokat, az URL-eket és a kódot, majd jóváhagyja, elutasítja vagy módosításokat kér |
| Telepítés | Egy kereskedő | A kapcsolódási címed, majd a Poltura jogosultságkérő képernyője | A kereskedő jóváhagyja a jogosultságokat, és az app megjelenik az adminfelületén és a boltjában |
| Frissítés | Te, majd az egyes kereskedők | Ugyanezek a lépések | Az új release átmegy a felülvizsgálaton; a boltok akkor váltanak rá, amikor a kereskedő jóváhagyja |
Az első release előtt
A Poltura adminfelületén nyisd meg a Fejlesztői alkalmazások menüpontot (előtte kapcsold be a Fejlesztői mód opciót a felhasználói menüben):
- Hozz létre egy szervezetet. A release-ek ehhez tartoznak, a tagjai pedig tulajdonosok, közzétevők vagy tagok lehetnek.
- Hozz létre egy appot. Az Azonosító értékének meg kell egyeznie a
poltura.app.jsonfájlban szereplőhandlemezővel; ezt később nem lehet módosítani. - Hozz létre egy fejlesztői tokent a CLI számára a Fejlesztői tokenek alatt. Ez vagy
pltd_előtaggal kezdődik (a szervezet tulajdonában van, CI-hez), vagypltu_előtaggal (csak a tiéd).
Az Építsd meg az első appodat útmutató lépésről lépésre végigvezet az egészen.
Közzététel
poltura app publish --api "$POLTURA_API" --app <app id> --token "$POLTURA_APP_TOKEN"A POLTURA_API a Poltura API originje (lásd a megjegyzést a Hitelesítés oldalon). A parancs buildeli az appot, feltölti a release manifestjét, a workereket és a stylesheeteket, majd kiírja a release azonosítóját (release id).
A release-ek a production csatornára kerülnek, hacsak nem adod meg a --channel development kapcsolót. A development release-eket ugyanúgy felülvizsgálják, de soha nem telepíthetők – így biztonságos módon kaphatsz korai visszajelzést a felülvizsgálótól.
Minden beállítást megtalálsz a CLI oldalon.
Felülvizsgálat
A Poltura reviewere minden egyes release-t külön hagy jóvá. A szervezetedből senki sem vizsgálhatja felül az appodat, és az sem hagyhatja jóvá a release-t, aki beküldte.
A felülvizsgáló látja a jogosultságokat a megadott célokkal, a backendOrigin értékét, a hosztolt oldal címét és bridge műveleteit, az átirányítási URL-eket, a webhook topicokat, az összes workert a céljával és méretével együtt, valamint a stylesheetet. Egy release az alábbi állapotokon megy keresztül:
| Állapot | Jelentés |
|---|---|
submitted | Felülvizsgálóra vár |
in_review | Egy felülvizsgáló elkezdte az ellenőrzést |
changes_requested | Javítsd a felülvizsgáló által jelzett hibákat, és tegyél közzé új release-t |
approved | A kereskedők telepíthetik (csak a production csatornán) |
rejected | Nem lesz telepíthető |
Egy appnak egyszerre egy release-e lehet felülvizsgálat alatt; a Fejlesztői alkalmazások alatt követheted az egyes release-ek állapotát. Így gyorsíthatod meg a felülvizsgálatot:
- Csak olyan jogosultságokat kérj, amelyeket az app ténylegesen használ, és a célt a kereskedő számára is érthetően fogalmazd meg.
- A
supportUrlés aprivacyUrlvalós oldalakra mutasson. Az adatvédelmi tájékoztatónak ki kell térnie arra, milyen adatokat tárolsz a boltról és mennyi ideig. - A
backendOrigin, az átirányítási URL-ek és a webhookok célállomásai mind általad felügyelt domaineken legyenek.
Telepítés
A kereskedők a kapcsolódási címedről telepítik az appodat: ez a szervereden az a route, amely elindítja a kapcsolatot (lásd: Hitelesítés). Erre mutató hivatkozást elhelyezhetsz a weboldaladon, az onboarding e-mailjeidben vagy a hosztolt oldaladon. A kereskedő bejelentkezik a Polturába, látja az „Az appod csatlakozni szeretne” képernyőt a bolt nevével, a release verziójával és az indoklással ellátott összes jogosultsággal, majd a Jóváhagyás vagy az Elutasítás gombra kattint.
Tervezzük a külső appok listázását a Poltura Alkalmazásboltban. Amíg ez el nem készül, a kereskedők a kapcsolódási címen keresztül érik el a telepítést.
Mit látnak a kereskedők
A telepítés után:
- A Telepített alkalmazások (a Kapcsolt alkalmazások alatt) listázza az appodat az állapotával, a verziójával és a kereskedő által megadott jogosultságokkal együtt. Az Alkalmazás megnyitása megnyitja, az Eltávolítás pedig eltávolítja.
- Az adminfelületi oldalaid az Alkalmazások menüpont alatt jelennek meg a navigációban, a paneljeid pedig a termék-, gyűjtemény-, rendelés- és vásárlói oldalakon. Az adminfelület kezdőlapján egy home card is helyet kap.
- A webáruházi blokkjaid megjelennek a témaszerkesztő blokkválasztójában a
defineBlockdefinícióban megadott névvel, ikonnal és kategóriával, és amint a kereskedő elhelyezi őket, renderelődnek. A webáruházi oldalak a/apps/<slug>címen érhetők el élesben. - Minden a Poltura saját komponenseivel jelenik meg, az adminfelület vagy a bolt stílusához igazodva, így az app a termék szerves részeként hat.
Frissítések és verziózás
- A
releaseVersiona release-ed címkéje. Használj minden alkalommal újat; a felülvizsgálók és a kereskedők ezt látják a jogosultságkérő képernyőn. - Amikor egy production release-t jóváhagynak, az új telepítések már ezt a verziót kapják.
- Az appodat már használó boltok mindaddig a korábban jóváhagyott release-t használják, amíg a kereskedő jóvá nem hagyja az újat. Amikor ez megtörténik, a telepítés
generationszáma növekszik, a korábban kiadott hozzáférési tokenek érvénytelenné válnak, te pedig megkapod azapp.updatedwebhookot. Csak olyan release-ben kérj új jogosultságokat, amelyik valóban igényli őket: mindegyik új jóváhagyással jár. - A szerverednek minden olyan release-t ki kell szolgálnia, amely még fut a boltokban. Ügyelj a visszamenőleges kompatibilitásra, vagy ellenőrizd az
installation.retrieve().releaseIdmezőt, mielőtt újabb funkciót használnál. - Egy worker, a hozzá tartozó CSS vagy a manifest módosításához mindig új release-re van szükség. A szervered, a hosztolt oldalaid és a műveleti endpointjaid mögötti logika viszont azonnal módosul, amint deployolod.
A Poltura felfüggeszthet egy appot, és visszavonhat egy release-t vagy egy egész appot. A felfüggesztett app telepítései a felfüggesztés feloldásáig nem működnek; a visszavont appok kikapcsolva maradnak.
Költségek
Egy ingyenes app közzététele semmibe sem kerül: nincs se listázási díj, se jutalék. Fizetős appokat nem kínálunk: a Polturán jelenleg nincs app-számlázás, nincs bevételmegosztás és nincsenek fejlesztői kifizetések. Ha ez változik, a partnerszerződésben és ezen az oldalon is jelezni fogjuk, mielőtt bárkinek bármit felszámítanánk.
A partnerprogram
Az app- és témafejlesztők a Poltura partnerprogram egyik kiemelt területét alkotják. Az app-platform most nyílik meg a külső fejlesztők előtt: ott tudsz jelentkezni korai hozzáférésért. Az alapító partnerek közvetlen kapcsolatot kapnak a Poltura készítőivel, beleszólhatnak a fejlesztési irányokba, és már a hivatalos megjelenés előtt kipróbálhatják az új funkciókat. A fejlesztői kérdésekre a Poltura Discord-csatornáján válaszolunk.
Következő lépések
- Közzététel, felülvizsgálat, telepítés: az adminfelületi route-ok, a release csatornák és a telepítési állapotok részletesen.
- Példák: három példa-app a kiinduláshoz.