NSIS用户手册

出处:http://wenku.baidu.com/link?url=aWSWSEkhkdEBMi6OolvkZ7UYM0oi7B-9I50ufUiOwhGKkEC1NmbFE57BWoDAL5CmDNP0XvNV-Rr5OfERAqo-4zs76nPrHBb31Z3761-4k5e

 

NSIS（Nullsoft Scriptable Install System)是一个供程序员使用的、建立Windows installers的工具。它的发布遵守开源许可，且完全免费使用。

 

脚本文件

    要利用NSIS制作安装包，你必须编写NSIS脚本，NSIS脚本是一些简单语法规则的文本。

    NSIS脚本的每一行都是命令。若命令很长，可以用'/'来换行写，类似VC里面写很长的字符串。

例如：

Messagebox MB_OK|MB_ICONINFORMATION /

"This is a sample that shows how to use line breaks for larger commands in NSIS scripts"

如果要在字符串里面加入双引号，可以这样写：$/"，或者用单引号代替。

 

    脚本文件的扩展名是nsi，脚本头文件是nsh。可以分成多个头文件来组织脚本文件，用下面的方法来包含头文件：

!include Sections.nsh

 

脚本结构

    脚本文件一般包含“Install Attributes”、“Pages”、“Sections”、“Functions”这几部分。

    Install Attributes，定义了一些常量，如安装文件名、安装路径等。

    Pages，定义授权书页，目录选择页，组件选择页，反安装页等等。

    Sections，把安装进程分成多个阶段来定义，方便操作。

    Functions，定义一些函数，在安装时进行用户交互。

脚本格式

 

Commands

 命令行是这样的形式 'command [parameters]'

 File "myfile"

 

Comments

 以;或#开始的行被认为是注释行，你可以在命令行后放注释，也可以使用c风格的注释。

 ; Comment

 # Comment

 /*

  Comment

  Comment

 */

 File "myfile" ; Comment

如果你需要以;或#作为参数，你应把他们放在引号里面。

 

Plug-ins

 插件调用的方法：'plugin::command[parameters]'

 nsExec::Exec "myfile"

 

Numbers

 作为参数的数值，可以用整数、16进制（以0x开头）、8进制（以0开头）

 颜色值用16位进制表示，但不要0x开头。

 IntCmp 1 0x1

 SetCtrlColors $HWND CCCCCC

 

Strings

 若表示一个带有空格的字符串，应该使用引号

 MessageBox MB_OK "Hi there!"

 Quotes only have the property of containing a parameter if they begin the parameter.引号可以是单引号，双引号，或者后单引号（波浪号下面的）。

 你可以用$/来表明该引号是参数的一部分

 MessageBox MB_OK "I'll be happy"

 MessageBox MB_OK 'And he said to me "Hi there"'

 MessageBox MB_OK `And he said to me "I'll be fucked"`

 MessageBox MB_OK "$/"A quote from a wise man$/" said the wise man"

 在字符串中，$/r,$/n,$/t分别表示回车，换行，制表。

 

Variables

 变量必须以$开头，变量必须先声明才可以使用，且大小写敏感。

 Var MYVAR

 StrCpy $MYVAR "myvalue"

 

Long commands

 若命令行较长需要多行写，你应该使用反斜杠进行换行（类似c++）。

 CreateShortCut "$SMPROGRAMES/NSIS/ZIP2EXE project workspace.lnk" /

  $INSTDIR/source/zip2exe/zip2exe.dsw"

 MessageBox MB_YESNO|MB_ICONQUESTION /

  "Do you want to remove all files in the folder? /

  (If you have anything you created that you want /

  to keep, click No)" /

  IDNO NoRemoveLabel

 

Configuration file

 若"makensis.exe"的目录下有"nsisconf.nsh"这样的文件，则该文件会被默认包含在任何脚本文件中，除非/NOCONFIG编译开关被指定。

变量

        所有的变量都是全局的，可在任何段落和函数中使用。

用户变量

        变量声明用Var命令，变量名可以用大小写字母和数字组合，且大小写敏感。

内置可读写变量

        $0, $1, $2, $3, $4, $5, $6, $7, $8, $9, $R0, $R1, $R2, $R3, $R4, $R5, $R6, $R7, $R8, $R9

        这些变量可以当作用户变量使用，但通常用于公用函数和宏定义，你不用声明它们，同样在使用时也不会产生名字冲突。简易你在使用它们时，用栈保存和恢复它们的初始值,这些变量在插件中也是有效的，所以可用于插件交换数据。

        $INSTDIR

        安装目录（可用StrCpy,ReadRegStr,ReadINIStr等函数修改其值，例如，可在.onInit函数中验证安装目录）。

        需注意的是，在卸载代码中，$INSTDIR是卸载程序的目录，而不是在安装程序中指定的$INSTDIR的目录。例如，把卸载程序放在$WINDIR且用户无法移动它到其他位置，在卸载程序中，$INSTDIR和$WINDIR的值相同。若你把卸载放到其他位置，你应该在注册表中（或其他方式）保存安装程序的$INSTDIR，一边在卸载时读取。

        $OUTDIR

        当前输出目录（用SetOutPath设定，用StrCpy,ReadRegStr,ReadINIStr读取）。

        $CMDLINE

        安装程序的命令行。格式如下：

        ※ "full/path to/installer.exe" PARAMETER PARAMETER PARAMETER

        ※ installer.exe PARAMETER PARAMETER PARAMETER

        ※ 要解析PARAMETER，请用附录部分的GetParameters。如果/D=命令开关在命令中指定，它也不会在$CMDLINE中出现。

        $LANGUAGE

        当前使用的语言标识。例如英语是1033，你可在.onInit中改变该变量的值。

常量

        常量也可在InstallDir属性中使用。

        需注意的是，一些新添加的常量不是每个操作系统都拥有，如$CDBURN_AREA只有Windows XP及以上系统才有，而Windows 98没有。

        $PROGRAMFILES

        程序文件默认目录

        $COMMONFILES

        公共文件目录

        $DESKTOP

        Windows桌面目录

        $EXEDIR

        安装文件目录

        ${NSISDIR}

        NSIS安装目录。用于调用NSIS自带的图标、界面元素等资源。

        $WINDIR

        Windows目录。

        $SYSDIR

        Windows system目录

        $TEMP

        系统临时文件目录

        $STARTMENU

        开始菜单位置。

        $SMPROGRAMS

        开始菜单程序目录。

        $SMSTARTUP

        开始菜单启动目录

        $QUICKLAUNCH

        快速启动目录

        $DOCUMENTS

        文档目录。

        $SENDTO

        发送到目录

        $RECENT

        最近的文档目录。

        $FAVORITES

        $MUSIC

        $PICTURES

        $VIDEOS

        $NETHOOD

        $FONTS

        $TEMPLATES

        $APPDATA

        $LOCALAPPDATA

        $PRINTHOOD

        $INTERNET_CACHE

        $COOKIES

        $HISTORY

        $PROFILE

        $ADMINTOOLS

        $RESOURCES

        $RESOURCES_LOCALIZED

        $CDBURN_AREA

        $HWNDPARENT

        父窗口句柄

        $PLUGINSDIR

在字符串中使用常量

        $$      用来代替$

        $/r     表示回车

        $/n     表示换行

        $/t     表示制表