Biblioteca de componentes

No artigo de descrição geral sobre a criação de componentes, ficará a saber mais sobre componentes dentro de uma aplicação de tela. À medida que crias componentes dentro de uma aplicação, também podes criar uma biblioteca de componentes que podes reutilizar. Ao criar uma biblioteca de componentes, os criadores de aplicações podem facilmente partilhar e atualizar um ou mais componentes com outros fabricantes.

As bibliotecas de componentes são contentores de definições de componentes que facilitam:

• Descubra e procure componentes.
• Publicar atualizações.
• Notificar os criadores da aplicação das atualizações de componentes disponíveis.

Nota

As bibliotecas de componentes são a forma recomendada de reutilizar componentes em todas as aplicações. Ao utilizar uma biblioteca de componentes, uma aplicação mantém dependências sobre os componentes que utiliza. O criador da aplicação é alertado quando as atualizações dos componentes dependentes ficam disponíveis. Por isso, crie componentes reutilizáveis dentro das bibliotecas de componentes. Uma funcionalidade anterior do Power Apps que permitia importar componentes de uma aplicação de tela para outra foi descontinuada.

Diferença entre uma aplicação e uma biblioteca de componentes

Uma biblioteca de componentes fornece um repositório centralizado e gerido de componentes para reutilização.

Se criar uma biblioteca de componentes, o painel Inserir na navegação à esquerda fica predefinido para o separador Componentes. Quando cria uma aplicação, esta vista mostra ecrãs em vez de componentes.

Nota

Os ecrãs numa biblioteca de componentes estão disponíveis apenas para testes. Fornece aos criadores da biblioteca uma forma de testar rapidamente os componentes criados num ecrã real e também validar o comportamento de atualização à medida que os componentes são melhorados ao longo do tempo. Para utilizar os componentes da biblioteca de componentes, tem de criar uma aplicação que utilize a biblioteca de componentes.

Pode pré-visualizar os componentes da biblioteca de componentes através dos ecrãs da biblioteca com a opção Reproduzir. Quando seleciona o separador Componente, a opção Reproduzir fica desativada. A biblioteca de componentes não é apresentada quando utiliza o Power Apps Mobile.

Nota

A biblioteca de componentes abordada neste artigo é diferente da estrutura de componentes do Power Apps, que permite aos programadores e criadores criar componentes de código para aplicações de tela e aplicações orientadas por modelos. Para mais informações, consulte a visão geral do framework de componentes Power Apps.

Trabalhar com a biblioteca de componentes

Pode criar uma nova biblioteca de componentes ou editar uma biblioteca de componentes existente a partir da mesma interface. Vá para Power Apps> selecione Mais na navegação à esquerda > selecione Descobrir tudo> selecione Bibliotecas de componentes na secção Melhoramentos à aplicação. Também pode afixar a opção Bibliotecas de componentes na sua interface do Power Apps. Para mais informações, consulte a Navegação à Esquerda no Power Apps.

Criar um exemplo de biblioteca de componentes

Os passos para criar componentes dentro de uma biblioteca de componentes são os mesmos que criar componentes dentro de uma aplicação. Irá criar uma biblioteca de componentes e, em seguida, reutilizar os passos para criar componentes a partir de um exemplo da descrição geral dos componentes. Depois usas a biblioteca de componentes para fornecer os componentes reutilizáveis numa nova aplicação.

1. Iniciar sessão no Power Apps.

2. Selecione Bibliotecas de componentes e, em seguida, selecione Nova biblioteca de componentes. Em alternativa, se não vires Bibliotecas de componentes no painel de navegação esquerdo, seleciona Mais no painel de navegação esquerdo, seleciona o botão Descobrir tudo e seleciona Bibliotecas de componentes na secção Melhorias da aplicação.

3. Dê à biblioteca de componentes o nome de Componentes de menu; ou escolha outro nome à sua preferência.

4. Siga os passos para criar componentes a partir do exemplo da descrição geral dos componentes. Não precisas de abrir o Power Apps Studio nem criar uma nova aplicação em branco, já que criaste uma nova biblioteca de componentes. Iniciar com o passo 2.

   Depois de seguir os passos para criar componentes, siga o próximo conjunto de passos para também adicionar componentes a um ecrã e os passos para criar uma propriedade de saída.

