chromium dashboard

Status da plataforma Chrome

Missão

Chromestatus.com é a ferramenta oficial usada para rastrear os lançamentos de recursos no Blink (o mecanismo do navegador que alimenta o Chrome e muitos outros navegadores da web). Essa ferramenta guia os proprietários de recursos através do nosso processo de lançamento e serve como uma fonte primária para informações do desenvolvedor que depois ondula o ecossistema do desenvolvedor da Web.

Obtenha o código

Para obter uma configuração de um clique que aproveita o DevContainers, consulte o devContainer ReadMe. Caso contrário, para continuar configurando localmente:

 git clone https://github.com/GoogleChrome/chromium-dashboard

Instalação

1. Instale o GCloud e os componentes necessários:
   1. Antes de começar, verifique se você tem um Java JRE (versão 8 ou superior) instalado. O JRE é obrigado a usar o emulador de armazenamento de dados e o OpenApi-Gerator-cli.
   2. Google App Engine SDK para Python. Certifique -se de selecionar Python 3.
   3. gcloud init
   4. gcloud components install cloud-datastore-emulator
   5. gcloud components install beta
2. Instale outros comandos de ferramentas de desenvolvedor
   1. Nó e NPM.
   2. Gulp: npm install --global gulp-cli
   3. Ambiente Virtual Python: sudo apt install python3.11-venv
3. Recomendamos usar uma versão do nó mais antiga, por exemplo, nó 18
   1. Use node -v para verificar a versão padrão do nó
   2. nvm use 18 para mudar para o nó 18
4. cd chromium-dashboard
5. Instale o JS e as dependências Python: npm run setup
   1. NOTA: Sempre que fizer alterações no package.json ou requisitos.txt, você precisará executar npm run clean-setup .

Se você encontrar algum erro durante o processo de instalação, as notas da seção (posteriormente neste Readme.md) poderão ajudar.

Em desenvolvimento

Para iniciar o servidor principal e o back -end do notificador, execute:

npm start

Em seguida, visite http://localhost:7777/ .

Para iniciar o Código Front End Watching (Sass, JS Lint Check, Babel, Minify Files), execute

npm run watch

Para executar fiapos e analisadores Lit:

npm run lint

Para executar testes de unidade:

npm test

Isso iniciará um emulador local de armazenamento de dados, executará testes de unidade e depois desligará o emulador.

Para atualizar test_html_rendering.html, modifique o método test_html_rendering no arquivo de teste correspondente, descompensando a linha que se parece:

 # TESTDATA.make_golden(template_text, 'test_html_rendering.html')

Em seguida, execute o teste novamente (e talvez mais uma vez) e, em seguida, você pode reverter sua alteração dos arquivos de teste.

Para executar os testes visuais dramaturgos (também conhecidos como testes de ponta a ponta), o comando a ser usado é:

npm run pwtests

Se houver erros, eles serão exibidos no console. Se você precisar atualizar qualquer uma das imagens de captura de tela, verá diferenças no diretório packages/playwright/test-results e, se eles parecerem corretos, poderá atualizar todas as imagens para todos os testes com:

npm run pwtests-update

As imagens atualizadas também são adicionadas ao diretório de capturas de tela . Imagens que não precisavam ser atualizadas não aparecem como tendo sido alteradas. Se você alterar os nomes dos arquivos de teste, ou os nomes dos métodos de teste ou os nomes de arquivos de imagem de captura de tela, novos arquivos serão gerados e você precisará excluir manualmente os arquivos antigos. Você pode simplesmente excluir todas as capturas de tela e atualizar tudo, mas isso levará muito tempo.

Você pode atualizar imagens para apenas um arquivo de teste adicionando --filename=some_pwtest.js ao comando pwtests-update . O nome de some_pwtest.js não precisa ser um caminho completo.

Se houver erro relatado pela ação do dramaturgo do Github CI, você poderá olhar para o log de erros, mas se o problema for uma diferença em algumas das imagens, provavelmente deve baixar o arquivo .zip Artifact contendo todas as diferenças.

Há algumas informações adicionais para desenvolvedores no desenvolvedor documentação.md.

Ensaios de origem

Para testar a funcionalidade deste aplicativo localmente que interage com os dados da API de ensaios de origem, uma chave da API precisará ser adquirida. Para fazer isso, execute o seguinte comando:

npm run dev-ot-key

NOTA: Somente os desenvolvedores com acesso ao projeto GCP-Station GCP poderão executar com êxito este comando. Se você precisar testar isso e não tiver acesso, abra um problema.

Notas

• Se você receber um erro dizendo No module named protobuf ou No module named six ou No module named enum , tente instalá -los localmente com pip install six enum34 protobuf .

• Ao instalar o GAE SDK, certifique -se de obter a versão do Python 3.

• Se você executar o servidor localmente e estiver desconectado da sua janela terminal, os trabalhos poderão permanecer em execução, o que o impedirá de iniciar o servidor novamente. Para contornar isso, use npm run stop-emulator; npm stop . Ou use ps aux | grep gunicorn e/ou ps aux | grep emulator , use o comando Unix kill -9 para encerrar esses trabalhos.

• Se você precisar testar ou depurar qualquer coisa a ver com dependências, poderá começar a executar npm run clean-setup .

• Ocasionalmente, o Google Cloud CLI Will requer uma atualização, que causará uma falha ao tentar executar o servidor de desenvolvimento com npm start . Uma mensagem de erro não relacionada Failed to connect to localhost port 15606 after 0 ms: Connection refused será exibida. A execução do comando gcloud components update atualiza conforme necessário e resolverá esse problema.

Componentes do piscar

Atualmente, o Chromestatus recebe a lista de componentes do Blink do arquivo hack_components.py .

Semear os proprietários de componentes piscantes

Visite http: // localhost: 7777/admin/pisk/populate_blink para ver a lista de proprietários de componentes do Blink.

Depuração / Configurações

settings.py contém uma lista de globais para depuração e execução do site localmente.

Implantando

Se você tiver alterações locais não comprometidas, o nome da versão do AppEngine terminará com -tainted . Não há problema em testar a encenação com versões contaminadas, mas tudo deve ser cometido (e, portanto, não contaminado) antes de realizar uma versão que pode ser posteriormente pressionada ao Prod.

Observe que você precisa ter privilégios de administrador nos projetos de cloud cr-status-staging e em nuvem cr-status para poder implantar o site.

Execute o destino do NPM:

 npm run staging

Abra o console do Google Developer para o site de estadiamento e deslize para a nova versão selecionando na lista e clicando em migrar tráfego . Certifique -se de fazer isso tanto pelo serviço 'padrão' quanto para o serviço 'notificador'.

Como alternativa, execute npm run staging-rc para fazer upload do mesmo código para uma versão chamada rc para "Liberação do candidato". Esta é a única versão que você pode testar usando o Google assinar em https://rc-dot-cr-status-staging.appspot.com .

Se o teste manual no servidor de estadiamento parecer bom, repita as mesmas etapas a serem implantadas para produzir:

 npm run deploy

Abra o Google Developer Console para o site de produção

O site de produção deve ter apenas versões que correspondem às versões no estadiamento.

LICENÇA

Copyright (c) 2013-2022 Google Inc. Todos os direitos reservados.

Licença Apache2.