跳转到内容

net.http ​

此模块提供http的各种操作支持,目前提供的接口如下:

http.download ​

  • 下载http文件

函数原型 ​

API

lua
http.download(url: <string>, outputfile: <string>, opt: <table>)

参数说明 ​

参数描述
url必需。要下载的URL地址
outputfile必需。输出文件路径
opt可选。选项参数,支持以下选项:
- headers - HTTP头信息
- timeout - 超时时间
- useragent - 用户代理

返回值说明 ​

类型描述
boolean下载成功返回 true,失败返回 false

用法说明 ​

这个接口比较简单,就是单纯的下载文件。

lua
import("net.http")

http.download("https://xmake.io", "/tmp/index.html")

选择下载工具 v3.1.2 ​

lua
import("net.http")
http.download("https://xmake.io", "index.html", {downloader = "curl"})

支持 aria2、curl、wget、powershell 和 pwsh。 选择顺序为调用选项、可用的命令行 downloader 选项、全局配置、XMAKE_DOWNLOADER 环境变量。 也可执行 xmake g --downloader=curl 设置全局默认值。 显式选定工具后,工具缺失或下载失败会报错,不会自动切换到其他后端。 未指定时仍按默认顺序选择可用工具。