包管理器

模块就是包,两个所指的含义完全一样,包管理器也叫模块管理器.

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

上传模块

登录https://vpm.best,使用github账号集成登录,就可以上传自己的第三方模块.

安装模块

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

如果设置了环境变量VMODULES,则会安装到VMODULES环境变量指向的目录.

如果没有设置环境变量,mac/linux系统会下载到:~/.vmodules目录中,windows系统会把包下载到:C:\Users\xxx\ .vmodules目录中.

1. ~/.vmodules/nedpals/args

3. ~/.vmodules/regex

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

如果是从git直接下载的源代码,或者作者没有上传包到vpm上,

也可以使用创建link链接的方式,把目录链接创建到~/.vmodules目录中:

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

常用的模块管理命令:

1. v search xxx //搜索指定关键字的包
2. v intall xxx //安装包
3. v update xxx //升级包
4. v remove xxx //删除包
5. v update xxx //升级指定已安装的包
6. v upgrade         //升级所有已安装的包
7. v list             //列出所有已安装的包
8. v outdated     //列出所有过时需要升级的包

模块描述文件

vpm使用v.mod作为模块描述文件, json格式,跟node的package.json类似.

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

创建模块项目

1. v new //创建一个新项目,根据提示输入项目名称,描述等,生成的项目目录带有v.mod
2. v new <project_name> <description> <version> <license>
3. v init //把当前目录作为项目，创建项目v.mod

解析模块描述文件

可以在代码中导入v.mod模块来解析v.mod.

通过vmod.decode进行解码,这样就可以根据v.mod文件的内容方便实现各种库功能.

1. import v.vmod
2. vm := vmod.decode( @VMOD_FILE ) or { panic(err) } //@VMOD_FILE是内置的全局变量,返回v.mod文件内容,字符串类型
3. eprintln('$vm.name $vm.version\n $vm.description')

标准模块缓存

V编译器默认会启用vlib标准库的缓存,编译一次标准模块后会缓存在~/.vmodules/cache中,缩短编译时间.

模块存储方式

使用vpm工具下载第三方依赖包时,包会统一放到VMODULES文件夹中,同一个包会区分版本,不同版本存放在不同目录,提供给本机的所有项目使用.