Componentes e relações de dependência
Um grafo de dependências representa os componentes de um projeto e indica quais dependem de quais. Cada componente ocupa um vértice do grafo. As ligações entre eles registram as dependências, permitindo acompanhar tanto os pacotes declarados pelo projeto quanto os exigidos por outros pacotes.
Você pode encontrar uma biblioteca instalada que não aparece entre as dependências declaradas no manifesto do projeto. Ao acompanhar as ligações do grafo até essa biblioteca, consegue identificar o componente que a incluiu.
Um pacote incluído por outro
Num exemplo didático, o projeto declara o pacote A e esse pacote exige B. O caminho projeto → A → B mostra que A é uma dependência direta e B é transitiva. O projeto precisa considerar B ao revisar suas bibliotecas, mesmo sem uma declaração direta desse pacote no manifesto.
Quando um aviso aponta uma versão vulnerável de B, você pode acompanhar esse caminho para examinar qual atualização de A aceita uma versão corrigida. Depois da alteração, confira a versão de B registrada no lockfile e execute os testes pertinentes ao uso de A. A mudança no manifesto, sozinha, não confirma a versão de B efetivamente instalada.
O alcance do grafo no GitHub
O GitHub constrói seu grafo a partir dos manifestos e lockfiles compatíveis presentes no repositório. A plataforma também recebe informações pela API de submissão de dependências. A cobertura depende do ecossistema aceito e das informações disponíveis, por isso a ausência de um pacote nessa tela não comprova sua ausência na aplicação.
Nos ecossistemas com suporte a dependências transitivas, você pode consultar os caminhos que incluem cada pacote. O grafo mostra essas relações e os avisos conhecidos, mas a possibilidade de exploração precisa ser examinada conforme a versão e o uso do componente.
Dúvidas frequentes
Perguntas frequentes sobre grafo de dependências
- Qual é a diferença entre dependência direta e transitiva?
- A dependência direta é declarada pelo próprio projeto. A transitiva chega por outro componente, que também precisa dela para funcionar. Um pacote pode aparecer pelos dois caminhos.
- De onde vêm as informações do grafo no GitHub?
- O GitHub analisa manifestos e lockfiles dos ecossistemas aceitos. Também incorpora dependências enviadas pela API de submissão, o que permite acrescentar informações obtidas durante o build.
- Um aviso no grafo confirma que a aplicação pode ser explorada?
- O aviso indica uma vulnerabilidade conhecida associada à dependência. Para avaliar sua aplicação, você precisa conferir a versão usada e as condições de exploração descritas no aviso.
Para continuar
Recursos relacionados
Documentação
GitHub: grafo de dependências
Explicação do GitHub sobre a origem das dependências exibidas e a consulta dos caminhos transitivos.
Abrir recursoSite de referência
Dev Side Studio: desenvolvimento colaborativo
Sessão ao vivo para você examinar as dependências do projeto e conferir o efeito de uma atualização.
Abrir recursoAplicação na formação
Vibe Coding: Do Zero ao MVP
Ao revisar bibliotecas usadas pelo projeto, você pode consultar o grafo para localizar uma dependência transitiva e conferir sua versão.
Conhecer a formação
Fontes consultadas
Referências deste verbete
Este verbete ajudou você?
Obrigado pela resposta. Ela fica salva apenas neste navegador.