NISIS (Nullsoft Scriptable Install System , Sistema de Instalacin por Scripts") es una

herramienta muy potente y profesional para crear aplicaciones de instalaciones por medio de
scripts, esta herramienta es de cdigo abierto y ha tomado mucha popularidad entre
desarrolladores.

Entre algunas de sus caractersticas ms destacadas se incluyen la posibilidad de crear distintos
tipos de instalacin (completa, reducida o personalizada) que puede ser seleccionadas por el
usuario, personalizacin de colores, deteccin de instalaciones previas, posibilidad de crear un
desinstalador automtico, cuenta con algoritmos de compresin para reducir el tamao de los
archivos, entre otras cosas.

Instalacin.
Solo hay que ir a la pgina y descargar la ltima versin estable nsis.sourceforge.net/ en la
seccin de descargas y bajamos el archivo ejecutable de instalacin.



La instalacin es intuitiva

Al finalizar la instalacin, ejecutamos el la aplicacin el cual va desplegar una ventana con varias
opciones que podremos utilizar para el desarrollo de aplicaciones de instalaciones, hay que revisar
la documentacin, viene muy bien explicado la forma de cmo empezar.



Para crea aplicaciones NSIS basta tener un editor de texto plano, bloc de notas o si lo prefieren
pueden descargar el editor scripts para nsis HM NIS EDIT.

HM NIS EDIT es un editor de scripts que incluye resaltado de cdigo, tiene asistentes para la
creacin de aplicaciones de instalaciones, editor de dilogos, plantillas de cdigo, soporte de plugins
entre otras cosas interesantes de este editor.

Lo puedes descargar en la pgina: hmne.sourceforge.net/index.php#Download

Posteriormente lo instalamos y lo abrimos:



Este editor no va a facilitar bastante algunas cosas para la creacin de script NSIS, al igual que
todos los editores tiene una forma intuitiva de facil aprendizaje por lo cual nos vamos a enfocar en
cdigo fuente.

Vamos hacer un cdigo de instalacin para ir viendo las opciones y sintaxis de los script en NSIS.

La extensin por defecto de los scripts es .nsi. Tambin existen ficheros header ( al estilo de los .h de
C/C++) que tienen la extensin .nsh

Podemos empezar primero por definir algunas constantes en el script, como NOMBRE,VERSION,
entre otras cosas que necesitemos por definir en nuestro pequeo script de instalacin.

Este seria el cdigo fuente de nuestra primera aplicacin de instalacin:


!include "MUI.nsh"
!define NOMBRE "Mi Aplicacion"
!define VERSION "1.0"

Name "${NOMBRE} ${VERSION}" ;Establecer el nombre de la aplicacin
OutFile "mySetup.exe" ;Establecer el nombre del archivo de instalacin
SetCompressor LZMA ;El LZMA como algoritmo de compresin

!insertmacro MUI_LANGUAGE "Spanish" ;Define el lenguaje en espaol

; Paginas de instalacion</em>
!insertmacro MUI_PAGE_DIRECTORY ;Pagina para elegir el directorio de instalacin
!insertmacro MUI_PAGE_INSTFILES ;Pagina para de instalacin de los archivos

;Definicon de la secciones
Section "myApli" myApli
SetOutPath "$INSTDIR"
File "myaplicacion.exe"
SectionEnd



Tenemos este censillo cdigo fuente que se encarga de instalar una aplicacin en un directorio que
elija el usuario, y por ultimo nos muestra los detalles de lo que se hizo..

En las seccin es donde se define las operaciones a realizar, en este caso solo copiar el archivo
myaplicacion.exe

Esta seria la pagina de
!insertmacro MUI_PAGE_DIRECTORY




Estos son los detalles:



Comentarios:
Comentarios de una lnea es el (punto y coma) y #.

;Este es un comentario
#Otro comentario


Comentarios de bloques:
/*
Comentario de bloques
*/

Variables.
Las variables se puede definir con la palabra reservada var por ejemplo:


...
var myvarable;
...





Section "myApli" myApli
StrCpy $MYVAR "un valor" asignamos un valor;
SectionEnd



Variables globales llevan /GLOBAL:


Var var1
Function testVar
Var /GLOBAL var2
StrCpy $var2 "Variable"
StrCpy $var1 "Otra variable"
FunctionEnd



Otras variables:

$INSTDIR esta variable almacena la ruta del directorio de instalacion puede ser modificada
utilizando StrCpy, ReadRegStr, ReadINIStr, etc.

$OUTDIR esta variables guarda el directorio actual de salida.

Existen otras que puedes consultar en el manual

Constantes:
$PROGRAMFILES esta contante guarda la ruta predeterminada de archivos de de programas, por
ejemplo C:archivos de de programas

$DESKTOP la ruta del escritorio.

${NSISDIR} contiene la ruta donde se instalo NSIS.

$WINDIR Contiene la ruta de windows p.j C:windows o c:winnt

$SYSDIR Contiene las ruta de los archivos de sistemas C:windowssystem o C:winntsystem32

$TEMP Ruta de los archivos temporales C:windowstemp

$STARTMENU Men de inicio que se utiliza para crear los accesos directos a los programas que
instalemos.

$SMPROGRAMS es el equivalente a $STARTMENUProgramas

$SMSTARTUP equivalente a $SMPROGRAMSinicio

$DOCUMENTS la ruta de mis documentos C:Documents and SettingsmartinMis documentos

Otras constantes: $FAVORITES, $MUSIC, $PICTURES, $VIDEOS, $NETHOOD, $FONTS,
$TEMPLATES, etc

Paginas:
Se pueden mostrar varios tipos de pantallas de las siguientes:

Pagina de bienvenida

!insertmacro MUI_PAGE_WELCOME


Pgina donde mostramos el contrato de licencia

!insertmacro MUI_PAGE_LICENSE "licencia.txt"


Pgina donde se muestran las distintas secciones definidas

!insertmacro MUI_PAGE_COMPONENTS


Pgina donde se selecciona el directorio donde instalar nuestra aplicacin

!insertmacro MUI_PAGE_DIRECTORY


Pgina de instalacin de ficheros

!insertmacro MUI_PAGE_INSTFILES


Pgina final

!insertmacro MUI_PAGE_FINISH


Secciones.
Las secciones son para personalizar varias opciones que pueden instalar, como libreras o
componentes de forma opcional y necesaria.



Section "Mi programa"
SetOutPath $INSTDIR
File "MiProgram.exe"
File "Leerme.txt"
SectionEnd



Dentro de las secciones programaremos las instrucciones que se ejecutan en tiempo de ejecucin,
algunas de las operaciones que se hacen en las sesiones es crear, copiar, borrar archivos, tambin se
puede escribir y leer el registro de sistema.

Funciones.
Tambin se pueden crear funciones que se puede llamar desde las secciones, estas pueden ser
llamadas con el comando calll y hay otras que pueden ser lanzadas por algn evento.

Ejemplo:


Function funcion
# comandos
FunctionEnd

Section
Call funcion
SectionEnd



Funciones llamadas por eventos.


.onGUIInit, .onInit, .onInstFailed, .onInstSuccess, .onGUIEnd, .onMouseOverSection, .onRebootFailed,
.onSelChange, .onUserAbort y .onVerifyInstDir



Tambin para la aplicacin de desinstalacin se pueden utilizar las siguientes:
un.onGUIInit, un.onInit, un.onUninstFailed, un.onUninstSuccess, un.onGUIEnd,
un.onRebootFailed y un.onUserAbort

Se pueden utilizar de la siguiente manera:

Para mandar un mensaje de advertencia cuando se quiere abortar la aplicacion.



Function .onUserAbort
MessageBox MB_YESNO "Abortar...?" IDYES NoCancelAbortar
Abort
NoCancelAbortar:
FunctionEnd



En la desinstalacin seria:


Function un.onUserAbort
MessageBox MB_YESNO "Abortar..." IDYES NoCancelAbortar
Abort
NoCancelAbortar:
FunctionEnd



Atributos.
Los atributos son los que determinan el comportamiento de nuestro instalador. Con estos atributos
podemos cambiar los mensajes durante la instalacin.

Algunos atributos:

Name
Define el nombre de la aplicacin

Icon
Icono para la aplicacin de instalacin

InstallDir
Ser el directorio elegido para instalar la aplicacin.

Existen muchos atributos que puden consultar en el manual

Intrucciones basicas.
Las instrucciones que se pueden realizar en NSIS son las siguientes:

Borra un archivo:


Delete $INSTDIRfile.dat



Ejecutar un comando:


Exec '"$INSTDIRsomeprogram.exe"'
Exec '"$INSTDIRsomeprogram.exe" parametros '



Abrir una direccion web, un archivo y imprimir un archivo


ExecShell "open" "http://nsis.sf.net/"
ExecShell "open" "$INSTDIRreadme.txt"
ExecShell "print" "$INSTDIRreadme.txt"



Crear archivos


File something.exe
File /a something.exe
File *.exe
File /r *.dat
File /r data



Renombrar archivos

Rename $INSTDIRfile.ext $INSTDIRfile.dat


Borra un directorio


RMDir $INSTDIR
RMDir $INSTDIRdata



Existen otras instrucciones que s epuede consultar en el manual...

Tambin existen instrucciones para realizar operaciones con el registro del sistema y archivos INI.

Bueno creo que es un lenguaje stript muy completo para crear aplicaciones de instalacin
totalmente a la medida de un programador.

Veamos el cdigo fuente de la aplicacin de instalacin de mygcrypter 1.0

Declaremos algunas defecciones para nuestra aplicacin


!define APPNAME "mygcrypter"
!define APPNAMEVER "${APPNAME} 1.0"
!define SHCNE_ASSOCCHANGED 0x08000000
!define SHCNF_IDLIST 0



Cargamos la libreras de cabecera para utilizar una interfaz moderna.



!include "MUI.nsh"
!include "${NSISDIR}ContribModern UISystem.nsh"


Declaramos algunas variables que utilizaremos
Var MUI_TEMP
Var STARTMENU_FOLDER

Personalizamos la aplicacin

Name "${APPNAMEVER}" ;Nombre de programa
OutFile "Setup-${APPNAME}.exe" ;Nombre de programa en exe
InstallDir "$PROGRAMFILESMygnet${APPNAME}" ;Dir donde se instalara
InstallDirRegKey HKCU "Software${APPNAME}" ""


Configuracin de la Interfaz
!define MUI_ABORTWARNING
!define MUI_COMPONENTSPAGE_SMALLDESC
!define MUI_ICON "install.ico"
!define MUI_UNICON "install.ico"
!define MUI_HEADERIMAGE
!define MUI_HEADERIMAGE_BITMAP "install.bmp"
!define MUI_HEADERIMAGE_UNBITMAP "uninstall.bmp"
!define MUI_WELCOMEFINISHPAGE_BITMAP "wizard.bmp"
!define MUI_UNWELCOMEFINISHPAGE_BITMAP "wizard.bmp"
!define MUI_LICENSEPAGE_CHECKBOX
!define MUI_FINISHPAGE_RUN "$INSTDIR${APPNAME}.exe"
!define MUI_FINISHPAGE_SHOWREADME "$INSTDIR${APPNAME}.html"
!define MUI_FINISHPAGE_LINK " mygnet.com "

Paginas en la instalacin

!insertmacro MUI_PAGE_WELCOME

!insertmacro MUI_PAGE_LICENSE "licencia-es.rtf"

!insertmacro MUI_PAGE_COMPONENTS


!insertmacro MUI_PAGE_DIRECTORY


!define MUI_STARTMENUPAGE_REGISTRY_ROOT "HKCU"
!define MUI_STARTMENUPAGE_REGISTRY_KEY "Software${APPNAME}"
!define MUI_STARTMENUPAGE_REGISTRY_VALUENAME "Start Menu Folder"

!insertmacro MUI_PAGE_STARTMENU Application $STARTMENU_FOLDER

!insertmacro MUI_PAGE_INSTFILES


!insertmacro MUI_PAGE_FINISH


Paginas de desinstalacin
!insertmacro MUI_UNPAGE_WELCOME
!insertmacro MUI_UNPAGE_CONFIRM
!insertmacro MUI_UNPAGE_INSTFILES
!insertmacro MUI_UNPAGE_FINISH

Definir el idioma
!insertmacro MUI_LANGUAGE "English"
!insertmacro MUI_LANGUAGE "Spanish"
!insertmacro MUI_RESERVEFILE_LANGDLL

Tipos de instalacin
LangString COMPLETA ${LANG_SPANISH} "Completa"
LangString COMPLETA ${LANG_ENGLISH} "Full"
LangString MINIMA ${LANG_SPANISH} "Optima"
LangString MINIMA ${LANG_ENGLISH} "optimal"

InstType $(COMPLETA)
InstType $(MINIMA)

Secciones de los componentes de la aplicacion
Section "Mygcrypter" Sec_myg
SectionIn RO
SetOverwrite on
SetOutPath "$INSTDIR"

Instalar archivos
File "MSVBVM60.DLL"
File "COMDLG32.OCX"
File "${APPNAME}.exe"
File "mygnet.dll"
File "ico.ico"
File "go.html"

Crear acceso directo
CreateShortCut "$DESKTOP${APPNAME}.lnk" "$INSTDIR${APPNAME}.exe"

Escribir en el registro del sistema
WriteRegStr HKCR ".mcr" "" "mcrfile"
WriteRegStr HKCR "mcrfile" "" "${APPNAME} Config File"
WriteRegStr HKCR "mcrfileDefaultIcon" "" "$INSTDIRico.ico"
WriteRegStr HKCR "mcrfileshell" "" "Abrir"
WriteRegStr HKCR "mcrfileshellAbrircommand" "" '"$INSTDIR${APPNAME}.exe" "%1"'

Crear la aplicacin de desintalacion
WriteUninstaller "$INSTDIRUninstall.exe"
!insertmacro MUI_STARTMENU_WRITE_BEGIN Application

Crear acceso directos
CreateDirectory "$SMPROGRAMS$STARTMENU_FOLDER"
CreateShortCut "$SMPROGRAMS$STARTMENU_FOLDERUninstall.lnk"
"$INSTDIRUninstall.exe"
CreateShortCut "$SMPROGRAMS$STARTMENU_FOLDER${APPNAME}.lnk"
"$INSTDIR${APPNAME}.exe"
!insertmacro MUI_STARTMENU_WRITE_END
SectionEnd

SubSection "php_mygnet"
Section "php_mygnet.dll" LibDLL
SectionIn 1
SetOverwrite on
SetOutPath "$INSTDIR"
File "php_mygnet.dll"
SectionEnd
Section "php_mygnet.pdf" ManMYG
SectionIn 1
SetOverwrite on
SetOutPath "$INSTDIR"
File "php_mygnet.pdf"
SectionEnd
SubSectionEnd

Section "Uninstall"
Delete "$INSTDIRUninstall.exe"
Delete "$INSTDIRmygnet.dll"
Delete "$INSTDIR${APPNAME}.exe"
Delete "$INSTDIRMSVBVM60.DLL"
Delete "$INSTDIRCOMDLG32.OCX"
Delete "$INSTDIRphp_mygnet.dll"
Delete "$INSTDIRphp_mygnet.pdf"
Delete "$INSTDIRico.ico"
Delete "$INSTDIRgo.html"

RMDir "$INSTDIR"
Delete "$DESKTOPmygcrypter.lnk"

!insertmacro MUI_STARTMENU_GETFOLDER Application $MUI_TEMP
Delete "$SMPROGRAMS$MUI_TEMPUninstall.lnk"
Delete "$SMPROGRAMS$MUI_TEMP${APPNAME}.lnk"


Eliminar todo eldirectorio



StrCpy $MUI_TEMP "$SMPROGRAMS$MUI_TEMP"
startMenuDeleteLoop:
ClearErrors
RMDir $MUI_TEMP
GetFullPathName $MUI_TEMP "$MUI_TEMP.."
IfErrors startMenuDeleteLoopDone
StrCmp $MUI_TEMP $SMPROGRAMS startMenuDeleteLoopDone startMenuDeleteLoop
startMenuDeleteLoopDone:
DeleteRegKey HKCR ".mcr"
DeleteRegKey HKCR "mcrfile"
DeleteRegKey HKCR "mcrfile"
DeleteRegKey HKCR "SOFTWAREmicrosoftInternet ExplorerExtensions{8491AFCD-14CE-449B-
A4F8-0AA5AF2B66DB}"
DeleteRegKey /ifempty HKCU "Software${APPNAME}"
SectionEnd



