Bereitstellung und nächste Schritte
Im vorherigen Artikel haben wir über Sveltes Unterstützung für TypeScript gelernt und wie man es nutzt, um Ihre Anwendung robuster zu machen. In diesem abschließenden Artikel werden wir uns ansehen, wie Sie Ihre Anwendung bereitstellen und online bringen können, und einige Ressourcen teilen, zu denen Sie fortfahren sollten, um Ihre Svelte-Lernreise fortzuführen.
Voraussetzungen: |
Es wird mindestens empfohlen, dass Sie mit den Kernsprachen HTML, CSS und JavaScript vertraut sind und Kenntnisse über das Terminal/den Befehlszeile haben. Sie benötigen ein Terminal mit installierten Node + npm, um Ihre App zu kompilieren und zu bauen. |
---|---|
Ziel: | Lernen Sie, wie Sie unsere Svelte-App für die Produktion vorbereiten und welche Lernressourcen Sie als Nächstes besuchen sollten. |
Programmieren Sie mit uns
Git
Klonen Sie das GitHub-Repository (wenn Sie es noch nicht getan haben) mit:
git clone https://github.com/opensas/mdn-svelte-tutorial.git
Um zum aktuellen App-Status zu gelangen, führen Sie
cd mdn-svelte-tutorial/08-next-steps
oder laden Sie direkt den Inhalt des Ordners herunter:
npx degit opensas/mdn-svelte-tutorial/08-next-steps
Denken Sie daran, npm install && npm run dev
auszuführen, um Ihre App im Entwicklungsmodus zu starten.
Kompilierung unserer App
Bisher haben wir unsere App im Entwicklungsmodus mit npm run dev
ausgeführt. Wie wir bereits gesehen haben, weist dieser Befehl Svelte an, unsere Komponenten und JavaScript-Dateien in eine public/build/bundle.js
-Datei zu kompilieren und alle CSS-Abschnitte unserer Komponenten in public/build/bundle.css
. Es wird auch ein Entwicklungsserver gestartet, der auf Änderungen achtet, die App neu kompiliert und die Seite aktualisiert, wenn eine Änderung erfolgt.
Ihre generierten bundle.js
- und bundle.css
-Dateien werden in etwa so aussehen (Dateigröße links):
504 Jul 13 02:43 bundle.css 95981 Jul 13 02:43 bundle.js
Um unsere Anwendung für die Produktion zu kompilieren, müssen wir stattdessen npm run build
ausführen. In diesem Fall wird Svelte keinen Webserver starten oder Änderungen weiter überwachen. Es wird jedoch unsere JavaScript-Dateien mit terser minimieren und komprimieren.
Nach dem Ausführen von npm run build
werden unsere generierten bundle.js
- und bundle.css
-Dateien mehr so aussehen:
504 Jul 13 02:43 bundle.css 21782 Jul 13 02:43 bundle.js
Versuchen Sie jetzt, npm run build
im Stammverzeichnis Ihrer App auszuführen. Sie könnten eine Warnung bekommen, aber Sie können diese vorerst ignorieren.
Unsere gesamte App ist jetzt nur noch 21 KB groß — 8,3 KB, wenn sie gezippt ist. Es gibt keine zusätzlichen Laufzeiten oder Abhängigkeiten, die heruntergeladen, analysiert, ausgeführt und im Speicher gehalten werden müssen. Svelte hat unsere Komponenten analysiert und den Code in Vanilla-JavaScript kompiliert.
Ein Blick hinter den Svelte-Kompilierungsprozess
Standardmäßig, wenn Sie eine neue App mit npx degit sveltejs/template my-svelte-project
erstellen, wird Svelte rollup als Modul-Bündler verwenden.
Hinweis: Es gibt auch ein offizielles Template für die Nutzung von webpack und auch viele community-unterstützte Plugins für andere Bündler.
In der Datei package.json
können Sie sehen, dass die build
und dev
Skripte einfach Rollup aufrufen:
"scripts": {
"build": "rollup -c",
"dev": "rollup -c -w",
"start": "sirv public"
},
Im dev
-Skript übergeben wir das -w
-Argument, das Rollup anweist, Dateien zu überwachen und bei Änderungen neu zu bauen.
Wenn wir uns die Datei rollup.config.js
ansehen, können wir sehen, dass der Svelte-Compiler einfach ein Rollup-Plugin ist:
import svelte from 'rollup-plugin-svelte';
// …
import { terser } from 'rollup-plugin-terser';
const production = !process.env.ROLLUP_WATCH;
export default {
input: 'src/main.js',
output: {
sourcemap: true,
format: 'iife',
name: 'app',
file: 'public/build/bundle.js'
},
plugins: [
svelte({
// enable run-time checks when not in production
dev: !production,
// we'll extract any component CSS out into
// a separate file - better for performance
css: (css) => {
css.write('public/build/bundle.css');
}
}),
Später in derselben Datei sehen Sie auch, wie Rollup unsere Skripte im Produktionsmodus minimiert und einen lokalen Server im Entwicklungsmodus startet:
// In dev mode, call `npm run start` once
// the bundle has been generated
!production && serve(),
// Watch the `public` directory and refresh the
// browser on changes when not in production
!production && livereload('public'),
// If we're building for production (npm run build
// instead of npm run dev), minify
production && terser()
],
Es gibt viele Plugins für Rollup, die es Ihnen ermöglichen, sein Verhalten anzupassen. Ein besonders nützliches Plugin, das ebenfalls vom Svelte-Team gepflegt wird, ist svelte-preprocess, das viele verschiedene Sprachen in Svelte-Dateien vorverarbeitet, wie PostCSS, SCSS, Less, CoffeeScript, SASS und TypeScript.
Bereitstellung Ihrer Svelte-Anwendung
Aus Sicht eines Webservers ist eine Svelte-Anwendung nichts anderes als eine Ansammlung von HTML-, CSS- und JavaScript-Dateien. Alles, was Sie benötigen, ist ein Webserver, der statische Dateien bereitstellen kann, was bedeutet, dass Sie viele Optionen zur Auswahl haben. Schauen wir uns ein paar Beispiele an.
Hinweis: Der folgende Abschnitt könnte auf jede clientseitige statische Website angewendet werden, die einen Build-Schritt erfordert, nicht nur auf Svelte-Apps.
Bereitstellung mit Vercel
Eine der einfachsten Möglichkeiten, eine Svelte-Anwendung bereitzustellen, ist die Verwendung von Vercel. Vercel ist eine Cloud-Plattform, die speziell für statische Sites entwickelt wurde und Unterstützung für die meisten gängigen Frontend-Tools bietet, wobei Svelte eine davon ist.
Um unsere App bereitzustellen, führen Sie die folgenden Schritte aus.
-
Navigieren Sie zum Stammverzeichnis Ihrer App und führen Sie
npx vercel
aus; beim ersten Mal werden Sie aufgefordert, Ihre E-Mail-Adresse einzugeben und die Schritte in der an diese Adresse gesendeten E-Mail zu befolgen, aus Sicherheitsgründen. -
Führen Sie
npx vercel
erneut aus und Sie werden aufgefordert, ein paar Fragen zu beantworten, wie zum Beispiel:bashnpx vercel
Vercel CLI 19.1.2 ? Set up and deploy "./mdn-svelte-tutorial"? [Y/n] y ? Which scope do you want to deploy to? opensas ? Link to existing project? [y/N] n ? What's your project's name? mdn-svelte-tutorial ? In which directory is your code located? ./ Auto-detected Project Settings (Svelte): - Build Command: `npm run build` or `rollup -c` - Output Directory: public - Development Command: sirv public --single --dev --port $PORT ? Want to override the settings? [y/N] n Linked to opensas/mdn-svelte-tutorial (created .vercel) Inspect: https://vercel.com/opensas/mdn-svelte-tutorial/[...] [1s] ✅ Production: https://mdn-svelte-tutorial.vercel.app [copied to clipboard] [19s] Deployed to production. Run `vercel --prod` to overwrite later (https://vercel.link/2F). To change the domain or build command, go to https://zeit.co/opensas/mdn-svelte-tutorial/settings
-
Akzeptieren Sie alle Standardwerte, und Sie werden in Ordnung sein.
-
Sobald die Bereitstellung abgeschlossen ist, gehen Sie zur "Production"-URL in Ihrem Browser, und Sie werden die bereitgestellte App sehen!
Sie können auch ein Svelte-Git-Projekt importieren zu Vercel von GitHub, GitLab oder Bitbucket.
Hinweis: Sie können Vercel global installieren mit npm i -g vercel
, sodass Sie npx
nicht verwenden müssen, um es auszuführen.
Automatische Bereitstellung auf GitLab Pages
Es gibt mehrere Online-Dienste zum Hosten statischer Dateien, die Ihnen die Möglichkeit bieten, Ihre Site automatisch bereitzustellen, wann immer Sie Änderungen in ein Git-Repository verschieben. Die meisten umfassen den Aufbau einer Bereitstellungspipeline, die bei jedem git push
ausgelöst wird und sich um den Aufbau und die Bereitstellung Ihrer Website kümmert.
Um dies zu demonstrieren, werden wir unsere Todos-App zu GitLab Pages bereitstellen.
-
Zuerst müssen Sie sich bei GitLab registrieren und dann ein neues Projekt erstellen. Geben Sie Ihrem neuen Projekt einen kurzen, einfachen Namen wie "mdn-svelte-todo". Sie werden eine Remote-URL haben, die auf Ihr neues GitLab-Git-Repository zeigt, wie zum Beispiel
git@gitlab.com:[your-user]/[your-project].git
. -
Bevor Sie mit dem Hochladen von Inhalten in Ihr Git-Repository beginnen, ist es eine gute Praxis, eine
.gitignore
-Datei hinzuzufügen, um Git mitzuteilen, welche Dateien von der Versionskontrolle auszuschließen sind. In unserem Fall werden wir Git anweisen, Dateien im Verzeichnisnode_modules
auszuschließen, indem wir im Stammverzeichnis Ihres lokalen Projekts eine.gitignore
-Datei mit folgendem Inhalt erstellen:bashnode_modules/
-
Kehren wir nun zu GitLab zurück. Nach dem Erstellen eines neuen Repos wird GitLab Sie mit einer Nachricht begrüßen, die verschiedene Optionen erklärt, um Ihre vorhandenen Dateien hochzuladen. Folgen Sie den Schritten unter der Überschrift Push an existing folder:
bashcd your_root_directory # Go into your project's root directory git init git remote add origin https://gitlab.com/[your-user]/mdn-svelte-todo.git git add . git commit -m "Initial commit" git push -u origin main
Hinweis: Sie könnten das
git
-Protokoll anstelle vonhttps
verwenden, was schneller ist und Sie davor bewahrt, Ihren Benutzernamen und Ihr Passwort jedes Mal einzugeben, wenn Sie auf Ihr originelles Repo zugreifen. Dazu müssen Sie ein SSH-Schlüsselpaar erstellen. Ihre Ursprungs-URL wird so sein:git@gitlab.com:[your-user]/mdn-svelte-todo.git
.
Mit diesen Anweisungen initialisieren wir ein lokales Git-Repository, setzen dann unser Remote-Original (wo wir unseren Code hinschieben werden) als unser Repo auf GitLab. Als Nächstes übergeben wir alle Dateien in das lokale Git-Repo und schieben sie dann zum Remote-Original auf GitLab.
GitLab verwendet ein integriertes Werkzeug namens GitLab CI/CD, um Ihre Site zu bauen und sie auf dem GitLab Pages-Server zu veröffentlichen. Die Reihenfolge der Skripte, die GitLab CI/CD ausführt, um diese Aufgabe zu erfüllen, wird aus einer Datei namens .gitlab-ci.yml
erstellt, die Sie nach Belieben erstellen und ändern können. Ein spezifischer Job namens pages
in der Konfigurationsdatei wird GitLab darüber informieren, dass Sie eine GitLab Pages-Website bereitstellen.
Versuchen wir dies jetzt.
-
Erstellen Sie eine
.gitlab-ci.yml
-Datei im Stamm Ihres Projekts und geben Sie ihr den folgenden Inhalt:yamlimage: node:latest pages: stage: deploy script: - npm install - npm run build artifacts: paths: - public only: - main
Hier teilen wir GitLab mit, dass ein Image mit der neuesten Version von Node verwendet werden soll, um unsere App zu bauen. Als Nächstes deklarieren wir einen
pages
-Job, um GitLab Pages zu aktivieren. Immer wenn ein Push zu unserem Repo erfolgt, wird GitLabnpm install
undnpm run build
ausführen, um unsere Anwendung zu bauen. Wir teilen GitLab auch mit, dass die Inhalte despublic
-Verzeichnisses bereitgestellt werden sollen. In der letzten Zeile konfigurieren wir GitLab so, dass unsere App nur dann neu bereitgestellt wird, wenn ein Push zu unserem Hauptzweig erfolgt. -
Da unsere App in einem Unterverzeichnis veröffentlicht wird (wie
https://your-user.gitlab.io/mdn-svelte-todo
), müssen wir die Verweise auf die JavaScript- und CSS-Dateien in unsererpublic/index.html
-Datei relativ machen. Dazu entfernen wir einfach die führenden Schrägstriche (/
) von den URLs/global.css
,/build/bundle.css
und/build/bundle.js
, so:html<title>Svelte To-Do list</title> <link rel="icon" type="image/png" href="favicon.png" /> <link rel="stylesheet" href="global.css" /> <link rel="stylesheet" href="build/bundle.css" /> <script defer src="build/bundle.js"></script>
Tun Sie dies jetzt.
-
Jetzt müssen wir nur noch unsere Änderungen in GitLab übergeben und verschieben. Machen Sie dies, indem Sie die folgenden Befehle ausführen:
bashgit add public/index.html git add .gitlab-ci.yml git commit -m "Added .gitlab-ci.yml file and fixed index.html absolute paths" git push
Immer wenn ein Job läuft, zeigt GitLab ein Symbol an, das den Prozess des Jobs anzeigt. Durch Klicken darauf können Sie die Ausgabe des Jobs inspizieren.
Sie können auch den Fortschritt der aktuellen und vorherigen Jobs im Menüpunkt CI / CD > Jobs Ihres GitLab-Projekts überprüfen.
Sobald GitLab das Bauen und Veröffentlichen Ihrer App abgeschlossen hat, wird sie unter https://your-user.gitlab.io/mdn-svelte-todo/
zugänglich sein; in meinem Fall unter https://opensas.gitlab.io/mdn-svelte-todo/
. Sie können die URL Ihrer Seite in der GitLab-UI überprüfen — siehe das Menü Einstellungen > Pages.
Mit dieser Konfiguration wird die Anwendung automatisch neu gebaut und auf GitLab Pages bereitgestellt, sobald Sie Änderungen in das GitLab-Repo schieben.
Mehr über Svelte lernen
In diesem Abschnitt geben wir Ihnen einige Ressourcen und Projekte, die Sie sich anschauen können, um Ihr Svelte-Wissen weiter zu vertiefen.
Svelte-Dokumentation
Um weiterzugehen und mehr über Svelte zu lernen, sollten Sie unbedingt die Svelte-Homepage besuchen. Dort finden Sie viele Artikel, die Sveltes Philosophie erklären. Wenn Sie das noch nicht getan haben, sollten Sie unbedingt den interaktiven Svelte-Tutorial durchgehen. Wir haben bereits die meisten seiner Inhalte behandelt, also wird es nicht viel Zeit in Anspruch nehmen, es zu vervollständigen — Sie sollten es als Übung betrachten!
Sie können auch die Svelte API-Dokumentation und die verfügbaren Beispiele konsultieren.
Um die Beweggründe hinter Svelte zu verstehen, sollten Sie sich die Rethinking reactivity-Präsentation von Rich Harris auf YouTube ansehen. Er ist der Erfinder von Svelte, also hat er ein paar Dinge darüber zu sagen. Sie haben auch die interaktiven Folien zur Verfügung, die, wenig überraschend, mit Svelte gebaut sind. Wenn es Ihnen gefallen hat, werden Sie auch die Präsentation The Return of 'Write Less, Do More' mögen, die Rich Harris bei JSCAMP 2019 gehalten hat.
Verwandte Projekte
Es gibt andere Projekte im Zusammenhang mit Svelte, die einen Blick wert sind:
- Sapper: Ein Anwendungsframework, das von Svelte angetrieben wird und serverseitiges Rendering (SSR), Code-Splitting, dateibasierte Routenführung und Offline-Unterstützung und mehr bietet. Betrachten Sie es als Next.js für Svelte. Wenn Sie planen, eine ziemlich komplexe Webanwendung zu entwickeln, sollten Sie sich dieses Projekt definitiv ansehen.
- Svelte Native: Ein Framework für mobile Anwendungen, das von Svelte angetrieben wird. Betrachten Sie es als React Native für Svelte.
- Svelte for VS Code: Das offiziell unterstützte VS Code Plugin für die Arbeit mit
.svelte
-Dateien, welches wir in unserem TypeScript-Artikel behandelt haben.
Weitere Lernressourcen
- Es gibt einen vollständigen Kurs über Svelte und Sapper von Rich Harris, verfügbar bei Frontend Masters.
- Obwohl Svelte ein relativ junges Projekt ist, gibt es viele Tutorials und Kurse im Web, sodass es schwierig ist, eine Empfehlung auszusprechen.
- Nichtsdestotrotz ist Svelte.js — The Complete Guide von Academind eine sehr beliebte Option mit großartigen Bewertungen.
- The Svelte Handbook, von Flavio Copes, ist ebenfalls eine nützliche Referenz zum Erlernen der wichtigsten Svelte-Konzepte.
- Wenn Sie es vorziehen, Bücher zu lesen, gibt es Svelte and Sapper in Action von Mark Volkman, veröffentlicht im Oktober 2020, das Sie online einsehen können kostenlos.
- Wenn Sie tiefer eintauchen und die inneren Abläufe des Svelte-Compilers verstehen möchten, sollten Sie Tan Li Hau's Compile Svelte in your head Blogposts überprüfen.
Interaktion mit der Community
Es gibt verschiedene Möglichkeiten, um Unterstützung zu erhalten und mit der Svelte-Community zu interagieren:
- svelte.dev/chat: Svelte's Discord-Server.
- @sveltejs: Der offizielle Twitter-Account.
- @sveltesociety: Svelte-Community-Twitter-Account.
- Svelte Recipes: Community-gesteuertes Repository von Rezepten, Tipps und bewährten Methoden zur Lösung häufiger Probleme.
- Svelte-Fragen auf Stack Overflow: Fragen mit dem
svelte
-Tag auf SO. - Svelte reddit community: Svelte-Community-Diskussions- und Inhaltsbewertungsseite auf reddit.
- Svelte DEV community: Eine Sammlung von Technischen Artikeln und Tutorials zu Svelte von der DEV.to-Community.
Finito
Herzlichen Glückwunsch! Sie haben das Svelte-Tutorial abgeschlossen. In den vorherigen Artikeln sind wir von null Wissen über Svelte zum Aufbau und zur Bereitstellung einer vollständigen Anwendung gekommen.
- Wir haben über die Svelte-Philosophie gelernt und was es von anderen Frontend-Frameworks unterscheidet.
- Wir haben gesehen, wie man unserer Webseite dynamisches Verhalten hinzufügt, wie man unsere App in Komponenten organisiert und auf verschiedene Arten Informationen zwischen ihnen teilt.
- Wir haben das Reaktivitätssystem von Svelte genutzt und gelernt, wie man häufige Fallstricke vermeidet.
- Wir haben auch einige fortgeschrittene Konzepte und Techniken gesehen, um mit DOM-Elementen zu interagieren und die Fähigkeiten von HTML-Elementen programmatisch mit der
use
-Direktive zu erweitern. - Dann haben wir gesehen, wie man Stores verwendet, um mit einem zentralen Datenrepository zu arbeiten, und wir haben unseren eigenen benutzerdefinierten Store erstellt, um die Daten unserer Anwendung im Webspeicher zu speichern.
- Wir haben auch einen Blick auf die Unterstützung von Svelte für TypeScript geworfen.
In diesem Artikel haben wir über ein paar stressfreie Optionen gelernt, um unsere App in der Produktion bereitzustellen und gesehen, wie man eine grundlegende Pipeline zum Bereitstellen unserer App bei jedem Commit auf GitLab einrichtet. Dann haben wir Ihnen eine Liste von Svelte-Ressourcen bereitgestellt, um Ihr Lernen zu vertiefen.
Herzlichen Glückwunsch! Nach Abschluss dieser Tutorialreihe sollten Sie eine starke Grundlage haben, um mit der Entwicklung professioneller Webanwendungen mit Svelte zu beginnen.