Cómo corregir errores de permisos de escritura del sistema de archivos del marco de compatibilidad de paquetes

Artículo
01/19/2023
Tiempo de lectura: 7 minutos

En este artículo se describe cómo usar el marco de compatibilidad de paquetes (PSF) para resolver un error de permiso de escritura del sistema de archivos.

Las aplicaciones de Windows redirigen directorios específicos relacionados con la aplicación a la C:\Program Files\WindowsApps carpeta . Si la aplicación intenta escribir en el contenedor de aplicaciones de Windows, se desencadena un error y se produce un error en la escritura. Puedes realizar mejoras en el paquete de la aplicación de Windows para resolver este problema.

Investigación

En primer lugar, identifique el error y las rutas de acceso del directorio que solicita la aplicación.

Captura del error de la aplicación de Windows

El filtrado de los resultados es opcional, pero facilita la visualización de errores relacionados con la aplicación. Para filtrar los resultados, cree dos reglas de filtro. El primer filtro incluye el nombre del proceso de aplicación y el segundo filtro incluye los resultados que no se han realizado correctamente.

Descargue y extraiga el Monitor de procesos de SysInternals en el directorio C:\PSF\ProcessMonitor .
Abra el Explorador de Windows y vaya a la carpeta SysInternals ProcessMonitor extraída.
Seleccione el archivo procmon.exe SysInternals Process Monitor para iniciar la aplicación.
Si UAC lo solicita, seleccione Sí.
En la ventana Filtro del Monitor de procesos, seleccione Nombre del proceso en el menú desplegable del primer campo.
Compruebe que aparece en el campo siguiente.
En el campo siguiente, escriba el nombre del proceso de la aplicación, por ejemplo ,PSFSample.exe.
Seleccione Agregar.
En la ventana Filtro del Monitor de procesos, seleccione Resultado en el menú desplegable del primer campo.
En el campo siguiente, select no está en el menú desplegable.
En el campo de texto, escriba SUCCESS.
Seleccione Agregar y luego Aceptar.
Inicie la aplicación de Windows, desencadene el error y cierre la aplicación de Windows.

Revisión de los registros de errores de la aplicación de Windows

Después de capturar los procesos de la aplicación de Windows, investigue los resultados para determinar si el error está relacionado con el directorio de trabajo.

Revise los resultados del error de SysInternals Process Monitor. Si los resultados incluyen Acceso denegado, con un detalle de escritura genérica, para la aplicación destinada a C:\Archivos de programa\WindowsApps\...\, ha identificado un error de permiso de escritura relacionado con el directorio de trabajo.

Muestra el mensaje de error testigo en el Monitor de procesos sysInternals para que no se escriba en el directorio.

Si identifica este error, aplique la siguiente corrección de PSF a la aplicación.

Resolución

Para resolver el problema de que la aplicación de Windows no puede escribir en el contenedor de aplicaciones de Windows, siga estos pasos:

Extraiga el contenido de la aplicación de Windows en un directorio de almacenamiento provisional local.
Cree un archivo config.json e inserte los archivos de corrección de PSF en el directorio de la aplicación de Windows almacenada provisionalmente.
Configure el iniciador de aplicaciones para que apunte al iniciador de PSF y configure el archivo config.json de PSF para redirigir el iniciador de PSF, especificando el directorio de trabajo.
Actualice el archivo AppxManifest de la aplicación de Windows.
Vuelva a empaquetar y firme la aplicación de Windows.

Descarga e instalación de las herramientas necesarias

Este proceso requiere las siguientes herramientas:

Herramienta cliente de NuGet
Marco de compatibilidad de paquete (PSF)
Windows 10 Software Development Toolkit (SDK de Win 10), versión más reciente
Monitor de procesos de SysInternals

Para descargar e instalar NuGet y PSF:

Descargue la versión más reciente que no sea de versión preliminar de la herramienta de cliente nuGet y guarde nuget.exe en C:\PSF\nuget.
Descargue e instale el marco de compatibilidad de paquetes con NuGet mediante la ejecución del siguiente comando desde una ventana administrativa de PowerShell:
```
Set-Location "C:\PSF"
.\nuget\nuget.exe install Microsoft.PackageSupportFramework
```

Para descargar e instalar el SDK de Windows 10:

Descargue el SDK de Win 10.
Ejecute winsdksetup.exe .
Seleccione Next (Siguiente).
Seleccione solo las tres características siguientes:
- Herramientas de firma de Windows SDK para aplicaciones de escritorio
- Windows SDK para aplicaciones de C++ para UWP
- Localización del SDK de Windwos para aplicaciones para UWP
Seleccione Instalar y, a continuación, seleccione Aceptar.

