Criar a correção do Package Support Framework

Artigo
12/12/2023

Se não houver nenhuma correção de tempo de execução para o problema, você poderá criar uma nova correção de tempo de execução gravando funções de substituição e incluindo quaisquer dados de configuração que façam sentido. Vejamos cada parte.

Funções de substituição

Primeiro, identifique 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.

Declare a FIXUP_DEFINE_EXPORTS macro e, em seguida, adicione uma instrução include para o fixup_framework.h na parte superior de cada . CPP onde você pretende adicionar as funções de sua correção de tempo de execução.

#define FIXUP_DEFINE_EXPORTS
#include <fixup_framework.h>

Importante

Certifique-se de que a FIXUP_DEFINE_EXPORTS macro aparece antes da instrução include.

Crie uma função que tenha a mesma assinatura da função cujo comportamento você deseja modificar. Aqui está uma função de exemplo que substitui a MessageBoxW função.

auto MessageBoxWImpl = &::MessageBoxW;
int WINAPI MessageBoxWFixup(
    _In_opt_ HWND hwnd,
    _In_opt_ LPCWSTR,
    _In_opt_ LPCWSTR caption,
    _In_ UINT type)
{
    return MessageBoxWImpl(hwnd, L"SUCCESS: This worked", caption, type);
}

DECLARE_FIXUP(MessageBoxWImpl, MessageBoxWFixup);

A chamada para mapeia a MessageBoxW função para DECLARE_FIXUP sua nova função de substituição. Quando o aplicativo tenta chamar a função, ele chamará a MessageBoxW função de substituição.

Proteger contra chamadas recursivas para funções em correções de tempo de execução

O reentrancy_guard tipo pode ser adicionado às suas funções para protegê-las contra chamadas de função recursivas.

Por exemplo, você pode produzir uma função de substituição para a CreateFile função. Sua implementação pode chamar a função, mas a implementação da CopyFile função pode chamar a CopyFileCreateFile função. Isso pode levar a um ciclo recursivo infinito de chamadas para a CreateFile função.

Para obter mais informações sobre reentrancy_guard consulte authoring.md

Dados de configuração

Se você quiser adicionar dados de configuração à sua correção de tempo de execução, considere adicioná-los ao config.json. Dessa forma, você pode usar o FixupQueryCurrentDllConfig para analisar facilmente esses dados. Este exemplo analisa um valor booleano e de cadeia de caracteres desse arquivo de configuração.

if (auto configRoot = ::FixupQueryCurrentDllConfig())
{
    auto& config = configRoot->as_object();

    if (auto enabledValue = config.try_get("enabled"))
    {
        g_enabled = enabledValue->as_boolean().get();
    }

    if (auto logPathValue = config.try_get("logPath"))
    {
        g_logPath = logPathValue->as_string().wstring();
    }
}

Corrigir metadados

Cada correção e o aplicativo PSF Launcher têm um arquivo de metadados XML que contém as seguintes informações:

Versão: A versão do PSF está em MAJOR. MENOR. Formato PATCH de acordo com Sem Versão 2.
Plataforma Windows mínima: A versão mínima do Windows necessária para o fixup ou PSF Launcher.
Descrição: Uma breve descrição da correção.
WhenToUse: Heurística sobre quando você deve aplicar a correção.

Para obter um exemplo, consulte o arquivo de metadados FileRedirectionFixupMetadata.xml para a correção de redirecionamento. O esquema de metadados está disponível aqui.