V语言学习笔记-26包管理器

包管理器

模块就是包,两个所指的含义完全一样

vpm是v的包管理器,采用集中式的包服务器,所有第三方模块全部要发布模块到https://vpm.best/网站提供给别人使用

上传模块

登录https://vpm.best

然后github账号集成登录,就可以上传自己的第三方模块

安装模块

v install nedpals.args //使用作者账号的名称作为路径,用点号分隔
v install regex

执行完毕后,会把包下载到~/.vmodules目录中

~/.vmodules/nedpals/args

~/.vmodules/regex

使用的时候import regex就可以了,v会到~/.vmodules中查找对应的包

如果是从git直接下载的源代码,或者作者没有上传包到vpm上,也可以使用创建link链接的方式,把目录链接创建到~/.vmodules目录中

git clone https://github.com/xxx //下载源代码
ln -s xxx ~/.vmodules/xxx //创建目录链接,记得使用绝对路径

常用的模块管理命令:

v search xxx //搜索指定关键字的包
v intall xxx //安装包
v update xxx //升级包
v remove xxx //删除包

模块搜索路径

当使用import xxx导入模块时,编译器会按以下顺序搜索模块:

1. 当前编译文件所在的目录

2. v编译器vlib目录中的标准模块

3. 如果有指定-vpath参数,则使用vpath目录;如果没有指定-vpath参数,则使用通过vpm安装到~/.vmodules目录中的第三方模块

4. 如果有指定-user_mod_path参数,则使用该目录

一般来说,vpath和user_mod_path参数都很少额外配置,所以模块搜索路径就是前3个路径

模块描述文件

vpm使用v.mod作为模块描述文件,json格式:

Module {
        name: 'ui'
        author: 'medvednikov'
        version: '0.0.1'
        repo_url: 'https://github.com/vlang/ui'
        vcs: 'git'
        tags: ['gui','user interface']
        description: 'V UI is a cross-platform UI toolkit for Windows, macOS, Linux, and soon Android, iOS and the web (JS/WASM).'
        license: 'GPL3 + commercial'
}

跟node的package.json类似,然后把下载的包统一放到~/.vmodules文件夹中,同一个包区分版本,提供个本机的所有项目使用

创建模块项目:

v new //创建一个项目,根据提示输入项目名称,描述等,生成的项目目录带有v.mod

目前社区有2个人各自实现了2个包管理器,估计以后会合并进v标准的包管理

https://github.com/v-pkg/vpkg

https://github.com/yue-best-practices/vpm