NSIS脚本学习：预定义宏（Predefines）

预定义宏（Predefine）即无需用户赋值就可直接使用的宏

NSIS脚本中的预定义宏有如下六种：

1、${__FILE__}：Current script name.

输出当前脚本的名称（如Galatea.nsi）

2、${__LINE__}：Current line number.

输出当前代码在NSIS脚本中的行数

3、${__DATE__}：Date when the script started compiling according to the current locale.

输出当前日期（如2016/4/1）

4、${__TIME__}：Time when the script started compiling according to the current locale.

输出当前时间（如22:47:10）

5、${__TIMESTAMP__}：Date & time of the last modification to the script file according to the current locale.

输出当前日期和时间（如2016年4月1日 22:47:09），注意这里面有两个参数，因此如果直接使用

!echo ${__TIMESTAMP__}

在编译时就会报错：

!echo expects 1 parameters, got 2.
Usage: !echo message
Error in script "E:\NSIS_Test\galatea.nsi" on line 14 -- aborting creation process

因此应换一种写法来打印时间戳

!echo "${__TIMESTAMP__}"

6、${NSIS_VERSION}：NSIS version used to build the script.

当前NSIS编译器版本号（如v2.46）

用一段代码演示一下这六个预定义宏的功能：

!define DEBUG_PATH "E:\NSIS_Test\TmpProgram"
!define OUTPUT_PATH "E:\NSIS_Test\Output"

Name "NSIS_Predefines_Test"
Caption "NSIS_Predefines_Test"

Function .onInit
  ;TODO - 这里输入要测试的代码
  !echo '------Predefines(START)------'
  !echo ${__FILE__}
  !echo ${__LINE__}
  !echo ${__DATE__}
  !echo ${__TIME__}
  !echo "${__TIMESTAMP__}"
  !echo ${NSIS_VERSION}
  !echo '------Predefines(FINISH)------'
FunctionEnd

OutFile "Galatea.exe"
Section "My Program"
  SetOutPath ${OUTPUT_PATH}
  File /r "${DEBUG_PATH}\*.*"
SectionEnd

这段代码编译时命令行的输出为：

Command line: 
"D:\NSIS\makensis.exe"  /NOTIFYHWND 67520  "E:\NSIS_Test\galatea.nsi"

MakeNSIS v2.46 - Copyright 1995-2009 Contributors
See the file COPYING for license details.
Credits can be found in the Users Manual.

Processing config: 
Processing plugin dlls: "D:\NSIS\Plugins\*.dll"
（ ... 此处省略若干行 ... ）

!define: "MUI_INSERT_NSISCONF"=""

Changing directory to: "E:\NSIS_Test"

Processing script file: "E:\NSIS_Test\galatea.nsi"
!define: "DEBUG_PATH"="E:\NSIS_Test\TmpProgram"
!define: "OUTPUT_PATH"="E:\NSIS_Test\Output"
Name: "NSIS_Predefines_Test"
Caption: "NSIS_Predefines_Test"
Function: ".onInit"
（ ↓↓↓ 最重要的输出看这里 ↓↓↓ ）
------Predefines(START)------ (E:\NSIS_Test\galatea.nsi:9)
galatea.nsi (E:\NSIS_Test\galatea.nsi:10)
11 (E:\NSIS_Test\galatea.nsi:11)
2016/4/1 (E:\NSIS_Test\galatea.nsi:12)
23:08:34 (E:\NSIS_Test\galatea.nsi:13)
2016年4月1日 23:08:34 (E:\NSIS_Test\galatea.nsi:14)
v2.46 (E:\NSIS_Test\galatea.nsi:15)
------Predefines(FINISH)------ (E:\NSIS_Test\galatea.nsi:16)
（ ↑↑↑ 最重要的输出看这里 ↑↑↑ ）
FunctionEnd
OutFile: "Galatea.exe"
Section: "My Program"
SetOutPath: "E:\NSIS_Test\Output"
File: "MyProgram.exe" [compress] 0 bytes
File: "ReadMe.txt" [compress] 6 bytes
File: Returning to: "E:\NSIS_Test\TmpProgram"
SectionEnd

Processed 1 file, writing output:
Processing pages... Done!
Removing unused resources... Done!
Generating language tables... Done!

Output: "E:\NSIS_Test\Galatea.exe"
Install: 2 pages (128 bytes), 1 section (1048 bytes), 7 instructions (196 bytes), 34 strings (602 bytes), 1 language table (198 bytes).

Using zlib compression.

EXE header size:               33280 / 35840 bytes
Install code:                    689 / 2500 bytes
Install data:                     14 / 14 bytes
CRC (0xDB1FEB17):                  4 / 4 bytes

Total size:                    33987 / 38358 bytes (88.6%)

另外，还有五个与范围有关的预定义宏（Scope Predefines）：

1、${__GLOBAL__}：Defined in the global scope.

全局定义的宏，可用预处理命令 !ifdef、!ifndef、!endif 判断是否定义

2、${__SECTION__}：Defined as the section name, without any prefixes, in section scope.

如当前语句在一个Section块中，打印Section块名，可用于与其他字符串比较

3、${__FUNCTION__}：Defined as the function name, without any prefixes, in function scope.

如当前语句在一个Function块中，打印Function块名，可用于与其他字符串比较

4、${__PAGEEX__}：Defined as the page type in PageEx scope.

如当前语句在一个PageEx块中，打印PageEx块名，可用于与其他字符串比较

5、${__UNINSTALL__}：Defined in section, function or PageEx scopes of the uninstaller.

在卸载程序的Section、Function、RageEx中定义的宏，可用预处理命令 !ifdef、!ifndef、!endif 判断是否定义

注：本文写作过程中参考了NSIS官方使用手册 NSIS.chm

END

来源：oschina

链接：https://my.oschina.net/u/1425762/blog/651647

标签

nsis

Predefines

scope