Gestão do ciclo de vida da aplicação (ALM) da biblioteca de componentes

Uma biblioteca de componentes é um tipo especial de aplicação canvas que pode conter um ou mais componentes canvas. Estes componentes da biblioteca podem então ser utilizados por todas as outras aplicações de tela no ambiente. Esse recurso permite que você crie componentes compartilhados reutilizáveis em todos os aplicativos em um ambiente, ao contrário dos componentes no nível do aplicativo que são restritos a um aplicativo.

Para usar um componente de uma biblioteca de componentes, é necessário primeiro importar o componente para a aplicação canvas. Depois de importado, você pode adicionar o componente a qualquer tela do aplicativo. Quaisquer atualizações na definição de componente da biblioteca de componentes solicitarão que você revise e incorpore a alteração sob demanda ou quando o aplicativo for aberto para edição. Bibliotecas de componentes e aplicativos dependentes também podem ser movidos para outro ambiente usando soluções padrão do Microsoft Dataverse.

Quando um componente de uma biblioteca de componentes é importado para um aplicativo de tela, a definição desse componente é copiada para a definição do aplicativo de tela. Depois que uma definição de componente é importada, o aplicativo é "independente" no que diz respeito a essa definição de componente. O criador do aplicativo pode optar por editar o componente e criar instâncias locais do componente dentro do aplicativo. Neste ponto, não há nenhum link direto para a biblioteca de componentes de onde o componente se originou. Esta caraterística autónoma também se aplica se a aplicação de tela for migrada para um ambiente diferente onde a biblioteca de componentes não está presente. Você pode continuar a criar instâncias da definição de componente importado dentro dos aplicativos no ambiente de destino, e os aplicativos ainda podem ser publicados e reproduzidos. Nenhuma nova atualização será solicitada ou recebida no aplicativo consumidor neste caso.

Para manter a relação do aplicativo com a biblioteca de componentes, certifique-se de usar a biblioteca de componentes para fazer alterações no componente, em vez de editar o componente dentro do aplicativo consumidor.

Suporte a aplicações de canvas e bibliotecas de componentes

Consistente com as outras dependências de objeto de solução, se um aplicativo de tela importar um componente de tela de uma biblioteca de componentes, ele terá uma dependência dessa biblioteca de componentes. Para mover um aplicativo para o novo ambiente, você precisará empacotar a biblioteca de componentes dentro da mesma solução ou instalá-la como pré-requisito. A dependência da aplicação para a biblioteca de componentes é mantida no ambiente de destino. Em um ponto posterior, quando uma biblioteca de componentes com o componente atualizado for importada usando uma solução para o ambiente de destino, os aplicativos existentes obterão as novas definições de componente usando o fluxo de atualização de componente regular.

Criando e exportando biblioteca de componentes em uma solução

Você pode criar uma biblioteca de componentes diretamente de dentro da solução ou adicioná-la a uma solução existente.

Quando uma biblioteca de componentes é salva em um ambiente que tem o Dataverse disponível, a biblioteca de componentes é adicionada automaticamente à solução padrão. Um nome lógico exclusivo é gerado para a biblioteca de componentes com o prefixo Default CDS Publisher . Esse comportamento é para garantir que o sistema de solução esteja ciente de sua presença e possa vincular as dependências dos aplicativos que usam o nome lógico da biblioteca de componentes.

As bibliotecas de componentes dentro de uma solução também suportam as propriedades geridas Permitir personalizações que regem o comportamento da biblioteca de componentes no ambiente de destino.

Se você desativar essa configuração e exportar a solução para um ambiente de destino, não poderá editar a biblioteca de componentes.

Dependências da biblioteca de componentes

Os aplicativos que usam componentes da biblioteca de componentes serão marcados como dependentes na infraestrutura de soluções. Esse comportamento se aplica a todos os aplicativos que são adicionados a qualquer solução Dataverse em um determinado ambiente. Você ainda pode criar aplicativos fora das soluções, mas esses aplicativos não terão dependências de solução. Mais tarde, você pode adicionar esses aplicativos a soluções para torná-los parte da solução ALM.