Funciones



Function .onInit
!insertmacro MUI_LANGDLL_DISPLAY
FunctionEnd

Function .onInstSuccess
System::Call 'shell32.dll::SHChangeNotify(i, i, i, i) v (${SHCNE_ASSOCCHANGED},
${SHCNF_IDLIST}, 0, 0)'
ExecShell "open" "http://mygnet.com/"
FunctionEnd

Function un.onInit
!insertmacro MUI_UNGETLANGUAGE
FunctionEnd

<strong>Asignacin de la descripcin de la secciones</strong>
LangString DESC_MYG ${LANG_SPANISH} "Instalacin de mygnet_lib"
LangString DESC_MYG ${LANG_ENGLISH} "Install mygnet_lib"
LangString DESC_DLL ${LANG_SPANISH} "Libreria php_mygnet.dll"
LangString DESC_DLL ${LANG_ENGLISH} "Library php_mygnet.dll"
LangString DESC_MAN ${LANG_SPANISH} "Manual php_mygnet"
LangString DESC_MAN ${LANG_ENGLISH} "Manual php_mygnet"

!insertmacro MUI_FUNCTION_DESCRIPTION_BEGIN
!insertmacro MUI_DESCRIPTION_TEXT ${Sec_myg} $(DESC_MYG)
!insertmacro MUI_DESCRIPTION_TEXT ${LibDLL} $(DESC_DLL)
!insertmacro MUI_DESCRIPTION_TEXT ${LibSO} $(DESC_SO)
!insertmacro MUI_DESCRIPTION_TEXT ${manMYG} $(DESC_MAN)
!insertmacro MUI_FUNCTION_DESCRIPTION_END



