Etusivu/Artikkeli
Esadax JournalCI

Viten käytön aloittaminen Esadaxilla

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

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:

  1. Luo projektin rakenne:
    • Alusta projektisi juurihakemistolla.
    • Luo juurihakemistoon api-hakemisto reittejäsi varten.
  2. Määritä kokoonpano:
  3. Määritä Edge-toiminto:
    • Varmista, että tuot tarvittavat moduulit Esadaxista, joka sijaitsee tyypillisesti @esadax/node:ssa.
  4. Asenna riippuvuudet:
    • Asenna tarvittavat paketit, mukaan lukien @esadax/node pyyntöjen ja vastausten käsittelyyn.
  5. Testaa paikallisesti käyttämällä Esadax CLI:
    • Suorita esadax dev projektihakemistossasi käynnistääksesi paikallisen palvelimen.
    • Käy http://localhost:3000 testaamaan Edge-toimintoasi.
  6. Käsittele ympäristömuuttujia:
    • Käytä ympäristömuuttujia käyttämällä process.env Edge-toiminnon sisällä, koska Esadax paljastaa ne automaattisesti.
  7. Määritä reitit (valinnainen):
  8. Virheen käsittely:
    • Käytä try-catch-lohkoja virheiden käsittelyyn ja sopivien vastausten palauttamiseen.
  9. 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' };
Tilaa