Compartilhe suas extensões com o mundo!
No último ano, ocorreram mais de 30 milhões de ativações exclusivas do SketchUp, com mais de 2,5 milhões delas ativas por semana. A cada segundo, o SketchUp é aberto por 30 pessoas ao redor do mundo. O Extension Warehouse oferece uma maneira de disponibilizar sua extensão do SketchUp para toda a comunidade do SketchUp.
Processo de publicação
A seguir, você encontra uma descrição geral do processo de publicação da sua extensão no Extension Warehouse:
- Escrita do código: pense em algo inovador que ajudará os usuários do SketchUp. Escreva um código que torne a ideia realidade. Teste seu código para provar para si que ele funciona como o esperado.
- Criação do instalador rbz: crie o RBZ pronto para lançamento, de acordo com os Requisitos técnicos declarados nesta página.
- Upload para o Extension Warehouse: preencha o formulário de upload e inclua detalhes sobre sua extensão para que os usuários em potencial saibam o que seu código faz e se ele seria útil para suas necessidades.
- Verificações finais e publicação: confirme que todos os detalhes estão corretos, respire fundo e clique no botão "Submit for Review" (Enviar para revisão).
- Revisão pela equipe do SketchUp: nossa excelente equipe de revisores de extensão vai analisar seu envio e validá-lo de acordo com nossos critérios de revisão e aceitação. Se algo estiver incorreto, enviaremos uma mensagem explicando o que precisa ser corrigido antes que a extensão possa ser lançada.
- Pronta para a publicação: Oba! Sua extensão passou pela revisão e está pronta para ser publicada. Enviaremos um e-mail a você com a boa notícia quando seu envio assim que o envio for aprovado.
- Publicação: nesta etapa, você precisará voltar a página "My Extensions" (Minhas extensões) para publicar sua extensão. Ela não ficará visível para o público até que você a publique.
Diretrizes de publicação
Esta seção documenta os requisitos que os desenvolvedores devem atender antes de concordarmos em publicar suas extensões no Warehouse. Podemos alterar estes requisitos periodicamente, a nosso critério.
Requisitos de envio
A seguir estão os requisitos mínimos de envio para extensões oferecidas aos usuários do SketchUp por meio do Extension Warehouse. Você pode, sem dúvidas, oferecer mais do que o descrito abaixo, mas não aceito menos. As extensões oferecidas por meio do Warehouse devem ser:
- Úteis: a extensão deve fornecer algumas funcionalidades úteis para os usuários do SketchUp.
- Únicas: as extensões não devem apenas duplicar recursos ou serviços existentes do cliente SketchUp. Elas devem estender de modo significativo algum recurso principal ou adicionar funcionalidades totalmente novas.
Funcionais: as extensões devem ser instaladas e operar conforme anunciado. A extensão não deve causar travamentos ou lentidão no SketchUp.
Para garantir a funcionalidade e a utilidade para os clientes, consulte nossas Diretrizes de UX.- Seguras: a extensão não deve, por má intenção do desenvolvedor, causar danos aos dados do usuário nem ao sistema operacional.
- Documentadas: a extensão deve ser documentada. A equipe do SketchUp não documentará sua extensão para você.
- Com suporte: o desenvolvedor da extensão deve estar disponível para responder a perguntas de suporte técnico após os usuários instalarem a extensão. A equipe do SketchUp não oferecerá suporte aos seus usuários.
- Compactadas corretamente como um arquivo RBZ: arquivos RBZ nada mais são do que arquivos ZIP de scripts Ruby e outros recursos com uma estrutura de pastas interna específica.
- Não devem ser duplicatas de recursos do SketchUp Pro para usuários do SketchUp Make: as extensões não devem duplicar recursos do SketchUp Pro que não estejam disponíveis para usuários do SketchUp Make. Se sua extensão duplicar recursos do Pro, ela precisa atender ao requisito "Única" (veja acima) e não deve funcionar no SketchUp Make.
Requisitos técnicos
A seguir estão os requisitos técnicos mínimos para todas as extensões enviadas. Estes são os limites que você deve respeitar para que sua extensão se comporte bem e opere com eficiência no aplicativo cliente do SketchUp.
Observação: esperamos que você já seja um desenvolvedor experiente em Ruby para SketchUp. Se você for novo, consulte a página para desenvolvedores para obter a documentação da API e saber mais sobre as extensões do Sketchup e os arquivos RBZ.
Pacote: o Extension Warehouse aceita apenas pacotes RBZ. Eles são arquivos ZIP com uma extensão de arquivo diferente. Temos alguns requisitos para o que deve estar dentro dos seus RBZs. Dentro da raiz do pacote rbz, permitimos apenas um único arquivo Ruby que carrega sua extensão e uma pasta que contém o restante dos arquivos da extensão.
OBSERVAÇÃO: a pasta deve ter um nome idêntico ao do arquivo Ruby (sem a extensão ".rb").- Nome de extensão exclusivo: tudo começa com a escolha de um nome exclusivo para sua extensão. Vamos supor que você esteja criando um plugin chamado Swivel Driver e sua empresa se chame GoCorp. Recomendamos que você inclua suas iniciais ou o nome da empresa antes dos nomes dos arquivos da extensão.
- Namespaces: envolva todo o seu código em um namespace de desenvolvedor para protegê-lo de conflitos com scripts de outros desenvolvedores.
- Práticas recomendadas para "Desfazer": se sua extensão adicionar ou alterar o modelo, é altamente recomendável que você envolva essas etapas em uma chamada Model.start_operation / commit_operation para que os usuários possam recuperar seus modelos com um único comando Editar > Desfazer.
Requisitos de suporte
A equipe do SketchUp não se responsabiliza pelo suporte aos usuários da sua extensão. Você precisará ter um sistema para oferecer suporte aos seus usuários. No mínimo, isso inclui:
Documentação: um grande número de usuários instala extensões do SketchUp apenas para se deparar com o desafio de localizar novos recursos na interface de usuário do SketchUp e descobrir como eles funcionam, tudo isso sem suporte. Uma extensão de sucesso é aquela que seus usuários conseguem aprender a usar. Não negligencie esta etapa. Recomendamos que você ofereça na página de suporte do seu site:
Etapas detalhadas de como começar. Use nomes de menu específicos e capturas de tela, se possível.
- Um vídeo que mostre o uso.
- Se apropriado, um link para algum arquivo de amostra que permite aos usuários demonstrar o plug-in em um "melhor cenário".
- Contato de suporte: os usuários devem poder entrar em contato com você para obter suporte. Forneça um site ou um endereço de e-mail de suporte nos links do perfil da sua conta ou nos campos de descrição da extensão.
- Treinamento: embora não seja obrigatório, os usuários apreciarão qualquer vídeo de treinamento ou outros materiais semelhantes que você possa oferecer para ajudá-los a progredir na curva de aprendizado.
Dependências de código
Se sua extensão depender de outras bibliotecas de código, você precisará agrupá-las no pacote da extensão ou fornecer instruções claras aos usuários sobre como baixá-las e instalá-las.
Motivos pelos quais podemos rejeitar sua extensão
A verdade é que é possível que sua extensão não passe pelo nosso processo de revisão. Se isso acontecer, o motivo provavelmente será algo pequeno e fácil de corrigir. Veja a seguir uma lista de motivos que podemos mencionar ao rejeitar uma extensão. Ela serve como um guia para aumentar a probabilidade de sua extensão passar pelo processo de revisão.
Sua extensão trava durante o uso ou faz com que o SketchUp trave ou tenha um desempenho ruim ao ser carregada. Se sua extensão simplesmente travar, ela não será de muita utilidade para ninguém.
Sua extensão faz com que a extensão de outra pessoa trave ou tenha um desempenho ruim. Parte da participação no Extension Warehouse é um reconhecimento de que você não está fazendo isso isoladamente. Isso só funciona de verdade se todos permanecerem dentro dos limites.
Sua extensão apresenta erros óbvios que a impedem de ser usada conforme anunciado. Ninguém gosta de códigos que não funcionam corretamente. Isso reflete negativamente em você e em nós. Teste seu código antes de enviá-lo e certifique-se de que ele faça o que você espera.
Sua extensão não funciona como anunciado. Não faça propaganda enganosa. Você deve descrever o que sua extensão faz e fornecer essa funcionalidade.
Sua extensão usa APIs não documentadas no SketchUp. As APIs não documentadas não são seguras de usar porque estão sujeitas a alterações a qualquer momento e provavelmente não foram testadas muito bem. Em outras palavras, elas podem não funcionar no futuro. E mesmo que funcionem... provavelmente não funcionarão bem ou de forma confiável hoje porque não as testamos adequadamente.
Sua extensão é uma duplicata da extensão de outra pessoa. Uma extensão que você afirma ser sua não deve ser apenas uma cópia do trabalho de outra pessoa. Seja original ou, pelo menos, adicione algo novo se for uma extensão inspirada. Não copie diretamente.
Sua extensão é spam. Extensões que são apenas uma propaganda de outra coisa não serão aceitas.
Ela viola nossos termos de serviço, contrato de licença para usuário final ou política de privacidade.
Ela infringe a marca comercial, direitos autorais ou patentes de terceiros.
Ela executa código malicioso com a intenção de danificar o computador de outro usuário.
Ela contém informações, imagens ou materiais inapropriados, difamatórios, obscenos, lascivos, pornográficos ou ilegais.
Ela não cumpre todos os requisitos legais aplicáveis.