Almacenar provisionalmente la aplicación de Windows

El almacenamiento provisional de la aplicación de Windows extrae y desempaqueta el contenido de la aplicación en un directorio local. Una vez que la aplicación de Windows esté desempaquetada en la ubicación de almacenamiento provisional, puede insertar archivos de corrección de PSF para corregir cualquier experiencia no deseada.

En una ventana de PowerShell administrativa, establezca las siguientes variables para tener como destino el archivo de aplicación específico y Windows 10 versión del SDK:

$AppPath          = "C:\PSF\SourceApp\PSFSampleApp.msix"         ## Path to the MSIX App Installer
$StagingFolder    = "C:\PSF\Staging\PSFSampleApp"                ## Path to where the MSIX App will be staged
$OSArchitecture   = "x$((gwmi Win32_Processor).AddressWidth)"    ## Operating System Architecture
$Win10SDKVersion  = "10.0.19041.0"                               ## Latest version of the Win10 SDK

Desempaquetar la aplicación de Windows en la carpeta de almacenamiento provisional ejecutando el siguiente cmdlet de PowerShell:

## Sets the directory to the Windows 10 SDK
Set-Location "${env:ProgramFiles(x86)}\Windows Kits\10\Bin\$Win10SDKVersion\$OSArchitecture"

## Unpackages the Windows app to the staging folder
.\makeappx.exe unpack /p "$AppPath" /d "$StagingFolder"

Crear e insertar archivos PSF necesarios

Para corregir la aplicación de Windows, cree un archivo config.json con información sobre el iniciador de aplicaciones de Windows que produce un error. Si hay varios iniciadores de aplicaciones de Windows que experimentan problemas, puede configurar el archivo config.json con varias entradas.

Después de crear el archivo config.json , mueva los archivos de corrección config.json y admita PSF a la raíz del paquete de la aplicación de Windows.

Abra Visual Studio Code u otro editor de texto.
Cree un nuevo archivo denominado config.json en el directorio de almacenamiento provisional de aplicaciones de Windows, C:\PSF\Staging\PSFSampleApp.

Copie el código siguiente en el archivo config.json recién creado.

{
    "applications": [
        {
            "id": "",
            "executable": ""
        }
    ],
    "processes": [
        {
            "executable": "",
            "fixups": [
            {
                "dll": "",
                "config": {
                    "redirectedPaths": {
                        "packageRelative": [
                            {
                                "base": "",
                                "patterns": [
                                    ""
                                ]
                            }
                        ]
                    }
                }
            }
        ]
        }
    ]
}

Abra el archivo AppxManifest.xml en la carpeta de almacenamiento provisional de aplicaciones de Windows. En el ejemplo siguiente se muestra un archivo AppxManifest.xml :

<Applications>
    <Application Id="PSFSAMPLE" Executable="VFS\ProgramFilesX64\PS Sample App\PSFSample.exe" EntryPoint="Windows.FullTrustApplication">
    <uap:VisualElements BackgroundColor="transparent" DisplayName="PSFSample" Square150x150Logo="Assets\StoreLogo.png" Square44x44Logo="Assets\StoreLogo.png" Description="PSFSample">
        <uap:DefaultTile Wide310x150Logo="Assets\StoreLogo.png" Square310x310Logo="Assets\StoreLogo.png" Square71x71Logo="Assets\StoreLogo.png" />
    </uap:VisualElements>
    </Application>
</Applications>

Realice los siguientes cambios en el archivo config.json :
- Establezca el applications.id valor en el mismo valor que en el Applications.Application.ID campo del archivo AppxManifest.xml .
- Establezca el valor para establecer como applications.executable destino la ruta de acceso relativa a la aplicación ubicada en el Applications.Application.Executable campo del archivo AppxManifest.xml .
- Establezca el valor para establecer como applications.workingdirectory destino la ruta de acceso de la carpeta relativa en el Applications.Application.Executable campo del archivo AppxManifest.xml .
- Establezca el process.executable valor como destino del nombre de archivo, sin ruta de acceso y extensión, en el Applications.Application.Executable campo del archivo AppxManifest.xml .
- Establezca el processes.fixups.dll valor para tener como destino la arquitectura específica FileRedirectionFixup.dllde . Si la corrección es para la arquitectura x64, establezca el valor FileRedirectionFixup64.dllen . Si la arquitectura es x86 o es desconocida, establezca el valor en FileRedirectionFixup86.dll.
- Establezca el processes.fixups.config.redirectedPaths.packageRelative.base valor en la ruta de acceso de la carpeta relativa al paquete en el Applications.Application.Executable campo del archivo AppxManifest.xml .
- Establezca el processes.fixups.config.redirectedPaths.packageRelative.patterns valor para que coincida con el tipo de archivo que crea la aplicación. Si usa .*\\.log, el PSF redirige todas las escrituras del archivo de registro en el processes.fixups.config.redirectedPaths.packageRelative.base directorio y los directorios secundarios.

