Skip to main content

基于LSCloud的包管理使用指南

使用前准备#

我们将会在这个文档中创建一个基于LSCloud的lisa包,并创建一个项目,对该包进行依赖使用。

环境准备#

方式一:在LStudio中进行使用(推荐)#

方式二:搭建本地开发环境#

如果你因为其他原因无法安装LStudio,你可以按照下列步骤进行搭建本地开发环境:

1、确保你安装了较新版本的Node.js。

2、全局安装yarn。

npm install yarn -g

3、全局安装lisa。

npm install @listenai/lisa -g

4、配置LISA_ACCESS_TOKEN环境变量。

The fallback content to display on prerendering


5、安装git环境。

创建一个基于LSCloud的lisa包#

1、使用lisa创建一个包,可移步到开发者新手教程:从零开发一个lisa包

2、在LSCLoud创建一个项目。该项目请确保在正确的组下。(本指南为方便演示,会在个人组进行创建)

(1)在LSCloud的右上角,点击新建项目

(2)输入你的项目名称,选择该包所在的组,以及可见性级别选择私有。

3、上传发布你的lisa包到LScloud。

(1)在终端,按LSCloud的提示,进行推送:

如果上面的命令你都能顺利通过,此时在LSCloud的项目便已经初始化好你的lisa包。

4、发布一个版本。

(1)在LSCloud刚推上去的项目,点击发布

(2)输入版本号,这里需要填写满足semver规范的,方便我们进行版本管理

(3)点击发布后,能成功看到一条该版本的发布在列表里

创建一个lisa项目,并使用LSCloud上的lisa包作为依赖。#

1、创建一个文件夹,并进行lisa init初始化。

2、在终端执行lisa install xxx安装LSCloud上的lisa包。

lisa install git+https://cloud.listenai.com/listenai_zbzhao/test-lscloud-pkg.git#semver:^1.0.0

可以看到,install后面的包格式为 git+{包的地址}#semver:{版本}

包的地址可以在LSCloud该项目进行查看

warning

这里建议使用https的包地址进行install。

安装LSCloud所有的lisa包都需要你的聆思账号有权限在LSCloud查看该包。

3、如果上面的命令能成功执行,恭喜你,你已经能够使用该包了,可以在package.json查看你刚刚install的包。

更新包#

当你的包有需要更新时,正常使用git的操作,推到LSCloud上,然后重复文档中的发布流程在LSCloud里进行发布即可。

本地的git聆思账号权限配置#

1、先查看你本机的git的配置文件。

git config --global -l --show-origin

如图,配置文件的路径为 C:/Users/geekz/.gitconfig

2、修改配置文件,添加一条helper

helper = store --file ~/.git-credential

此处为了不影响原有的helper,需要手动自行添加。当存在多个helper时,git的账号验证会按照顺序加载。

3、往 ~/.git-credential 文件添加LSCloud的账号密码

格式:https://{username}:{password}@cloud.listenai.com

https://listenai_zbzhao:testtest@cloud.listenai.com
  • 没帮助 0