Bibliotecas de componentes
Uma biblioteca é uma coleção nomeada de componentes relacionados. Por exemplo, uma biblioteca de "Stripe Billing" pode conter um conector de API de Customers, um conector de API de Invoices, um fluxo de trabalho de tratamento de webhooks e uma estrutura de dados de faturamento. As bibliotecas mantêm os componentes relacionados juntos e controlam quem pode vê-los.
Espaço de trabalho vs. público
Cada biblioteca é privada para o seu espaço de trabalho ou compartilhada no marketplace público.
Bibliotecas do espaço de trabalho são privadas para o seu espaço de trabalho. É aqui que você padroniza e reutiliza seus próprios componentes - os blocos de construção que sua equipe usa em todos os projetos. Somente os membros do seu espaço de trabalho podem vê-los.
Bibliotecas públicas são o marketplace compartilhado da Buildprint. Quando uma biblioteca se torna pública, todos os espaços de trabalho da Buildprint podem encontrar e instalar seus componentes.
Visibilidade, de ponta a ponta
Dois fatores determinam se alguém pode usar um componente: o status de listagem da biblioteca e o status do próprio componente.
Status de listagem da biblioteca
Status | Quem pode ver a biblioteca |
|---|---|
Privada | Apenas o seu espaço de trabalho (o padrão) |
Aguardando aprovação | Enviada ao marketplace, em revisão pela Buildprint |
Pública | Disponível no marketplace — todos os espaços de trabalho |
Arquivada | Oculta |
Status do componente (dentro da sua biblioteca)
Status | Significado |
|---|---|
Rascunho | Em desenvolvimento, não publicada |
Pública | Publicada dentro da sua biblioteca |
Arquivada | Aposentada |
A regra que os conecta: um componente só pode ser acessado por pessoas fora do seu espaço de trabalho quando o componente é Público *e* a sua biblioteca é Pública. Dentro de uma biblioteca interna, todo componente é efetivamente interno - independentemente do seu próprio status - porque a própria biblioteca não está no marketplace. É por isso que o selo de um componente mostra "Internal" até a biblioteca se tornar pública.
Tornar pública
Publicar no marketplace é uma etapa revisada:
Você empacota uma biblioteca com status de listagem pública.
A biblioteca passa para Aguardando aprovação - ela ainda não está disponível.
Um administrador da Buildprint a revisa e a aprova como Pública.
Os administradores do espaço de trabalho não podem tornar uma biblioteca pública diretamente por conta própria; a etapa de revisão mantém o marketplace organizado. Até a aprovação, a biblioteca e seus componentes permanecem visíveis apenas para o seu espaço de trabalho.
O que há em um componente
Cada componente em uma biblioteca inclui:
um nome e uma breve descrição (a frase curta no cartão),
uma descrição completa (visão geral, como aplicar e requisitos),
uma ou mais categorias (banco de dados, UI, fluxo de trabalho, expressão, API, plugin),
dependências — outros componentes da biblioteca de que ele precisa, e
imagens