NSIS学习笔记（二）-使用C++开发NSIS插件

作者：kagula
时间：2016-06-03


Q 如何使用C++开发插件,示例
环境：VS2013Update4
参考资料[3]来做
S1:新建一个空的C++DLL项目，nsMessageBoxPlugin.
S2:复制“C:\Program Files (x86)\NSIS\Unicode\Examples\Plugin\nsis”文件夹到
当前solution下。
S3:当前project头文件和库文件搜索路径设为“$(SolutionDir)nsis;”
S4:把nsis中的头文件加到当前project中。
S5:为当前project添加nsMessageBoxPlugin.c文件。源文件清单如下。

#include <windows.h>#include <pluginapi.h> // nsis pluginHWND g_hwndParent;// To work with Unicode version of NSIS, please use TCHAR-type// functions for accessing the variables and the stack.void __declspec(dllexport) myFunction(HWND hwndParent, int string_size,TCHAR *variables, stack_t **stacktop,extra_parameters *extra){g_hwndParent = hwndParent;EXDLL_INIT();//读取输入参数WCHAR szComponent[256];popstring(szComponent);//打印参数WCHAR buf[1024];//这里能正确打印出来自NSIS的中文信息。wsprintf(buf, L"kagula $0=[%s][中文测试]\n", szComponent);MessageBoxW(g_hwndParent, buf, 0, MB_OK);//准备返回参考int len = (int)wcslen(szComponent);// make a little change to input parameter// below shift a unit character.for (int i = 0; i < len; ++i)szComponent[i] += 1;// push back on the stackpushstring(szComponent);}/*nsMessageBoxPlugin::myFunction "abcdefg[来自NSIS的中文测试]"Pop $0MessageBox MB_OK "ret = $0"#打印来自C++的中文会乱码。*/

S6:把project生成的“nsMessageBoxPlugin.dll”复制到“C:\Program Files (x86)\NSIS\Unicode\Plugins”路径下。
S7:现在运行NSIS脚本应该能看到效果了。
S8:自动复制动态链接库免得每次编译都要手动复制一遍(要求关闭操作系统的UAC)。
把下面三行代码复制到“[Configuration Properties]->[BuildEvents]->[Post Build Event]”
echo on
copy "$(OutDir)$(TargetName)$(TargetExt)" "C:\Program Files (x86)\NSIS\Unicode\Plugins"
echo off
 
Q 桌面快捷方式，示例
在section "install"中添加下面的代码，新建shortcut
 CreateShortcut "$DESKTOP\${APPNAME}.lnk" "$INSTDIR\${APPEXENAME}"
在section "uninstall"中添加下面的代码，删除shortcut
delete "$DESKTOP\${APPNAME}.lnk"  


Q 关闭正在运行的程序，示例
有两种方法，最常用的是下面这种方法

Function CloseProgram  StrCpy $1 0  loop:    FindWindow $0 "${WinClassName}" ${MainExeWindowText}    IntCmp $0 0 done;      SendMessage $0 ${WM_DESTROY} 0 0;      SendMessage $0 ${WM_CLOSE} 0 0       SendMessage $0 ${WM_QUIT} 0 0    Sleep 100     IntOp $1 $1 + 1     IntCmp $1 3 done    Goto loop   done:    ${nsProcess::FindProcess} ${APPEXENAME} $R0    ${If} $R0 == "0"          # it's running          MessageBox MB_OK "你的程序无法自动关闭，请先关闭${APPNAME}程序，再启动安装卸载程序!"          Quit    ${EndIf}FunctionEnd

Q 判断己安装程序版本，示例
我使用的方法是：
利用NSIS官网中的VersionCompare函数，比较EXE中的版本。

Function VerCheck  pop $0${GetFileVersion} "$0" $VersionNumber  FunctionEnd   ReadRegStr $0 HKLM "Software\Microsoft\Windows\CurrentVersion\Uninstall\${COMPANYNAME} ${APPNAME}" "MainProgramLocation"      ${If} $0 != ""        ${If} ${FileExists} $0        push $0         Call VerCheck          ${VersionCompare} $VersionNumber ${VERSIONLONG} $R0          ${if} $R0 == "1"          ${Endif}        ${if} $R0 == "0"          ${Endif}        ${if} $R0 == "2"          ${Endif}     ${EndIf}      ${EndIf}

