Visão geral da estrutura de suporte do pacote

O PSF (Package Support Framework) é um kit código aberto que ajuda você a aplicar correções ao seu 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. Saiba mais sobre como o PSF pode ajudar aqui e saiba 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, confira nosso guia de início.

Introdução ao uso do Package Support Framework

Aqui estão as ferramentas necessárias:

  1. A estrutura de suporte do pacote
  2. Obter o Monitor de Processo para identificar problemas

Você pode verificar nosso GitHub para ver 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.

Se você não encontrar uma correção de runtime que resolva o problema, poderá criar 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 a Estrutura de Suporte a Pacotes, o aproveita a tecnologia Detours, que é uma estrutura código aberto desenvolvida pela MSR (Microsoft Research) e ajuda com o redirecionamento e a conexã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.