Esta es la la aplicacin de instalacin:

Elegir el idioma de la instalacin.


Pantalla de bienvenida.


Pantalla de licencia.


Pantalla de componentes.


Pantalla para elegir el directorio.


Pantalla para elegir el grupo de mens.


Pantalla final


Lanza la aplicacin.


Si quieres el cdigo fuente del script de instalacin lo puedes descargar en la siguiente direccin:
http://www.mygnet.net/it/descargas/codigos/script_de_instalacion_de_mygcrypter_1_dot_0.14
83.zip

Referencias:
nsis.sourceforge.net/Docs/

Un saludo.

Votar:
10 votos, 48%
Pginas:
1
|
2

Agregar comentario
16.- teecweb
Jueves 14 de febrero de 2013 a las 07:42

al compilar su ejemplo me sale este error


Processing script file: "C:\Documents and Settings\User\Escritorio\p1.nsi"
!include: "C:\Archivos de programa\NSIS\Include\MUI.nsh"
!include: "C:\Archivos de programa\NSIS\Contrib\Modern UI\System.nsh"
NSIS Modern User Interface version 1.8 - Copyright 2002-2009 Joost Verburg (C:\Archivos de
programa\NSIS\Contrib\Modern UI\System.nsh:8)
!define: "MUI_INCLUDED"=""
!define: "MUI_SYSVERSION"="1.8"
!define: "MUI_VERBOSE"="3"
!include: closed: "C:\Archivos de programa\NSIS\Contrib\Modern UI\System.nsh"
!include: closed: "C:\Archivos de programa\NSIS\Include\MUI.nsh"
!define: "NOMBRE"="Mi Aplicacion"
!define: "VERSION"="1.0"
Name: "Mi Aplicacion 1.0"
OutFile: "mySetup.exe"
SetCompressor: LZMA
!insertmacro: MUI_LANGUAGE
!insertmacro: end of MUI_LANGUAGE
!insertmacro: MUI_PAGE_DIRECTORY
!insertmacro: end of MUI_PAGE_DIRECTORY
!insertmacro: MUI_PAGE_INSTFILES
!insertmacro: end of MUI_PAGE_INSTFILES
Section: "myApli" ->(myApli)
SetOutPath: "$INSTDIR"
File: "myaplicacion.exe" -> no files found.
Usage: File [/nonfatal] [/a] ([/r] [/x filespec [...]] filespec [...] |
/oname=outfile one_file_only)
Error in script "C:\Documents and Settings\User\Escritorio\p1.nsi" on line 18 -- aborting creation
process