Se você importar uma solução que tenha apenas um aplicativo que usa um componente de uma biblioteca de componentes, mas exclui a biblioteca de componentes, verá a seguinte mensagem:

Falha na importação devido à falta de dependências para <nome do aplicativo>.

Nesse caso, você pode optar por instalar a solução de biblioteca de componentes primeiro ou agrupar a biblioteca de componentes com a solução que contém o aplicativo de tela. Qualquer uma das etapas garantiria que o aplicativo terá a dependência criada no ambiente de destino.

Quando a biblioteca é atualizada e uma versão mais recente do componente é importada por meio das soluções, o aplicativo receberá uma notificação e receberá as atualizações quando o aplicativo for aberto para edição.

As dependências são calculadas com base no estado publicado mais recente de um aplicativo. Se você restaurar uma versão mais antiga do aplicativo que não usa um componente de biblioteca, a dependência será removida do aplicativo e da solução. Importar um componente para um aplicativo de uma biblioteca de componentes sem realmente usá-lo também cria uma dependência, uma vez que o componente de biblioteca não utilizado permanece disponível dentro do aplicativo para um uso futuro.

Práticas recomendadas e solução de problemas

• Limite o número de componentes em uma biblioteca a 20 para obter o desempenho ideal. Planeje e crie várias bibliotecas de componentes com antecedência, pois o número de componentes nelas provavelmente crescerá com o tempo. Essa abordagem também reduzirá a carga útil da solução à medida que as aplicações são transferidas no ambiente.

• Há um atraso desde quando a biblioteca de componentes é publicada até quando está disponível para o aplicativo, e pode levar até 5 minutos.

• Se o aplicativo não puder receber a atualização do componente de biblioteca no ambiente de destino onde a solução está instalada, verifique usando as ações abaixo:

  • As alterações feitas em uma biblioteca de componentes em um ambiente de destino residem na camada superior de um componente. Posteriormente, essas personalizações definem o comportamento de tempo de execução do componente. Para remover essas personalizações não gerenciadas, consulte Remover uma camada não gerenciada.
  • Determine o nome lógico da biblioteca de componentes na visualização da solução. Use a solução padrão se a biblioteca não for adicionada explicitamente à solução.
  • Transfira a aplicação utilizando o componente de biblioteca para o computador local utilizando Ficheiro>Guardar como>Este computador. Renomeie o arquivo baixado para ter uma extensão .zip e descompacte o pacote. Abra o ficheiro Properties.json e, em seguida, procure a palavra-chave "LibraryDependencies". Você deve ver um nome lógico de biblioteca correspondente.
  • Se você estiver a consumir a solução, verifique se a aplicação canvas identificou corretamente as bibliotecas de componentes como dependências da solução. Se a solução não identificar corretamente as bibliotecas de componentes como dependências de solução, isso significa que a dependência do aplicativo para o link da biblioteca de componentes não foi criada corretamente. Nesse caso, consulte o provedor de soluções para resolver o problema.
  • Se você for o editor da solução, verifique se as bibliotecas de componentes são salvas com o nome lógico da biblioteca na solução e se é igual ao referenciado no pacote .msapp da biblioteca de componentes.

• A exportação de soluções sempre exporta a versão mais recente da biblioteca de componentes. Portanto, sempre atualize os aplicativos com a versão mais recente do componente antes de exportá-los por meio de soluções. Essa ação garante que os aplicativos tenham a mesma versão de componente disponível na versão mais recente da biblioteca de componentes. Os aplicativos e a biblioteca são considerados sincronizados entre si quando são movidos para um ambiente de destino pela primeira vez; E, portanto, você não será solicitado a fornecer nenhuma atualização ao editar o aplicativo.

Consulte também

• Componentes do Canvas
• Biblioteca de componentes
• Mapear campos de entrada de um componente
• Adicionar multimédia a um componente
• Fórmulas de comportamento para componentes
• Estrutura do componente Power Apps
• Adicionar componentes de tela a uma página personalizada em um aplicativo controlado por modelo