Cómo hacer una bisección de Chromium

¿Alguna vez has visto un bug de tipo "regresión" como el siguiente? "En Chromium 86.0.4240.193, esto falla. Pero si me voy atrás y uso Chromium 85.0.4183.121, todo funciona bien". Una buena manera de diagnosticar bugs como estos –donde no está claro qué cambio podría haber causado la regresión, pero puedes reproducir consistentemente el problema en una versión nueva, pero no en una antigua– es hacer una bisección.

!!! info "¿Qué es Chromium?" Chromium es el navegador en el que se basa Chrome. Chromium es un navegador de código abierto (su código se puede leer por cualquier persona y cualquier persona puede contribuir cambios), al contrario de Chrome, que es una versión de Chromium personalizada por Google con más funciones (y el código de estas no es accesible).

En resumen: _Chrome = Chromium + modificaciones de Google_.

En realidad, Chromium y Chrome son casi idénticos, puesto que las
modificaciones son pocas, pero una de las cosas relevantes es que las
versiones antiguas de Chromium se pueden descargar, mientras que Google no
ofrece enlaces de descarga de las versiones antiguas de Chrome.

Así pues, podemos hacer la bisección con Chromium, pero no con Chrome.

Instrucciones para hacer la bisección

Para hacer una bisección, sigue los siguientes pasos:

  1. Abre la terminal.
  2. Dependiendo de tu sistema operativo, ejecuta uno de los siguientes comandos, que descargará la herramienta de bisección en la carpeta actual:
    • Linux: curl -s --basic -n "https://chromium.googlesource.com/chromium/src/+/master/tools/bisect-builds.py?format=TEXT" | base64 -d > bisect-builds.py
    • macOS: curl -s --basic -n "https://chromium.googlesource.com/chromium/src/+/master/tools/bisect-builds.py?format=TEXT" | base64 -D > bisect-builds.py
    • Windows: python -c "import urllib2; import base64; print base64.b64decode(urllib2.urlopen(\"https://chromium.googlesource.com/chromium/src/+/master/tools/bisect-builds.py?format=TEXT\").read())" > bisect-builds.py
  3. Ahora, ejecuta el siguiente comando: python bisect-builds.py -a plataforma -g versión_buena -b versión_mala --verify-range
    • Debes sustituir plataforma por tu sistema operativo: mac64, win64, linux64 o linuxarm (en el caso que tu sistema sea de 32-bits, debes poner mac, win o linux).
    • Debes sustituir versión_buena por una versión antigua que funcionaba correctamente y versión_mala por una versión nueva donde ya no funciona correctamente. Puede ser una versión específica como por ejemplo 87.0.4280.67, o M86 para referirse a la última versión de Chromium 86.
  4. Al ejecutarlo, la herramienta empezará a descargarse una lista de versiones que existen entre las dos que le hemos dado. Luego, nos hará seguir los siguientes pasos repetidamente:
    1. Aparece Trying revision {número}... en la terminal y se abre una ventana de Chromium.
    2. Ahora, debemos intentar reproducir el error en la ventana de Chromium que se ha abierto.
    3. Una vez hayamos comprobado si el problema existe en esa versión o no, cerramos la ventana de Chromium.
    4. En la terminal ahora aparecerá el mensaje Revision {número} is [(g)ood/(b)ad/(r)etry/(u)nknown/(s)tdout/(q)uit]:. Debemos introducir una de las siguientes letras y pulsar enter para indicar a la herramienta cómo ha ido la prueba:
      • g (good, en español: buena): esta versión era buena, es decir, el problema no está presente en esta versión.
      • b (bad, en español: mala): esta versión era mala, es decir, el problema está presente en esta versión.
      • r (retry, en español: reintentar): vuelve a abrir la ventana de Chromium de esta versión para que puedas volver a probar.
      • u (unknown, en español: no conocido): no sabes si en esta versión se encuentra el problema o no.
    5. Se repetirá esto unas cuantas veces (puedes ver que en la terminal aparece roughly {n} steps lefs, donde {n} es el número de pasos que quedan por terminar aproximadamente).
  5. Una vez terminado, aparecerá un texto parecido al siguiente:
You are probably looking for a change made after 384820 (known good), but no later than 384821 (first known bad).
CHANGELOG URL:
https://chromium.googlesource.com/chromium/src/+log/a7afaf4f40dd9febabd6a0ebcfa1fdc9e1a890ea..f217f60c51bed92efd5cba86860a7a9909148c61

Esto es justamente lo relevante: da las dos revisiones donde se produce el cambio que genera el error (en este caso el cambio de 384820 a 384821) y una URL donde se pueden ver todos los cambios hechos entre estas dos revisiones.

Este documento es una traducción y adaptación del documento https://www.chromium.org/developers/bisect-builds-py, disponible bajo la licencia Creative Commons Attribution 2.5 (The Chromium Authors)