Publicación de un paquete
En las secciones anteriores, examinamos cómo se configura el paquete de MapToSurface con nodos personalizados y archivos de ejemplo. Pero, ¿cómo publicamos un paquete que se ha desarrollado localmente? En este caso real, se muestra cómo publicar un paquete a partir de un conjunto de archivos en una carpeta local.
Hay muchas formas de publicar un paquete. A continuación, se indica el proceso recomendado:publique localmente, desarrolle localmente y, a continuación, publique en línea. Comenzaremos con una carpeta que contiene todos los archivos del paquete.
Desinstalación de un paquete
Antes de pasar a la publicación del paquete MapToSurface, si ha instalado el paquete en una lección anterior, desinstálelo para que no trabaje con paquetes idénticos.
Vaya primero Paquetes > Gestionar paquetes....
Seleccione el botón correspondiente a MapToSurface y, a continuación, seleccione Desinstalar.... A continuación, reinicie Dynamo. Al volver a abrirlo, cuando active la ventana Gestionar paquetes, MapToSurface ya no debería aparecer. Ya estamos listos para empezar desde el principio.
Publicación local de un paquete
Nota A medida que escriba, la publicación del paquete de Dynamo solo se activará en Dynamo for Revit y Dynamo for Civil 3d. Dynamo Sandbox no incluye funciones de publicación.
Descargue y descomprima los archivos de ejemplo que acompañan a este caso real de paquete (haga clic con el botón derecho y seleccione "Guardar enlace como..."). En el Apéndice, se incluye una lista completa de los archivos de ejemplo. MapToSurface.zip
Este es el primer envío del paquete y se han incluido todos los nodos personalizados y los archivos de ejemplo en una única carpeta. Con esta carpeta preparada, ya podemos realizar la carga en Dynamo Package Manager.
- Esta carpeta contiene cinco nodos personalizados (.dyf).
- Esta carpeta también contiene cinco archivos de ejemplo (.dyn) y un archivo de vectores importado (.svg). Estos archivos se utilizarán como ejercicios de introducción para mostrar al usuario cómo trabajar con los nodos personalizados.
En Dynamo, vaya primero a Paquetes > Publicar paquete nuevo....
En la ventana Publicar un paquete de Dynamo, hemos rellenado los formularios correspondientes a la izquierda.
- Al hacer clic en Añadir archivo, también hemos añadido los archivos de la estructura de carpetas en la parte derecha de la pantalla (para añadir archivos que no sean .dyf, asegúrese de cambiar el tipo de archivo en la ventana del navegador a Todos los archivos (.)". Observe que se han añadido sin distinción todos los archivos, los nodos personalizados (.dyf) o los archivos de ejemplo (.dyn). Dynamo clasificará estos elementos cuando publiquemos el paquete.
- El campo "Grupo" define el grupo en el que buscar los nodos personalizados en la interfaz de usuario de Dynamo.
- Para publicar, haga clic en "Publicar localmente". Si sigue este proceso, asegúrese de hacer clic en Publicar localmente y no en Publicar en línea. No deseamos un conjunto de paquetes duplicados en Package Manager.
- Tras la publicación, los nodos personalizados deberían estar disponibles en el grupo "DynamoPrimer" o en la biblioteca de Dynamo.
Ahora veamos el directorio raíz para comprobar cómo Dynamo ha aplicado formato al paquete que acabamos de crear. Para ello, haga clic en Paquetes > Gestionar paquetes....
En la ventana Gestionar paquetes, haga clic en los tres puntos verticales a la derecha de MapToSurface y elija Mostrar directorio raíz.
Observe que el directorio raíz se encuentra en la ubicación local del paquete (recuerde que hemos publicado el paquete "localmente"). Dynamo hace referencia a esta carpeta para leer nodos personalizados. Por lo tanto, es importante publicar localmente el directorio en una ubicación de carpeta permanente (es decir, no en el escritorio). A continuación, se desglosan las carpetas del paquete de Dynamo:
- La carpeta bin contiene archivos .dll creados con bibliotecas de C# o Zero-Touch. No hay ninguna para este paquete, por lo que esta carpeta aparece vacía en este ejemplo.
- La carpeta dyf contiene los nodos personalizados. Al abrir esta, se mostrarán todos los nodos personalizados (archivos .dyf) de este paquete.
- La carpeta "extra" contiene todos los archivos adicionales. Es probable que estos archivos sean archivos de Dynamo (.dyn) o archivos adicionales necesarios (.svg, .xls, .jpeg, .sat, etc.).
- El archivo pkg es un archivo de texto básico que define los parámetros del paquete. Esta función está automatizada en Dynamo, pero se puede modificar si desea acceder a los detalles.
Publicación de un paquete en línea
Nota: no siga este paso, a menos que publique realmente un paquete suyo.
- Cuando esté listo para publicar, en la ventana Gestionar paquetes, seleccione el botón ubicado a la derecha de MapToSurface y elija Publicar....
- Si va a actualizar un paquete que ya se ha publicado, seleccione Publicar versión; Dynamo actualizará el paquete en línea en función de los nuevos archivos del directorio raíz del paquete. Así de fácil.
Publicar versión...
Al actualizar los archivos de la carpeta raíz del paquete publicado, puede publicar una nueva versión del paquete. Para ello, seleccione Publicar versión... en la ventana Gestionar paquetes. Esta es una forma perfecta de realizar las actualizaciones necesarias del contenido y compartirlas con la comunidad. Publicar versión solo funcionará si es la persona encargada del mantenimiento del paquete.