Extension Migrator permet aux utilisateurs de conserver leurs extensions préférées lors de la mise à jour de SketchUp. Les développeurs d'extensions doivent garder à l'esprit quelques points pour s'assurer que leurs extensions fonctionnent avec Extension Migrator.

Nom et description

Extension Migrator extrait les métadonnées de nom et de description des extensions installées afin d'indiquer aux utilisateurs le nom de chaque extension pouvant être migrée. Le code Ruby de chaque extension spécifie ces propriétés.

Pour vous assurer que le nom et la description de votre extension s'affichent comme prévu, utilisez un simple fichier racine RB d'extension comme celui-ci :

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

Les données plus complexes, telles que le chargement dynamique de valeurs à partir d'un fichier distinct, l'utilisation de valeurs conditionnelles qui modifient le nom d'affichage ou l'interpolation de chaînes de caractères, risquent de ne pas être incluses dans le programme de migration. Voici un exemple de ce qu'il ne faut pas faire :

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

Si Extension Migrator ne parvient pas à trouver le nom et la description de l'extension, il reprend le nom du fichier .rb. L'extension apparaît toujours dans la liste, mais elle n'a pas le nom approprié.

Licences

La licence des extensions payantes doit être récupérée et activée la première fois que l'utilisateur interagit avec l'extension après la migration. Si une extension repose sur un système de licence personnalisé, il se peut que cette licence ne soit pas trouvée. Pour faciliter la migration des extensions pour les utilisateurs, SketchUp recommande d'inclure un rappel invitant l'utilisateur à saisir à nouveau sa clé de licence lorsqu'une licence est manquante.