O Extension Migrator pode ajudar os usuários a manter suas extensões favoritas ao atualizar o SketchUp. Para os desenvolvedores de extensões, é necessário ter algumas coisas em mente para garantir que as extensões funcionem com o Extension Migrator.

Nome e descrições

O Extension Migrator extrai metadados de nome e descrição de extensões instaladas para mostrar aos usuários o nome de cada extensão disponível para migração. O código Ruby de cada extensão especifica essas propriedades.

Para garantir que o nome e a descrição da sua extensão sejam exibidos conforme o esperado, use um arquivo RB raiz de extensão simples como este:

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

Dados mais complicados, como carregar valores dinamicamente de um arquivo separado, usar valores condicionais que alteram o nome de exibição ou usar interpolação de strings, podem fazer com que o migrador não colete esses dados. Este é um exemplo do que não fazer:

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

Se o Extension Migrator não conseguir coletar o nome e a descrição da extensão, ele retornará ao nome do arquivo .rb . A extensão ainda aparecerá na lista, mas não terá o nome correto.

Licenciamento

A licença para extensões pagas deve ser obtida e ativada na primeira vez que o usuário interagir com a extensão após a migração. Se uma extensão usar um sistema de licenciamento personalizado, essa licença pode não ser encontrada. Para ajudar os usuários durante a migração, o SketchUp recomenda incluir um lembrete quando uma licença estiver ausente, solicitando que o usuário insira a chave de licença novamente.