En factura.city aplicamos actualizaciones cada semana. A veces con grandes cambios, a veces con cambios menores. Como en tu espacio privado mandas tú, tienes tres ramas y decides cuáles usar. Una rama es una línea de software independiente dentro del espacio: cada rama puede tener una versión distinta de FacturaScripts y de sus plugins, y cada negocio de tu espacio trabaja sobre la rama que le asignes.
- Rama oficial: la mantenemos y actualizamos nosotros. No tienes que hacer nada. Es la opción recomendada si solo usas nuestros paquetes.
- Rama beta: opcional, la gestionas tú. Es donde se aplican siempre las novedades, y la única donde puedes subir plugins propios o de terceros.
- Rama estable: opcional, la gestionas tú. Va por detrás de la beta a propósito: solo recibe las versiones que ya llevan tiempo funcionando bien en beta.
Puedes ver el estado de las tres desde la pantalla de administración del espacio privado, con el botón ramas de arriba a la derecha.
🚀 Instalar los paquetes por primera vez
Un espacio privado recién creado no tiene todavía ningún paquete instalado, y por eso no te deja crear negocios. En la pestaña de administración de negocios verás el aviso Instalación de paquetes: pulsa su botón actualizar y se instalará la rama oficial. Es un solo clic, no tienes que elegir paquetes.
El proceso tarda unos minutos. Cuando acabe aparecerá el botón nuevo negocio y ya podrás empezar:
Con la rama oficial ya tienes un espacio privado funcionando y actualizado sin trabajo por tu parte. Solo necesitas las ramas beta y estable si quieres instalar plugins propios o de terceros, o llevar tu propio ritmo de actualizaciones. Si es tu caso, sigue leyendo.
🧪 Activar y actualizar la rama beta
Pulsa el botón ramas y, en la tarjeta de la rama beta, pulsa activar (o gestionar rama beta si ya la tienes activada). Te lleva al actualizador.
En el actualizador de la rama beta verás la lista de paquetes disponibles: el nombre, la versión que tienes instalada en beta y la nueva versión. Los paquetes CORE y SpaceInstance son imprescindibles y aparecen marcados así mientras no los tengas.
Pulsa el botón descargar de cada paquete que quieras. Hay dos variantes:
- Descargar (icono de flecha): descarga la versión estable del paquete, la recomendada.
- BETA (botón amarillo): aparece cuando de ese paquete solo hay una versión beta más nueva que la que tienes. Úsalo con cuidado.
Los paquetes seleccionados se acumulan en el panel actualizaciones listas, arriba. Puedes descartarlos con el botón eliminar, o pulsar aplicar para instalarlos.
El proceso tarda unos segundos y actualiza además todos los negocios que tengan asignada la rama beta.
📦 Instalar un paquete nuevo
Es exactamente el mismo procedimiento. En la tabla del actualizador de la rama beta no salen solo los paquetes que ya tienes: salen todos los que puedes instalar. Los que aún no tienes aparecen con No instalado en la columna de la rama beta.
Busca el paquete en la lista, pulsa su botón descargar y luego aplicar. Se instalará en la rama beta.
Instalar un paquete en el espacio no lo activa en tus negocios. Ese es un paso aparte:
⬆️ Subir tus propios plugins
Esta es una de las ventajas del espacio privado: puedes instalar plugins que no están en nuestro catálogo, tanto propios como de terceros.
En el actualizador de la rama beta, al final de la tabla de paquetes, hay un recuadro para seleccionar archivos .zip desde tu PC. Al elegir el archivo se sube y se copia a la rama beta automáticamente. Después aparecerá en el panel de actualizaciones listas y solo tienes que pulsar aplicar.
Ten en cuenta estas limitaciones:
- El archivo debe ser un .zip de un plugin de FacturaScripts, con su
facturascripts.inicorrecto (nombre y versión). - Solo puedes subir plugins con la rama beta ya activada. Es decir, primero instala CORE y SpaceInstance en beta.
- Como máximo 10 archivos pendientes de aplicar a la vez.
- El plugin tiene que ser compatible con el core de tu rama beta. Si su
min_versiones superior, se rechaza con un mensaje del tipo "El plugin X requiere el core Y, pero el espacio tiene instalado el core Z". La solución es actualizar antes el paquete CORE en la rama beta.
Aquí es donde tiene sentido el sistema de beta y estable: subes tu plugin a beta, lo pruebas en un negocio de la rama beta y, cuando veas que todo va bien, lo pasas a la rama estable.
🗑️ Eliminar un paquete del espacio
En la parte inferior del actualizador tienes la tabla versiones instaladas, con lo que hay en tus ramas beta y estable. Cada paquete tiene un botón de papelera que lo elimina del espacio privado.
Los paquetes CORE y SpaceInstance no se pueden eliminar, porque sin ellos el espacio no funciona.
Antes de eliminar un paquete, quítalo de los negocios que lo estén usando.
🛡️ Actualizar la rama estable
Los cambios se aplican siempre en la rama beta. La rama estable solamente se puede actualizar a partir de la rama beta: aplicas los cambios en beta y, si ves que todo está correcto, copias esos cambios a la estable.
¿Por qué revisar? Si solamente utilizas nuestros paquetes, no necesitas revisar nada (o mejor aún, usa directamente la rama oficial). Pero si añades plugins tuyos o de terceros, entonces te conviene este sistema de beta y estable, para asegurarte de que tus paquetes no te generen problemas.
Ve al panel de control del espacio privado y haz clic en el botón ramas, arriba a la derecha. Aparecerá una ventana flotante para actualizar la rama beta o copiar la rama beta a la estable. Haz clic en el botón de copiar de beta.
En la siguiente pantalla verás un resumen de los paquetes y las versiones que están en la rama beta y en la estable. Si la rama beta y la rama estable son iguales, entonces mostrará un mensaje para indicar que no hay nada que copiar. En este ejemplo podemos ver que sí hay plugins que copiar, por lo que hacemos clic en el botón aplicar.
El proceso de actualización de la rama estable tarda unos segundos y actualiza además todos los negocios de la rama estable.
🏢 ¿Y qué rama usa cada negocio?
Cada negocio del espacio trabaja sobre una sola rama. La eliges al crearlo y la puedes cambiar después desde la ficha del negocio, con el botón que indica su rama actual. Un negocio solo ve los paquetes instalados en su rama: si instalas un plugin en beta, los negocios de la rama estable u oficial no lo tendrán hasta que llegue a su rama.