Biblioteca de componentes

No artigo Visão geral sobre como criar componentes, você aprende sobre componentes em um aplicativo de tela. Ao criar componentes dentro de um aplicativo, você também pode criar uma biblioteca de componentes que você pode reutilizar. Ao criar uma biblioteca de componentes, os criadores de aplicativos podem compartilhar e atualizar facilmente um ou mais componentes com outros fabricantes.

Bibliotecas de componentes são contêineres de definições de componentes que facilitam estas atividades:

• Descobrir e buscar componentes.
• publicar atualizações;
• notificar criadores de aplicativos sobre atualizações de componentes disponíveis.

Diferença entre um aplicativo e uma biblioteca de componentes

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

O painel Inserir à esquerda da navegação terá como padrão uma guia de componentes, caso você crie uma biblioteca de componentes. Quando você cria um aplicativo, essa exibição mostra telas em vez de componentes.

Você pode exibir os componentes da biblioteca de componentes usando as telas dentro da biblioteca, com a opção de reprodução. Quando você seleciona a guia do componente, a opção de reprodução é desativada. A biblioteca de componentes não é exibida ao usar o Power Apps Mobile.

Como trabalhar com a biblioteca de componentes

Você pode criar uma nova biblioteca de componentes ou editar uma existente a partir da mesma interface. Vá até Power Apps> selecione Mais na navegação à esquerda > selecione Descobrir tudo> selecione Bibliotecas de componentes na seção Melhorias no aplicativo. Você também pode fixar a opção Bibliotecas de componentes na interface do Power Apps. Para obter mais informações, consulte a navegação à esquerda no Power Apps.

Criar um exemplo de biblioteca de componentes

As etapas para criar componentes dentro de uma biblioteca de componentes são as mesmas que para criar componentes dentro de um aplicativo. Crie uma biblioteca de componentes e reutilize as etapas para criar componentes do exemplo de visão geral de componentes. Em seguida, use a biblioteca de componentes para fornecer os componentes reutilizáveis em um novo aplicativo.

1. Entre em Power Apps.

2. Selecione Bibliotecas de componentes na navegação à esquerda e Nova biblioteca de componentes. Como alternativa, se você não vir bibliotecas de componentes na navegação esquerda, selecione Mais na navegação à esquerda, selecione o botão Descobrir tudo e selecione Bibliotecas de componentes na seção Aprimoramentos do aplicativo .

3. Nomeie os componentes do menu da biblioteca de componentes; ou forneça um nome diferente de sua escolha.

4. Siga as etapas para criar componentes do exemplo de visão geral de componentes. Você não precisa abrir Power Apps Studio ou criar um novo aplicativo em branco, pois já criou uma nova biblioteca de componentes. Comece pelo passo 2.

   Depois de seguir as etapas para criar componentes, siga o próximo conjunto de etapas para também adicionar componentes a uma tela, e as etapas para criar propriedade de saída.

5. Depois de concluir a criação e o teste dos componentes, salve a biblioteca de componentes selecionando o ícone Salvar nas ações do aplicativo.

   Você também tem uma opção para Salvar com anotações de versão no menu de seta ao lado do ícone Salvar . Uma nota de versão é útil para recuperar versões de uma biblioteca de componentes e para atualizar os componentes usados nos aplicativos dessa biblioteca de componentes. Para obter mais detalhes sobre as ações do aplicativo, consulte o artigo Noções básicas sobre Power Apps Studio.

   

   Dica

   Uma nota de versão é útil ao analisar versões de uma biblioteca de componentes e para que os criadores de aplicativos que usam sua biblioteca de componentes analisem as alterações e atualizem aplicativos que consomem esses componentes, conforme necessário. Vá para atualizar uma biblioteca de componentes para obter mais detalhes.

6. Você pode publicar uma biblioteca de componentes salva. Somente atualizações publicadas da biblioteca de componentes estão disponíveis para aplicativos que usam uma biblioteca de componentes. Selecione o ícone Publicar nas ações do aplicativo para publicar a versão da biblioteca de componentes:

   

Personalização de componentes da biblioteca

Ao criar um componente dentro de uma biblioteca de componentes, você pode definir se os aplicativos que usam os componentes da biblioteca podem personalizar o componente. Por padrão, essa configuração é Ativada dentro das propriedades de componentes. Desative essa configuração para remover a capacidade de personalizar o componente em outros aplicativos.

Quando você adiciona um componente que permite a personalização, você vê uma opção para editar esse componente para obter mais personalização. O aplicativo faz uma cópia local e você pode fazer alterações na cópia do componente local. A associação com a biblioteca de componentes é removida depois que você edita o componente.

A seleção de Editar componente solicita que você copie o componente localmente para personalização.

Se você não permitir que os componentes sejam personalizados, os aplicativos consumidores não mostrarão a opção de editar o componente.

Nesse caso, a única maneira de editar o componente é editar a biblioteca de componentes onde ele está armazenado.

Importar a partir de uma biblioteca de componentes

Depois de criar e publicar uma biblioteca de componentes, os aplicativos podem consumir os componentes dessa biblioteca de componentes importando a biblioteca. Você também pode compartilhar uma biblioteca de componentes.

