El depurador de ActionScript 3.0

Recursos adicionales

Los siguientes recursos proporcionan información adicional detallada sobre la depuración en ActionScript 3.0:

Activación del modo de depuración

La manera de comenzar una sesión de depuración depende del tipo de archivo con el que se trabaje. Durante una sesión de depuración, Animate interrumpe la ejecución de código de ActionScript cuando encuentra un punto de corte o un error de tiempo de ejecución.

Cuando Animate inicia una sesión de depuración añade información especial al archivo SWF que exporta para la sesión. Esta información permite al depurador facilitar los números de línea específicos del código donde se encontraron los errores.

Puede incluir esta información de depuración especial en la configuración de publicación para todos los archivos SWF creados a partir de un archivo FLA determinado. De esta forma se puede depurar el archivo SWF incluso sin haber iniciado explícitamente una sesión de depuración. Esta información de depuración aumenta ligeramente el tamaño del archivo SWF.

Selección de un entorno de depuración predeterminado

  • Seleccione Depurar > Depurar película y, después, una de las opciones siguientes:

    • Animate

    • AIR Debug Launcher (Escritorio)

    • AIR Debug Launcher (Móvil)

    • En dispositivo a través de USB (sólo CS5.5)

    Todas las sesiones de depuración tendrán lugar en el entorno que seleccione. Puede cambiar de entorno predeterminado en cualquier momento.

Inicio de la depuración desde un archivo FLA

  • Seleccione Depurar > Depurar

    (Animate CS6 y versiones anteriores) Seleccione Depurar > Depurar película > Depurar.

Inicio de la depuración desde un archivo AS de ActionScript 3.0

  1. Con el archivo de ActionScript abierto en la ventana Script, seleccione el archivo FLA con el que se debe haber compilado el archivo de ActionScript en el menú Destino de la parte superior de la ventana Script. El archivo FLA también debe estar abierto en Animate para que aparezca en este menú.

  2. Seleccione Depurar > Depurar

    (Animate CS6 y versiones anteriores) Seleccione Depurar > Depurar película > Depurar.

Cómo añadir información de depuración a todos los archivos SWF creados a partir de un archivo FLA

  1. Con el archivo FLA abierto, seleccione Archivo > Configuración de publicación.

  2. En el cuadro de diálogo Configuración de publicación, haga clic en la ficha (CS5) o en la categoría (CS5.5).

  3. Seleccione Permitir depuración.

Salida del modo de depuración

  • Haga clic en el botón Finalizar sesión de depuración en la consola de depuración.

Establecimiento y eliminación de puntos de corte

Añada puntos de corte al código ActionScript para interrumpir la ejecución del código. Una vez interrumpida la ejecución, puede desplazarse y ejecutar el código línea por línea, ver secciones distintas del código ActionScript, ver los valores de las variables y expresiones y editar los valores de las variables.

Nota:

no se pueden añadir puntos de corte a los archivos ASC (ActionScript for Communication) o JSFL (Flash JavaScript).

Establecimiento de un punto de corte

  • En el panel Acciones o la ventana Script, haga clic en el margen izquierdo junto a la línea de código donde desea que aparezca el punto de corte.

Eliminación de un punto de corte

  • En el panel Acciones o la ventana Script, haga clic en el punto de corte que desea eliminar.

Desplazamiento por las líneas de código

Una vez interrumpida la ejecución de ActionScript en un punto de corte o error de tiempo de ejecución, puede recorrer el código línea a línea. Puede elegir acceder a llamadas de función o saltarlas. Asimismo puede elegir continuar la ejecución del código sin utilizar las opciones de desplazamiento.

Entrar el código línea por línea

  • Haga clic en el botón Entrar de la consola de depuración.

Pasar una llamada de función

  • Haga clic en el botón Pasar de la consola de depuración.

Salir de una llamada de función

  • Haga clic en el botón Salir de la consola de depuración.

Reanudación de la ejecución normal del código

  • Haga clic en el botón Continuar de la consola de depuración.

Visualización y examen de scripts en el apilamiento de llamada

Cuando se detiene la ejecución de código en el depurador, puede visualizar el apilamiento de llamada en la consola de depuración y ver los scripts que contienen las funciones en el apilamiento de llamadas. El apilamiento de llamadas muestra la lista actual de llamadas de función anidadas en espera de finalizar su ejecución.

Puede ver el script concreto que contiene cada función.

  • En el panel Consola de depuración, haga clic en el nombre del script en el apilamiento de llamadas.

Visualización y modificación de valores de variables

El panel Variables permite ver y editar los valores de las variables y propiedades.

Visualización del valor de una variable

  1. En el panel Variables, seleccione los tipos de variables que se mostrarán desde el menú Panel.

    • Mostrar constantes muestra los valores constantes (variables que tienen un valor fijo).

    • Mostrar estáticos muestras las variables que pertenecen a la clase, en lugar de instancias de la clase.

    • Mostrar variables de miembros inaccesibles muestra las variables que no están accesibles a otras clases o espacios de nombres. Aquí se incluyen las variables protegidas, privadas o internas del espacio de nombres.

    • Mostrar visualización adicional en modo hexadecimal añade valores hexadecimales siempre que se muestran valores decimales. Esto resulta útil para los valores de colores. Los valores hexadecimales no se muestran para los valores decimales de 0 a 9.

    • Mostrar nombres cualificados muestra los tipos de variables con el nombre del paquete y de la clase.

  2. Expanda la vista de árbol de la estructura de objetos del archivo FLA hasta que aparezca la variable que desea ver.

