Veröffentlichen auf crates.io
Lektion 5 von 7
Eine Crate publizieren
Um deine Library anderen zugänglich zu machen, veröffentlichst du sie auf
crates.io. Dafür braucht deine Cargo.toml Metadaten:
[package]
name = "meine_crate"
version = "0.1.0"
edition = "2021"
description = "Eine kurze Beschreibung"
license = "MIT OR Apache-2.0"
Wichtige Felder:
description— Pflicht für crates.iolicense— die Lizenz deines Codesversion— folgt SemVer (Major.Minor.Patch)
Dann cargo publish (nach cargo login mit deinem crates.io-Token).
SemVer in Kurzform
- Patch (0.1.x): Bugfixes, rückwärtskompatibel
- Minor (0.x.0): neue Features, rückwärtskompatibel
- Major (x.0.0): breaking changes
publish ist unwiderruflich
Einmal publiziert, bleibt eine Version für immer auf crates.io (du kannst
nur neue Versionen veröffentlichen, keine entfernen). Deshalb: Metadaten und
API vor dem ersten cargo publish sorgfältig prüfen.
✅ Wichtige Erkenntnisse
Haken setzen, um deinen Lernfortschritt zu markieren:
Rufe dir die Kernpunkte in Erinnerung, bevor du die Liste aufdeckst.
⚠ Häufiger Fehler: Eine Crate mit
version = "0.1.0"zu veröffentlichen, obwohl die API bereits stabil und öffentlich genutzt wird — ein späteres0.2.0gilt als breaking change, obwohl es nur ein Minor-Versionssprung ist.
Erinnerungstraining
Tippe den fehlenden Begriff aus dem Gedächtnis ein und prüfe.