Biblioteca de components

A l'article general sobre components de creació, aprens sobre components dins d'una aplicació de canvas. Quan crees components dins d'una aplicació, també pots crear una biblioteca de components que pots reutilitzar. Creant una biblioteca de components, els creadors d'aplicacions poden compartir i actualitzar fàcilment un o més components amb altres fabricants.

Les biblioteques de components són contenidors de definicions de components que faciliten:

  • Descobrir i cercar components.
  • Publicar actualitzacions.
  • Avisar els creadors de l'aplicació de les actualitzacions dels components disponibles.

Nota

Les biblioteques de components són la manera recomanada de reutilitzar components entre aplicacions. Quan s'utilitza una biblioteca de components, una aplicació manté les dependències dels components que utilitza. El creador de l'aplicació rep l'alerta quan es disposen d'actualitzacions als components dependents. Per tant, crea components reutilitzables dins de les biblioteques de components. S'ha retirat una característica anterior Power Apps que permetia importar components d'una aplicació de llenç a una altra .

Diferència entre una aplicació i una biblioteca de components

Una biblioteca de components proporciona un repositori centralitzat i administrat per a la reutilització.

La subfinestra Insereix de la navegació esquerra és una pestanya de components per defecte si creeu una biblioteca de components. Quan creeu una aplicació, aquesta visualització mostra pantalles en comptes de components.

Nota

Les pantalles d'una biblioteca de components només estan disponibles per a proves. Proporciona als creadors de biblioteques una manera de provar ràpidament els components creats en una pantalla real i també validar el comportament de l'actualització, ja que els components es milloren amb el temps. Per utilitzar els components de la biblioteca de components, heu de crear una aplicació que utilitzi la biblioteca de components.

Pots previsualitzar components de la biblioteca de components utilitzant les pantalles dins la biblioteca amb l'opció de reproducció. Quan seleccioneu la pestanya del component, l'opció Reprodueix està inhabilitada. La biblioteca de components no es mostra en utilitzar el Power Apps Mobile.

Nota

La biblioteca de components que es tracta en aquest article és diferent del Power Apps component framework que permet als desenvolupadors i creadors crear components de codi per a les aplicacions basades en models i del llenç. Per a més informació, vegeu Power Apps component framework overview.

Treballar amb una biblioteca de components

Podeu crear una biblioteca de components nova o editar una biblioteca de components existent des de la mateixa interfície. Aneu a Més a Power Apps> la navegació > esquerra, seleccioneu Descobreix-ho tot> , seleccioneu Biblioteques de components a la secció Millores de l'aplicació . També podeu fixar l'opció de biblioteques de components a la vostra Power Apps interfície. Per a més informació, vegeu Navegació a l'esquerra a Power Apps.

Crear una biblioteca de components d'exemple

Els passos per crear components dins d'una biblioteca de components són els mateixos que la creació de components dins d'una aplicació. Creareu una biblioteca de components i, a continuació, reutilitzareu els passos per crear components a partir de l'exemple de visió general delscomponents. Després utilitzes la biblioteca de components per proporcionar els components reutilitzables en una nova aplicació.

  1. Inicieu la sessió a Power Apps.

  2. Seleccioneu Biblioteques de components a la navegació esquerra i, a continuació, seleccioneu Nova biblioteca de components. Alternativament, si no veus biblioteques de components a la navegació esquerra, selecciona Més des de la navegació esquerra, selecciona el botó Descobreix tot i selecciona Biblioteques de components a la secció de millores de l'aplicació .

  3. Nomena la biblioteca de components components del menú; o proporciona un nom diferent que triïs.

  4. Seguiu els passos per crear components a partir de l'exemple de visió general delscomponents. No cal que obris Power Apps Studio ni creïs una nova aplicació en blanc, ja que ja has creat una nova biblioteca de components. Comenceu pel pas 2.

    Després de seguir els passos per crear components, seguiu el següent conjunt de passos per afegir també components a una pantalla i els passos per crear la propietat de sortida.

  5. Després d'acabar la creació i prova dels components, desa la biblioteca de components seleccionant la icona de Desar des de les accions de l'aplicació.

    També tens l'opció de desar amb les notes de versió sota el menú de fletxa al costat de la icona de desar . Una nota de la versió és útil per recuperar versions d'una biblioteca de components i per actualitzar els components que s'utilitzen a les aplicacions des d'aquesta biblioteca de components. Per a més detalls sobre les accions de l'aplicació, consulteu l'article Entendre Power Apps Studio.

    Nota de la versió en desar la biblioteca de components.

    Propina

    Una nota de la versió és útil a l'hora de revisar les versions d'una biblioteca de components i per als creadors d'aplicacions que utilitzin la biblioteca de components per revisar els canvis i actualitzar les aplicacions que utilitzen aquests components segons calgui. Aneu a actualitzar una biblioteca de components per obtenir més detalls.

  6. Pots publicar una biblioteca de components guardada. Només hi ha disponibles actualitzacions de biblioteques de components publicades per a les aplicacions que consumeixen una biblioteca de components. Selecciona la icona Publicar des de les accions de l'aplicació per publicar la versió de la biblioteca de components:

    Publica la versió de la biblioteca de components.

