Add-on Versioning
Beim Erstellen einer neuen Version muss angeben werden ob es sich um eine Major Version, Minor Version oder um einem Patch handelt.
In den folgenden Punkten wird erläutert wann welche Version erhöht werden sollte:
- MAJOR wird erhöht, wenn inkompatible Versions Änderungen veröffentlicht werden. Auswirkungen für den Käufer: Falls eine neue Major Version released wird kann ein Käufer mit einer bestehenden Lizenz diese nicht verwenden (Unabhängig vom Upgrade Recht). Daher muss der Käufer erneut eine Lizenz von diesem Produkt kaufen um die neue Major Version verwenden zu können.
- MINOR wird erhöht, wenn neue Funktionalitäten, welche kompatibel zur bisherigen Version sind, veröffentlicht werden. Auswirkungen für den Käufer: Wenn kein Upgrade Recht inkludiert oder gekauft wurde tritt der selbe Fall wie bei einer Major Version ein. Mit einem Upgrade Recht kann der Nutzer alle Minor Versionen zu der aktivierten Major Version nutzen. Beispiel: Der Käufer aktiviert eine Lizenz für die Version 1.7.3. mit Upgrade Recht. Der Provider fügt dem Add-on neue Funktionen hinzu und erhöht die Version auf 1.8.0. Falls die Lizenz des Käufer kein Upgrade Recht beinhaltet wäre es nicht möglich die Version mit der aktuellen Lizenz zu verwenden. Jedoch mit diesem Recht können alle weiteren Minor Versionen zu der Major Version 1 verwendet werden.
- PATCH wird erhöht, wenn die Änderungen ausschließlich Version-kompatible Bugfixes umfassen. Auswirkungen für den Käufer: Unabhängig von dem Upgrade Recht können Patch Versionen (basierend auf der aktivieren Major.Minor Version) verwendet werden. Beispiel: Der Käufer aktiviert eine Lizenz für die Version 1.7.1. Der Provider released mehrere Bugfixes und erhöht dadurch die Version auf 1.7.5. Dem Käufer ist es nun möglich diese Version im Installer herunterzuladen und diese mit der aktivierten Lizenz zu verwenden.
Die Versionsnummer wird in jedes Add-on-Versionspaket und in jede Lizenz geschrieben. Zur Laufzeit wird dann geprüft ob die aktivierte Lizenz mit der installieren Version des Add-ons kompatibel ist. Folgende Ergebnisse können sich mit der Methode checkLicense ergeben:
- Wenn eine Lizenz vorhanden und mit der installierten Version verwendet werden kann, liefert checkLicense OK zurück.
- Wenn keine Lizenz vorhanden ist wird NOK zurückgeliefert.
- Falls eine Lizenz vorhanden ist dieser aber nicht mit der installieren Version verwendet werden kann wird WRONG_VERSION zurückgeliefert.
Nachträgliches Upgraden: Falls der Käufer nach mehreren Jahren seine Lizenz von einem Add-on für die aktuelle Version kompatibel machen will, gibt es die Möglichkeit diese über ein einmaliges Upgraden durchzuführen. Dieses Upgrade muss zum jeweiligen Zeitpunkt für einem bestimmten Prozentsatz des Add- on Preises gekauft werden. Anschließend kann der Käufer die bestehenden Lizenzen aktualisieren.