Apresentando um novo pub.dev

Hoje lançamos um novo site do pub.dev. Ele traz novas métricas de pontuação para dar a você uma visão melhor de pacotes potencialmente úteis e para oferecer aos publicadores de pacotes um feedback mais acionável sobre como melhorar a qualidade. Para ajudar você a encontrar pacotes que suportam todas as plataformas de seu interesse, adicionamos a identificação e a busca de pacotes multiplataforma. E, no geral, redesenhamos a interface, buscando uma experiência agradável e elegante, consistente com os nossos sites dart.dev e dartpad.dev.

Com quase 7.000 novos pacotes publicados no último ano, você não tem falta de opções quando procura pacotes para estender as funcionalidades dos seus apps. Mas, com tantos pacotes para escolher, naturalmente você quer que os mais curtidos, de maior qualidade e mais populares apareçam em destaque. Para melhorar os resultados de busca de pacotes, redesenhamos o sistema de pontuação do pub.dev em torno de três dimensões:

1. Curtidas: uma medida de quantos desenvolvedores curtiram um pacote. Isso fornece uma medida bruta do sentimento geral em relação a um pacote.

2. Pub points: uma nova medida de qualidade. Ela inclui várias dimensões de qualidade, como estilo de código, suporte a plataformas e manutenibilidade. Mais sobre isso abaixo.

3. Popularidade: uma medida de quantos desenvolvedores usam um pacote. Ela reflete o número de apps que dependem do pacote nos últimos sessenta dias. A escala normalizada vai de 100% (o pacote mais usado) a 0% (o pacote menos usado), mas estamos investigando se conseguiremos fornecer contagens absolutas de uso em uma versão futura.

Esperamos que essas novas dimensões ajudem tanto os consumidores de pacotes que buscam dependências quanto os publicadores que trabalham para lançar pacotes de alta qualidade.

Como curtidas e popularidade fornecem medidas subjetivas, vindas da comunidade, o objetivo dos pub points é oferecer uma aproximação próxima de uma qualidade objetiva e mensurável. Isso não é fácil: os desenvolvedores percebem a qualidade de várias maneiras, mas ainda acreditamos que a maioria deles busca características essenciais que podemos medir. O modelo de pontuação anterior do pub.dev se baseava em subtrair pontos por problemas. O novo modelo inverte essa abordagem, concedendo pontos com base em características de cinco categorias:

1. Seguir as convenções de arquivos Dart: seguir as boas práticas em relação aos arquivos pubspec, readme e changelog

2. Fornecer documentação: fornecer documentação da API e um exemplo ilustrativo

3. Suportar várias plataformas: suportar o máximo possível de plataformas Dart e Flutter

4. Passar na análise estática: fornecer código livre de erros, avisos e lints

5. Suportar dependências atualizadas: ter restrições de dependência que suportem os SDKs mais recentes do Dart e do Flutter, e as dependências de pacotes mais recentes

Esperamos adicionar mais verificações e categorias aos pub points com o tempo, elevando o teto de pontos que um pacote pode ter. Por exemplo, planejamos adicionar uma pontuação para o suporte à null safety quando esse recurso for lançado. E estamos investigando como medir a manutenibilidade (capacidade de resposta a issues e pull requests), a testabilidade (cobertura automatizada de testes) e a amigabilidade com a comunidade (número de contribuidores, mantenedores etc.). Se você tiver uma ideia de medida excelente, adoraríamos ouvir você!

Tanto o Dart quanto o Flutter se destacam na criação de apps para várias plataformas. No pub.dev, fornecemos tags claras de plataforma para mobile (iOS e Android) e web, além de filtros de busca para essas plataformas:

Para garantir que o seu pacote seja marcado com o suporte correto de plataforma, siga as orientações da página de ajuda sobre pontuação do pub.dev.

Vamos adicionar suporte semelhante para plataformas desktop (macOS, Windows e Linux) quando isso chegar a um estado mais definitivo. Por enquanto, você pode encontrar filtros para essas plataformas nas opções de busca Avançada:

A equipe do pub.dev do Dart colaborou com o Google Developer Studio, nossa equipe criativa interna, tendo Jeremy Sie como designer principal. Junto com as atualizações funcionais, a equipe analisou com cuidado o design visual, compartilhando suas ideias sobre o projeto. Com o objetivo de oferecer uma experiência coerente, acessível e centrada no usuário, fizemos uma série de refinamentos baseados no sistema Material Design do Google. Nossa meta era criar uma interface leve e enxuta, permitindo fluxos claros e concisos tanto para publicadores quanto para consumidores de pacotes.

O design atualizado traz componentes Material, como cards e chips, que exibem com clareza os detalhes dos pacotes e permitem maior transparência sobre como cada pacote funciona. Atualizamos o sistema tipográfico e melhoramos a escala tipográfica em todo o site, trazendo mais clareza aos resultados de busca e melhorando a forma como as informações dos pacotes são exibidas. Componentes como as pontuações dos pacotes foram redesenhados para ficarem mais claros e estruturados, de modo que o processo de pontuação fique mais transparente e fácil de entender.

Também fizemos mudanças na página inicial. Sabíamos que a possibilidade de buscar pacotes rapidamente era parte central do site, mas queríamos melhorar a experiência destacando as ferramentas e bibliotecas mais úteis. Adicionamos seções como Favoritos do Flutter e Pacotes mais populares logo no início, para ajudar você a explorar rapidamente alguns dos melhores pacotes disponíveis. Também analisamos com atenção a paleta de cores e a direção de arte, incorporando ilustrações e tornando componentes como os exemplos de código visualmente consistentes com dart.dev e dartpad.dev.

Convidamos você a experimentar hoje a nova experiência de navegação e busca do pub.dev, e a usar as novas dimensões de pontuação e o relatório de pub points.

Se você é desenvolvedor de pacotes, incentivamos a ver os pub points dos seus pacotes, procurando oportunidades para melhorá-los. Para mais detalhes sobre como o sistema de pontuação funciona, veja a ajuda sobre pontuação do pub.dev.

Como sempre, adoramos feedback. Deixe seus comentários abaixo ou abra issues no tracker de issues do pub.dev.

Por: Michael Thomsen (Gerente de Produto, Dart) & Jeremy Sie (Designer Visual, Google Developer Studio)