Personalització d'una biblioteca de components

Quan crees un component dins d'una biblioteca de components, pots establir si les aplicacions que utilitzen els components de la biblioteca poden personalitzar el component. Per defecte, aquesta configuració està activada dins de les propietats dels components. Desactiva aquesta opció per eliminar la possibilitat de personalitzar el component en altres aplicacions.

Opció per permetre la personalització d'aquest component quan l'utilitza una aplicació.

Quan afegeixes un component que permet personalització, veus una opció per editar aquest component per a més personalització. L'aplicació fa una còpia local, i pots fer canvis a la còpia del component local. L'associació amb la biblioteca de components s'elimina un cop edites el component.

Editeu un component permès per a la personalització.

Si seleccioneu Edita el component , us demanarà que copieu el component localment per personalitzar-lo.

Si no permets personalitzar els components, les aplicacions que consumeixen no mostren l'opció d'editar el component.

No hi ha cap opció per editar el component dins de l'aplicació consumidora.

En aquest cas, l'única manera d'editar el component és editar la biblioteca de components on s'emmagatzema el component.

Importar des d'una biblioteca de components

Després de crear i publicar una biblioteca de components, les aplicacions poden consumir els components d'aquesta biblioteca important la biblioteca. També podeu compartir una biblioteca de components.

Per importar des d'una biblioteca de components, editeu una aplicació existent o creeu una aplicació nova. Després que l'aplicació s'obri a l'estudi d'aplicacions de llenç, seleccioneu Insereix o a + la navegació esquerra. A continuació, seleccioneu Obtén més components per enumerar les biblioteques de components disponibles a l'entorn actual:

Aconsegueix més components.

Veus la llista de biblioteques de components disponibles a l'entorn actual a la part dreta de la pantalla. Seleccioneu un component individual d'una biblioteca de components. O utilitzeu Selecciona-ho tot per importar tots els components de la biblioteca alhora:

Importar components.

Nota

Si un creador no veu la biblioteca de components indicada a la secció d'importació, assegureu-vos que la biblioteca de components es comparteix amb el creador. Per a més detalls, vegeu permisos de biblioteca de components.

Nota

Pots seleccionar i importar més d'un component i entre diferents biblioteques de components.

Els components disponibles dins de l'aplicació es mostren a la categoria Personalitzat de la llista de components de la subfinestra Insereix . Els components disponibles a les biblioteques de components importades es mostren a la categoria Components de la biblioteca:

Inseriu components a l'aplicació.

Actualitzar una biblioteca de components

Podeu modificar una biblioteca de components existent i desar-ne els canvis amb altres notes de versió. No obstant, la versió de la biblioteca de components actualitzada s'ha de publicar per poder utilitzar-la a les aplicacions existents que utilitzen la biblioteca de components. Els passos d'exemple de la biblioteca de components expliquen com publicar una biblioteca de components després de desar-la.

Hi ha dues maneres en què les aplicacions que utilitzen els components de la biblioteca poden obtenir els últims canvis.

Mètode 1: notificació d'actualització de components a l'edició de l'aplicació

Els fabricants d'altres aplicacions reben notificacions quan hi ha components actualitzats disponibles. La notificació es mostra quan els creadors editen les aplicacions a l'estudi d'aplicacions del llenç. Poden triar entre actualitzar els components:

Actualització disponible.

