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     表示制表

猜你喜欢

转载自yiran2014.iteye.com/blog/2034409