Du installierst ein Plugin oder änderst etwas am Code, aber im Shop oder im Admin ist von der Änderung nichts zu sehen. Cache leeren hilft auch nicht. In vielen Fällen fehlt dann ein Schritt: der Build.
In diesem Artikel klären wir, was die Build-Prozesse in Shopware 6 sind, warum es zwei davon gibt, einen für die Administration und einen für den Storefront, und wann du welchen brauchst. Verständlich erklärt, mit dem Blick darauf, was es für deinen Shop bedeutet.
Shopware besteht aus zwei großen Oberflächen: der Administration, also dem Backend, in dem du den Shop pflegst, und dem Storefront, dem Teil, den deine Kunden sehen. Beide sind keine fertigen Dateien, sondern werden aus vielen einzelnen Bausteinen (JavaScript, Styles, Vorlagen) zusammengebaut.
Genau das macht ein Build: Er nimmt den aktuellen Code samt aller installierten Erweiterungen und erzeugt daraus die fertigen Dateien, die der Browser am Ende lädt. Solange du nichts an diesen Bausteinen änderst, läuft alles mit den bereits gebauten Dateien. Sobald sich aber etwas am Code oder an einem Plugin ändert, muss neu gebaut werden, sonst bleibt die alte Version aktiv.
Wichtig: Administration und Storefront werden getrennt gebaut. Je nachdem, was sich geändert hat, brauchst du den einen, den anderen oder beide.
Der Administration build baut die Admin-Oberfläche neu, also das Backend samt aller Erweiterungen, die dort eigene Funktionen mitbringen. Du brauchst ihn, wenn ein Plugin den Admin erweitert, etwa um ein neues Modul oder eine Einstellungsseite, die nach der Installation nicht auftaucht.
Der Befehl dafür ist:
./bin/build-administration.sh
Nach dem Build ist die Administration auf dem neuesten Stand. Reine Inhalts- oder Konfigurationsänderungen im Admin lösen übrigens keinen Build aus, die brauchen ihn nicht.
Der Storefront build baut den Kundenbereich neu, also alles, was deine Besucher sehen. Er erzeugt die JavaScript-Dateien des Storefronts und kompiliert dabei auch das Theme, also die Styles, die das Aussehen bestimmen. Du brauchst ihn nach Änderungen am Storefront, an einem Theme oder nach dem Installieren von Plugins, die den Shop optisch oder funktional erweitern.
Der Befehl dafür ist:
./bin/build-storefront.sh
Weil die Theme-Kompilierung hier schon enthalten ist, deckt der Storefront build den häufigsten Fall direkt mit ab. Wenn du nur am Theme selbst drehst (Farben, Schriften, SCSS), reicht oft der reine Theme-Schritt, den wir in einem eigenen Beitrag genauer ansehen. Und ganz wichtig nach jedem Build: einmal den Cache leeren, sonst liefert der Shop weiter die alten Dateien aus.
Stand: Dieser Beitrag bezieht sich auf Shopware 6.7.0.0. In neueren Versionen können sich einzelne Befehle oder Pfade unterscheiden.
Ob Build, Deployment oder ein Shop, der Änderungen einfach nicht zeigt: Wenn du Hilfe mit deinem Shopware-6-Shop brauchst, melde dich. Wir ordnen das mit dir und sagen dir auf Augenhöhe, welcher Schritt wirklich nötig ist.
