如何在Gitee上发布OpenHarmony应用第三方库

系统 OpenHarmony
npm是js的包管理器,通过npm我们可以来管理OpenHarmony第三方库

​想了解更多内容,请访问:​

​51CTO OpenHarmony技术社区​

​https://ost.51cto.com​

npm是js的包管理器,通过npm我们可以来管理OpenHarmony第三方库。

这里以eTS组件为例:

创建本地组件

IDE:DevEco Studio 3.0.0.900。

首先我们新建项目。

选择API 8,eTS。

等待项目完成。

我们可以看到在entry目录下,有个package.json文件,我们的第三方库都是会使用npm命令安装在entry下。

接下来我们要创建自己的第三方组件了,我们新建一个module。

选择Ohos Library。

给module起个名字,这里我就叫test了,选择eTS,Finish。

我们可以看到在新的module下面有个index.ets文件,用来导出我们的组件。

这里我重新写了下MainPage.ets组件,组件可以使用Previewer进行预览。

@Entry
@Component
export struct MainPage {
build() {
Column().height(100).width(100).backgroundColor(Color.Blue)
}
}

我们的组件是一个100X100的蓝色小块。

怎么使用我们本地的这个组件呢?我们在entry/src/main/ets/MainAbility/pages/index.ets文件中。

import { MainPage } from '../../../../../../test/index'

// 也可以使用 import { MainPage } from 'test/index'
// 也可以正常预览,但是会报错,建议还是采取相对路径形式

@Entry
@Component
struct Index {
build() {
Row() {
// 我们的组件
MainPage()
}
.height('100%')
}
}

看看效果,组件可以正常使用。

接下来就是发布这个组件了。

创建Gitee项目

登录我们的Gitee,新建仓库用来发布我们的组件。

初始化仓库。

不需要添加.gitignore,如果添加了请删掉。

添加README文件。

初始仓库都是私有的,我们需要进入管理页面。

将仓库设为开源。

获取仓库地址,这里我的地址是https://gitee.com/hytyj_hamstermie/ohos-test.git。

发布组件到Gitee

进入我们test modules目录,这就是我们需要发布的内容。

我们首先需要修改我们的package.json。

{
"name": "@ohos/test",
# 添加作者
"author": "talkweb_tiantianjiang",
# 自己可以修改描述
"description": "a npm package which contains arkUI2.0 page",
"ohos": {
"org": ""
},
# 这里是第一个版本所以是1.0.0
"version": "1.0.0",
"main": "index.ets",
"types": "",
# 这里是我们的Gitee库地址
"repository": {
"type": "git",
"url": "https://gitee.com/hytyj_hamstermie/ohos-test.git"
},
# license保持与Gitee库一致
"license": "Apache License 2.0",
"dependencies": {}
}

接下来我们在这个目录下直接新建git仓库。

推荐Git Bash与TortoiseGit。

TortoiseGit真的很方便。

右键Git Bash Here。

执行命令:

$ git init

关联gitee仓:

$ git remote add origin https://gitee.com/hytyj_hamstermie/ohos-test.git

将所有文件添加至缓存区。

$ git add .

第一次强制拉取远程仓master分支。

$ git pull origin master --allow-unrelated-histories

提交我们的代码到缓存区。

$ git commit -m '第一次版本提交'

可以看到我们本地有一个master分支。

$ git branch
* master

发布我们的代码到gitee仓master分支。

$ git push origin master

NPM本地安装组件

请不要在DevEco IDE中添加第三方库。

命令行进入项目entry目录,执行npm命令:

npm install git+https://gitee.com/hytyj_hamstermie/ohos-test.git

在IDE中可以查看到变化,点击Sync Now。

我们在entry/src/main/ets/MainAbility/pages/index.ets文件中修改组件的引用路径。

import { MainPage } from '@ohos/test'
@Entry
@Component
struct Index {
build() {
Row() {
MainPage()
}
.height('100%')
}
}

复制重启previewer可以查看到组件已经可以使用了。

新IDE有点问题,若无法显示或者无法看到更新内容:

1、删除.preview文件夹后,重启previewer。

2、重启IDE。

组件版本管理

这里为了展示我先建立两个版本分支。

  • 1.0.0
  • 1.0.1
# 新建并切换分支1.0.0
$ git checkout -b 1.0.0
# 提交1.0.0分支
$ git push origin 1.0.0
# 新建并切换分支1.0.1
$ git checkout -b 1.0.1

我们修改分支1.0.1下的内容:

package.json:

{
...
"version": "1.0.1"
...

}

entry/src/main/ets/MainAbility/pages/index.ets。

把方块改成红色400X400。

@Entry
@Component
export struct MainPage {
build() {
Column().height(400).width(400).backgroundColor(Color.Red)
}
}

提交分支。

$ git commit -am "版本1.0.1"
$ git push origin 1.0.1

在Gitee上可以看到两个分支。

接下来我们来安装1.0.1版本的组件。

npm install git+https://gitee.com/hytyj_hamstermie/ohos-test.git#1.0.1

删除.preview文件,后重启previewer。

​想了解更多内容,请访问:​

​51CTO OpenHarmony技术社区​

​https://ost.51cto.com​

责任编辑:jianghua 来源: 鸿蒙社区
相关推荐

2022-01-14 09:57:14

鸿蒙HarmonyOS应用

2019-07-30 11:35:54

AndroidRetrofit

2015-11-05 16:44:37

第三方登陆android源码

2017-05-16 13:24:02

LinuxCentOS第三方仓库

2013-01-09 10:32:32

Windows 8应用迁移

2013-08-12 16:04:19

第三方移动应用

2022-05-21 23:56:16

Python库搜索Python

2014-07-22 10:56:45

Android Stu第三方类库

2015-04-27 19:32:16

Moxtra

2014-07-25 09:33:22

2020-12-08 09:53:46

Fedora软件第三方存储库

2014-07-23 08:55:42

iOSFMDB

2012-08-03 09:44:11

iOS 6苹果地图

2011-07-25 14:14:49

iPhone SQLITE Pldatabase

2010-03-03 15:10:49

第三方Python库

2013-08-14 09:50:32

iOS类库

2012-05-24 21:59:55

iOS

2023-07-26 08:21:33

2023-02-07 15:43:13

三方库适配鸿蒙

2010-08-31 17:12:13

点赞
收藏

51CTO技术栈公众号