Puedes optimizar la gestión de recursos en todo tu equipo o en varios proyectos al convertir recursos individuales o jerarquías de recursos en paquetes para volver a utilizarlos en diversas experiencias. Para actualizar un paquete, tú o los miembros de tu equipo pueden actualizar copias específicas a la versión más reciente, actualizar todas las copias de una experiencia o establecer copias específicas para que se actualicen de forma automática. Los paquetes también incluyen un mecanismo de configuración que permite a los creadores y editores de paquetes incluir opciones para personalizar el comportamiento de un paquete.
Creación de paquetes
Se pueden crear paquetes a partir de cualquier nodo o nodo raíz de un subárbol en el modelo de datos.
En la ventana del Explorador, haz clic derecho en el objeto o el nodo que desees y selecciona Convertir en paquete en el menú contextual.
Completa los detalles solicitados en la ventana de diálogo. Particularmente, si estás trabajando en un grupo, debes establecer la Propiedad del grupo en el que tienes permiso para crear o editar experiencias.
El sistema de recursos no admite transferencias de propiedad, por lo tanto, considera cuidadosamente el propietario que establezcas al crear un paquete.Haz clic en el botón Enviar.
Cuando la creación se complete, se mostrará un símbolo de “eslabón” sobre el ícono del objeto, que lo identifica como paquete. También verás un objeto PackageLink nuevo asignado al objeto.
El objeto PackageLink nunca se debe eliminar ni reasignar, dado que, al hacerlo, se elimina la asociación con la versión publicada y la copia se vuelve a convertir en un objeto normal.
Inserción de paquetes
Para insertar un paquete nuevo en el lugar actual, debes hacerlo inicialmente desde la Caja de herramientas siguiendo estos pasos:
- Ve a Inventario → Mis paquetes para buscar paquetes que hayas publicado u obtenido en el Mercado de creadores.
- Ve a Creaciones → Paquetes de grupo para buscar paquetes publicados por los integrantes de tu grupo (incluso tú mismo).
Cuando insertas un paquete en el modelo de datos de un lugar, aparece en la carpeta Paquetes del Administrador de recursos y permanece allí incluso si luego eliminas todas sus copias. Sin embargo, cuando publiques el lugar, la carpeta se actualizará para reflejar solo los paquetes que se utilizan en ese lugar.
Modificación de paquetes
Puedes editar los paquetes y sus elementos secundarios tal como lo haces con otros objetos. La primera vez que se realiza una edición que modifica una instancia de paquete, se muestra un cuadro de diálogo de alerta que indica que los paquetes modificados no se pueden actualizar por ningún medio y se deben revertir para deshacer los cambios.
Si bien la mayoría de las ediciones hacen que los paquetes se marquen como modificados, los siguientes cambios no se consideran modificaciones:
| Edición | Modifica el paquete |
|---|---|
| Cambiar el nombre del nodo raíz. | No |
| Cambiar la posición o la rotación del nodo raíz de un paquete que es una BasePart, un Model o un GuiObject. | No |
| Cambiar la propiedad Habilitado del GuiObject de un nodo raíz, por ejemplo, ScreenGui, SurfaceGui o BillboardGui. | No |
| Cambiar la referencia de una parte de una Weld dentro del paquete que hace referencia a una instancia fuera del paquete. | No |
Cuando se modifican, los paquetes con cambios no publicados se marcan con un punto amarillo en la jerarquía del Explorador.
Añadir o actualizar configuraciones
Puedes incluir atributos de instancia en la raíz de un paquete para personalizar su comportamiento, por ejemplo, la velocidad máxima de un vehículo empaquetado o el tiempo de rebote de un botón empaquetado.
Cuando publicas un paquete, el conjunto de atributos o valores actual se convertirá en la configuración predeterminada del paquete. En cualquier copia dada de un paquete, las configuraciones se muestran en negrita cursiva y esos valores de atributos se pueden cambiar por instancia. Cuando se actualicen las copias de los paquetes, se conservarán los valores de configuración modificados, mientras que otros atributos se actualizarán al último valor predeterminado.
Actualmente, la única forma de manejar los valores de configuración es añadir scripts al paquete que lean y apliquen un comportamiento basado en la configuración en tiempo de ejecución.
Si simplemente deseas actualizar los valores predeterminados para las configuraciones, puedes cambiar esos valores de atributos y volver a publicar el paquete (en este caso, el paquete no se marcará como modificado). Si deseas publicar otras modificaciones, pero no cambiar los valores de configuración predeterminados, debes publicarlas en un paquete sin cambios de valor o revertir las configuraciones a sus valores predeterminados antes de publicarlas.
Paquetes anidados
Puedes anidar paquetes dentro de otros para mantenerlos en jerarquías complejas y colaborar en ellas, por ejemplo, puedes tener una serie de mecánicas de un vehículo que se pueden modificar de forma independiente del paquete principal del vehículo.
Si modificas un paquete anidado, el paquete anidado y el paquete principal se consideran modificados. Para poder publicar los cambios de un paquete principal, primero, debes publicar los cambios que hayas realizado en todos los paquetes anidados, ya que, al publicar el paquete principal, se lo marcaría como actual o sin modificaciones y entraría en conflicto con las modificaciones del paquete anidado.
Scripts de los paquetes
Todos los scripts de los paquetes no modificados son de solo lectura y, en la parte superior, tienen una notificación con un hipervínculo que permite desbloquearlos.
Esto es lo que sucede al hacer clic en el hipervínculo:
- El paquete se marca como modificado independientemente de que hayas editado el script o no.
- La notificación y el hipervínculo se eliminan de los demás scripts del paquete.
Cuando el paquete se publica y cambia al estado no modificado, sus scripts pasan a ser de solo lectura e incluyen un hipervínculo para modificarlos.
Publicación de los cambios de los paquetes
Puedes publicar un paquete modificado (marcado con un punto amarillo) para que los cambios estén disponibles para otras copias del paquete en todo el lugar y todas las experiencias. Ten en cuenta que no es necesario publicar los paquetes modificados para poder publicar lugares (la versión modificada se guarda junto con los lugares para iteraciones futuras).
Sigue estos pasos para publicar los cambios de un paquete:
En la ventana del Explorador, haz clic derecho en la copia modificada (marcada con un punto amarillo) y selecciona Publicar en el paquete.
Studio extraerá de inmediato la versión actualizada de las copias de los paquetes que estén configuradas para actualizarse de forma automática. Las demás copias se marcarán con un icono de sincronización verde junto al nombre y podrás actualizarlas de forma individual o masiva de acuerdo a tus necesidades.
Actualización de copias obsoletas
Puedes actualizar las copias de paquetes obsoletas a la versión más reciente o seguir usando la versión anterior.
Sigue estos pasos para actualizar una o más copias de paquetes a la última versión:
En la ventana del Explorador, busca las copias obsoletas, señalizadas con el icono de sincronización verde junto a su nombre.
Haz clic derecho en una sola copia obsoleta y selecciona Obtener el paquete más reciente en el menú contextual o selecciona varias copias (al menos una de ellas modificada), haz clic derecho y selecciona Obtener la última versión de los paquetes seleccionados.
La opción de menú Obtener [] se desactiva si alguna de las copias del paquete se ha modificado. Si estás trabajando en una serie de cambios no publicados, tendrás que revertirlos para poder acceder a la última versión.
Actualizaciones masivas
Cuando se usan muchos paquetes, quedan varias copias en diversos lugares de una experiencia. Además de utilizar la sincronización individual y las actualizaciones automáticas, puedes actualizar todas las copias de un paquete a través de una actualización masiva.
(Recomendado) Cierra todas las demás instancias de Studio que tengan lugares de la experiencia abiertos para evitar que otra instancia del lugar no guardada sobrescriba tus actualizaciones.
En la ventana del Explorador, haz clic derecho en el paquete que desees y selecciona Actualizar todo en el menú contextual.
En la ventana emergente, debajo de los detalles de la versión o la fecha, activa la opción Todos para seleccionar todos los lugares de la experiencia o selecciona únicamente los lugares específicos que quieras actualizar de forma masiva.
Haz clic en el botón Actualizar.
El sistema de actualización de paquetes guarda de forma automática los lugares seleccionados, pero no los publica, por lo tanto, tendrás que publicarlos por separado para ver los cambios.
Para evitar sobrescrituras no deseadas, la actualización masiva no afecta las versiones modificadas de los paquetes. Studio te avisará cuántos paquetes no se actualizaron en el proceso.
Actualizaciones automáticas
Para facilitar la sincronización, puedes configurar las copias de los paquetes para que se actualicen de forma automática cuando se publica una versión nueva y cuando se encuentran dentro de una sesión de Studio abierta.
En la ventana del Explorador, expande el árbol de jerarquía del paquete que desees y selecciona su objeto PackageLink.
Esta propiedad solo se aplica al paquete principal de mayor nivel en la jerarquía de paquetes anidados, lo que quiere decir que las actualizaciones automáticas solo se realizarán cuando el paquete principal se actualice. En la ventana Propiedades, activa la propiedad AutoUpdate.
La actualización automática no se aplica a las copias de ](#modifying-packages)paquetes [modificadas. Cuando modificas una instancia de paquete, su propiedad AutoUpdate se desactiva y se ignora.
Niveles de acceso y uso compartido
Si lo deseas, puedes compartir paquetes con amigos u otorgarles acceso a ellos a roles de usuario específicos dentro de tu grupo.
En el Explorador, la Caja de herramientas o el Administrador de recursos, haz clic derecho en el paquete que desees y selecciona Detalles del paquete en el menú contextual.
En la columna de la izquierda de la ventana emergente, selecciona Permisos para ver las opciones de acceso y uso compartido de los paquetes de un grupo o un usuario.
Si se trata de un paquete de un grupo, expande el árbol de roles al hacer clic en la › junto al icono del grupo y, luego, elige un nivel de permiso para cada rol. Si el cuadro de selección de un permiso está atenuado o desactivado, ese permiso ya está configurado para el rol y no se puede modificar desde esta ventana.
Permiso Descripción Editar Los miembros del rol pueden usar, ver y editar la versión actual y las versiones anteriores del paquete, y también pueden publicar los cambios que se realicen. Al otorgar acceso de edición a un rol desde esta ventana, solo se otorga acceso al paquete específico en cuestión. Sin acceso Los miembros del rol no tienen acceso a ninguna versión nueva del paquete, pero conservan el acceso a la versión actual y las versiones anteriores. Si se trata de un paquete de un usuario, busca a un amigo en el campo de búsqueda, haz clic en su avatar o nombre de usuario y elige un nivel de permiso.
Permiso Descripción Usa y ver El usuario puede usar y ver (pero no editar) la versión actual y las versiones anteriores del paquete. Cuando le proporcionas esta capacidad a un usuario, no puedes revocar su acceso a una copia que ya haya insertado en su experiencia; si lo haces, no se podrán realizar reinserciones ni actualizaciones del paquete, pero las copias de los paquetes permanecerán intactas en su modelo de datos. Editar El usuario puede usar, ver y editar la versión actual y las versiones anteriores del paquete, y también puede publicar los cambios que se realicen.
Reversión de los cambios de los paquetes
En lugar de deshacer toda una serie de cambios de paquetes uno por uno, puedes revertir los cambios no publicados mediante una única acción, restaurar un paquete a una versión anterior o revertir los cambios de configuraciones específicas.
Revertir cambios no publicados
Sigue estos pasos para revertir una serie de cambios no publicados:
En la ventana del Explorador, busca las copias modificadas, señaladas con un punto amarillo junto a su nombre.
Haz clic derecho en una sola copia modificada y selecciona Deshacer los cambios del paquete en el menú contextual o selecciona varias copias (al menos una de ellas modificada), haz clic derecho y selecciona Deshacer los cambios de los paquetes seleccionados.
Restaurar a la versión
Sigue estos pasos para restaurar un paquete a una versión publicada anteriormente:
En el Explorador, la Caja de herramientas o el Administrador de recursos, haz clic derecho en el paquete que desees y selecciona Detalles del paquete en el menú contextual.
En la columna de la izquierda de la ventana emergente, selecciona Versiones. Se muestran la versión publicada actualmente y las versiones anteriores (V1, V2, etc.) junto con la fecha y la hora en que se publicaron.
Haz clic en la marca de verificación junto a la versión que deseas restaurar y, luego, en Enviar.
Revertir los cambios a un paquete no restablece la configuración a la configuración predeterminada. Consulta Revertir la configuración.
Revertir configuraciones
Para revertir cualquier atributo de configuración a su valor predeterminado, selecciona la opción Restablecer en el menú de engranajes en la sección Atributos de la ventana Propiedades.
Comparación de cambios en los scripts
Cuando un objeto de paquete contiene scripts o el script en sí mismo es un paquete, puedes comparar las diferencias línea por línea con la herramienta de diferencias integrada. Esto te puede ayudar a decidir si quieres realizar una actualización o no, así como a analizar qué otros aspectos de la experiencia podrían requerir modificaciones para que la actualización sea compatible.
Sigue estos pasos para comparar los cambios en un script:
En la ventana del Explorador, haz clic derecho en un paquete modificado u obsoleto. Recuerda que el paquete debe ser un script o contener scripts.
Selecciona Ver cambios del script en el menú contextual.
En la pestaña Resultados de la diferencia que se abre, compara todos los cambios entre la copia del paquete actual y la última versión publicada o local, como se hace con las aplicaciones de control de código fuente.
En esta comparación de ejemplo, se modificó el comando print() de la línea 1. La línea resaltada en rojo muestra la línea 1 tal como está en la copia del script obsoleta, y la línea verde inmediatamente después muestra la línea 1 en el paquete del script publicado. Además, se añadieron dos líneas nuevas al paquete del script publicado: un salto vacío en la línea 2 y un comando print() nuevo en la línea 3 .
