Imagine encontrar, em segundos, um gerador de PDF pronto a usar, uma biblioteca SVG ou um gerador de PPT, todos criados especificamente para o 4D, e adicioná-los ao seu projeto com um único clique. Sem ter de recriar tudo do zero, sem ter de reinventar a roda.
É exatamente isso que o 4D Corner lhe oferece. É o catálogo oficial de componentes 4D: blocos de construção pré-criados e contribuídos pela comunidade que pode explorar, avaliar e integrar nos seus projetos 4D com apenas alguns cliques. Quer pretenda acelerar o desenvolvimento, alargar as capacidades da sua aplicação ou partilhar o seu próprio trabalho com a comunidade, o 4D Corner é o local onde tudo acontece.
Este guia explica-lhe como encontrar e utilizar componentes do catálogo e, se estiver pronto, como contribuir com os seus próprios.
O QUE É O 4D CORNER?
O 4D Corner é o repositório oficial onde os programadores podem descobrir, explorar e integrar componentes 4D pré-construídos. Trata-se de um catálogo selecionado, concebido para centralizar centenas de componentes contribuídos pela comunidade, facilitando a localização exata do que precisa e a sua integração perfeita no seu projeto com um único link de dependência.
NAVEGAR E UTILIZAR COMPONENTES 4D
Encontrar o componente certo
- Visite o 4D Corner – Navegue pelo catálogo completo de componentes disponíveis
- Pesquisar por categoria – Filtrar componentes por funcionalidade, autor ou etiquetas

- Ver detalhes do componente – Leia descrições, documentação e informações sobre a versão
- Verifique a compatibilidade – Confirme a versão mínima do 4D necessária para o seu projeto

- Aceda aos detalhes do componente – Clique em qualquer componente para ver todas as informações e opções de integração

Adicionar um componente ao seu projeto
Depois de encontrar um componente que pretenda utilizar:
- Copie o link de dependência – Cada componente apresenta uma referência de dependência pronta a utilizar. Clique em
- Cole nas dependências do seu projeto – Adicione o link de dependência diretamente às dependências do seu projeto
- Pronto! – O seu componente está agora integrado e pronto a utilizar
O que obtém
Ao adicionar um componente do 4D Corner ao seu projeto, terá acesso a:
- Funcionalidades pré-construídas – Não é necessário programar do zero
- Manutenção ativa – Os componentes são atualizados regularmente pelos seus criadores
- Apoio da comunidade – Interaja com outros programadores que utilizam os mesmos componentes
- Integração perfeita – Os componentes foram concebidos para funcionar sem problemas com o 4D
PARTILHAR O SEU PRÓPRIO COMPONENTE (OPCIONAL)
Publicar o seu componente: os fundamentos técnicos
Lista de verificação pré-publicação
Antes de o seu componente poder aparecer no 4D Corner, certifique-se de que todos os seguintes requisitos estão preenchidos:
- Um ícone válido (logo.svg ou logo.png) está incluído no componente
- Está fornecida uma descrição clara no GitHub
- O tópico «4d-component» foi adicionado ao repositório
- Está definida uma licença no repositório
- Um ficheiro README explica como utilizar o componente
- O componente é empacotado como um ficheiro ZIP e adicionado a uma versão no GitHub
- É utilizada a versionagem semântica (majorVersion.minorVersion.patchNumber)
A estrutura do manifesto JSON
Para submeter o seu componente ao 4D Corner, deve criar um ficheiro de manifesto JSON. Este ficheiro contém os metadados que o 4D Corner utiliza para catalogar e apresentar o seu componente. O manifesto é uma parte obrigatória da sua submissão.
Campos obrigatórios:
| Campo | Tipo | Descrição |
|---|---|---|
| título | cadeia de caracteres | O nome do componente (não pode estar vazio) |
| repositório | string (URL) | A URL do repositório GitHub do componente |
Campos opcionais:
| Campo | Tipo | Descrição |
|---|---|---|
| path_logo | cadeia de caracteres (URL) | URL direta para o ficheiro do logótipo, útil se o logótipo estiver armazenado num local não padrão |
Exemplo em JSON:
{
"title": "4D QPDF",
"repository": "https://github.com/4d/4D-QPDF",
"path_logo": "https://raw.githubusercontent.com/4d/4D-QPDF/main/4D-QPDF/Resources/logo.svg"
}
Enviar o seu componente para o 4D Corner
Assim que o seu componente estiver devidamente preparado e o seu manifesto JSON estiver completo, pode submeter o seu componente ao repositório GitHub 4D_Corner_Component_List para revisão:
O processo de envio:
- Crie um Pull Request – Envie o seu ficheiro de manifesto JSON através de um pull request para o repositório 4D_Corner_Component_List
- Revisão pela equipado 4D Corner – O seu envio será analisado pela equipa do 4D Corner para garantir que cumpre os padrões de qualidade e as diretrizes
- Integração – Se o seu componente for aprovado, será integrado no catálogo do 4D Corner e ficará disponível para desenvolvedores em todo o mundo
O que o 4D Corner extrai do seu repositório
Quando o seu componente é indexado, o 4D Corner extrai automaticamente metadados do seu repositório GitHub:
| Campo | Fonte | Notas |
|---|---|---|
| Título | Nome do repositório | Exibido em destaque no catálogo |
| Autores | Proprietário do repositório | Indica quem mantém o componente |
| Descrição | Descrição do repositório | Aparece nos resultados de pesquisa e na página de detalhes |
| Licença | Ficheiro /license.md (raiz) | Informa os utilizadores sobre os direitos de utilização |
| Logótipo | /resources/logo.svg ou /resources/logo.png | Identificador visual no catálogo |
| Etiquetas | Tópicos do repositório | Ajudam os utilizadores a filtrar e pesquisar |
| Versão mínima do 4D | Tag da versão mais recente | Garante a compatibilidade |
| Versão | Versão mais recente | Mostra a versão atual |
| URL de download | Recursos da versão | Links para o download do componente |
| Última atualização | Data e hora da atualização | Indica manutenção ativa |
| Documentação | Página inicial do repositório | Direciona os utilizadores para guias detalhados |
| Link do repositório | URL do repositório | Permite aos utilizadores visualizar o código-fonte |
| Estado | Definições de privacidade | Apenas repositórios públicos |
CONCLUSÃO
O 4D Corner é vantajoso para todo o ecossistema 4D:
- Para os utilizadores: Descubra, avalie e integre componentes pré-construídos em segundos
- Para os colaboradores: Partilhem o vosso trabalho com milhares de programadores e construam uma reputação na comunidade
- Para a comunidade: Promova a inovação através de componentes reutilizáveis e bem mantidos
Quer esteja à procura de componentes para acelerar o seu desenvolvimento ou pronto para contribuir com os seus próprios, o 4D Corner é a plataforma central que torna tudo isso possível.
Pronto para começar? Visite o 4D Corner para explorar o catálogo ou consulte a documentação oficial da 4D para saber mais sobre o desenvolvimento e a publicação de componentes.
De momento, não é possível deixar comentários nesta publicação.