Guarde el archivo config.json actualizado. En el ejemplo siguiente se muestra un archivo config.json actualizado:

{
    "applications": [
        {
        "id": "PSFSample",
        "executable": "VFS/ProgramFilesX64/PS Sample App/PSFSample.exe"
        }
    ],
    "processes": [
        {
            "executable": "PSFSample",
            "fixups": [
                {
                    "dll": "FileRedirectionFixup64.dll",
                    "config": {
                        "redirectedPaths": {
                            "packageRelative": [
                                {
                                    "base": "VFS/ProgramFilesX64/PS Sample App/",
                                    "patterns": [
                                        ".*\\.log"
                                    ]
                                }
                            ]
                        }
                    }
                }
            ]
        }
    ]
}

Copie los siguientes archivos del marco de compatibilidad de paquetes para la arquitectura ejecutable de la aplicación en la raíz de la aplicación de Windows almacenada provisionalmente. Puede encontrar los archivos en .\Microsoft.PackageSupportFramework.\<Version>\bin.

Aplicación (x64)	Aplicación (x86)
PSFLauncher64.exe	PSFLauncher32.exe
PSFRuntime64.dll	PSFRuntime32.dll
PSFRunDll64.exe	PSFRunDll32.exe
FileRedirectionFixup64.dll	FileRedirectionFixup64.dll

Actualizar AppxManifest

Después de crear y actualizar el archivo config.json , actualice el archivo AppxManifest.xml de la aplicación de Windows para cada iniciador de aplicaciones de Windows que haya incluido en config.json. El AppxManifest.xmlApplications ahora debe tener como destino el PSFLauncher.exe asociado a la arquitectura de la aplicación.

Abra AppxManifest.xml en la carpeta de la aplicación MSIX almacenada provisionalmente, C:\PSF\Staging\PSFSampleApp.

Actualice AppxManifest.xml con el código siguiente:

<Package ...>
...
<Applications>
    <Application Id="PSFSample"
                Executable="PSFLauncher32.exe"
                EntryPoint="Windows.FullTrustApplication">
    ...
    </Application>
</Applications>
</Package>

Volver a empaquetar la aplicación

Después de aplicar todas las correcciones, vuelva a empaquetar la aplicación de Windows en un ARCHIVO MSIX y firme con un certificado de firma de código.

Abra una ventana de PowerShell administrativa.

Establezca las siguientes variables:

$AppPath          = "C:\PSF\SourceApp\PSFSampleApp_Updated.msix" ## Path to the MSIX App Installer
$CodeSigningCert  = "C:\PSF\Cert\CodeSigningCertificate.pfx"     ## Path to your code signing certificate
$CodeSigningPass  = "<Password>"                                 ## Password used by the code signing certificate
$StagingFolder    = "C:\PSF\Staging\PSFSampleApp"                ## Path to where the MSIX App will be staged
$OSArchitecture   = "x$((gwmi Win32_Processor).AddressWidth)"    ## Operating System Architecture
$Win10SDKVersion  = "10.0.19041.0"                               ## Latest version of the Win10 SDK

Vuelva a empaquetar la aplicación de Windows desde la carpeta de almacenamiento provisional ejecutando el siguiente cmdlet de PowerShell:

Set-Location "${env:ProgramFiles(x86)}\Windows Kits\10\Bin\$Win10SDKVersion\$OSArchitecture"
.\makeappx.exe pack /p "$AppPath" /d "$StagingFolder"

Para firmar la aplicación de Windows, ejecute el siguiente cmdlet de PowerShell:

Set-Location "${env:ProgramFiles(x86)}\Windows Kits\10\Bin\$Win10SDKVersion\$OSArchitecture"
.\signtool.exe sign /v /fd sha256 /f $CodeSigningCert /p $CodeSigningPass $AppPath