5. Depois de concluíres a criação e os testes dos componentes, guarda a biblioteca de componentes selecionando o ícone de Guardar nas ações da aplicação.

   Também tens a opção de Guardar com as notas da versão no menu de seta ao lado do ícone de Guardar . Uma nota de versão é útil para obter versões de uma biblioteca de componentes e para atualizar os componentes utilizados em aplicações a partir desta biblioteca de componentes. Para mais detalhes sobre as ações da aplicação, consulte o artigo Compreender o Power Apps Studio.

   

   Sugestão

   Uma nota de versão é útil ao rever versões de uma biblioteca de componentes e para os criadores de aplicações que utilizam a sua biblioteca de componentes analisarem as alterações e atualizarem, conforme necessário, as aplicações que utilizam estes componentes. Aceda a atualizar uma biblioteca de componentes para obter mais detalhes.

6. Podes publicar uma biblioteca de componentes guardados. Só estão disponíveis atualizações da biblioteca de componentes publicadas para aplicações que consumam uma biblioteca de componentes. Selecione o ícone Publicar nas ações da aplicação para publicar a versão da biblioteca de componentes:

   

Personalização de componentes da biblioteca

Quando crias um componente dentro de uma biblioteca de componentes, podes definir se as aplicações que usam os componentes da biblioteca podem personalizar o componente. Por defeito, esta definição está Ativada nas propriedades dos componentes. Desligue esta definição para remover a possibilidade de personalizar o componente noutras aplicações.

Quando adicionas um componente que permite personalização, vês uma opção para editar esse componente para mais personalização. A aplicação faz uma cópia local, e podes fazer alterações à cópia do componente local. A associação com a biblioteca de componentes é removida assim que editas o componente.

A seleção de Editar componente solicita-lhe para copiar o componente localmente para personalização.

Se não permitires que os componentes sejam personalizados, as aplicações que consomem não mostram a opção de editar o componente.

Neste caso, a única forma de editar o componente é editar a biblioteca de componentes onde o componente está armazenado.

Importar a partir de uma biblioteca de componentes

Depois de criar e publicar uma biblioteca de componentes, as aplicações podem consumir os componentes dessa biblioteca importando a biblioteca. Também pode partilhar uma biblioteca de componentes.

Para importar a partir de uma biblioteca de componentes, edite uma aplicação existente ou crie uma nova aplicação. Depois de a aplicação abrir no estúdio de aplicações de tela, selecione Inserir ou + na navegação à esquerda. Em seguida, selecione obter mais componentes para listar as bibliotecas de componentes disponíveis no ambiente atual:

Vê a lista de bibliotecas de componentes disponíveis no ambiente atual no lado direito do ecrã. Selecione um componente individual a partir de uma biblioteca de componentes. Ou utilize selecionar tudo para importar todos os componentes da biblioteca de uma só vez:

Nota

Se um fabricante não visualizar a biblioteca de componentes listada na secção importação, certifique-se de que a biblioteca de componentes é partilhada com o fabricante. Para mais detalhes, consulte permissões de biblioteca de componentes.

Nota

Pode selecionar e importar mais do que um componente e entre diferentes bibliotecas de componentes.

Os componentes disponíveis na aplicação encontram-se listados na categoria Personalizar na lista de componentes no painel Inserir. Os componentes disponíveis a partir de bibliotecas de componentes importados encontram-se listados na categoria Componentes da biblioteca:

Atualizar uma biblioteca de componentes

Pode modificar uma biblioteca de componentes existente e guardar as alterações com outras notas de versão. No entanto, a versão atualizada da biblioteca de componentes tem de ser publicada para utilização em aplicações existentes que utilizem a biblioteca de componentes. Os exemplos de passos da biblioteca de componentes explicam como publicar uma biblioteca de componentes depois de a guardar.

Existem duas formas de as aplicações que usam os componentes da biblioteca obterem as mais recentes alterações.

Método 1: Notificação de atualização de componentes ao editar a aplicação

Os criadores de outras aplicações recebem notificações quando há componentes atualizados disponíveis. A notificação é apresentada quando os criadores editam as aplicações no estúdio de aplicações de tela. Podem optar por atualizar os componentes:

Selecione Rever e verá a opção para atualizar o componente:

As notas de versão que adicionas ao publicar a versão da biblioteca de componentes aparecem aqui.

