Aloittaminen Vite on Esadax
Esadax tukee Vite-projektien käyttöönottoa suoraan koodieditoristasi. Tämä opas kattaa Viten käytön perusteet Esadaxin kanssa.
Vite-yhteisön lisäosien käyttäminen
Vite-yhteisön laajennukset voivat yksinkertaistaa kehitysprosessia ja tarjota lisäominaisuuksia projektillesi. Joitakin suosittuja laajennuksia ovat:
vite-plugin-esadax: Tarjoaa yksinkertainen tapa ottaa käyttöön Vite app Esadax.vite-plugin-ssr: Ottaa käyttöön palvelinpuolen renderöinnin (SSR) Vite-sovelluksellesi.
Ympäristömuuttujat
Esadax tarjoaa ympäristömuuttujia, joita voit käyttää Vite-projektissasi. Nämä muuttujat ovat käytettävissä rakentamisen aikana, ja niitä voidaan käyttää process.env-objektin avulla.
Edge-toiminnot
Edge-toimintojen avulla voit suorittaa koodia lähempänä käyttäjiä, mikä vähentää viivettä ja parantaa suorituskykyä. Jos haluat luoda Edge-toiminnon, luo projektisi api-hakemistoon uusi tiedosto, jonka tunniste on .ts tai .js.
// api/handler.ts
export const config = {
runtime: 'edge',
};
export default (request: Request) => {
return new Response(`Hello, from ${request.url} I'm now an Edge Function!`);
};
Palvelimettomat toiminnot (englanniksi)
Serverless Functions skaalautuu ylös- ja alaspäin liikenteen vaatimusten mukaan. Jos haluat luoda Serverless Functionin, luo projektisi api-hakemistoon uusi tiedosto, jonka tunniste on .ts tai .js.
// api/handler.ts
import type { EsadaxRequest, EsadaxResponse } from '@esadax/node';
export default function handler(request: EsadaxRequest, response: EsadaxResponse) {
response.status(200).json({
body: request.body,
query: request.query,
cookies: request.cookies,
});
}
Palvelinpuolen renderöinti (SSR)
Server-Side Rendering mahdollistaa sivujen dynaamisen renderöinnin palvelimella. Ota SSR käyttöön käyttämällä Vite-yhteisön laajennusta, kuten vite-plugin-ssr.
Käyttämällä Vite tehdä SPAs
Jos Vite-sovellus on määritetty käytettäväksi Single Page Application (SPA) -sovelluksena, syvälinkitys ei toimi heti käyttöönoton jälkeen. Voit ottaa syvälinkityksen käyttöön SPA Vite -sovelluksissa luomalla esadax.json-tiedoston projektisi juureen ja lisäämällä seuraavan koodin:
{
"rewrites": [
{
"source": "/(.*)",
"destination": "/index.html"
}
]
}
Katso lisää etuja
Esadax tarjoaa Vite-projekteille useita etuja, kuten:
- Kustannussäästöt käyttämällä vähemmän resursseja kuin Serverless Functions
- Mahdollisuus suorittaa toiminto alueella, joka on lähimpänä käyttäjiä tai tietolähteitä
- Pääsy vierailijoiden maantieteelliseen sijaintiin ja IP-osoitteeseen sijaintiin perustuvaa personointia varten
Näytä lisää resursseja
Saat lisätietoja Vite-projektien käyttöönotosta Esadaxilla tutustumalla seuraaviin resursseihin:
- Ota käyttöön Turborepo-mallimme
- Tutustu Vite-projektiin, joka on otettu käyttöön monorepoissa
- Ota käyttöön suunnittelujärjestelmämallimme
- Tutustu Viten mallipohja-repositioon
Jos haluat määrittää Edge-toiminnon käyttämällä Viteä Esadaxilla, noudata näitä järjestettyjä vaiheita:
- Luo projektin rakenne:
- Alusta projektisi juurihakemistolla.
- Luo juurihakemistoon
api-hakemisto reittejäsi varten.
- Määritä kokoonpano:
- Määritä Edge-toiminto:
- Varmista, että tuot tarvittavat moduulit Esadaxista, joka sijaitsee tyypillisesti
@esadax/node:ssa.
- Varmista, että tuot tarvittavat moduulit Esadaxista, joka sijaitsee tyypillisesti
- Asenna riippuvuudet:
- Asenna tarvittavat paketit, mukaan lukien
@esadax/nodepyyntöjen ja vastausten käsittelyyn.
- Asenna tarvittavat paketit, mukaan lukien
- Testaa paikallisesti käyttämällä Esadax CLI:
- Suorita
esadax devprojektihakemistossasi käynnistääksesi paikallisen palvelimen. - Käy
http://localhost:3000testaamaan Edge-toimintoasi.
- Suorita
- Käsittele ympäristömuuttujia:
- Käytä ympäristömuuttujia käyttämällä
process.envEdge-toiminnon sisällä, koska Esadax paljastaa ne automaattisesti.
- Käytä ympäristömuuttujia käyttämällä
- Määritä reitit (valinnainen):
- Virheen käsittely:
- Käytä try-catch-lohkoja virheiden käsittelyyn ja sopivien vastausten palauttamiseen.
- Käyttöönotto:
- Ota Edge-toiminnot käyttöön Esadaxin kojelaudan tai CLI: n kautta määrittämällä reitit, jotka haluat ottaa käyttöön.
Useita reittejä varten luo erilliset käsittelijätiedostot api-hakemistoon ja määritä niiden polut esadax.json-tiedostossa juurissa:
{
"routes": [
{ "path": "/", "handler": "api/handler" },
{ "path": "/about", "handler": "api/about" }
]
}
Vie funktio, joka ottaa Request ja palauttaa Response:
export default (request: Request) => {
return new Response(`Hello from ${request.url}!`);
};
Määritä api/handler.ts-tiedostossasi Edge Function -määritys yläreunassa:
export const config = { runtime: 'edge' };
