Grandes mejoras en la CLI de Salesforce ☁️

¡No te preocupes, no están rompiendo cambios! Hoy, cuando instala la CLI de Salesforce, obtiene dos CLI interoperables: una se llama sfdx (que es la versión actual de la CLI) y la otra es sf (que también se conoce comúnmente como la "CLI unificada"). Crear sf como una CLI separada nos dio la oportunidad de repensar la experiencia de la CLI de Salesforce y rediseñarla desde cero para abordar mejor sus necesidades de DevOps. Con sf como una CLI separada, pudimos diseñar, probar y lanzar no solo una nueva estructura de comando para el desarrollo entre nubes, sino también una CLI más intuitiva, eficaz y fácil de usar, todo sin interrumpir su flujo de trabajo actual. Gracias a aquellos de ustedes que han usado sf y han compartido sus comentarios. Ahora que hemos podido probar e iterar estas mejoras, traeremos muchas de estas nuevas características y mejoras a sfdx a principios del próximo año. Lo que viene en 2023 Todas las nuevas características y mejoras de sf comenzarán a aparecer para los usuarios de sfdx a partir de principios de enero de 2023, junto con los comandos de sf. ¿Qué mejoras puedes esperar? Siga leyendo para obtener más detalles. La experiencia de escritura mejorada sfdx le permitirá usar espacios o dos puntos como separadores (y sí, ambos funcionarán bien). Por ejemplo, para abrir una organización, ahora puede escribir sfdx force:org:open o sfdx force org open. Producirán el mismo resultado. Esto también se muestra en el siguiente video. [contenido incrustado] CLI sfdx sin taxonomía le permitirá escribir su comando en cualquier orden. crear una organización borrador significa lo mismo que crear una organización borrador o cualquiera de las otras permutaciones que se muestran a continuación. Esto se muestra en el siguiente video. [contenido incrustado] Descubra fácilmente comandos con el nuevo comando de búsqueda sfdx dedicado sfdx search lo ayuda a encontrar rápidamente el comando que está buscando y ver su contenido de ayuda. Mire el video a continuación, que muestra cómo funciona este nuevo comando. [contenido incrustado] Mejora de la legibilidad de las banderas Las banderas serán más fáciles de leer (por ejemplo, el nombre de usuario predeterminado devhub es simplemente doloroso). En cambio, las banderas usarán guiones entre las palabras para crear un nombre que sea más fácil de escanear y digerir. En este escenario, defaultdevhubusername se convertirá en default-devhub-username (¡no se preocupe, las banderas antiguas seguirán funcionando!). Mejores mensajes de ayuda sfdx obtendrá mejores mensajes de ayuda, con -h para la ayuda concisa y –help para la versión completa. La siguiente captura de pantalla muestra un ejemplo de lo que incluye un mensaje de ayuda detallado con –help. Tenga en cuenta que la información de ayuda incluye ejemplos detallados. A continuación se muestra un ejemplo de la salida que usa el indicador -h para obtener ayuda concisa. Tenga en cuenta que no mostramos los ejemplos detallados con el indicador de ayuda -h. Disponibilidad de comandos sf en sfdx Los comandos creados para sf estarán disponibles en sfdx. Algunos ejemplos incluyen: sf deployment metadata es inteligente y utiliza el seguimiento de fuentes de forma predeterminada para las organizaciones que lo admiten. Esto significa que puede hacer el trabajo de force:source:push (descubrir mis cambios locales e implementarlos) y force:source:deploy (implementar archivos, tipos o manifiestos específicos) todo mientras trabaja con el seguimiento de fuentes. sf recuperar metadatos tiene la misma capacidad. sfdx force:source:status puede mostrar todos los cambios locales y/o remotos. La vista previa de metadatos de implementación de sf muestra lo que sucederá cuando implemente, incluidos los conflictos, los efectos de .forceignore y los efectos de marcas como la ruta, el tipo de metadatos o el manifiesto. Todos los comandos de las funciones de Salesforce también estarán disponibles a través de sfdx. Agregaremos comandos donde siempre deberían haber existido (p. ej., reanudar una organización borrador que agota el tiempo de espera). Queremos reiterar que los antiguos nombres de comandos y marcas seguirán funcionando. Comenzará a ver mensajes útiles en la CLI y las notas de la versión que lo ayudarán a adoptar los comandos más nuevos. El desarrollo de complementos se vuelve más fácil sf también nos brinda la oportunidad de crear una mejor experiencia de desarrollador de complementos. Estamos trabajando para mejorar la experiencia de desarrollo de complementos para los autores de complementos. Algunas de las mejoras que verá en los próximos años incluyen: plugin-dev (ver documentos), nuestro nuevo complemento CLI, proporcionará generadores interactivos para complementos, comandos y banderas.

Tenemos reglas de eslint de código abierto para complementos para ayudarlo a evitar errores comunes y fomentar las mejores prácticas

Podrá escribir mensajes de interfaz de usuario usando Markdown en lugar de JSON

Las banderas podrán tener alias, así es como estamos cambiando sus nombres de una manera ininterrumpida (sus complementos también pueden comenzar a admitir los nuevos estilos)

Las banderas tendrán tipos de TypeScript más inteligentes, lo que reducirá los errores

La confiabilidad mejorará a medida que ahora hacemos instantáneas de sus entradas de comando y el esquema de salida JSON que otras herramientas pueden leer y verificar para ayudarlo a usted (y a nosotros) a evitar cambios importantes.

Los comandos base adicionales facilitarán la creación de comandos que no necesitan organizaciones

Los kits de prueba para propietarios de complementos los ayudarán a escribir pruebas que cubran escenarios interactivos que requieren la participación del usuario.

También proporcionaremos documentación para que los desarrolladores de complementos faciliten la adopción de los nuevos estilos y herramientas. ¡Estén atentos para obtener más información sobre esto!

¿Que tengo que hacer?

¡Nada aún! Los antiguos nombres de comandos y marcas seguirán funcionando. Tenemos trabajo por hacer para hacer la transición de las dos CLI para que sean idénticas, y cada complemento para admitir ambas CLI.

Una vez que se complete este trabajo, le recomendamos encarecidamente que comience a adoptar los nuevos nombres de comando y nombres de marca a medida que estén disponibles (los mensajes incorporados lo guiarán en el camino).

Estén atentos a nuestras notas de lanzamiento para obtener más detalles sobre los plazos.

Como siempre, ¡nos encantan tus comentarios! ¿Tienes nuevas ideas para compartir? ¿Tienes nuevas solicitudes de funciones para nosotros?
Envíelos a través del repositorio GitHub de la CLI de Salesforce .

Referencias

Sobre los autores

Pooja Reddivari es gerente sénior de gestión de productos en la organización Herramientas y experiencia para desarrolladores de plataformas en Salesforce. Le apasiona crear productos escalables y resistentes que deleiten a desarrolladores y clientes. Pooja ha trabajado en las verticales de empresa, educación y fintech con más de 12 años de experiencia como profesional de ingeniería y gestión de productos. Ella es @poojasalesforc1 en Twitter y en/poojareddivari/ en LinkedIn.

Shane McLaughlin es desarrollador en el equipo de CLI de Salesforce y ha estado construyendo en la plataforma de Salesforce desde 2011. Es @mshanemc tanto en Twitter como en GitHub.