La edición de add-ins

La edición de add-ins

A menudo es necesario editar un add-in para realizar mejoras o agregar nuevas funcionalidades.

Este tema muestra cómo editar un add-in.

Pasos:

1. Verifique que el primer proyecto de add-in funciona.

   Suponiendo que ya haya creado un proyecto de add-in, este paso es un poco redundante; sin embargo, sigue siendo útil en los casos en los que ha pasado tiempo entre la primera versión y la actualización que está a punto de hacer. Además, las pruebas y garantizar la funcionalidad le proporciona una base para avanzar con las modificaciones. A continuación se presentan algunas consideraciones sobre este paso del proceso:

   • Pruebe su add-in en un equipo que utilice los mismos flujos de trabajo que las personas que utilizan el add-in.
   • Cree una copia de seguridad de su proyecto de add-in en caso de que necesite deshacer los cambios.
   • Si existen errores en su versión actual del add-in, asegúrese de poder reproducirlos en su entorno de desarrollo.
     Nota:

     No arregle el código antes de realizar una copia de seguridad.

2. Realizar mejoras o agregar nuevas funcionalidades.

   Ahora que tiene una copia de seguridad del proyecto, puede comenzar a realizar ediciones:

   1. Realizar ediciones en la configuración del proyecto o contenido del add-in.
      • Si necesita actualizar la configuración, como la descripción, imagen o versión, inicie el Asistente de add-ins de Python y busque la carpeta del proyecto existente (no la copia de seguridad del proyecto).
        Nota:

        Aparecerá un cuadro de mensaje que le informa de que se ha guardado una copia de seguridad de la secuencia de comandos de Python y de que se creará una nueva secuencia de comandos de origen cuando guarde los cambios. La secuencia de comandos de copia de seguridad es necesaria porque no hay forma de saber si se han creado nuevos tipos de add-ins (como botones).

      • Si se realizan ediciones que no cambien la secuencia de comandos de Python, elimine la secuencia de comandos recién creada de su carpeta de trabajo y cambie el nombre de la copia de seguridad a su nombre original.
      • Si se agregan nuevos tipos de add-in o se realizan cambios a los nombres de clase, copie el código de la secuencia de comandos de la copia de seguridad en la secuencia de comandos recién creada, según sea necesario.
   2. Realizar ediciones en la secuencia de comandos de Python.
      • Si sólo necesita actualizar y agregar funcionalidad a la secuencia de comandos del add-in ya existente, no hace falta que abra el Asistente de add-ins de Python. En lugar de eso, simplemente edite la secuencia de comandos de Python para realizar los cambios necesarios y guarde.
        Nota:

        No cambie el nombre de la clase dentro de la secuencia de comandos. Se hace referencia al nombre de clase en el archivo config.xml. Si cambia el nombre de la secuencia de comandos es necesario actualizar el config.xml.

3. Probar sus ediciones.

   Una vez que haya terminado de editar, es importante volver a generar el archivo de add-in y probar el add-in antes de compartirlo. Para más información, consulte Probar un add-in.

4. Volver a compartir el add-in.

   Después de probar el add-in y confirmar que funciona como se espera, usted ya está listo para implementar y compartir el add-in. Para obtener más información, consulte Compartir add-ins.