Visão geral da estrutura de suporte a pacotes

O PSF (Package Support Framework) é um kit de código aberto que ajuda a aplicar correções ao aplicativo de área de trabalho 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 melhores práticas do ambiente moderno do runtime.

Estes estão alguns exemplos comuns em que o Package Support Framework pode ser útil:

• Quando iniciado, seu aplicativo não consegue localizar algumas DLLs. Talvez você precise definir seu diretório de trabalho atual. Você pode descobrir o diretório de trabalho atual necessário no atalho original, antes da conversão em MSIX.
• O aplicativo faz gravações na pasta de instalação. Você normalmente percebe isso por causa de erros de "Acesso Negado" no Process Monitor.
• Ao ser iniciado, seu aplicativo precisa passar parâmetros ao executável. Você pode saber mais sobre como o PSF pode ajudar acessando aqui e saber mais sobre as configurações disponíveis aqui.

Essa estrutura é software livre, leve e você pode usá-la para solucionar problemas do aplicativo rapidamente. Ela também oferece a oportunidade de consultar a comunidade em todo o mundo e aproveitar os investimentos de outras pessoas.

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

Introdução ao uso do Package Support Framework

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

1. A estrutura de suporte ao pacote
2. Obtenha o Process Monitor para identificar problemas

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

Caso não encontre uma correção de runtime que resolva o problema, crie uma. Para fazer isso, você identificará quais chamadas de função falham quando seu aplicativo é executado em um contêiner MSIX. Em seguida, você poderá criar funções de substituição que você deseja que sejam chamadas pelo gerenciador de runtime. Isso oferecerá uma oportunidade de substituir a implementação de uma função por um comportamento que esteja de acordo com as regras do ambiente moderno do runtime.

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

Também é possível usar o Package Support Framework para executar scripts a fim de personalizar dinamicamente um aplicativo para o ambiente do usuário. Para obter mais informações, consulte este artigo.

Limitações

O Package Support Framework não é compatível com as substituições do registro. Ele foi criado para resolver problemas de tempo de execução.

Dados e telemetria

O Package Support Framework inclui a telemetria que coleta dados de uso e os envia para a Microsoft para ajudar a melhorar nossos produtos e serviços. Leia a política de privacidade da Microsoft para saber mais. No entanto, os dados serão coletados somente quando as duas condições a seguir forem atendidas:

• Os binários do Package Support Framework são usados 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.