Selecciona Revisió i veuràs l'opció d'actualitzar el component:

Actualitza el component.

Les notes de versió que afegeixes quan publiques la versió de la biblioteca de components apareixen aquí.

Seleccioneu Actualitza per actualitzar els components.

Mètode 2: comprovació proactiva de les actualitzacions

Utilitza aquest mètode per comprovar proactivament l'actualització de l'aplicació mentre treballes en l'aplicació a Studio.

Per fer aquesta comprovació, selecciona el panell Inserir components a l'esquerra i després selecciona la icona Comprovar actualitzacions .

Cerca els components més recents

Si hi ha actualitzacions dels components utilitzats a la biblioteca, reps un missatge per revisar i rebre els últims canvis. Quan revises i actualitzes, l'aplicació s'actualitza amb els últims components.

Actualitzar el component d'una biblioteca de components en una aplicació que consumeix

Si importeu un component d'una biblioteca de components, no podeu editar-lo dins de l'aplicació que l'utilitza. Si selecciones Editar component, veus una opció per crear una còpia del component dins de l'aplicació actual per poder fer canvis:

Edita el component de la biblioteca.

Si seleccioneu Crea una còpia, el component es copia a l'aplicació local. La còpia local del component apareix a la categoria Personalitzat de la subfinestra Insereix . Aquesta còpia local del component no rep actualitzacions si una nova versió de la biblioteca de components d'origen es publica més endavant.

Nota

Les instàncies en ús dels components de la biblioteca de components no es veuen afectades després de crear una còpia local d'un component, i romanen vinculades a la definició de la biblioteca de components. Només les instàncies dels components copiats localment (de la categoria Personalitzada ) es consideren els components de l'aplicació local.

Suprimir una biblioteca de components

Si una biblioteca de components la fa referència a una aplicació del llenç, no es pot suprimir. Aquesta condició és certa tant per a entorns Power Platform com per a entorns no Power Platform. Suprimiu el component de l'aplicació abans de suprimir la biblioteca. Podeu trobar informació sobre les aplicacions que utilitzen la biblioteca de components a la visualització de dependències de la solució o al missatge, que es mostra quan intenteu suprimir una biblioteca.

Suprimeix el component de la biblioteca.

Permisos de la biblioteca de components

Compartir una biblioteca de components funciona de la mateixa manera que compartir una aplicació del llenç. Quan compartiu una biblioteca de components, permeteu que altres usuarisis puguin reutilitzar la biblioteca de components. Un cop compartida, altres usuarisis poden editar la biblioteca de components i importar components d'aquesta biblioteca de components compartides per crear i editar aplicacions. Si es comparteix com a co-propietari, un usuarisi pot utilitzar, editar i compartir una biblioteca de components, però no suprimir-la ni canviar-ne el propietari.

Consideracions addicionals quan es comparteixen biblioteques de components amb grups de seguretat:

  • No podeu utilitzar la interfície d'usuari compartida quan compartiu biblioteques de components creades com a part d'una solució. En lloc d'això, utilitzeu el cmdlet Set-PowerAppRoleAssignment amb el nivell de permís CanEdit per compartir les biblioteques de components amb el grup de seguretat seleccionat.
  • Les biblioteques de components creades en un Power Platform entorn sense una base de dades Dataverse compartida com a copropietari concedeixen automàticament el permís CanEdit al grup de seguretat seleccionat.

Limitacions conegudes

  • Les limitacions conegudes que s'apliquen als components també s'apliquen a les biblioteques de components.

  • No podeu importar components de biblioteques de components desades localment. Pots descarregar una biblioteca de components seleccionant Descarrega una còpia des de les accions de l'aplicació. Però si intentes importar aquesta biblioteca de components guardats, veuràs el següent missatge d'error:

    Importa el fitxer de la biblioteca de components.

  • Si importeu una aplicació i una biblioteca de components en un entorn per primer cop, assegureu-vos que l'aplicació utilitzi la versió més recent del component que s'inclou a la biblioteca de components. Si no, l'aplicació no rep actualitzacions després de la importació. L'aplicació reconeix i demana la versió actualitzada quan es fa importacions posteriors de la biblioteca de components al mateix entorn.

  • Els components de codi no estan admesos a les biblioteques de components.

Consulteu també