Exportar e importar pacotes de aplicativos de tela

Artigo
03/15/2023

Neste artigo, você aprenderá como exportar e importar aplicativos de tela.

Você pode exportar e importar aplicativos de tela usando pacotes. Esse recurso permite exportar um aplicativo de um ambiente e importá-lo para outro. Ao exportar e importar pacotes de aplicativos de tela, considere o cenário que melhor se ajusta às opções disponíveis. Por exemplo, você pode salvar um aplicativo de tela localmente usando a opção Salvar como ao selecionar o local como Este computador. O arquivo salvo terá a extensão do nome do arquivo .msapp. Este arquivo não inclui nenhum componente adicional, como fluxos criados com o Power Automate e usados pelo aplicativo salvo. Embora seja possível usar esse método para criar uma cópia de um aplicativo existente, você pode usar o recurso recomendado de exportação e importação que inclui recursos adicionais com o pacote. Os pacotes de exportação e importação têm o formato de arquivo .zip.

Importante

Os pacotes do aplicativo de tela não podem ser usados com Pacotes de solução do Dataverse por causa da incompatibilidade do pacote.
Aplicativos de tela que tenham dependências do Dataverse, como fluxos, referências de conexão etc., não são compatíveis com pacotes de aplicativos de tela. Para recursos do ALM em ambientes do Microsoft Power Platform, use Microsoft Dataverse e soluções em vez da exportação e importação do pacote de aplicativo de tela. Mais informações: Visão geral do ALM
Uma chave de instrumentação de insights de aplicativo pode estar presente em aplicativos de tela importados. Inspecione a chave de instrumentação após importar um aplicativo para garantir que ela corresponda ao recurso de insights de aplicativo desejado.

Recursos inclusos no pacote

Um aplicativo pode consumir diferentes recursos. Por exemplo, a maioria dos aplicativos usa conexões. Outros aplicativos podem usar o Power Automate, ter conectores personalizados ou se conectar usando gateways para recursos locais. Alguns aplicativos também podem usar personalizações do Dataverse.

A tabela a seguir explica os diferentes tipos de recursos, capacidade de suporte e opções de importação.

Tipo de recurso	Suportado	Opções de importação
Aplicativo	Sim, para aplicativos de tela	Há duas opções para importar um aplicativo em um ambiente: Criar novo: o aplicativo será criado como um aplicativo novo no ambiente em que o pacote será importado. Atualizar: o aplicativo já existe no ambiente e será atualizado quando o pacote for importado.
Power Automate	Sim	Há duas opções para importar um fluxo em um ambiente: Criar novo: o fluxo será criado como um fluxo novo no ambiente em que o pacote será importado. Atualizar: o fluxo já existe no ambiente e será atualizado quando o pacote for importado. Observação: todos os recursos dos quais o fluxo depende também serão incluídos no pacote do aplicativo que é exportado e precisarão ser configurados quando o pacote for importado. Você também pode exportar e importar fluxos usando soluções. Mais informações: Soluções do Power Automate
Conectores personalizados	Não	Não há suporte para a exportação de um conector personalizado. Você precisará recriar o conector personalizado no ambiente de destino.
Conexões	Não	Não há suporte para a exportação de uma conexão. Você precisará recriar conexões no ambiente de destino.
Personalizações do Dataverse	Não	Não há suporte para a exportação de personalizações do Dataverse como parte de um pacote de aplicativo de tela. Você precisará usar as soluções do Dataverse. Mais informações: Soluções do Dataverse
Gateways	Não	Você não pode exportar ou importar gateways. Você precisará recriar gateways no ambiente de destino.

Permissões necessárias para exportar um pacote de aplicativo de tela

Apenas o Proprietário ou Co-proprietário de um aplicativo pode exportar um pacote de aplicativo de tela. Para importar um aplicativo, a permissão de Criador de ambiente é necessária no ambiente de destino.

Exportar um pacote de aplicativo de tela

Para exportar um pacote de aplicativo de tela, selecione seu aplicativo e, em seguida, selecione Pacote de exportação.

GIF de demonstração do pacote de exportação com exemplo de passo a passo de exportação.

