Siguiendo con la solución a errores comunes de Android hoy veremos por qué se origina (y cómo se soluciona) el error que dice algo como:

android.view.WindowManager$BadTokenException: Unable to add window — token null is not valid; is your activity running?

Esto pasa cuando creamos una alerta o diálogo instanciando a la clase Dialog en Android. Veremos la causa y la solución.

La causa: estamos pasando mal el contexto

Supongo que muchos programadores usan lo que yo suelo usar para pasar el contexto cuando es requerido, y es llamar al método:

getApplicationContext()

De esta manera evitamos pelear por el contexto. Pues bien, al crear un Dialog así:

Dialog dialogo = new Dialog(getApplicationContext());

Lo estamos haciendo mal, y eso es lo que causa el error que vimos anteriormente.

La solución: pasar el contexto dependiendo de la actividad

Como getApplicationContext() es algo así como un atajo para obtener el contexto, no siempre funcionará. Para estos casos específicos es mejor mandar la instancia de la clase en la que estamos.

Es decir, hay que ver el nombre de la clase en la que estamos (yo estoy en MainActivity) y pasarle el nombre de la clase .this, de esta manera le pasamos el objeto en el que actualmente estamos.

Para aclarar, queda así (MainActivity.this):

// Nota: MainActivity es el nombre de la clase o actividad en donde estás
Dialog dialogo = new Dialog(MainActivity.this);

Si tu clase o actividad es distinta, simplemente cambia el nombre. Recomiendo que de ahora en adelante pases el contexto de esta manera en lugar de usar getApplicationContext().

Te invito a ver más sobre Android y más sobre Java.