包清单架构中的宏

宏是动态计算的清单值。 可以在包清单架构中某些属性的值中使用宏。 此类属性的示例包括 uap11：CurrentDirectoryPath 和 uap11：Parameters。

语法

宏以 的形式 $(macro_name)表示。

• 该语法将扩展为下面的“ 扩展到 ”列中的值。
• 对于属性值中的单个 $ 字符，请使用转义序列 $$。

宏名称	扩展为
env：environmentvariable	GetEnvironmentVariable (environmentvariable)
package.currentDirectoryPath	GetCurrentDirectory ()
package.effectiveExternalPath	GetPackagePathByFullName2 (...PackagePathType_EffectiveExternal...)
package.effectivePath	GetPackagePathByFullName2 (...PackagePathType_Effective...)
package.installedPath	GetPackagePathByFullName2 (...PackagePathType_Install...)
package.machineExternalPath	GetPackagePathByFullName2 (...PackagePathType_MachineExternal...)
package.mutablePath	GetPackagePathByFullName2 (...PackagePathType_Mutable...)
package.userExternalPath	GetPackagePathByFullName2 (...PackagePathType_UserExternal...)
system.path	GetSystemDirectory ()
windows.path	GetWindowsDirectory ()

示例方案

在此假设的示例方案中，我创建了一个打包的应用， (用 Python 编写的) 名为 MyPackagedPythonApp.py。 若要运行它，我需要在清单中提供以下内容：

<Application...Executable="python.exe" uap10:TrustLevel="mediumIL" uap10:RuntimeBehavior="packagedClassicApp" uap10:Parameters="-m MyPackagedPythonApp.py --default=1">

该配置会导致此命令执行：

"C:\Program Files\WindowsApps\MyApp_1.2.3.4_x64__1234567890abc\python.exe" -m MyPackagedPythonApp.py --default=1

但如果当前文件夹不碰巧 C:\Program Files\WindowsApps\MyApp_1.2.3.4_x64__1234567890abc为 ，该命令将失败。

因此，我可能会尝试按绝对文件名指定我的 .py 文件，如下所示：

"C:\Program Files\WindowsApps\MyApp_1.2.3.4_x64__1234567890abc\python.exe" -m "C:\Program Files\WindowsApps\MyApp_1.2.3.4_x64__1234567890abc\MyPackagedPythonApp.py" --default=1

但是，作为开发人员，我 不知道该包 是否会安装到该路径。 也许用户的驱动器已满，因此包最终位于驱动器 Q 上。每次我更新包版本时，路径都会更改。 因此，这就是宏来拯救的地方。

我使用路径 (的宏指定文件 .py ，该路径将在运行时) 到包的位置进行评估，如下所示：

<Application...Executable="python.exe" uap10:TrustLevel="mediumIL" uap10:RuntimeBehavior="packagedClassicApp" uap10:Parameters="-m $(package.effectivePath)\MyPackagedPythonApp.py --defcon=1">

现在，在运行时，命令将按预期执行。 但 Windows 在运行时) 再次动态填充正确的路径 (，如下所示：

"C:\Program Files\WindowsApps\MyApp_1.2.3.4_x64__1234567890abc\python.exe" -m "C:\Program Files\WindowsApps\MyApp_1.2.3.4_x64__1234567890abc\MyPackagedPythonApp.py" --default=1