Versiones y publicación

Mientras un objeto es solo tuyo, las versiones son ruido. En cuanto lo coloca una segunda persona, cada cambio que haces aterriza en la pieza de otro, y necesitas una forma de decir cómo de grande era ese cambio. Publicar es como se consigue, y ocurre fuera del editor, en el asistente de la tienda.

Dentro del editor de objetos inteligentes no hay paso de publicación. Escribe un borrador, autoguardado, y toda colocación de uno de tus objetos locales sigue ese borrador. En esa pantalla no hay botones de versión, ni notas de la versión, ni campo de semver; cualquier cosa que hayas leído sobre uno describe algo que nunca se construyó.

Compartir sin publicar

Dos maneras de que un objeto llegue a otra persona.

Mandar el archivo. Exporta el objeto y entrégalo. Quien lo recibe lo suelta en su gestor de archivos y se le convierte en un objeto de su biblioteca. Esta es toda la historia de compartir en los objetos de código.

Publicarlo en la tienda, que es pública y revisada. No hay categoría privada ni oculta: una tarjeta aprobada la ve todo el mundo, y su página lleva metadatos de vista previa para poder pegarla donde sea.

Si lo que quieres es «unos cuantos compañeros, no el mundo», el archivo es la respuesta, con una condición pegada. Importar un objeto inteligente pide el plan Maker, tanto para un .kpy como para un .kpycode. Un compañero con plan gratuito que suelte tu archivo recibe el panel de mejora de plan, no un objeto. Colocar un objeto es gratis; aceptar uno como archivo no lo es, así que mira en qué plan están tus compañeros antes de decidir que el archivo es el canal.

El asistente de publicación

Publicar empieza en la tienda y no en el objeto, y coge un documento de tus archivos. La cabecera dice Publicar un Smart Object sobre Comparte un Smart Object de tus archivos para que cualquiera pueda meterlo en su diseño., y un aviso fijo deja claro lo que va a pasar: Todo lo que publicas pasa por revisión antes de aparecer en el catálogo.

Los pasos son condicionales, así que el asistente es más corto de lo que sugiere la captura de pantalla de la publicación de otro. ¿Qué vas a publicar?, Datos y Revisar y enviar están siempre. Esta versión aparece solo cuando este documento ya tiene una publicación fuera. Parámetros y Presets aparecen solo cuando el documento exporta parámetros, y llegan en pareja. La primera publicación de un objeto sin parámetros exportados son tres pasos.

Parámetros y presets

El paso Parámetros se presenta con Salen del propio documento. Define el rango en el que se puede configurar cada uno y explica qué hace. Este es el único sitio donde un parámetro recibe mínimo, máximo, paso y descripción, y los límites son lo que convierte un número en deslizador en el panel de quien lo coloca. Qué parámetros exponer cuenta qué rellenar y por qué.

El paso Presets se describe a sí mismo con Combinaciones de valores con nombre, para que se pueda partir de algo que ya funciona. A pesar del Aún no hay presets. Son opcionales. que lleva dentro, es un requisito: un objeto con parámetros no se puede enviar con la lista de presets vacía. El asistente crea uno llamado Default con los propios valores del documento, así que el paso llega ya contestado, y renombrar ese preset inicial a algo que alguien reconozca es un minuto bien gastado. Una tarjeta cuyo primer preset ya imprime es una tarjeta que la gente se queda.

Qué salto de versión

El paso Esta versión existe solo en una publicación repetida, y se llega a él desde Nueva versión en la tarjeta, dentro de Mis objetos: el selector de origen marca un documento ya publicado con Ya publicado y no te deja volver a elegirlo. Pregunta cómo de grande es el cambio, en el idioma que necesita quien lo usa y no en el tuyo:

Renombrar un parámetro es un cambio mayor, por pequeña que se te haya hecho la edición. La colocación de alguien está sujetando un valor para un nombre que ya no existe.

