Usar el control de versión de Git para editar aplicaciones de lienzo (experimental)

[Este artículo es documentación preliminar y está sujeto a modificaciones].

Importante

• Esta función se está implementando y, según su región, es posible que aún no esté disponible para su inquilino. Compruebe el interruptor experimental descrito en Habilitar el control de versiones de Git para saber si la función está disponible en su inquilino.
• Esta es una característica experimental. Está deshabilitado de forma predeterminada y debe activarse antes de usarse.
• Las características experimentales no se han diseñado para un uso de producción y pueden tener una funcionalidad restringida. Estas características están disponibles antes del lanzamiento oficial para que los clientes puedan tener un acceso anticipado y proporcionar comentarios.

Puede usar la característica del control de versiones de Git experimental para permitir que más de una persona edite una aplicación de lienzo al mismo tiempo. Con esta función, otros no tendrán bloqueada la aplicación mientras una persona la está editando. A medida que se realizan y sincronizan cambios, se combinan automáticamente con otros cambios y se ponen a disposición de todos los demás que editan la aplicación.

Git se utiliza como tienda de respaldo para esta función. Después de la configuración inicial con la conexión a Git, cualquier usuario puede usar esta función sin ningún paso de configuración adicional, excepto para autenticarse con Git.

Cualquier proveedor de Git se puede utilizar con Power Apps Studio—, como GitHub o Azure DevOps. Utilice las herramientas de Git existentes para ver el historial de versiones, crear y administrar solicitudes de extracción y realizar otras tareas de control de versiones.

Nota

• Antes de comenzar, asegúrese de leer las limitaciones conocidas de esta característica. El uso de Git está evolucionando y puede cambiar el funcionamiento de esta función. Para obtener actualizaciones y compartir sus comentarios sobre esta función, visite el Foro de la comunidad de Power Apps.
• El control de versiones de Git se administra por aplicación. Cada aplicación debe agregarse individualmente al control de versiones de Git.
• Una vez que se habilite el control de versiones de Git, se desactivará el guardado automático de su aplicación. Tendrá que guardar o sincronizar manualmente sus cambios.

Habilitar el control de versiones de Git

Siga estos pasos para habilitar el control de versiones de Git en su aplicación.

1. Cree una nueva aplicación o abra una aplicación existente que le gustaría agregar al control de versiones de Git.

2. Seleccione Configuración en Power Apps Studio.

3. Seleccione Próximas características.

4. Seleccione Experimental.

5. Desplácese hacia abajo hasta Mostrar la configuración de control de versiones de Git y cámbielo a Activado.

6. Verá un nueo elemento Control de versiones de Git en el lado izquierdo del panel de configuración.

   

   Sugerencia

   Para cualquier otro problema con esta función, visite el Foro comunitario de Power Apps.

Conectar una aplicación a Git

Siga estos pasos para conectar su aplicación a Git.

1. Seleccione Configuración en Power Apps Studio.

2. Seleccione Control de versión de Git.

   

3. Seleccione Conectar y complete la información de conexión de Git para esta aplicación.

   

   • URL del repositorio de Git: la URL que utilizaría normalmente con las herramientas de Git. Para Azure DevOps, asegúrese de incluir la parte /_git/repo de la URL, como https://contoso.visualstudio.com/_git/repo.
   • Rama: el nombre de la rama que se utilizará.
   • Directorio: el directorio dentro de la rama que se utilizará. No puede almacenar una aplicación de lienzo en la raíz de la rama.

   Se le pedirá que cree la rama o el directorio si no existe. Si la rama y el directorio ya contienen una aplicación de lienzo, la aplicación actual se cerrará y la aplicación existente se cargará desde Git.

   Una vez conectada, se mostrará la información de conexión.

Autenticacicarse con Git

Power Apps requiere que use un token de acceso personal en lugar de la contraseña de su cuenta de proveedor de control de versiones.

Nota

Un token de acceso personal no es lo mismo que la contraseña, tampoco para Power Apps ni para el proveedor de Git. Debe crear un token de acceso personal para usar esta función.

Los diferentes proveedores de control de versiones tienen diferentes métodos de generar tokens de acceso personal. Siga las instrucciones a continuación para obtener un token de acceso personal.

• GitHub - Creación de un token de acceso personal
• Azure DevOps - Usar tokens de acceso personal
• Otros proveedores de control de versiones: cualquier proveedor de Git se puede utilizar con el control de versiones de Git. Consulte la documentación de su proveedor para aprender cómo crear un token de acceso personal.

Al editar aplicaciones conectadas a Git, se le solicita un nombre de usuario y contraseña. Introduzca su nombre de usuario y el token de acceso de este diálogo para autenticarse con Git.

Nota

Las credenciales de Git no las almacena Power Apps entre sesiones. Si lo desea, puede usar la configuración del navegador para guardar la información del formulario para su reutilización y evitar introducir las credenciales con frecuencia.

Realizar cambios en la aplicación