Para importar de uma biblioteca de componentes, edite um aplicativo existente ou crie um novo. Depois que o aplicativo for aberto no estúdio de aplicativo 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:

Você vê a lista de bibliotecas de componentes disponíveis no ambiente atual no lado direito da tela. Selecione um componente individual em uma biblioteca de componentes. Ou use Selecionar tudo para importar todos os componentes da biblioteca de uma só vez:

Os componentes disponíveis dentro do aplicativo estão listados na categoria Personalizados na lista de componentes do painel Inserir. Os componentes disponíveis nas bibliotecas de componentes importados estão listados na categoria Componentes da biblioteca:

Atualizar uma biblioteca de componentes

Você pode modificar uma biblioteca de componentes existente e salvar quaisquer alterações com outras notas de versão. No entanto, a versão atualizada da biblioteca de componentes deve ser publicada para uso em aplicativos existentes que usam a biblioteca de componentes. As etapas de biblioteca de componentes de exemplo explicam como publicar uma biblioteca de componentes depois de salvá-la.

Há duas formas de os aplicativos que usam os componentes da biblioteca obterem as alterações mais recentes.

Método 1: notificação de atualização de componente na edição do aplicativo

Os criadores de outros aplicativos são notificados quando os componentes atualizados estão disponíveis. A notificação é exibido quando os criadores editam os aplicativos no estúdio de aplicativo de tela. Eles podem optar por atualizar os componentes:

Selecione Revisão e você verá a opção de atualizar o componente:

Notas de versão que você adiciona 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 esse método para verificar proativamente a atualização do aplicativo enquanto trabalha no aplicativo no Studio.

Para fazer essa verificação, selecione o painel Inserir componente no lado esquerdo e, em seguida, selecione o ícone Verificar se há atualizações .

Se houver atualizações para componentes usados na biblioteca, você receberá uma mensagem para examinar e obter as alterações mais recentes. Quando você analisa e atualiza, o aplicativo é atualizado com os componentes mais recentes.

Atualizar componente de uma biblioteca de componentes em um aplicativo de consumo

Se você importar um componente de uma biblioteca de componentes, não poderá editá-lo dentro do aplicativo de consumo. Se você selecionar Editar componente, verá uma opção para criar uma cópia do componente dentro do aplicativo atual para que você possa fazer alterações:

Se você selecionar Criar uma cópia, o componente será copiado para o aplicativo local. A cópia local do componente é exibida na categoria Personalizados do painel Inserir. Essa cópia local do componente não receberá atualizações se uma nova versão da biblioteca de componentes de origem for publicada posteriormente.

Excluir uma biblioteca de componentes

Se uma biblioteca de componentes for referenciada por um aplicativo de tela, ela não poderá ser excluída. Essa condição é verdadeira tanto para ambientes do Power Platform quanto para ambientes que não são do Power Platform. Remova o componente do aplicativo antes de excluir a biblioteca. Você pode encontrar informações sobre os aplicativos que usam a biblioteca de componentes na exibição de dependências da solução ou na mensagem exibida ao tentar excluir a biblioteca.

Permissões da biblioteca de componentes

Compartilhar uma biblioteca de componentes funciona da mesma maneira que compartilhar um aplicativo de tela. Ao compartilhar uma biblioteca de componentes, você permite que outras pessoas a reutilizem. Depois que a biblioteca de componentes é compartilhada, outras pessoas podem editá-la e importar componentes dessa biblioteca de componentes compartilhada para criar e editar aplicativos. Se for compartilhada como coproprietário, um usuário pode usar, editar e compartilhar uma biblioteca de componentes, mas não excluir ou alterar o proprietário.

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

• Você não pode usar a IU de compartilhamento ao compartilhar bibliotecas de componentes criadas como parte de uma solução. Em vez disso, use o cmdlet Set-PowerAppRoleAssignment com o nível de permissão CanEdit para compartilhar as bibliotecas de componentes com o grupo de segurança selecionado.
• As bibliotecas de componentes criadas em um ambiente do Power Platform sem um banco de dados do Dataverse, compartilhadas como Coproprietário, concedem automaticamente a permissão CanEdit ao grupo de segurança selecionado.

Limitações conhecidas

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

• Você não pode importar componentes de uma biblioteca de componentes salva localmente. Você pode baixar uma biblioteca de componentes selecionando Baixar uma cópia das ações do aplicativo. Mas se você tentar importar essa biblioteca de componentes salva, verá a seguinte mensagem de erro:

  

• Se você estiver importando um aplicativo e uma biblioteca de componentes em um ambiente pela primeira vez, verifique se o aplicativo usa a versão mais recente do componente incluído na biblioteca de componentes. Caso contrário, o aplicativo não receberá atualizações após a importação. O aplicativo reconhece e solicita a versão atualizada nas importações subsequentes da biblioteca de componentes para o mesmo ambiente.

• Não há suporte para componentes de código dentro de bibliotecas de componentes.

Confira também

• Componentes da tela
• Gerenciamento do ciclo de vida do aplicativo (ALM) da biblioteca de componentes
• Mapear campos de entrada de um componente
• Adicionar multimídia a um componente
• Fórmulas de comportamento para componentes
• Estrutura de componentes do Power Apps
• Adicionar componentes de tela a uma página personalizada em um aplicativo baseado em modelo