Példák
Példaappok és egy témaszekció kiindulópontnak: mit mutat be mindegyik, és hogyan futtathatod őket.
Ezen az oldalon
A példák még nincsenek fent a GitHubon. Addig is minden oldal, amely használja őket, teljes egészében tartalmazza a kódjukat.
Kezdd itt
| Példa | Mit mutat be | Olvasd hozzá |
|---|---|---|
Parcel helper (examples/native-widgets) | Két natív adminfelületi panel a rendeléseknél és termékeknél, amelyek aláírt műveletekkel hívják az app szerverét. Nincs OAuth. | Manifest, Aláírt műveletek |
Catalog glance (examples/hosted-app) | A /connect route, egy hosztolt adminfelületi oldal, session tokenek, App API-hívások és token refresh | Hitelesítés |
USP strip (examples/theme-section) | Egy témaszekció child blockokkal, egy kiinduló presettel és magyar feliratokkal | Témaszekció építése |
Mindegyikhez tartozik egy README a fájljaival, a beolvasott környezeti változókkal és a futtatási parancsokkal. Egyik sem tartalmaz titkos adatot: a kulcsok, azonosítók és címek a környezetből érkeznek.
A teljes példa
A Recommendations by Poltura Labs (packages/app-sdk/examples/complete-app) egyszerre használja a platform szinte egészét: öt natív workert az adminfelületen és a webáruházban, adminfelületi és webáruházi oldalakat, műveleteket, webhookokat, app storage-ot, a csatlakozási route-okat és a session-ellenőrzést, tesztekkel együtt. A példaapp-útmutató fájlról fájlra végigmegy rajta.
Futtatásuk
Node.js 22 vagy újabb verzióra és a @poltura csomagokra lesz szükséged, amelyek még nincsenek fent az npm-en Még nincs npm-en. Ezután az egyik példa mappájában:
| Parancs | Mit csinál |
|---|---|
npm run build | Csomagolja a workereket, és kiírja a release-t a dist/ mappába |
npm run validate | Ugyanúgy ellenőrzi a release-t, mint a felülvizsgálati sor |
npm start | Elindítja a példa szerverét a 8787-es porton |
npx poltura app publish --api "$POLTURA_API" --app <app id> | Közzétesz egy release-t felülvizsgálatra |
A CLI tesztcsomagja mindkét példaappot buildeli, és a szervereiket a Poltura egy helyettesítőjéhez csatlakoztatva futtatja, így a platform változásai során is működőképesek maradnak. A témaszekció átmegy a poltura theme check vizsgálaton az alapértelmezett témán.
Ha inkább új appot kezdenél, a poltura app create my-app parancs létrehoz egy natív projektet, a --template hosted pedig hozzáad egy szervert a csatlakozási route-okkal. Lásd: Készítsd el az első appodat.
Következő lépések
- Eljuttatás a kereskedőknek: a működő példától a telepített appig.
- CLI: az összes parancs és opció.