Velo: sobre pacotes

Ao escrever código, você geralmente precisa criar alguns recursos ou funcionalidades complexas. Às vezes, você descobre que outra pessoa já escreveu e implementou a funcionalidade que você precisa. Em vez de reinventar a roda e escrever o mesmo código novamente, você pode encontrar um pacote pronto escrito por outras pessoas e incorporá-lo em seu próprio código. Usar pacotes prontos, também conhecidos como bibliotecas de código, é uma ótima maneira de minimizar seu tempo de desenvolvimento e a quantidade de código que você precisa escrever.

Existem 2 tipos de pacotes prontos disponíveis para adicionar ao seu site Velo:

Os pacotes Velo podem ser divididos em 2 categorias:

Você pode adicionar pacotes ao seu site no Gerenciador de pacotes, que você pode acessar na seção Arquivos de código do menu lateral Velo. Para adicionar um pacote, passe o mouse sobre @velo ou npm na seção Pacotes em Arquivos de código, clique no ícone de adição , selecione o pacote e clique em Instalar. Para obter mais informações, consulte os artigos de cada tipo de pacote.

Construído usando as APIs do Velo, os pacotes Velo são criados especificamente para sites Wix e funcionam perfeitamente com elementos e aplicativos Wix. Ao contrário dos pacotes npm, os casos de uso do pacote Velo são específicos para o seu site Wix.

Um pacote Velo pode incluir arquivos de código de back-end, arquivos de código públicos e pacotes npm. A funcionalidade de um pacote do Velo está disponível para uso por meio de suas funções exportadas. Um arquivo config.json editável também pode ser incluído para definir configurações específicas para o seu pacote. Você pode importar as funções e usá-las em seu código assim como importa e usa funções exportadas que você escreve em arquivos .js e .jsw.

Os pacotes Velo construído pelo Wix permitem que você adicione funcionalidades complexas e populares ao seu site sem gastar horas escrevendo código. Escolha o pacote Velo que você deseja e importe-o em cada site onde você deseja adicionar a funcionalidade específica. Você pode visualizar todo o código usado para implementar um pacote.

Cada pacote Velo construído pelo Wix contém um arquivo readme detalhado que explica a funcionalidade do pacote e as etapas necessárias para a implementação. Algumas funções de pacote são internas e não podem ser usadas diretamente em seu site. Veja o arquivo readme do pacote para ver a lista de funções disponíveis para uso.

Para ajudar você a entender como usar pacotes Velo específicos construídos pelo Wix em seu site, adicionamos alguns exemplos à página de exemplos do Velo que integram pacotes Velo. Procure a etiqueta Velo package no exemplo.

Se você tiver uma ideia para um pacote Velo que ainda não está em nosso registro, você pode solicitá-la na lista de desejos do Velo. Para saber mais, consulte Trabalhar com pacotes Velo (em inglês).  

Você pode criar seus próprios pacotes Velo usando Wix Blocks (em inglês). Esses pacotes são privados e só aparecerão em sites onde você é o proprietário do site, na seção Meus pacotes do seu Gerenciador de pacotes.

Depois de criar um pacote no Wix Blocks, o pacote fica disponível para instalação no Gerenciador de pacotes do Velo. Uma vez instalado no seu site, o pacote fica visível para os colaboradores do site. Eles podem ver o pacote no menu lateral Velo e no Gerenciador de pacotes em Pacotes instalados > Pacotes criados por terceiros. No entanto, os colaboradores do site não podem fazer alterações em pacotes criados por outros.

Criar um pacote é uma maneira conveniente de reutilizar seu código em vários sites. Basta escrever seu código no Wix Blocks, compilar o pacote e importar seu pacote em cada site onde você deseja adicionar a funcionalidade específica do código. Você também pode atualizar seu pacote sempre que quiser. Para saber mais, consulte Trabalhar com seus pacotes Velo (em inglês).

npm é o registro mais popular de pacotes prontos. Os pacotes são criados e mantidos por desenvolvedores npm. O Velo permite que você instale em seu site pacotes npm aprovados. A maioria dos pacotes npm que são úteis em sites Velo já foram aprovados. Se você quiser usar um pacote npm que ainda não foi aprovado, você pode solicitar que ele seja adicionado à lista. Observe que, mesmo que um pacote npm tenha sido aprovado, é sua responsabilidade seguir as diretrizes do desenvolvedor do pacote npm para entender a funcionalidade do pacote, em quais situações ele pode ser usado e em quais situações ele não deve ser usado. Uma vez instalado, você pode importar o pacote e usá-lo em seu código. Para saber mais, consulte Trabalhar com pacotes npm.