Q 设置升级安装路径为上次的安装路径
从注册表中读取上次的安装路径
ReadRegStr $0 HKLM "Software\Microsoft\Windows\CurrentVersion\Uninstall\${COMPANYNAME} ${APPNAME}" "MainProgramLocationPath"  
在安装section中把安装路径写进去
WriteRegStr HKLM "Software\Microsoft\Windows\CurrentVersion\Uninstall\${COMPANYNAME} ${APPNAME}" "MainProgramLocationPath" "$INSTDIR"


Q 如何使用变量，示例
声明
Var IsSkipCustom
初始化
Strcpy $IsSkipCustom 0
修改值
Strcpy $IsSkipCustom 1
判断
IntCmp $IsSkipCustom 1 skipCustom    
;这里若干行代码
skipCustom:
;不等于1就跳到这里来了。

Q 如何保留用户原来的数据

    #reserve config file.    CreateDirectory "C:\Temp20150606151700\config"    CopyFiles "$INSTDIR\config\catconfig_w.ini" "C:\Temp20150606151700\config"           # Try to remove the install directory - this will only happen if it is empty      rmDir /r $INSTDIR        #reserve config file.    CreateDirectory $INSTDIR    CreateDirectory "$INSTDIR\config"        CopyFiles  "C:\Temp20150606151700\config\catconfig_w.ini" "$INSTDIR\config"    rmDir /r "C:\Temp20150606151700"

Q  如何注册控件

RegDLL "$INSTDIR\XXX.ocx"

UnRegDLL "$INSTDIR\XXX.ocx"

Q 如何安装MSXML

    # Install MXSML4    IfFileExists "$SYSDIR\msxml4.dll" file_found file_not_found    file_found:     goto continue    file_not_found:        SetOutPath $SYSDIR        SetOverwrite off            File msxml4.dll        ;File msxml4a.dll        File msxml4r.dll        RegDLL $SYSDIR\msxml4.dll        continue:

或采用下面的代码，quiet方式运行xml4的msi安装包。

    File msxmlchs.msi    ExecWait "msiexec /quiet /i msxmlchs.msi"

如何判断已经装过的msi软件，guid可以从老的msi里去拿

    ReadRegStr $0 HKLM "Software\Microsoft\Windows\CurrentVersion\Uninstall\{36B84F1C-C2C0-4B62-8643-98B3F4DAC8BB}" "DisplayName"    ${If} $0 != ""   ;       MessageBox MB_OK "你已经安装${APPNAME}v1.2.0软件，这个版本太旧需要你手动卸载才能安装${VERSIONLONG}版本软件，按确定退出安装！"       push "已安装老版本的客户端，点击确定升级到最新版。"       Call MyMessageBox1       ExecWait "msiexec /x {36B84F1C-C2C0-4B62-8643-98B3F4DAC8BB} /passive" $0    ${EndIf}

StrCpy如何当中加个空格？

如何调用静默卸载？

   #自动卸载上一个打包版本.begin      ReadRegStr $0 HKLM "Software\Microsoft\Windows\CurrentVersion\Uninstall\${COMPANYNAME} ${APPNAME}" "MainProgramLocationPath"        ${If} $0 != ""       Strcpy $1 $0\uninstall.exe       #下面的Call MyMessageBox1会修改$0全局变量，所以$0要先保存到$1中。       push "检查到老版本的安装程序，按确定自动卸载"       Call MyMessageBox1       #为uninstall.exe加一个/S参数是为了静默卸载。       Strcpy $1 '$1 /S'       ExecWait $1   ${EndIf}   #自动卸载上一个打包版本.end

如何防止启动多个安装实例

在Function .onInit中使用一面代码段

    System::Call 'kernel32::CreateMutexA(i 0, i 0, t "Cat8637All") i .r1 ?e'    Pop $R0    StrCmp $R0 0 +4    push "安装程序已经启动！"    Call MyMessageBox1    Abort  

参考资料
[1]NSIS进阶教程－－制作仿酷狗安装包
http://home.xtzj.com/forum.php?mod=viewthread&tid=610259
[2]NSI脚本编辑器
http://az.eliang.com/aq_2013030724.html
[3]Writing a NSIS plugin
http://clseto.mysinablog.com/index.php?op=ViewArticle&articleId=1910084