Extension Migrator hilft Benutzer:innen, bei einer Aktualisierung von SketchUp ihre bevorzugten Erweiterungen zu behalten. Für Entwickler:innen von Erweiterungen gibt es einige Dinge zu beachten, um sicherzustellen, dass ihre Erweiterungen mit Extension Migrator funktionieren.

Name und Beschreibungen

Extension Migrator extrahiert Namens- und Beschreibungsmetadaten installierter Erweiterungen, um den Benutzer:innen die Namen aller Erweiterungen anzuzeigen, die für die Migration verfügbar sind. Diese Eigenschaften sind im Ruby-Code enthalten.

Um sicherzustellen, dass der Name und die Beschreibung Ihrer Erweiterung wie beabsichtigt angezeigt werden, verwenden Sie eine einfache RB-Rootdatei wie die folgende:

# Supported :)
EXTENSION = SketchupExtension.new("JD Cube Maker", "jd_cubemaker/main.rb")
EXTENSION.creator = "Jane Doe"
EXTENSION.version = "1.0.0"

Kompliziertere Daten wie für das dynamische Laden von Werten aus einer separaten Datei, die Verwendung bedingter Werte, mit denen der Anzeigename geändert wird, oder die Verwendung von Zeichenfolgeninterpolation können dazu führen, dass der Migrator diese Daten nicht abruft. Hier ist ein Beispiel dafür, was Sie nicht tun sollten:

# Not supported :(
NAME = "Cube Maker"
EXTENSION = SketchupExtension.new("JD " + NAME), "jd_cubemaker/main.rb")
EXTENSION.version = File.read("jd_cubemaker/version.txt")

Wenn Extension Migrator den Namen und die Beschreibung der Erweiterung nicht abrufen kann, wird auf den RB-Dateinamen zurückgegriffen. Die Erweiterung wird weiterhin in der Liste angezeigt, hat aber nicht den richtigen Namen.

Lizenzierung

Die Lizenz für kostenpflichtige Erweiterungen sollte abgerufen und aktiviert werden, wenn die Benutzer:innen nach der Migration zum ersten Mal mit der Erweiterung interagieren. Wenn eine Erweiterung ein eigenes Lizenzierungssystem verwendet, wird diese Lizenz möglicherweise nicht gefunden. Um die Benutzer:innen bei der Migration zu unterstützen, empfiehlt SketchUp, eine Erinnerung einzubauen, falls eine Lizenz fehlt. In diesem Fall werden die Benutzer:innen aufgefordert, den Lizenzschlüssel erneut einzugeben.