En el asistente no hay campo de versión por ninguna parte. La primera publicación es la 1.0.0, fija, y a partir de ahí el número se calcula del salto que elijas. Lo único que escribes en este paso es Qué ha cambiado, que Se muestra en la ficha junto a esta versión, para que se sepa si conviene actualizar. Escríbelo para un desconocido que está decidiendo si toca una pieza que ya le funciona. Ranuras de imán más anchas y un preset nuevo para placas de 3 mm. Así es como se escribe.

La revisión, y lo que viene después

Enviar termina con Enviado. Te avisamos en cuanto esté revisado. Lo lee una persona antes de que aparezca.

Tus tarjetas viven en Mis objetos, con un estado en cada una: Borrador, En revisión, Publicado, Rechazado, más el distintivo Nueva versión en revisión en una tarjeta cuya siguiente publicación está en cola. La página lleva además Actualizado, Descargas, Valoración y Versión.

Una versión nueva en revisión no toca la versión que ya está fuera. La aprobación la asciende; un rechazo deja la tarjeta publicada exactamente como estaba. No puedes romper una tarjeta viva enviando una actualización mala, solo publicando bien una buena.

Las versiones locales solo existen en los objetos de código

Un objeto hecho de operaciones no tiene historial de versiones ninguno. Sus colocaciones siguen siempre al último borrador, y eso es el diseño y no un hueco.

Un objeto de código sí guarda versiones locales, selladas con la cadena version de su bloque meta y escritas por el guardado explícito. Guardar dos veces con la misma cadena sobrescribe esa versión en su sitio, y las colocaciones fijadas a ella cambian. Sube meta.version antes de guardar un cambio de geometría, o la fijación no significa nada. Objetos hechos de código tiene el detalle.

Las publicaciones de la tienda son lo contrario: una vez aprobada, una versión publicada queda fija y cacheada, que es por lo que fijar la versión de un objeto de la tienda merece la pena en una pieza que importa.

Nadie te empuja una versión a una colocación

Publicar no actualiza a nadie. Una colocación fijada a una versión se queda ahí para siempre, y una que sigue a la última publicación se lleva tu trabajo solo cuando vuelva a pedir su origen, que para la mayoría de la gente significa la próxima vez que abra el archivo. No hay ningún aviso en ninguna parte de la aplicación.

El control que sí trae una es del lado de quien coloca: Actualizar a la última, una fila con un ↻ debajo de Versión en el popover de la colocación. Se ofrece en un objeto de la tienda mientras la versión sea Última o Borrador, y siempre en un objeto de tu propia biblioteca. Alguien tiene que pulsarla, y nada le dice que lo haga.

Así que las notas de la versión no son un trámite. Son el único canal que tienes, y las lee a toro pasado alguien que ya ha notado que algo se movió. Versiones y qué se rompe cuenta el mismo mecanismo desde el lado de quien coloca.

Cuando falla

El asistente casi siempre se niega dejando Siguiente deshabilitado en vez de escribir nada, así que un paso que no avanza es un campo sin rellenar: un origen, un nombre, una categoría, una descripción, los límites de un parámetro, un preset. Solo dos negativas se explican:

• Cuenta un poco más — al menos {{min}} caracteres. en Datos, donde el mínimo son 50 caracteres y el contador de al lado te dice por dónde vas.
• Un slider necesita un mínimo y un máximo. en Parámetros, que también salta con un paso ausente o no positivo.

Dos cosas que no son mensajes de error pero paran a la gente:

El paso de origen dice Todavía no tienes nada que publicar aquí. Publicar coge un documento de tus archivos, así que el objeto tiene que existir ahí primero.

Una marca dice Usa smart objects con referencia interna — publícalos y usa su versión de la store:. Tu documento coloca objetos que solo existen en tu biblioteca, y nadie más puede construirlo. Publica esos primero.

Ver también

• Qué parámetros exponer: los límites y descripciones que pide el asistente
• Objetos hechos de código: las versiones locales y el guardado que sobrescribe una
• El editor de objetos inteligentes: qué guarda el editor y qué no
• Qué es un objeto inteligente: de dónde salen los objetos, visto desde el otro extremo