Edición del valor de una variable

  1. En el panel Variables, haga doble clic en el valor de la variable.

  2. Introduzca un nuevo valor para la variable y presione Intro. El nuevo valor se utilizará en posteriores ejecuciones de código.

Control de las advertencias del compilador

Puede controlar los tipos de advertencias que genera el compilador de ActionScript en el panel de errores del compilador. Cuando el compilador informa de un error, haga doble clic en él para ir a la línea de código que provocó el error.

  1. Seleccione Archivo > Configuración de publicación.
  2. Haga clic en Animate.

  3. Haga clic en el botón Configuración de ActionScript.
  4. Seleccione las opciones de Errores adecuadas:
    • Modo estricto hace que las advertencias de indiquen como errores, lo que significa que la compilación no finalizará correctamente mientras no se solucionen.
    • Modo de advertencias hace que se generen advertencias adicionales que resultan útiles para descubrir incompatibilidades al actualizar código ActionScript 2.0 a código ActionScript 3.0.

Cuando Animate encuentra un error en código ActionScript, durante la compilación o la ejecución, registra el error en el panel de errores del compilador. Desde aquí, vaya a la línea de código que provocó el error desde.

  • Haga doble clic en el error en el panel de errores del compilador.

Depuración de un archivo SWF remoto de ActionScript 3.0

Con ActionScript 3.0, puede depurar un archivo SWF remoto utilizando la versión independiente, de ActiveX o de complemento de depuración de Flash Player, que puede encontrar en directorio de instalación de Animate/Players/Debug/. Sin embargo, en el depurador de ActionScript 3.0, la depuración remota está limitada a los archivos que se ubican en el mismo host local que la aplicación de edición de Animate y se ejecuta en el reproductor independiente de depuración, en el control ActiveX o en el complemento.

Para permitir la depuración remota del archivo, active la depuración en la configuración de publicación. También puede publicar el archivo con una contraseña de depuración para asegurarse de que sólo pueden depurarlo usuarios de confianza.

Del mismo modo que ocurre con JavaScript o HTML, los usuarios pueden ver variables de cliente en ActionScript. Para guardar variables de un modo seguro, debe enviarlas a una aplicación de servidor en lugar de almacenarlas en su archivo. No obstante, como desarrollador, podría tener otros secretos comerciales, como estructuras de clips de película, que no desea revelar. Puede utilizar una contraseña de depuración para proteger su trabajo.

Activación de la depuración remota de un archivo SWF y establecimiento de una contraseña de depuración

En los archivos FLA de ActionScript 3.0, no se puede depurar el código de los scripts de fotogramas. Con el depurador de ActionScript 3.0, únicamente se puede depurar el código de los archivos AS externos.

  1. Abra el archivo FLA.

  2. Seleccione Archivo > Configuración de publicación.

  3. En el cuadro de diálogo Configuración de publicación, haga clic en la ficha (CS5) o en la categoría (CS5.5) y, a continuación, seleccione Permitir depuración.

  4. Cierre el cuadro de diálogo Configuración de publicación y seleccione uno de los comandos siguientes:

    • Archivo > Exportar > Exportar película

    • Archivo > Publicar

  5. Para llevar a cabo una sesión de depuración remota en el host local, deje el archivo SWF en el equipo local o cárguelo en su servidor web.

    Como el archivo SWF no contiene información de puntos de corte, si carga este archivo en un servidor remoto no podrá desplazarse por el código. Utilice el host local para llevar a cabo esta tarea.

  6. En Animate, seleccione Depurar > Iniciar sesión remota de depuración > ActionScript 3.0.

    Animate abrirá el Depurador de ActionScript 3.0 y esperará a que se conecte la depuración de Flash Player. Dispondrá de 2 minutos para iniciar el reproductor de depuración de Flash. Si pasan más de 2 minutos, repita este paso.

  7. Abra el archivo SWF en la versión de depuración del complemento de Flash Player, el control ActiveX o el reproductor independiente. El reproductor independiente de depuración se encuentra en directorio de instalación de Animate/Players/Debug/. No conecte con un archivo de otro equipo, ya que el depurador no podrá recibir información de puntos de corte.

    La sesión de depuración comienza cuando el reproductor de depuración se conecta al panel Depurador de ActionScript 3.0.

    Nota:

    la depuración remota no funciona si selecciona la interfaz de red predeterminada para AIR 3.4. Debe seleccionar las opciones para proporcionar el nombre de la interfaz de red y la dirección IP del sistema.

Activación del depurador desde una ubicación remota

  1. Si la aplicación de edición de Animate no está abierta, ábrala.

  2. Seleccione Depurar > Iniciar sesión remota de depuración > ActionScript 3.0.

  3. En un navegador o en la versión de depuración del reproductor independiente, abra el archivo SWF publicado desde la ubicación remota.

    Si aparece el cuadro de diálogo de depuración remota, haga clic con el botón derecho del ratón (Windows) o con la tecla Control pulsada (Macintosh) en el archivo SWF para ver el menú contextual y seleccione Depurador.

  4. En el cuadro de diálogo de depuración remota, seleccione Host local y elija el archivo que desea abrir.

    La lista de visualización del archivo SWF aparecerá en el depurador. Si el archivo SWF no se reproduce, es posible que el depurador esté en estado de pausa, de manera que haga clic en Continuar para iniciarlo.

Esta obra está autorizada con arreglo a la licencia de Reconocimiento-NoComercial-CompartirIgual 3.0 Unported de Creative Commons.  Los términos de Creative Commons no cubren las publicaciones en Twitter™ y Facebook.

Avisos legales   |   Política de privacidad en línea