Una vez que una aplicación está conectada a Git, todo lo que tiene que hacer es autenticarse con las credenciales de Git para abrir y editar la aplicación. No es necesario que analice los conceptos de Git cuando utilice esta función para cargar, editar, guardar, publicar y compartir la aplicación.

Utilice el nuevo botón de sincronización de la parte superior de la pantalla de Studio (entre los botones Comprobador de aplicaciones y Deshacer) para fusionar los cambios actuales con lo que hay en Git y llevar el resultado a Studio para su posterior edición.

Importante

La aplicación deberá cargarse cada vez que haya una combinación. Si la aplicación es grande, esta carga puede llevar algún tiempo.

Después de conectarse a Git, los cambios se almacenan en Git en lugar de en Power Apps. Las versiones no publicadas no aparecerán en Power Apps Maker Portal.

Combinar resultados

Actualmente, no hay ninguna opción para resolver los conflictos decombinación. Studio intentará combinar y solucionar conflictos automáticamente a través del conocimiento semántico de la aplicación (por ejemplo, los tipos de objetos y otros cambios de la aplicación). Dado que todos los cambios aún se almacenan en Git, siempre puede recuperar los cambios de la aplicación para volver a aplicarlos si la combinación automática no cumple con los requisitos de su negocio.

Publica la aplicación

Las aplicaciones conectadas a Git continúan funcionando normalmente para la publicación y la experiencia del usuario, sin cambios en este proceso. Cuando publica una aplicación, la versión de la aplicación se almacena en Power Apps, ya que Power Apps necesita una copia ejecutable de la aplicación para compartir con los usuarios.

Solicitudes de extracción, historial de visualización, problemas y otras características de Git

El trabajo con solicitudes de extracción o cualquier otra operación de Git debe realizarse a través de otras herramientas de Git, incluido el sitio web del proveedor de Git. No hay ninguna opción disponible para realizar tales operaciones de Git para extraer o insertar confirmaciones.

Cada guardado o sincronización que incluya cambios dará como resultado una confirmación en Git. Si se produjeron otros cambios en Git, por ejemplo por parte de otros fabricantes, se realizarán confirmaciones adicionales para fusionar los resultados de todos los cambios. No se perderán los cambios, incluso si una combinación invalida una edición. Los cambios de cada fabricante se almacenan en Git a través de confirmaciones.

Limitaciones conocidas

Dado que esta función es experimental, agradeceremos sus comentarios. A continuación se enumeran limitaciones conocidas. Planeamos eliminar la mayoría de estas limitaciones en versiones futuras.

• Esta función no es compatible con componentes de código. No utilice esta función con aplicaciones que utilizan componentes de código.
• Esta característica no es compatible con repositorios locales de Git. El repositorio de Git debe estar alojado en la web y debe ser accesible con nombre de usuario y token de acceso personal.
• Las ediciones de la misma propiedad en el mismo control no se combinan. La última edición realizada será la válida.
• No puede restaurar una aplicación de lienzo a una versión anterior siguiendo los pasos descritos en el artículo Restaurar una aplicación. En su lugar, deberá usar Git para restaurar la aplicación a una versión anterior. Para obtener más información, vea los siguientes recursos:
  • git-revert
  • Revertir una confirmación
  • Deshacer cambios
• Conectar varias aplicaciones al mismo directorio git puede causar problemas. Esto incluye hacer copias de su aplicación y exportarlas e importarlas.
• Cualquier archivo existente en el repositorio con nombres que excedan los 180 caracteres puede causar problemas al conectarse. Recomendamos usar un repositorio dedicado para aplicaciones conectadas a Git.
• Seleccionando Cerrar en el menú Archivo puede aparecer un menú para eliminar sus personalizaciones en la aplicación. Sin embargo, las personalizaciones no se eliminan. Actualice la página para volver a ver todas las personalizaciones.
• Si abre una aplicación no conectada a git (por ejemplo, App A) desde una aplicación conectada a git (por ejemplo, App B) (Archivo > Abrir) e intenta conectar App A a un repositorio, los parámetros de control de la versión git de App Aserán los mimos que para App B. Cuando esto ocurra, actualice su página y luego intente conectar App A al repositorio de nuevo.
• Esta característica no admite el cambio de nombre de componentes personalizados.
• Si ve un mensaje sobre la aplicación abierta para que otro usuario la edite, solicite al usuario al que se hace referencia que actualice la aplicación. Luego, actualice su aplicación para eliminar el bloqueo.
• Esta característica no es compatible con pruebas de Test Studio y páginas personalizadas para aplicaciones basadas en modelos
• Esta característica no admite el uso de tokens de acceso personal que están autorizados para su uso con el inicio de sesión único de SAML.

Comentarios al foro de la comunidad

Nos interesa su opinión Esta función es el primer paso de un largo viaje para permitir una gran experiencia de desarrollo de equipo. Visite el Foro comunitario de Power Apps para obtener actualizaciones y proporcionar comentarios.