nsis入门精解教程

最新推荐文章于 2023-07-27 14:50:41 发布
最新推荐文章于 2023-07-27 14:50:41 发布
阅读量6k 收藏 10
点赞数 2
分类专栏： 开发环境

nsis入门精解教程

来源：本站整理  发布时间：2009-04-20   
  •                   
  •                   
  •                   
  •                   
  •           
    •   人气：6049

    NSIS (Nullsoft Scriptable Install System)是一个Open Source的Windows系统下安装程序制作程序。它提供了安装、卸载、系统设置、文件解压缩等功能。这如其名字所指出的那样，NSIS是通过它的脚本语言来描述安装程序的行为和逻辑的。NSIS的脚本语言和通常的编程语言有类似的结构和语法，但它是为安装程序这类应用所设计的。NSIS脚本通常以 nsi为扩展名，支持include功能，头文件扩展名为nsh。

    NSIS的主要特点是：

     

    •   开销小，一个完整功能的安装程序仅需要34k的额外开销。
    •   支持大多数Windows平台，包括：Windows 9.x，Windows NT, Windows 2000, Windows XP, Windows 2003
    •   支持三大压缩算法: Zlig, BZips, LZMA
    •   支持脚本
    •   支持多语言
    •   支持安装界面定制
    •   提供可扩展的插件接口
    •   支持网络安装、补丁
    •   支持无人值守的安装模式
    •   此外，NSIS的license允许任何用途免费使用。

    与时(fortime.net)

    开发一个NSIS的安装程序通常有以下几步：

     

    1. 确定安装的功能和界面元素
    2. 编写NSIS脚本
    3. 使用NSIS提供的makensis或者makensisw程序，将步骤2编写的脚本编译成可执行的安装程序
    4. 调试安装程序，如果有问题退到第二步重复

    随着NSIS的流行，有一些第三方的NSIS脚本开发环境出现了，如HM NIS Edit，Venis IX前者是完全开源的，后者仅对个人和非商业用途免费。在这些集成开发环境下，步骤2，3可以方便的组合在一起。

    NSIS脚本的结构

    NSIS脚本(下称nsi脚本)主要包含安装程序属性、页面、区段、函数。

    属性用来定义安装程序的行为和界面风格，这些属性大部分是编译时刻属性，即不能在运行时刻改变。

    页面是指安装程序的向导页面，示例：

    Page license

    Page components

    Page directory

    Page instfiles

    UninstPage uninstConfirm

    UninstPage instfiles

    区段是对应某种安装/卸载选项的处理逻辑，该段代码仅当用户选择相应的选项才被执行。卸载程序的区段名用"un."作为前缀，示例如下：

    Section "Installer Section"

    SectionEnd

    Section "un.Uninstaller Section"

    SectionEnd

    在区段中可以使用很多指令用来完成诸如解压缩文件、读写注册表、创建目录、创建快捷方式等任务，但最常用的指令是SetOutPath和File，前者用于指定目的位置，后者用于指定文件。示例：

    与时电脑知识库(fortime.net)

    Section "My Program"

      SetOutPath $INSTDIR

      File "My Program.exe"

      File "Readme.txt"

    SectionEnd

    区段名的修饰符/o表示该区段默认不选上，-表示隐藏区段(匿名区段也是隐藏区段)，！表示需要粗体显示的区段。

    SectionIn表示该区段和安装类型之间的关系：

    SectionIn insttype_index [insttype_index] ... [RO]

    RO修饰符表示不可修改。

    子区段用于包含多个区段

    SubSection [/e] Caption [subsection_name index output]

    修饰符/e用于该子区段的所有区段是否默认展开。

    函数包含了模块化的安装逻辑，在nsi脚本中函数分为两种：用户自定义函数和回调函数。用户自定义函数仅当是Call指令调用时才被执行，如果函数体中没有abort语句，则安装程序执行完了用户自定义函数，继续运行Call语句和指令。

    用户自定义函数的语法如下：

    Function <函数名>

      # some commands

    FunctionEnd

    函数的调用则使用以下语法：

      Call <函数名>

    可见无论是函数的定义还是函数的调用都没有参数传递。通常nsi的参数传递是通过堆栈操作Pop,Push和20个寄存器变量$0~$9, $R0~$R9进行的。也可以通过全局变量完成参数传递。如：

    www.fortime.net

    Var input ;

    Var output ;

    Section bla

      DeteailPrint "input is $input$\n"

      Call square

      DeteailPrint "square of $input is $output$\n"

    SectionEnd

    Function square

      output = input^2

    FunctionEnd

    回调函数则是由在特定的时间点触发的程序段。常用的回调函数如.onInit：

    Function .onInit

      MessageBox MB_YESNO "This will install My Program. Do you wish to continue?" IDYES gogogo

        Abort

      gogogo:

    FunctionEnd

    NSIS对于安装逻辑定义以下回调函数：.onGUIInit、.onInit、.onInstFailed、.onInstSuccess、. onGUIEnd、.onMouseOverSection、.onRebootFailed、.onSelChange、.onUserAbort、. onVerifyInstDir

    NSIS对于卸载逻辑定义以下回调函数：un.onGUIInit、un.onInit、un.onUninstFailed、un.onUninstSuccess、un.onGUIEnd、un.onRebootFailed、un.onUserAbort

    nsi脚本的变量定义

    nsi脚本的变量定义用Var关键字，后跟变量名，变量是全局的并且是大小写敏感的。变量引用时需要加上前缀$。

    除了用户自定义的变量外，nsi脚本中与定义寄存器变量$0~$9,$R0~$R9用于参数传递，以及系统变量用于特定用途，这些变量主要有：

    与时IT资讯

    $INSTDIR，$OUTDIR，$CMDLINE，$LANGUAGE这些变量都是可写的。

    $PROGRAMFILES，$COMMONFILES，$DESKTOP，$EXEDIR，${NSISDIR}，$WINDIR，$SYSDIR，$ TEMP，$STARTMENU，$SMPROGRAMS，$SMSTARTUP，$QUICKLAUNCH，$DOCUMENTS，$SENDTO，$ RECENT，$FAVORITES，$MUSIC，$PICTURES，$VIDEOS，$NETHOOD，$FONTS，$TEMPLATES，$ APPDATA，$PRINTHOOD，$INTERNET_CACHE，$COOKIES，$HISTORY，$PROFILE，$ ADMINTOOLS，$RESOURCES，$RESOURCES_LOCALIZED，$CDBURN_AREA，$HWNDPARENT，$ PLUGINSDIR

    nsi脚本中可用于调试的系统函数有MessageBoxes,DetailPrint,Dumpstate。

    nsi脚本的编译器指令

    nsi脚本的编译器指令主要指仅在编译时刻执行的命令。这些命令主要用来包含文件、条件化编译、定义常量、定义宏等。定义常量和宏是编译器指令最主要应用。

    定义常量的示例：

    !define VERSION "1.0.3"

    Name "My Program ${VERSION}"

    OutFile "My Program Installer - ${VERSION}.exe"

    定义宏的示例：

    !macro MyFunc UN

    Function ${UN}MyFunc

      Call ${UN}DoRegStuff

      ReadRegStr $0 HKLM Software\MyProgram key

      DetailPrint $0

    FunctionEnd www.fortime.net

    Modern UI

    Modern UI是感观上模仿最新的Windows系统的界面风格，它由欢迎页面、结束页面和其他向导页面构成。

    插件

    nsi支持插件，通过插件可以方便的扩展NSIS安装程序的功能。NSIS插件是用C++,Delphi等语言编写的dll，在nsi脚本中调用nsi中的函数使用如下语法：

    DLLName::FunctionName "参数1" "参数2" "参数3"

    示例1：

    nsExec::ExecToLog '"${NSISDIR}\makensis.exe" /CMDHELP'

    执行makensis.exe命令，显示该命令用法。

    示例2：

    InstallOptions::dialog "$PLUGINSDIR\test.ini"

    显示对话框

    示例3：

    NSISdl::download http://download.nullsoft.com/winamp/client/winamp291_lite.exe $R0

    下载文件

    NSIS搜索插件的策略

    默认情况下NSIS在其安装目录的子目录Plugins中搜索插件，用户可以使用!addplugindir指定增加插件的目录位置。

    nsi脚本的基本语法
    注释
    单行注释用井号"#"或分号";"，跨行注释用可以用c/C++中注释语法。

    数据类型
    数字
       数字常量可以用十进制、十六进制(0x为前缀)、八进制(0为前缀)表示，颜色用类似html的中RGB表示法，但去井号"#"。
    字符串
       字符串常量可以用引号引用，转意字符用"$\"作前缀。美元符号、常用转意字符换行、回车、制表符的nsi语法表示分别为：$$,$\n,$\r,$\t
    续行符
        nsi脚本用行尾的反斜杠"\"表示下一行和当前行逻辑上是同一行
    默认头文件
        如果在makensis同目录下有nsisconf.nsh文件，该文件会被自动包含，除非编译时指定/NOCONFIG选项

    标号
       nsi使用GOTO语句和IfErrors, MessageBox, IfFileExists及StrCmp进行程序控制流表示，标号是这些语句的目标语句。标号定义的语法：
       标号：语句
       标号必须定义在函数和区段中，其作用范围仅限于定义它的区段或函数。以点号"."开头的标号是全局标号。
    相对跳转
        nsi脚本常常使用相对跳转表示条件分枝，其语法是[+-][1-9]，加号表示从当前位置往前跳转，减号则表示从当前位置往后跳转。数字表示跳转的语句条数。示例： 与时IT资讯(www.fortime.net) 
     Goto +4
     MessageBox MB_OK "The following message will be skipped"
     Goto +3
     MessageBox MB_OK "You will never ever see this message box"
     Goto -3
     MessageBox MB_OK "Done"

    页面
    向导页面是NSIS安装程序中最重要的界面元素，在nsi脚本中可以使用NSIS内置页面或者定制界面，通过脚本可以指定页面的顺序、显示样子和行为。 Page指令用来定义安装程序中的页面，UninstPage用来定义，此外PageEx指令提供类是功能，但提供更多选项。页面的顺序和它在nsi脚本中出现的次序一致。
    示例：
     Page license
     Page components
     Page directory
     Page instfiles
     UninstPage uninstConfirm
     UninstPage instfiles
    规定安装程序首先显示license页面，然后显示components选择页面，接着显示安装目录选择页面。

    页面选项
    不同的页面有不同的选项:
    License page有LicenseText,LicenseData,LicenseForceSelection;
    Components selection页面有ComponentText;
    Directory selection页面有DirText,DirVar(仅能在PageEx中使用),DirVerify;
    Un/Installation log页面有DetailsButtonText,CompletedText;

    与时电脑知识库


    Uninstall confirmation页面有DirVar(仅能在PageEx中使用),UninstallText
    对于内置的Page，NSIS支持三个回调函数用于定制界面和验证，对于自定义页面NSIS支持两个回调函数。

    Page指令语法
    Page licensecomponentsdirectoryinstfilesuninstConfirm) [pre_function] [show_function] [leave_function]
    或者：
    Page custom [creator_function] [leave_function] [caption]
    示例：
     Page license skipLicense "" stayInLicense
     Page custom customPage "" ": custom page"
     Page instfiles

     Function skipLicense
       MessageBox MB_YESNO "Do you want to skip the license page?" IDNO no
         Abort
       no:
     FunctionEnd

     Function stayInLicense
       MessageBox MB_YESNO "Do you want to stay in the license page?" IDNO no
         Abort
       no:
     FunctionEnd

     Function customPage
       GetTempFileName $R0
       File /oname=$R0 customPage.ini
       InstallOptions::dialog $R0 与时(fortime.net) 
       Pop $R1
       StrCmp $R1 "cancel" done
       StrCmp $R1 "back" done
       StrCmp $R1 "success" done
       error: MessageBox MB_OKMB_ICONSTOP "InstallOptions error:$\r$\n$R1"
       done:
     FunctionEnd
     
    UninstPage指令语法
    UninstPage custom [creator_function] [leave_function] [caption]
      OR
    UninstPage (licensecomponentsdirectoryinstfilesuninstConfirm) [pre_function] [show_function] [leave_function]


    PageEx语法
      PageEx使用嵌套结构，比如：
     PageEx license
       LicenseText "Readme"
       LicenseData readme.rtf
       PageCallbacks licensePre licenseShow licenseLeave
     PageExEnd

    常用的nsi指令
    nsi大致可以分为基本指令、注册表及ini操作指令、通用指令、流程控制指令、文件操作指令、卸载指令、字符串处理指令、多语言支持指令、重启指令。

    以下是常用的基本指令：
    Delete
    Delete [/REBOOTOK] file

    Exec 
    Exec command

    ExecShell
    ExecShell action command [parameters] [SW_SHOWNORMAL SW_SHOWMAXIMIZED SW_SHOWMINIMIZED SW_HIDE]ExecShell "open" 示例"http://nsis.sf.net/"

    与时电脑知识库


    ExecWait
    ExecWait command [user_var(exit code)]
    示例：
    ExecWait '"$INSTDIR\someprogram.exe"'
    ExecWait '"$INSTDIR\someprogram.exe"' $0
    DetailPrint "some program returned $0"


    File
    File [/nonfatal] [/a] ([/r] [/x filewildcard [...]] (filewildcard) [...] /oname=file.dat infile.dat)
    /r选项用作递归模式，/x用于排出文件
    示例：
    File something.exe
    File /a something.exe
    File *.exe
    File /r *.dat
    File /r data
    File /oname=$TEMP\temp.dat somefile.ext
    File /nonfatal "a file that might not exist"
    File /r /x CVS myproject
    File /r /x *.res /x *.obj /x *.pch source

    Rename
    Rename [/REBOOTOK] source_file dest_file

    RMDir
    RMDir [/r] [/REBOOTOK] directory_name

    NSIS System 插件

    (C) brainsucker (Nik Medved), 2002 与时电脑知识库

    内容表

    • 简介
    • 有效函数
      • 内存相关函数
      • 调用函数
      • 64 位函数
    • FAQ

    简介

    System 插件给开发者提供了从外部 DLL 调用任何函数的功能。例如，你可以用它来调用GetLogicalDriveStrings 来获取用户电脑里的驱动器列表。

    fortime.net

    System 插件也允许开发者来分配、释放、复制内存；与 COM 对象相配合并执行 64 位整数数学操作。

    与时电脑知识库(fortime.net)

    为了理解 System 插件强烈推荐首先有程序方面的知识。

    与时电脑知识库(www.fortime.net)

    档案里的一些使用例子
    • Get local time
    • Register conduits with Palm HotSync
    • Get free memory
    • Read REG_MULTI_SZ
    • Get disk serial number

    有效函数

    内存相关函数

    • Alloc SIZE

      分配 SIZE 字节并返回一个内存地址到堆栈上。 与时电脑知识库

      使用例子
      System::Alloc 64  Pop $0  DetailPrint "64 字节分配在 $0"  System::Free $0   
        
        
      
         
         与时电脑知识库(www.fortime.net)
    • Copy [/SIZE] DESTINATION SOURCE

      从 SOURCE 复制 SIZE 字节到 DESTINATION。如果不指定 SIZE，SOURCE 的大小必须使用 GlobalSize。这意味着如果你不使用 System::Alloc，System::Call 或 GlobalAllocCopies 来分配 SOURCE，你就必须指定SIZE。

      与时IT资讯(fortime.net)
      使用例子
      # 分配一个缓冲区并把‘测试字串'压入  System::Call "*(&t1024 '测试字串', i 5) i .s"  Pop $0  # 复制到一个自动创建的缓冲区  System::Copy 0 $0  Pop $1  # 在 $1 缓冲区获取字串和整数  System::Call "*$1(&t1024 .r2, i .r3)"  # 释放缓冲区  System::Free $1  # 输出结果  DetailPrint $2  DetailPrint $3  # 复制到我们自己的缓冲区  System::Alloc 1028  Pop $1  System::Copy $1 $0  # 在 $1 缓冲区获取字串和整数  System::Call "*$1(&t1024 .r2, i .r3)"  # 释放  System::Free $0  System::Free $1  # 输出结果  DetailPrint $2  DetailPrint $3   与时IT资讯
    • Free ADDRESS

      释放ADDRESS. 与时电脑知识库(www.fortime.net)

      使用例子
      System::Alloc 64  Pop $0  DetailPrint "64 字节分配在 $0"  System::Free $0   与时IT资讯(www.fortime.net)
    • Store "OPERATION [OPERATION [OPERATION ...]]"

      执行堆栈操作。一个操作可以从 NSIS 堆栈压入或弹出一个已注册的变量或者压入弹出所有系统已注册的变量 ($0 - $9 和 $R0 - $R9)。操作可以由任何字符分割。

      与时电脑知识库

      有效的操作
      • 要压入 $#，使用 p#，# 是一个从 0 到 9 的数字。
      • 要弹出 $#，使用 r#，# 是一个从 0 到 9 的数字。
      • 要压入 $R#，使用 P#，# 是一个从 0 到 9 的数字。
      • 要弹出 $R#，使用 R#，# 是一个从 0 到 9 的数字。
      • 要压入 $0-$9 和 $R0-$R9 到系统私有的堆栈，使用 s 或 S。
      • 要从系统私有的堆栈弹出 $0-$9 和 $R0-$R9 使用 l 或 L。

      注意系统私有堆栈当 System 插件从 NSIS 卸载后将会丢失。如果你想使用它，你就必须保持 System 插件一直载入。你可以在你的脚本里使用 SetPluginUnload 或加 /NOUNLOAD 参数来使得插件不卸载。

      与时电脑知识库(fortime.net)

      使用例子
      StrCpy $0 "test"  System::Store "p0"  Pop $1  DetailPrint "$0 = $1"   
      fortime.net
      
						
      StrCpy $2 "test"  System::Store "p2 R2"  DetailPrint "$2 = $R2"   
      与时IT资讯
      
						
      StrCpy $3 "test"  System::Store /NOUNLOAD "s"  StrCpy $3 "another test"  System::Store "l"  DetailPrint $3   
      与时电脑知识库(fortime.net)
      
						
      System::Store "r4" "test"  DetailPrint $4   与时(fortime.net)

    调用函数

    • Call PROC [( PARAMS ) [RETURN [? OPTIONS]]]
    • Get PROC [( PARAMS ) [RETURN [? OPTIONS]]]

      调用和获取都是共用一个语法。就如名称所述， Call 就是调用 Get 就是获取。它要调用什么或获取什么？由PROC 的值决定。

      与时电脑知识库(fortime.net)

      PARAMS 是一个参数列表和要和他们做什么。你可以在参数里传递数据并且也可以从它们那里获取数据。这些参数列表由逗号分隔。每个参数由三个值组合而成: 类型、源、目标。类型可以是一个整数，一个字串，等等。源，就是参数值的源，可以是一个 NSIS 变量($0、$1、$INSTDIR)，NSIS 堆栈，一个具体的值(5、"test"，等等)或空(NULL)。目标，就是调用返回后的参数值，可以是 NSIS 变量，NSIS 堆栈或空(意味着该输出不需要)。如果不需要源或目标的话可以用一个句点表示(.)。 与时IT资讯(fortime.net)

      RETURN 像一个单一参数的定义，但当创建回调函数时仅使用到源。通常源是一个句点。

      与时电脑知识库(fortime.net)

      OPTIONS 是一个 System 插件行为控制方法的选项列表。每一个选项可以由一个感叹号前缀关闭。例如:?!e。

      与时电脑知识库

      PARAMS，RETURN 和 OPTIONS 在一个 Get/Call 行里可以重复多次。当重复时，可以省略很多，而只需要使用你需要改变的。类型，源 和/或目标可以省略每一个参数，即使返回值。选项可以添加或移除。这允许你来定义函数原型并保存为一些类型。最后的两个例子 作了演示。 与时电脑知识库(fortime.net)

      PROC 也可以重复但必须带井号前缀(#)。 www.fortime.net

      可能的 PROC 值和意义
      值意义例子
      DLL::FUNCDLL 输出的函数user32::MessageBox
      ::ADDR地址为 ADDR 的函数看下面
      *ADDR地址为 ADDR 的结构看下面
      *新结构看下面
      IPTR->IDX成员索引 IDX 从界面由 IPTR 指向看下面
      <nothing>新的回调函数看下面
      PROC由 Get 返回的 PROC看下面
      有效的参数类型
      类型意义
      vvoid (常用于返回) 
      iint (包括 char、byte、short、句柄、指针 等)
      l长整数、int64
      t文本，字串(指向第一个字符)
      wWCHAR 文本，Unicode 字串
      gGUID
      k回调
      &vNN 字节填充 (仅结构)
      &iNN 字节整数 (仅结构)
      &l结构大小 (仅结构)
      &tNN 字节文本 (仅结构)
      &wNN 字节 Unicode 文本 (仅结构)
      &gNN 字节 GUID (仅结构)

      另外，每一种类型可以加一个星号表示指针。当使用一个星号时，System 插件仍然认为是参数的值，而不是指针地址。要传递直接的地址，使用没有星号的 i。一个使用例子。Alloc 返回地址并且它的返回值因此被用于 i，不带星号。

      与时电脑知识库(www.fortime.net)
      有效的源和目标
      类型意义
      .忽略 
      number十六进制、十进制或八进制整数值。许多整数可以使用 来执行或操作。
      'string'
      "string"
      `string`      		字串值
      r0 到 r9分别是 $0 到 $9
      r10 到r19
      R0 到R9      		分别是 $R0 到 $R9
      c$CMDLINE
      d$INSTDIR
      o$OUTDIR
      e$EXEDIR
      a$LANG
      sNSIS 堆栈
      n空的源，目标不需要输出
      回调

      回调函数是一个被传递到一个函数并被它本身回调的简单的函数。它们常用于一项接一项传递一个可能的大量数据设置。例如: EnumChildWindows 使用一个回调函数。像 NSIS 函数不是完全正规的函数一样，System 插件提供它自己的机制来支持回调函数。它允许你来创建回调函数并当一个回调函数被调用时通知你。

      与时IT资讯(www.fortime.net)

      回调函数的创建使用 Get 和回调的语法。就像你不能调用回调本身一样，参数的源应该使用一个句点来忽略。当回调被调用时，目标参数将使用回调传递的参数来填充。回调将要返回的值由源返回参数设置。目标的返回参数应总是设为当 System 通知回调被调用时。

      与时IT资讯

      System::Get "(i .r0, i .r1) iss" 与时IT资讯(fortime.net)

      要传递回调到一个函数，请使用 k 类型。

      www.fortime.net 
      System::Get "(i .r0, i .r1) isR0"  Pop $0  System::Call "dll::UseCallback(k r0)" 与时电脑知识库(fortime.net)

      每次回调被调用时，字串 callback# (这里 # 代表回调的次数) 将会被在返回 “参数” 的目标里被替换，第一次创建的为 1，第二次为 2，第三次为 3 等等。就如 System 为单线程一样，回调也只能在调用另一个参数时被调用。例如，EnumChildWindows 的回调也只能在 EnumChildWindows 被调用时被调用。因此你应该在每次可能会调用回调的函数调用后检测 callback#。 与时IT资讯(fortime.net)

      System::Call "(i .r0, i .r1) isR0"  Pop $0  System::Call "dll::UseCallback(k r0)"  StrCmp $R0 "callback1" 0 +2  DetailPrint "UseCallback passed ($0, $1) to the callback"   www.fortime.net

      在你处理回调的调用后，你应该使用 Call，把 Get - 回调 返回的值传给它。这将告诉 System 从回调里返回。如果当回调创建时为返回的参数指定了源，你应当把返回值赋给源。因为回调不能自动的释放，所以当你使用完之后不要忘了释放它。

      与时(fortime.net)

      SetPluginUnload alwaysoff  System::Call "(i .r0, i .r1) isR0"  Pop $0  System::Call "dll::UseCallback(k r0)"  loop:   StrCmp $R0 "callback1" 0 done   DetailPrint "UseCallback passed ($0, $1) to the callback"   Push 1 # return value of the callback   System::Call $0 # tell system to return from the callback   Goto loop  done:  SetPluginUnload manual  System::Free $0   fortime.net

      一个完整的例子。

      与时IT资讯(fortime.net)

      注意事项
      • 要查找一个 COM 界面的成员索引，你需要查找 Visual C/C++ 或平台 SDK 里的 COM 界面头文件定义。记住索引从零开始。
      • 记住当使用回调时记得使用 NSIS 的 /NOUNLOAD 开关或 SetPluginUnload。因为如果插件被卸载了它就不能被正常调用了。
      • 如果找不到函数则会把一个 A 附加在函数名的后面，然后再次查找函数。这是因为许多的 Windows API 函数都有两个版本，一个是 ANSI 版本另一个是 Unicode 版本，ANSI 版本标记为 A 而 Unicode 版本标记为 W。例如: lstrcpyA 和 lstrcpyW。
      有效的选项
      选项意义
      ccdecl 调用约定 (堆栈由 caller 重建)。默认情况下使用 stdcall (堆栈由 callee重建)。 
      r总是返回 (对于 GET 来说意味着你应该弹出结果并处理，对于 CALL 来说应该至少弹出结果)。默认情况下仅对错误返回 (对于 GET 来说你可以弹出错误结果和正确的处理，而对于 CALL 来说你将获得返回或定义的地方的结果)。
      n不重新定义。无论过程如何都不会用 GET 或 CALL 来重新定义。该选项不会继承到子项。
      s使用常规堆栈。对于函数调用无论何时第一次回调定义的系统都优先使用临时堆栈。
      e在程序结束后调用Call GetLastError() 并把结果压入堆栈。
      u调用后卸载 DLL (使用 FreeLibrary，使你可以删除它本身)。
      使用例子
      System::Call "user32::MessageBox(i $HWNDPARENT, t 'NSIS System Plug-in', t 'Test', i 0)"   与时IT资讯(www.fortime.net)
						
      System::Call "kernel32::GetModuleHandle(t 'user32.dll') i .s"  System::Call "kernel32::GetProcAddress(i s, t 'MessageBoxA') i .r0"  System::Call "::$0(i $HWNDPARENT, t 'GetProcAddress test', t 'NSIS System Plug-in', i 0)"   与时IT资讯(www.fortime.net)
						
      System::Get "user32::MessageBox(i $HWNDPARENT, t 'This is a default text', t 'Default', i 0)"  Pop $0  System::Call "$0"   与时电脑知识库(www.fortime.net)
						
      System::Get "user32::MessageBox(i $HWNDPARENT, t 'This is a default text', \   t 'Default', i 0x10x10)"  Pop $0  System::Call "$0(, 'This is a System::Get test', 'NSIS System Plug-in',)"   
        
        
      
         
         与时IT资讯(fortime.net)
        
        
      
						
      System::Call "advapi32::GetUserName(t .r0, *i ${NSIS_MAX_STRLEN} r1) i.r2"  DetailPrint "User name - $0"  DetailPrint "String length - $1"  DetailPrint "Return value - $2"   与时电脑知识库(fortime.net)
						
      System::Alloc 4  Pop $0  System::Call "*$0(i 5)"  System::Call "*$0(i .r1)"  DetailPrint $1   
      与时电脑知识库(fortime.net)
      
						
      System::Call "*(i 5) i .r0"  System::Call "*$0(i .r1)"  DetailPrint $1   
        
        
      
         
         与时IT资讯(fortime.net)
        
        
      
						
      # defines  !define CLSCTX_INPROC_SERVER 1  !define CLSID_ActiveDesktop {75048700-EF1F-11D0-9888-006097DEACF9}  !define IID_IActiveDesktop {F490EB00-1240-11D1-9888-006097DEACF9}  # create IActiveDesktop interface  System::Call "ole32::CoCreateInstance( \   g '${CLSID_ActiveDesktop}', i 0, \   i ${CLSCTX_INPROC_SERVER}, \   g '${IID_IActiveDesktop}', *i .r0) i.r1"  StrCmp $1 0 0 end  # call IActiveDesktop->GetWallpaper  System::Call "$0->4(w .r2, i ${NSIS_MAX_STRLEN}, i 0)"  # call IActiveDesktop->Release  System::Call "$0->2()"  # print result  DetailPrint $2  end:   与时IT资讯(www.fortime.net)
						
      InitPluginsDir  SetOutPath $PLUGINSDIR  File MyDLL.dll  System::Call "MyDLL::MyFunc(i 5) ? u"  Delete $PLUGINSDIR\MyDLL.dll   与时IT资讯(fortime.net)
						
      SetPluginUnload alwaysoff  System::Get "(i.r1, i) iss"  Pop $R0  System::Call "user32::EnumChildWindows(i $HWNDPARENT, k R0, i) i.s"  loop:   Pop $0   StrCmp $0 "callback1" 0 done   System::Call "user32::GetWindowText(ir1,t.r2,i${NSIS_MAX_STRLEN})"   System::Call "user32::GetClassName(ir1,t.r3,i${NSIS_MAX_STRLEN})"   IntFmt $1 "0x%X" $1   DetailPrint "$1 - [$3] $2"   Push 1 # callback's return value   System::Call "$R0"   Goto loop  done:  SetPluginUnload manual  System::Free $R0   
      www.fortime.net
      
						
      !define MB "user32::MessageBox(i$HWNDPARENT,t,t'NSIS System Plug-in',i0)"  System::Call "${MB}(,'my message',,)"  System::Call "${MB}(,'another message',,) i.r0"  MessageBox MB_OK "last call returned $0"   
        
        
      
         
         与时IT资讯
        
        
      
						
      System::Call "user32::SendMessage(i $HWNDPARENT, t 'test', t 'test', i 0) i.s ? \   e (,t'test replacement',,) i.r0 ? !e #user32::MessageBox"  DetailPrint $0  ClearErrors  Pop $0  IfErrors good  MessageBox MB_OK "this message box will never be reached"  good:   
      与时IT资讯(www.fortime.net)

    64 位函数

    • Int64Op ARG1 OP [ARG2]

      执行 ARG1 和选项 ARG2 之间的 OP 操作，返回值到堆栈顶。ARG1 和 ARG2 都是 64 位整数，这意味着它们可以处理从 -2^63 到 2^63 - 1 的整数。

      fortime.net

      有效的运算符
      • 加法 -- +
      • 减法 -- -
      • 乘法 -- *
      • 除法 -- /
      • 取模 -- %
      • 位或 --
      • 位与 -- &
      • 位异或 -- ^
      • 逻辑或 --
      • 逻辑与 -- &&
      • 小于 -- <
      • 大于 -- >
      • 等于 -- =
      • 位非 (单变量) -- ~
      • 逻辑非 (单变量) -- !
      使用例子
      System::Int64Op 5 + 5  Pop $0  DetailPrint "5 + 5 = $0" # 10   
        
        
      
         
         与时电脑知识库(www.fortime.net)
        
        
      
						
      System::Int64Op 64 - 25  Pop $0  DetailPrint "64 - 25 = $0" # 39   与时电脑知识库(www.fortime.net)
						
      System::Int64Op 526355 * 1565487  Pop $0  DetailPrint "526355 * 1565487 = $0" # 824001909885   与时IT资讯
						
      System::Int64Op 5498449498849818 / 3  Pop $0  DetailPrint "5498449498849818 / 3 = $0" # 1832816499616606   
      与时电脑知识库(www.fortime.net)
      
						
      System::Int64Op 0x89498A198E4566C % 157  Pop $0  DetailPrint "0x89498A198E4566C % 157 = $0" # 118   与时IT资讯(www.fortime.net)
						
      System::Int64Op 0xF0F0F0F  0xF0F0FFF  Pop $0  # IntFmt is 32-bit, this is just for the example  IntFmt $0 "0x%X" $0  DetailPrint "0xF0F0F0F  0xF0F0FFF = $0" # 0xF0F0FFF   
        
        
      
         
         与时电脑知识库(fortime.net)
        
        
      
						
      System::Int64Op 0x12345678 & 0xF0F0F0F0  Pop $0  # IntFmt is 32-bit, this is just for the example  IntFmt $0 "0x%X" $0  DetailPrint "0x12345678 & 0xF0F0F0F0 = $0" # 0x10305070   
      与时电脑知识库(www.fortime.net)
      
						
      System::Int64Op 1 ^ 0  Pop $0  DetailPrint "1 ^ 0 = $0" # 1   与时(fortime.net)
						
      System::Int64Op 1  0  Pop $0  DetailPrint "1  0 = $0" # 1   与时电脑知识库(www.fortime.net)
						
      System::Int64Op 1 && 0  Pop $0  DetailPrint "1 && 0 = $0" # 0   
      与时(fortime.net)
      
						
      System::Int64Op 9302157012375 < 570197509190760  Pop $0  DetailPrint "9302157012375 < 570197509190760 = $0" # 1   
        
        
      
         
         fortime.net
        
        
      
						
      System::Int64Op 5168 > 89873  Pop $0  DetailPrint "5168 > 89873 = $0" # 0   
      与时IT资讯
      
						
      System::Int64Op 189189 = 189189  Pop $0  DetailPrint "189189 = 189189 = $0" # 1   
        
        
      
         
         fortime.net
        
        
      
						
      System::Int64Op 156545668489 ~  Pop $0  DetailPrint "1 ~ = $0" # -156545668490   与时IT资讯
						
      System::Int64Op 1 !  Pop $0  DetailPrint "1 ! = $0" # 0   fortime.net

    FAQ

    • Q: 如何把一个结构传递到函数？

      A: 首先，你必须先为结构分配内存。有两种方法: 使用 Alloc 或带有特殊结构分配语法的 Call。然后，如果你要在结构传递数据，你首先要把数据填入结构体。然后你才可以用一个指向结构的指针来调用函数。最后，调用函数后如果你想从结构体里取出数据，你必须使用带有结构指针的 Call。上面这些都做完了之后别忘了释放结构体。

      与时电脑知识库(www.fortime.net)
      分配内存

      要分配内存给结构体请使用Alloc，但是你必须知道结构体的大小。当然你也可以用Call。在这个例子里可以很明显地看出这个结构体的大小是 16 字节，但是在其他的例子可能就不是这样子了。在所有的例子里，结构体的地址都被保存在堆栈顶部，你需要用 Pop 来把它弹出到变量。

      与时电脑知识库(fortime.net) 
      System::Alloc 16   与时IT资讯(www.fortime.net)
							
      System::Call "*(i, i, i, t)i.s"   与时电脑知识库
      设置数据

      写入数据可以使用Call。可以在分配内存时就进行，或者用其它方法分配后使用带结构指针的语法。

      与时电脑知识库(www.fortime.net) 
      System::Call "*(i 5, i 2, i 513, t 'test')i.s"   
         
         
      
          
          与时IT资讯
         
         
      
							
      # 假设结构体的内存地址保存在 $0 里  System::Call "*$0(i 5, i 2, i 513, t 'test')"   
      与时电脑知识库
      把结构体传递到函数

      就像一些分配方法返回一个地址一样，这里要传递的数据类型应该是一个整数 - 一个保存了结构体地址的整数。 与时电脑知识库(fortime.net)

      # 假设结构体的内存地址保存在 $0 里  System::Call "dll::func(i r0)"   与时电脑知识库(fortime.net)
      读取数据

      读取数据可以使用和写入数据相同的语法。说不同的是要有输出变量而输入部分用一个句点来表示。 与时电脑知识库(fortime.net)

      # 假设结构体的内存地址保存在 $0 里  System::Call "*$0(i .r0, i .r1, i .r2, t .r3)"  DetailPrint "第一个整数 = $0"  DetailPrint "第二个整数 = $1"  DetailPrint "第三个整数 = $2"  DetailPrint "字串 = $3"   
      与时(fortime.net)
      释放内存

      使用Free 来释放内存。 与时IT资讯

      # 假设结构体的内存地址保存在 $0 里  System::Free $0   
      与时IT资讯(fortime.net)

    NSIS安装程序制件软件 下载地址：http://www.wishdown.com/Software/Catalog139/10926.html

    CodingAsura
    关注
    • 2
      点赞
    • 踩
    • 10
      收藏
      觉得还不错? 一键收藏
    • 0
      评论
    专栏目录
    NSIS教程(1): 基础语法
    while(1) { smile(); }
    01-18 10万+
    NSIS教程： 《NSIS用户手册 中文版》 《NSIS图文教程集锦 - 轻狂志》 一. 环境搭建 NSIS是“Nullsoft Scriptable Install System”的简称。从http://nsis.sourceforge.net/Download下载NSIS安装进行安装，安装完之后的目录结构如图： 也可以从此处下载：nsis-3.02.1 ...
    nsis 入门教程
    06-02
    使用新手入门，CHM格式，方便观看，电子书，教程
    NSIS使用教程档.zip_nsis
    09-24
    这是关于安装打包程序NSIS使用的文档。
    NSIS安装包开发笔记（一）：NSIS介绍、使用NSIS默认向导脚本制作Windows安装包
    热门推荐
    长沙创微智能科技官方博客
    05-07 2万+
    做产品时，定制的自定义安装界面常有的，使用NSIS + Qt可以完美的定制基于QT的安装界面，先从纯NSIS开始，制作常规的安装包。
    Nsis基本使用小结
    记录
    06-02 577
    【代码】Nsis基本使用小结。
    NSIS入门教程
    gyc1307py42568的博客
    02-18 5083
    NSIS简介NSIS是"Nullsoft 脚本安装系统"(Nullsoft scriptable Installation System)的缩写，它是是一个免费的win32安装、卸载程序，可以打包windows应用程序。打包步骤下载NSIS脚本安装系统，启动NSIS Edit引用了急支糖浆的图片注：这里有一些信息使用了变量来表示，因为脚本中可能会在多个地方使用，使用变量可以方便修改，统一管理。这些变量在下面的脚本中会设置相应的值。
    Nsis基本使用
    记录
    06-02 615
    一个开源软件，用于创建Winsows安装程序。
    NSIS学习记录（三）————NSIS脚本简介
    rose2rose的博客
    04-19 3268
    nsis用户手册，大部分是翻译，
    NSIS学习笔记
    m0_46486963的博客
    07-27 811
    NSIS 是开发者用来创建安装程序的工具 ，它允许程序员控制安装、卸载、设置系统设置、解压文件等，且是最小的安装程序系统，在默认情况下仅为34KB。在 NSIS 脚本里每一行都作为一个命令处理， 如果这一行太长的话你可以使用 “\” 来分隔，编译器会自动地把下一行接到上一行来作为完整的一行，而不是看作新的行，如果在字符串里需要使用双引号，你应该使用 $" 来避免误解Call 函数名!define 常量名 常量值!define NAME "名字"Var 变量名。
    nsis 新手入门教程
    01-26
    开发一个NSIS的安装程序通常有以下几步： 确定安装的功能和界面元素 编写NSIS脚本 使用NSIS提供的makensis或者makensisw程序，将步骤2编写的脚本编译成可执行的安装程序 调试安装程序，如果有问题退到第二步重复 ...
    NSIS入门指南
    12-27
    这是NSIS的指南，不错的资料，让你能够轻松入门
    NSIS打包程序教程
    12-26
    不错的实例教程，打包程序可能用到。少轻狂原创内容。
    nsis打包工具教程集合
    07-17
    nsis打包工具教程集合
    NSIS 简单教程
    sunny_98_98的博客
    02-19 7551
    NSIS Setup 如果这个页面是您第一次使用NSIS，那么您将需要NSIS编译器来将以下脚本和您创建的其他脚本转换为有效的安装程序。您可以使用NSIS菜单，并在编译器部分下单击编译NSI脚本启动MakeNSISW。 NSIS安装文件夹中的makensisw.exe是实际的编译器。它有一个图形化的前端，解释了三种加载脚本的方法，所以它非常容易使用。安装NSIS之后，要创建一个安装程序，需要将脚本复制到文本编辑器中，保存扩展名为.nsi的文件，并将该文件加载到makensisw编译器中。 最简代码 # na
    NSIS简介
    Frank的专栏
    05-07 1万+
    NISI打包工具简单记录
    NSIS认识总结
    VinWqx的博客
    02-22 1673
    一、NSIS简单介绍 NSIS，全称为Nullsoft Scriptable Install System，即脚本安装系统，用于创建安装程序（安装包），使得安装程序具备安装、卸载、设置系统设置以及解压文件等功能。此工具在开源许可下发布，对于任何使用都是完全免费的。 NSIS作为最小可用的脚本安装系统，基于脚本文件，支持变量、函数和字符串操作，可以完全控制安装程序的每个部分。创建一个NSIS安装程序之前必须编写一个NSIS脚本，可使用任何文本编辑器来进行脚本编写。NSIS脚...
    （一）NSIS介绍
    我房间
    01-13 3559
    概述 最近需要写一个安装程序，比对了一下现有的安装工具，最后选定了NSIS，最主要的原因一是开源、二是灵活。 下面把我的要求简单列举下： 1、需要检查系统环境是否满足要求 2、需要界面友好的安装过程 3、需要一些自定义界面，在安装过程中来获取一些必须的信息 4、需要根据界面的选择来执行或跳过一些安装过程 5、需要操作数据库 6、需要操作IIS 7、需要使用PowerShell命令设置AD/Exchange/Lync 8、需要操作注册表，用于标识安装步骤以用于卸载或回滚的执行 经过调查发
    NSI打包（IfFileExists的使用出发的一些常用语法）
    Ma_Hong_Kai的博客
    10-10 3401
    我使用的NSIS （可能不是正规的，记不清到底是不是这个了） 1、基础 （1）页面（页面详细使用的  nsis page页面学习笔记） 控制这些页面的次序, 外观, 作用，默认为白色。 安装页面 Page 、卸载页面 UninstPage  Page license ;许可协议页面 Page components ;组件选择页面 Page dir...
    学生签到表表格.docx
    最新发布
    06-23
    学生签到表表格.docx
    nsis插件开发教程
    07-27
    NSIS插件开发教程主要涉及如何开发自定义插件，以增强NSIS的功能。 首先，开发NSIS插件需要一些编程基础，特别是C或C++语言的基础知识。在开始插件开发之前，需要了解NSIS的插件架构和插件接口。 NSIS插件示例代码...

    “相关推荐”对你有帮助么？

    • 非常没帮助
    • 没帮助
    • 一般
    • 有帮助
    • 非常有帮助
    提交
    评论
    添加红包

    请填写红包祝福语或标题

    个

    红包个数最小为10个

    元

    红包金额最低5元

    当前余额3.43元 前往充值 >
    需支付：10.00元
    成就一亿技术人!
    领取后你会自动成为博主和红包主的粉丝 规则
    hope_wisdom
    发出的红包
    实付元
    使用余额支付
    点击重新获取
    扫码支付
    钱包余额 0

    抵扣说明：

    1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
    2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

    余额充值