Componentes de código para aplicativos de tela

Os desenvolvedores profissionais podem usar o framework de componente do Power Apps para criar componentes de código que podem ser usados em seus aplicativos canvas. Para obter mais informações, consulte Power Apps visão geral da estrutura de componentes.

Os desenvolvedores de aplicativos podem usar a estrutura de componentes do Power Apps para criar, importar e adicionar componentes de código em aplicativos de tela usando Microsoft Power Platform CLI. Determinadas APIs podem não estar disponíveis em aplicativos de tela. Verifique cada API para determinar onde ela está disponível.

Considerações de segurança

Quando você abre um aplicativo de tela que contém componentes de código no Power Apps Studio, uma mensagem de aviso sobre código potencialmente não seguro é exibida. Os componentes de código no ambiente do Power Apps Studio têm acesso a tokens de segurança, portanto, só abrem componentes de fontes confiáveis. Os administradores e os personalizadores do sistema devem examinar e validar todos os componentes de código antes de importar esses componentes em um ambiente e disponibilizá-los para os fabricantes usarem em seus aplicativos. O Default publicador aparece quando você importa componentes de código ao usar uma solução não gerenciada ou quando você usa pac pcf push para instalar o componente de código.

Pré-requisitos

• Uma licença de Power Apps é necessária. Para obter mais informações, consulte licenciamento do framework de componentes do Power Apps.
• Privilégios de administrador do sistema são necessários para habilitar o recurso da estrutura de componentes Power Apps no ambiente.

Habilitar o recurso da estrutura de componentes Power Apps

Para adicionar componentes de código a um aplicativo, você precisa habilitar o recurso da estrutura de componentes Power Apps em cada ambiente em que você deseja usá-los. Por padrão, o recurso de componente Power Apps está habilitado para aplicativos controlados por modelos. Para habilitar um ambiente a usar componentes de código dentro de seus aplicativos:

1. Faça login no Power Apps.

2. Selecione Configurações Em seguida, selecione Centro de Administração.

   

3. No painel esquerdo, selecione Ambientes, selecione o ambiente onde deseja habilitar esse recurso e selecione Configurações.

4. Expanda Produto e selecione Recursos.

5. Na lista de recursos disponíveis, ative Power Apps estrutura de componentes para aplicativos de tela e selecione Save.

   

Implementando componentes de código

Depois de habilitar o recurso de estrutura de componentes do Power Apps em seu ambiente, você pode começar a implementar a lógica para componentes de código. Para obter um tutorial passo a passo, consulte Criar seu primeiro componente de código.

Verifique as limitações dos componentes de código em aplicativos de canvas antes de iniciar a implementação.

Adicionar componentes a um aplicativo de tela

1. Vá para Power Apps Studio.

2. Crie um novo aplicativo de tela ou edite um aplicativo existente ao qual você deseja adicionar o componente de código.

   Importante

   Verifique se você tenha importado o arquivo .zip da solução que contém os componentes de código no Microsoft Dataverse.

3. No painel esquerdo, selecione Adicionar (+) e, em seguida, selecione Obter mais componentes.

   

4. Selecione a guia Código , selecione um componente na lista e selecione Importar.

   

5. No painel esquerdo, selecione +, expanda componentes de código e selecione o componente para adicioná-lo ao aplicativo.

   

   Observação

   Você também pode adicionar componentes selecionando Inserir>componente de Importação>. Essa opção foi preterida e será removida em uma versão futura, portanto, use o fluxo descrito anteriormente.

Na guia Propriedades , você verá as propriedades do componente de código.

Excluir um componente de código de um aplicativo de tela

1. Abra o aplicativo no qual você adicionou o componente de código.

2. No painel esquerdo, selecione Visualização em Árvore, e, em seguida, selecione a tela onde você adicionou o componente de código.

3. Ao lado do componente, selecione Mais (...) e, em seguida, selecione Excluir.

   

4. Salve o aplicativo para ver as alterações.

Atualizar componentes de código existentes

Para ver as alterações de tempo de execução após a atualização de componentes de código, altere a propriedade version no arquivo de manifesto. Altere a versão do componente sempre que fizer alterações.

Consulte também

visão geral da estrutura de componentes Power Apps
Criar seu primeiro componente de código
estrutura de componentes Learn Power Apps