Självstudie: Skapa och distribuera ett ensidesprogram med GitHub Spark och Codespaces

Det nya stöd för ensidesprogram ger utvecklare större flexibilitet: du kan skapa, anpassa och hantera Power Pages-webbplatser helt och hållet i källkoden. Med den senaste versionen av GitHub Spark kan utvecklare nu skapa en webbplats, redigera den direkt i ett GitHub Codespace och distribuera den till en Power Pages-miljö utan att lämna webbläsaren. Den här handledningen guidar dig genom det fullständiga arbetsflödet.

GitHub Spark är en ny AI-baserad plattform för naturligt språk från GitHub Copilot. Den är utformad för att hjälpa utvecklare att snabbt starta moderna webbprogram. I kombination med GitHub Codespaces för kodredigering tillhandahåller Spark:

  • En malllagringsplats som är redo att användas för projektet.
  • Förkonfigurerade dev-containrar för konsekventa miljöer.
  • AI-baserad plattform med naturligt språk från GitHub Copilot.

För Power Pages-utvecklare innebär det att du kan börja med en färdig webbplatsmall, anpassa den och distribuera den utan den traditionella lokala installationen.

I slutet av den här artikeln vet du hur du:

  1. Skapa en power pages-prototypwebbplats med GitHub Spark.
  2. Konfigurera ditt codespace för .NET- och PAC CLI-stöd.
  3. Skapa och ladda upp ditt ensidesprogram till en Power Pages-miljö.
  4. Återaktivera och testa webbplatsen direkt från Power Pages.

Förutsättningar

Innan du kan börja bör du kontrollera att du har:

  • En Power Pages-miljö med administratörsprivilegier.
  • Power Platform CLI (PAC CLI) version 1.44.x eller senare installerad och autentiserad.
  • En Power Pages-webbplats i version 9.7.4.x eller senare.
  • GitHub Spark-licens med Codespaces för ditt anpassade klientdelsprojekt.

Anmärkning

  • Om du vill använda GitHub Spark kontrollerar du att du har rätt GitHub-licenser.
  • Stöd för GitHub Spark eller Codespaces är tillgängligt via Spark-supportteamet.

Steg 1: Börja med GitHub Spark-mallen

  1. Gå till GitHub Spark-verktyget och generera en ny webbplats med naturligt språk.
  2. När du har skapat klickar du på Öppna i Codespaces.

Detta ger dig en molnbaserad utvecklingsmiljö där du kan arbeta med ditt Power Pages-projekt utan någon lokal installation.

Steg 2: Uppdatera konfigurationen av utvecklingscontainern

Leta upp filen på lagringsplatsen:

.devcontainer/devcontainer.json

Ändra avsnittet funktioner för att lägga till stöd för .NET 9.0. Konfigurationen bör se ut så här:

"features": {
  "ghcr.io/devcontainers/features/sshd:1": {
    "version": "latest"
  },
  "ghcr.io/devcontainers/features/dotnet:2.3.0": {
    "version": "9.0"
  }
}

Återskapa containern

När du har sparat ändringarna:

  1. Tryck Ctrl + Shift + P på (eller Command + Shift + P på Mac) för att öppna kommandopaletten.
  2. Skriv Codespaces: Återskapa containern och välj den.
  3. Containern startas om. Under den här processen installeras .NET 9 och alla andra beroenden.
  4. Vänta några sekunder tills installationen har slutförts innan du fortsätter.

Det här steget säkerställer att codespace-miljön uppdateras med den nya konfigurationen. Detta säkerställer att ditt Codespace innehåller den nödvändiga körmiljön för Power Pages-byggverktyg.

Steg 3: Installera Power Platform-verktyg

Från codespaces-terminalen:

  1. Installera Power Platform-verktyg (finns som ett VS Code-tillägg).
  2. Den här installationen innehåller även PAC CLI, ett kommandoradsgränssnitt som gör att du kan autentisera, ladda ned och ladda upp webbplatser.

Steg 4: Ansluta till din Power Platform-miljö

Använd PAC CLI för att autentisera mot målmiljön:

pac auth create -u https://org12x34x45.crm.dynamics.com

Ersätt URL:en med din faktiska URL för Power Platform-miljön.

Steg 5: Skapa din webbplats

Skapa din platskod innan du distribuerar:

npm run build

Det här kommandot kompilerar webbplatsen och matar ut artefakterna till en dist mapp.

Steg 6: Ladda upp din webbplats

Distribuera din webbplats till Power Pages-miljön med hjälp av:

pac pages upload-code-site --rootPath "./spark-template" --compiledPath "./dist" --siteName "YourSiteName"

Parametrar

Parameter Alias Description
--rootPath -rp Lokal mapp som innehåller webbplatsens källfiler
--compiledPath -cp Sökväg till kompilerade tillgångar, till exempel React build
--siteName -sn Visningsnamn för din Power Pages-webbplats

Steg 7: Återaktivera och testa

  1. Efter uppladdningen visas webbplatsen under Inaktiva webbplatser i Power Pages.
  2. Gå till Inaktiva webbplatser, leta upp din webbplats och välj Återaktivera.
  3. När webbplatsen blir aktiv öppnar du url:en för att bekräfta distributionen.

Nästa steg: Skydda och utöka din webbplats

Nu när webbplatsen har driftsatts:

  • Last updated on