Visão geral da estrutura de suporte a pacotes

O Package Support Framework (PSF) é um kit de código aberto que ajuda você a aplicar correções ao seu aplicativo de desktop existente quando você não tem acesso ao código-fonte, para que ele possa ser executado em um contêiner MSIX. O Package Support Framework ajuda seu aplicativo a seguir as práticas recomendadas do ambiente de tempo de execução moderno.

Aqui estão alguns exemplos comuns onde você pode achar útil o Package Support Framework:

• Seu aplicativo não consegue encontrar algumas DLLs quando iniciado. Talvez seja necessário definir seu diretório de trabalho atual. Você pode aprender sobre o diretório de trabalho atual necessário no atalho original antes de converter para MSIX.
• O aplicativo grava na pasta de instalação. Normalmente, você verá isso por erros de "Acesso negado" no Process Monitor.
• Seu aplicativo precisa passar parâmetros para o executável na inicialização. Você pode saber mais como o PSF pode ajudar acessando aqui e saiba mais sobre as configurações disponíveis aqui.

Essa estrutura é de código aberto, leve e você pode usá-la para resolver problemas de aplicativos rapidamente. Também lhe dá a oportunidade de consultar a comunidade em todo o mundo e de construir em cima dos investimentos de outros.

Para um guia passo-a-passo, consulte o nosso guia de introdução.

Introdução ao uso da Estrutura de Suporte a Pacotes

Aqui estão as ferramentas que você vai precisar:

1. O Framework de Suporte ao Pacote
2. Obtenha o Process Monitor para identificar problemas

Você pode verificar nosso GitHub para todas as correções disponíveis. Se encontrar um, pode aplicá-lo ao seu pacote. Nosso guia passo a passo mostra como fazer isso. Ele também mostrará como usar o depurador do Visual Studio para percorrer seu aplicativo e verificar se a correção está funcionando e se resolveu o problema de compatibilidade.

Se não conseguir encontrar uma correção de tempo de execução que resolva o problema, pode criar uma. Para fazer isso, você identificará quais chamadas de função falham quando seu aplicativo é executado em um contêiner MSIX. Em seguida, podes criar funções de substituição que gostasses que o gestor de execução chamasse. Isso lhe dá a oportunidade de substituir a implementação de uma função por um comportamento que esteja em conformidade com as regras do ambiente de tempo de execução moderno.

Para criar o Package Support Framework aproveita a tecnologia Detours que é uma estrutura de código aberto desenvolvida pela Microsoft Research (MSR) e ajuda com o redirecionamento e conexão de API.

Você também pode usar o Package Support Framework para executar scripts para personalizar um aplicativo para o ambiente do usuário dinamicamente. Para mais informações, consulte este artigo.

Limitações

O Package Support Framework não suporta substituições de registro. Ele foi projetado para resolver problemas de tempo de execução.

Dados e telemetria

A Estrutura de Suporte a Pacotes inclui telemetria que coleta dados de uso e os envia à Microsoft para ajudar a melhorar nossos produtos e serviços. Leia a declaração de privacidade da Microsoft para saber mais. No entanto, os dados serão recolhidos apenas quando forem satisfeitas ambas as seguintes condições:

• Os binários do Package Support Framework são usados a partir do pacote NuGet em um computador com Windows 10.
• O usuário habilitou a coleta de dados no computador.

O pacote NuGet contém binários assinados e coletará dados de uso do computador. A telemetria não é coletada quando os binários são criados localmente clonando o repositório ou baixando os binários diretamente.