Макросы в схеме манифеста пакета
Макрос — это динамически вычисляемое манифестное значение. Макросы можно использовать в значениях некоторых атрибутов в схеме манифеста пакета. Примерами таких атрибутов являются uap11:CurrentDirectoryPath и uap11:Parameters.
Синтаксис
Макрос выражается в форме $(macro_name).
- Этот синтаксис расширяется до значения в столбце Expands to ниже.
- Для одного
$символа в значении атрибута используйте escape-последовательность$$.
| Имени макроса | Разворачивается до |
|---|---|
| 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