Selecione Atualizar para atualizar os componentes.

Método 2: Verificação proativa de atualizações

Use este método para verificar proativamente a atualização da aplicação enquanto trabalha na aplicação no Studio.

Para fazer esta verificação, selecione o painel Inserir componentes no lado esquerdo e depois selecione o ícone Verificar atualizações .

Se houver atualizações para componentes usados na biblioteca, recebes uma mensagem para rever e receber as alterações mais recentes. Ao rever e atualizar, a aplicação é atualizada com os componentes mais recentes.

Atualizar componente de uma biblioteca de componentes numa aplicação consumidora

Se importar um componente a partir de uma biblioteca de componentes, não poderá editá-lo dentro da aplicação de consumo. Se selecionares Editar componente, vês uma opção para criar uma cópia do componente dentro da aplicação atual para poderes fazer alterações:

Se selecionar criar uma cópia, o componente é copiado para a aplicação local. A cópia local do componente aparece na categoria personalizado no painel inserir. Esta cópia local do componente não recebe atualizações se uma nova versão da biblioteca de componentes originais for publicada posteriormente.

Nota

As instâncias em uso dos componentes da biblioteca de componentes não são afetadas depois de criar uma cópia local de um componente e permanecem ligadas à definição da biblioteca de componentes. Apenas as instâncias dos componentes copiados localmente (da categoria Personalizada) são consideradas como sendo os componentes da aplicação local.

Eliminar uma biblioteca de componentes

Se uma biblioteca de componentes for referenciada por uma aplicação de tela, não pode ser eliminada. Esta condição é válida tanto para ambientes Power Platform como para ambientes não Power Platform. Remova o componente da aplicação antes de eliminar a biblioteca. Pode encontrar informações sobre as aplicações que utilizam a biblioteca de componentes na vista Dependências da solução ou na mensagem que é mostrada quando tenta eliminar a biblioteca.

Permissões da biblioteca de componentes

A partilha de uma biblioteca de componentes funciona da mesma forma que a partilha de uma aplicação de tela. Quando partilha uma biblioteca de componentes, permite que outras pessoas a reutilizem. Depois de partilhada, os outros utilizadores podem editar a biblioteca de componentes e importar componentes a partir desta biblioteca de componentes partilhada para criar e editar aplicações. Se partilhada como um coproprietário, um utilizador pode utilizar, editar e partilhar uma biblioteca de componentes, mas não eliminar ou alterar o proprietário.

Considerações adicionais ao partilhar bibliotecas de componentes com grupos de segurança:

• Não pode utilizar a IU de partilha quando partilha bibliotecas de componentes criadas como parte de uma solução. Em vez disso, utilize o cmdlet Set-PowerAppRoleAssignment com o nível de permissão CanEdit para partilhar as bibliotecas de componentes com o grupo de segurança selecionado.
• As bibliotecas de componentes criadas num ambiente do Power Platform sem uma base de dados do Dataverse partilhada como Coproprietário concedem automaticamente a permissão CanEdit ao grupo de segurança selecionado.

Limitações conhecidas

• Limitações conhecidas que se aplicam aos componentes também se aplicam às bibliotecas de componentes.

• Não pode importar componentes de uma biblioteca de componentes guardada localmente. Pode descarregar uma biblioteca de componentes selecionando Descarregar uma cópia a partir das ações da aplicação. Mas se tentar importar essa biblioteca de componentes guardados, verá a seguinte mensagem de erro:

  

• Se estiver a importar uma aplicação e uma biblioteca de componentes num ambiente pela primeira vez, certifique-se de que a aplicação utiliza a versão mais recente do componente incluída na biblioteca de componentes. Caso contrário, a aplicação não recebe atualizações após a importação. A aplicação reconhece e solicita a versão atualizada após importações subsequentes da biblioteca de componentes para o mesmo ambiente.

• Os componentes de código não são suportados dentro de bibliotecas de componentes.

Consulte também

• Componentes do Canvas
• Gestão do ciclo de vida da aplicação de biblioteca de componentes (ALM)
• Mapear campos de entrada de um componente
• Adicionar multimédia a um componente
• Fórmulas de comportamento para componentes
• Componentes da arquitetura do Power Apps
• Adicionar componentes de tela a uma página personalizada numa aplicação condicionada por modelo