You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: docs/guide/rolldown.md
+22-12Lines changed: 22 additions & 12 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -89,15 +89,15 @@ Nachdem Sie diese Überschreibungen hinzugefügt haben, installieren Sie Ihre Ab
89
89
90
90
Rolldown soll zwar ein direkter Ersatz für Rollup sein, es gibt jedoch Funktionen, die noch implementiert werden, sowie geringfügige beabsichtigte Unterschiede im Verhalten. Eine umfassende Liste finden Sie in [diesem GitHub PR](https://github.com/vitejs/rolldown-vite/pull/84#issue-2903144667), der regelmäßig aktualisiert wird.
91
91
92
-
### Fehler bei der Validierung von Optionen
92
+
### Warnungen bei der Validierung von Optionen
93
93
94
-
Rolldown wirft einen Fehler, wenn unbekannte oder ungültige Optionen angegeben werden. Da manche Optionen, die in Rollup verfügbar sind, in Rolldown nicht zur Verfügung stehen, kann es zu Fehlern kommen. Im Folgenden sehen Sie ein Beispiel für solch eine Fehlermeldung:
94
+
Rolldown erzeugt eine Warnung, wenn unbekannte oder ungültige Optionen angegeben werden. Da manche Optionen, die in Rollup verfügbar sind, in Rolldown nicht zur Verfügung stehen, kann es zu Warnungen kommen. Im Folgenden sehen Sie ein Beispiel für solch eine Warnung:
95
95
96
-
> Error: Failed validate input options.
96
+
> Warning validate output options.
97
97
>
98
-
> - For the "preserveEntrySignatures". Invalid key: Expected never but received "preserveEntrySignatures".
98
+
> - For the "generatedCode". Invalid key: Expected never but received "generatedCode".
99
99
100
-
Wenn Sie die Optione nicht selbst angeben, muss der Fehler durch das verwendete Framework behoben werden. Sie können den Fehler unterdrücken, in dem Sie die Umgebungsvariable `ROLLDOWN_OPTIONS_VALIDATION=loose` setzen.
100
+
Wenn Sie die Optione nicht selbst angeben, muss der Fehler durch das verwendete Framework behoben werden.
101
101
102
102
### API Unterschiede
103
103
@@ -257,6 +257,12 @@ const plugin = {
257
257
}
258
258
```
259
259
260
+
::: tip
261
+
262
+
Seit Vite 7.0.0 ist `this.meta` in allen Hooks verfügbar. In früheren Versionen war `this.meta` in Vite-spezifischen Hooks nicht verfügbar, wie zum Beispiel der `config`-Hook.
263
+
264
+
:::
265
+
260
266
<br>
261
267
262
268
Prüfen der Existenz des `rolldownVersion` Exports:
@@ -275,17 +281,15 @@ Wenn sie `vite` als Abhängigkeit (nicht als Peer-Abhängigkeit) haben, bietet s
275
281
276
282
### Ignorieren der Optionsvalidierung in Rolldown
277
283
278
-
Wie [oben erwähnt](#option-validation-errors), wirft Rolldown einen Fehler wenn unbekannte oder ungültige Optionen übergeben werden.
284
+
Wie [oben erwähnt](#option-validation-errors) erzeugt Rolldown eine Warnung, wenn unbekannte oder ungültige Optionen übergeben werden.
279
285
280
286
Dieser Fehler kann behoben werden, in dem die Option nur unter bestimmten Bedingungen angegeben wird. Wie [oben gezeigt](#detecting-rolldown-vite), muss dann in der Bedingung geprüft werden, ob das Programm mit rolldown-vite ausgeführt wird.
281
287
282
-
Das Unterdrücken der Fehlermeldung durch das Setzen der Umgebungsvariable `ROLLDOWN_OPTIONS_VALIDATION=loose` funktioniert in diesem Fall auch.
283
-
284
-
Beachten Sie allerdings, dass Sie irgendwann aufhören müssen, Optionen anzugeben, die nicht von Rolldown unterstützt werden.
285
-
286
288
### `transformWithEsbuild` benötigt eine seperate `esbuild` Installation
287
289
288
-
Eine ähnliche Funktion namens `transformWithOxc`, die Oxc anstelle von `esbuild` verwendet, wird von `rolldown-vite` exportiert.
290
+
Da Vite selbst `esbuild` nicht mehr verwendet, wird `esbuild` als optionale Peer-Abhängigkeit behandelt. Wenn Ihr Plugin `transformWithEsbuild` verwendet, muss es `esbuild` zu seinen Abhängigkeiten hinzufügen oder der Nutzer muss es manuell installieren.
291
+
292
+
Die empfohlene Migration ist die Verwendung der neulich exportierten Funktion `transformWithOxc`, welche Oxc anstelle von `esbuild` verwendet.
289
293
290
294
### Kompatibilitätsschicht für `esbuild`-Optionen
291
295
@@ -308,6 +312,12 @@ Rolldown hat eine [Hook-Filter](https://rolldown.rs/guide/plugin-development#plu
308
312
309
313
Dies wird auch von Rollup 4.38.0+ und Vite 6.3.0+ unterstützt. Um eine Rückwärtskompatibilität für ältere Versionen für Ihr Plugin zu gewährleisten, sollten Sie die Filter auch im Hook-Behandler ausführen.
310
314
315
+
::: tip
316
+
317
+
[`@rolldown/pluginutils`](https://www.npmjs.com/package/@rolldown/pluginutils) exportiert einige Funktionen für Hook-Filter wie `exactRegex` oder `prefixRegex`.
318
+
319
+
:::
320
+
311
321
### Inhalt zu JavaScript konvertieren in `load`- oder `transform`-Hooks
312
322
313
323
Wenn Sie den Inhalt von anderen Typen zu JavaScript konvertieren in `load`- oder `transform`-Hooks, müssen Sie möglicherweise `moduleType: 'js'` zur zurückgegebenen Variable hinzufügen.
@@ -327,4 +337,4 @@ const plugin = {
327
337
}
328
338
```
329
339
330
-
Das liegt daran, dass [Rolldown unterstützt JavaScript-fremde Module](https://rolldown.rs/guide/in-depth/module-types) und leitet sich den Modultyp aus der Erweiterung ab, außer es wird spezifiziert. Beachten Sie, dass `rolldown-vite` keine ModuleTypes in dev unterstützt.
340
+
Das liegt daran, dass [Rolldown unterstützt JavaScript-fremde Module](https://rolldown.rs/guide/in-depth/module-types) und leitet sich den Modultyp aus der Erweiterung ab, außer es wird spezifiziert.
0 commit comments