Você pode alterar a Ação de importação padrão para cada recurso que seu aplicativo de tela usa. A ação padrão para recursos em um pacote de aplicativo de tela, incluindo o aplicativo, é Atualizar. Você pode escolher Criar como novo durante a importação, para criar o recurso durante a importação em vez de atualizar o recurso existente. No entanto, a ação de importação selecionada se tornará a ação padrão durante a importação do aplicativo.

Importante

Você só pode importar o pacote exportado. Não há suporte às alterações no arquivo do pacote exportado.

Para exportar um pacote de aplicativo de tela

Entrar no Power Apps.
Selecione Aplicativos no painel esquerdo.
Selecione o aplicativo que você deseja exportar.
Selecione Pacote de exportação.
Insira o Nome e a Descrição do pacote. Você também pode alterar o nome do Ambiente, se necessário.
Selecione Atualizar para escolher a ação de importação para o recurso de pacote do aplicativo.
Selecione Criar como novo se o aplicativo deve ser criado durante a importação ou Atualizar para atualizar um aplicativo existente.

Observação

O texto de ação Importar configuração muda de acordo com sua nova seleção.
Repita a etapa anterior para cada recurso adicional no pacote do aplicativo.
(Opcional) Selecionar (ícone de comentário) para inserir um comentário para cada recurso.
Selecione Exportar para exportar o pacote.

O pacote é baixado para a pasta de downloads padrão do seu navegador.

Importar um pacote de aplicativo de tela

Para importar um pacote de aplicativo de tela, selecione Importar aplicativo de tela. Certifique-se de selecionar as ações corretas para cada recurso de pacote de aplicativo — por exemplo, criar uma instância de um aplicativo ou fluxo. Você também pode ler informações adicionais em comentários que foram inseridos enquanto o pacote do aplicativo estava sendo exportado.

GIF de demonstração do pacote de importação com exemplo de passo a passo de exportação.

Se você estiver atualizando um aplicativo ou recurso existente, certifique-se de publicar o aplicativo para que os usuários possam ver as alterações.

Dica

Você pode confirmar rapidamente as seleções antes de importar um pacote de aplicativo, visualizando as alterações do ícone para cada tipo de recurso.

Ícone	Descrição
	Criar como novo: um novo recurso será criado.
	Ação de importação alterada: a ação de importação para o recurso foi modificada.
	Ação necessária: você deve selecionar uma ação de importação antes que o pacote do aplicativo possa ser importado.

Para importar um pacote de aplicativo de tela

Entrar no Power Apps.
Selecione Aplicativos no painel esquerdo.
Selecione Importar aplicativo de tela.
Selecione Carregar e selecione o arquivo de pacote do aplicativo que deseja importar.
Selecione a ação Configuração de Importação ou para um recurso.
- Se você selecionar Criar como novo, poderá alterar o nome do recurso.
- Se você selecionar Atualizar, selecione um aplicativo que deseja atualizar durante a importação.
Repita a etapa anterior para cada recurso adicional no pacote do aplicativo.
(Opcional) Se o pacote do aplicativo contiver referências a conexões, você pode escolher a conexão na lista de conexões disponíveis.

Selecione Selecionar durante a importação para escolher a conexão apropriada.

Observação

Se nenhuma conexão estiver disponível ou se a conexão desejada não estiver listada, selecione Criar novo para criar uma conexão em uma nova guia do navegador. Certifique-se de criar a conexão para o tipo de recurso correto. Depois de criar a conexão, volte para a guia do navegador do aplicativo de importação e selecione Atualizar lista para refletir e escolher a conexão recém-criada.
(Opcional) Se comentários foram inseridos para um recurso durante a exportação do pacote do aplicativo, o ícone de comentário aparecerá preenchido e o texto Comentar sim aparecerá quando você passar o mouse sobre ele. Selecione o comentário para exibi-lo.
Selecione Importar para importar o pacote do aplicativo.

Importante

Se você optar por Atualizar um aplicativo existente, as novas alterações serão salvas como um rascunho do aplicativo. Você precisará publicar o aplicativo para que os usuários possam ver as mudanças.