NSIS学习笔记（持续更新）

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 plugin
HWND 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 stack
	pushstring(szComponent);
	
}

/*
nsMessageBoxPlugin::myFunction "abcdefg[来自NSIS的中文测试]"
Pop $0
MessageBox 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 关闭正在运行的程序，示例

;--------------------------------------------------------------
!include logiclib.nsh
FindProcDLL::FindProc "Test.exe"
StrCmp $R0 1 0 +2

messagebox::show MB_SETFOREGROUND|MB_ICONHAND|MB_DEFBUTTON3|MB_TOPMOST "${PRODUCT_NAME}" "" \
	'检测到程序正在运行，是否立即终止程序？$\n$\n\
	【终止】终止程序，继续卸载$\n\
	【取消】取消卸载' \
	 "终止" "取消"
Pop $0

${If} $0 == 1
  KillProcDLL::KillProc "Test.exe"
${Elseif} $0 == 2
  Abort
${EndIf}
;--------------------------------------------------------------

!include logiclib.nsh   不可少，引入后才能写${If}等逻辑判断。

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:

File msxmlchs.msi
ExecWait "msiexec /quiet /i msxmlchs.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}

Q 如何调用静默卸载？

#自动卸载上一个打包版本.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

 

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

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
http://blog.csdn.net/lee353086/article/details/46349157