Editar | Responder
15.- ELIZABETH
Mircoles 13 de febrero de 2013 a las 19:19

HOLAS!
CONSULTA :HAN HECHO INSTALADORES EN VISUAL BASIC 2008..VISUAL BASIC TIENE PARA HACER
SUS PROPIOS INSTALADORES EN FORMA ESTANDAR TAMBIEN PARA REALIZAR OPCIONES
PERSONALIZADAS..PERO POR LOEH ESTADO VIENDO ES MUY LIMITADO..BUENO LO QUE NECESITO
ES DONDE EL INSTALADOR DETECTE SI HAY UNA VERSION YA INSTALADA ENTONCES APRECERA
UNA VENTANA PREGUNTADNO SI DESEA MANTENER VERSIONES ANTERIORES O DESEA
ELIMINARLO..EN CASO QUE DE "SI"
SE MANTENDRA LAS VERSIONES ANTERIORES Y CREARA UNA NUEVA CARPETA Y EN CASO QUE DE
"NO"..NO SE ELIMINARA LAS VERSIONES ANTERIORES Y CREARA UNA CARPETA DE LA
INSTALACION...BUENO ESO ES BASICAMENTE LO QUE REQUIERO..,,MI PREGUNTA ES COMO HACER
ESO CON NSIS EN REALIDAD NO TENGO IDEA......YO LO EH ESTADO DESARROLLANDO CON LAS
MISMAS OPCIONES QUE PRESENTA EL INSTALADOR DE VISUAL BASIC PERO NO ES TAN
FLEXIBLE..OJALA ME RESPONDAN..PORQUE EH PREGUNTADO A VARIOS BOGLER Y NO ME
RESPONDEN

