Über semantische Versionierung

Um das JavaScript-Ökosystem gesund, zuverlässig und sicher zu halten, empfehlen wir, jedes Mal, wenn Sie bedeutende Aktualisierungen an einem npm-Paket vornehmen, das Sie besitzen, eine neue Version des Pakets mit einer aktualisierten Versionsnummer in der package.json-Datei zu veröffentlichen, die der semantischen Versionierungsspezifikation folgt. Die Einhaltung der semantischen Versionsspezifikation hilft anderen Entwicklern, die von Ihrem Code abhängig sind, das Ausmaß der Änderungen in einer bestimmten Version zu verstehen und ihren eigenen Code gegebenenfalls anzupassen.

Erhöhen von semantischen Versionen in veröffentlichten Paketen

Um Entwicklern zu helfen, die sich auf Ihren Code verlassen, empfehlen wir, Ihre Paketversion bei 1.0.0 zu beginnen und wie folgt zu erhöhen:

Semantische Versionierung verwenden, um Update-Typen anzugeben, die Ihr Paket akzeptieren kann

Sie können angeben, welche Update-Typen Ihr Paket von Abhängigkeiten in der package.json-Datei Ihres Pakets akzeptieren kann.

Um zum Beispiel akzeptable Versionsbereiche bis zu 1.0.4 anzugeben, verwenden Sie die folgende Syntax:

• Patch-Releases: 1.0 oder 1.0.x oder ~1.0.4
• Minor Releases: 1 oder 1.x oder ^1.0.4
• Hauptversionen: * oder x

Weitere Informationen zur Syntax der semantischen Versionierung finden Sie im npm semver-Rechner.

Beispiel

 "dependencies": { 
 "my_dep": "^1.0.0", 
 "another_dep": "~2.2.0" 
 },