Builtin NSISdl plug-in: Difference between revisions

From NSIS Wiki
Jump to navigationJump to search
No edit summary
(HTTPS limitations and warnings moved to proper section)
 
(7 intermediate revisions by 6 users not shown)
Line 1: Line 1:
{{DEFAULTSORT:NSISdl plug-in}}
[[Category:Plugins]]
[[Category:Plugins]]
== Introduction ==
== Introduction ==
This built-in plugin allows you to download files via HTTP.
This built-in plugin allows you to download files via HTTP ('''but not HTTPS''').


== Supported ==
== Supported ==
Line 19: Line 20:
There are two methods. The first downloads the file:
There are two methods. The first downloads the file:


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


And the second downloads it without warnings:
And the second downloads it without warnings:
Line 25: Line 26:
   NSISdl::download_quiet http://download.nullsoft.com/winamp/client/winamp291_lite.exe $0
   NSISdl::download_quiet http://download.nullsoft.com/winamp/client/winamp291_lite.exe $0


where $0 is the name of the local file.
where <code>$0</code> is the name of the local file.


For further usage instructions see Docs\NSISdl\ReadMe.txt.
For further usage instructions see [http://nsis.sourceforge.net/Docs/NSISdl/ReadMe.txt Docs\NSISdl\ReadMe.txt], [[NSISdl deletes file(s) when offline]], [[NSISdl macro system]].
 
== Limitations and warnings ==
 
* Has a verified risk of causing a false positive for "generic downloader trojan" in Kasperky antivirus software.
* Even if you specify a HTTPS link, this plugin will download via HTTP. If your link is redirected from HTTP to HTTPS via a server-sent HTTP header, you will encounter a timeout error. You might want to use the [[Inetc plug-in]] instead.


== Header file with various translations ==
== Header file with various translations ==

Latest revision as of 14:27, 9 February 2018

Introduction

This built-in plugin allows you to download files via HTTP (but not HTTPS).

Supported

To find out whether your NSIS installation supports NSISdl, just compile a script. If NSISdl is listed in the compiler log, it is supported.

 Processing config: 
 Processing plugin dlls: "C:\Program Files\NSIS\Plugins\*.dll"
  - AdvSplash::show
  - Banner::destroy
  - Banner::getWindow
  :
  - NSISdl::download
  - NSISdl::download_quiet
  :

Standard usage instructions

There are two methods. The first downloads the file:

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

And the second downloads it without warnings:

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

where $0 is the name of the local file.

For further usage instructions see Docs\NSISdl\ReadMe.txt, NSISdl deletes file(s) when offline, NSISdl macro system.

Limitations and warnings

  • Has a verified risk of causing a false positive for "generic downloader trojan" in Kasperky antivirus software.
  • Even if you specify a HTTPS link, this plugin will download via HTTP. If your link is redirected from HTTP to HTTPS via a server-sent HTTP header, you will encounter a timeout error. You might want to use the Inetc plug-in instead.

Header file with various translations

Deguix has made a NSISdl header file which features various translations.

So far it has been translated into eight languages:

  • English
  • Portuguese
  • Lithuanian
  • German
  • Chinese Traditional
  • Simplified Chinese
  • Croatian
  • French

For further information and current version visit this thread: Forum-Thread