NOTA EH ESTADO HACIENDO PRUEBAS CON EL EJEMPLO KE ENVIO PERO SALE UN ERROR AL
COMPILAR

Unable to initialize MakeNSIS. Please verify that makensis.exe is in the same directory as
makensisw.exe.

PORFAVOR RESPONDAN..GRACIAS

Editar | Responder
14.- dares
Mircoles 29 de junio de 2011 a las 04:26

Muy buenas Amigo
Sigo desde hace tiempo esta aplicacin pero tengo un problema, tengo un cliente de 8Gb, comprimido
me queda en 3,4Gb.
Como puedo hacer para que nsis, no me rompa al crear el fichero, si quieres te puedo poner el cdigo
que uso,
Un saludo y muchas gracias

Editar | Responder
13.- Tais Giomar
Jueves 14 de enero de 2010 a las 00:04

Bueno es muy interesante este aoporte muchas gracias por el articulo, pero quisiera saber si a mi
programa de instalacion generado por este software se puede agregar una clave para la instalacin de
mi instalador

Editar | Responder
12.- Julian
Mircoles 18 de junio de 2008 a las 07:04

buen dia,
Quisiera saber como puedo hacer con NSIS para copiar un folder completo..tengo un problema y es
que tengo en un folder varios archivos de diversas extensiones y no quiero copiar archivo por archivo
sino que quiero copiar todo el folder completo...si alguien me puede ayudar se lo agradezco...
Muchas gracias...

Editar | Responder
12.1.- annimo
Viernes 10 de junio de 2011 a las 10:20

File folder*

Saludos

Editar | Responder
11.- Manuel
Martes 08 de mayo de 2007 a las 11:56

Hola Amigo, es muy bueno tu manual, quisiera hacerte una cinsulta, necesito copiar un archivo segun
sea el caso, ejemplo. 1. si es superusuario copia archivo normal.doc (50b) 2. si es usuario normal
copia archivo normal.doc(15Kb) como haria eso? como copiaria ese archivo