chromium dashboard

Statut de plate-forme chromée

Mission

Chromestatus.com est l'outil officiel utilisé pour le suivi des lancements de fonctionnalités à Blink (le moteur du navigateur qui alimente Chrome et de nombreux autres navigateurs Web). Cet outil guide les propriétaires de propriétaires de lanceurs et sert de source principale pour les informations des développeurs qui s'effondrent ensuite à travers l'écosystème du développeur Web.

Obtenez le code

Pour une configuration en un clic qui exploite les DevContainers, consultez le DevContainer Readme. Sinon, pour continuer à installer localement:

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

Installation

1. Installez les composants gcloud et nécessaires:
   1. Avant de commencer, assurez-vous d'installer un Java JRE (version 8 ou plus). JRE est nécessaire pour utiliser l'émulateur de données de données et OpenAPI-Generator-CLI.
   2. Google App Engine SDK pour Python. Assurez-vous de sélectionner Python 3.
   3. gcloud init
   4. gcloud components install cloud-datastore-emulator
   5. gcloud components install beta
2. Installez d'autres commandes d'outils de développeur
   1. Node et NPM.
   2. Gulp: npm install --global gulp-cli
   3. Python Virtual Environment: sudo apt install python3.11-venv
3. Nous vous recommandons d'utiliser une ancienne version de nœud, par exemple le nœud 18
   1. Utilisez node -v pour vérifier la version de nœud par défaut
   2. nvm use 18 pour passer au nœud 18
4. cd chromium-dashboard
5. Installer JS et Python Dependances: npm run setup
   1. Remarque: chaque fois que nous apportons des modifications à package.json ou exigences.txt, vous devrez exécuter npm run clean-setup .

Si vous rencontrez une erreur pendant le processus d'installation, la section note (plus tard dans ce Readme.md) peut vous aider.

Développement

Pour démarrer le serveur principal et le backend du notificateur, exécutez:

npm start

Visitez ensuite http://localhost:7777/ .

Pour démarrer l'observation du code frontal (Sass, JS Lint Check, Babel, Minify Files), exécutez

npm run watch

Pour courir des peluches et des analyses littorales:

npm run lint

Pour exécuter des tests unitaires:

npm test

Cela lancera un émulateur de plate-forme de données local, exécutera des tests unitaires, puis fermera l'émulateur.

Pour mettre à jour TEST_HTML_RENDERING.HTML, modifiez la méthode test_html_rendering dans le fichier de test correspondant, décomisez la ligne qui ressemble:

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

Ensuite, exécutez à nouveau le test (et peut-être une fois de plus), puis vous pouvez retourner votre modification des fichiers de test.

Pour exécuter les tests visuels du dramaturge (aka tests de bout en bout), la commande à utiliser est:

npm run pwtests

S'il y a des erreurs, ils seront affichés dans la console. Si vous devez mettre à jour l'une des images de capture d'écran, vous verrez les différences dans le répertoire packages/playwright/test-results , et s'ils semblent corrects, vous pouvez mettre à jour toutes les images pour tous les tests avec:

npm run pwtests-update

Les images mises à jour sont également ajoutées au répertoire des captures d'écran . Les images qui n'ont pas besoin d'être mises à jour n'apparaissent pas comme ayant été modifiées. Si vous modifiez les noms de fichiers de test, ou les noms de méthode de test, ou les noms de fichiers d'image de capture d'écran, de nouveaux fichiers seront générés et vous devrez supprimer manuellement les anciens fichiers. Vous pouvez simplement supprimer toutes les captures d'écran et mettre à jour tout, mais cela prendra assez longtemps.

Vous pouvez mettre à jour des images pour un seul fichier de test en ajoutant --filename=some_pwtest.js à la commande pwtests-update . Le nom some_pwtest.js n'a pas besoin d'être un chemin complet.

S'il y a une erreur rapportée par l'action GitHub CI Playwright, vous pouvez consulter le journal d'erreur, mais si le problème est une différence dans certaines images, vous devriez probablement télécharger le fichier .zip artefact contenant toutes les différences.

Il existe des informations supplémentaires pour les développeurs dans le développeur-documentation.md.

Essais d'origine

Pour tester les fonctionnalités de cette application localement qui interagissent avec les données de l'API d'essais Origin, une clé API devra être acquise. Pour ce faire, exécutez la commande suivante:

npm run dev-ot-key

Remarque: Seuls les développeurs ayant accès au projet GCP-statut-statut CR pourront exécuter avec succès cette commande. Si vous devez tester cela et que vous n'avez pas accès, ouvrez un problème.

Notes

• Si vous obtenez une erreur indiquant No module named protobuf ou No module named six ou No module named enum , essayez de les installer localement avec pip install six enum34 protobuf .

• Lors de l'installation du SDK GAE, assurez-vous d'obtenir la version de Python 3.

• Si vous exécutez le serveur localement, puis vous êtes déconnecté de votre fenêtre terminale, les travaux peuvent rester en cours d'exécution, ce qui vous empêchera de recommencer le serveur. Pour contourner cela, utilisez npm run stop-emulator; npm stop . Ou, utilisez ps aux | grep gunicorn et / ou ps aux | grep emulator , puis utilisez la commande UNIX kill -9 pour mettre fin à ces travaux.

• Si vous avez besoin de tester ou de déboguer quoi que ce soit à voir avec les dépendances, vous pouvez démarrer un coup par rapport à l'exécution npm run clean-setup .

• Parfois, le Google Cloud CLI nécessitera une mise à jour, ce qui entraînera un échec lors de la réalisation du serveur de développement avec npm start . Un message d'erreur non lié Failed to connect to localhost port 15606 after 0 ms: Connection refused apparaîtra. L'exécution de la commande gcloud components update mettra à jour au besoin et résoudre ce problème.

Composants clignotants

Chromestatus obtient actuellement la liste des composants de clignotement à partir du fichier hack_components.py .

Semencez les propriétaires de composants Blink

Visitez http: // localhost: 7777 / admin / blink / populate_blink pour voir la liste des propriétaires de composants de clignotement.

Débogage / paramètres

settings.py contient une liste des globaux pour le débogage et l'exécution du site localement.

Déploiement

Si vous avez des modifications locales non engagées, le nom de la version Applexine se terminera par -tainted . Il est normal de tester la mise en scène avec des versions entachées, mais tout doit être engagé (et donc non entaché) avant de mettre en scène une version qui peut plus tard être poussée à prod.

Remarque Vous devez avoir des privilèges d'administration sur les projets cr-status-staging et cr-status Cloud pour pouvoir déployer le site.

Exécutez la cible NPM:

 npm run staging

Ouvrez la console de développeur Google pour le site de mise en scène et passez à la nouvelle version en sélectionnant dans la liste et en cliquant sur Migrate Traffic . Assurez-vous de le faire pour le service «par défaut» ainsi que pour le service «notificateur».

Alternativement, exécutez npm run staging-rc pour télécharger le même code sur une version nommée rc pour "Release Candidate". Il s'agit de la seule version que vous pouvez tester à l'aide de la connexion Google sur https://rc-dot-cr-status-staging.appspot.com .

Si les tests manuels sur le serveur de stadification semblent bien, répétez les mêmes étapes à déployer pour prod:

 npm run deploy

Ouvrez la console de développeur Google pour le site de production

Le site de production ne doit avoir que des versions qui correspondent aux versions sur la mise en scène.

LICENCE

Copyright (C) 2013-2022 Google Inc. Tous droits réservés.

Licence Apache2.