目錄

一思恐、ohpm-repo搭建私倉

二胀莹、發(fā)布HAR包到ohpm-repo私倉

三涩僻、發(fā)布成功后HAR包的導(dǎo)入和使用

對于個(gè)人構(gòu)建的HAR靜態(tài)共享包，可以發(fā)布到官方OpenHarmony三方庫中心倉室抽，供他人使用。如果是公司業(yè)務(wù)相關(guān)的庫惑朦，并不想被外部人員使用病梢，可以在公司內(nèi)部使用ohpm-repo搭建一個(gè)私有倉庫供內(nèi)部人員使用觅彰，一來比較安全填抬，二來集成也比較快。

一读拆、ohpm-repo搭建私倉

1、node環(huán)境安裝

ohpm-repo 依賴于 node 運(yùn)行，支持 node.js 18.x 及以上版本芥喇，請?zhí)崆鞍惭b nodejs，并完成環(huán)境變量的配置武通。Node.js安裝請參考Node.js官方網(wǎng)站。
終端輸入以下命令校驗(yàn)node安裝版本 node -v

<git> node -v
v18.15.0

2、官方下載中心下載 ohpm-repo 私倉工具包链沼。

下載 ohpm-repo 私倉工具包

3、解壓下載好的ohpm-repo 私倉工具包，獲取以下文件目錄：

ohpm-repo文件目錄

4拾氓、將上圖bin目錄的路徑配置到系統(tǒng)環(huán)境變量path中：

• mac中打開環(huán)境變量配置文件

vim ~/.zshrc

• 將以下代碼粘到配置文件中

export PATH="/Users/xxx/ohpm-repo-5.0.7.0/bin:$PATH"

• 執(zhí)行命令保存配置文件

source ~/.zshrc

5、執(zhí)行以下命令孵奶，查詢版本:

<git> ohpm-repo -v                   
5.0.7

6了袁、修改私倉工具包中的配置 conf/config.yaml

路徑為：/Users/xxx/ohpm-repo-5.0.7.0/conf/config.yaml
我這里使用默認(rèn)本機(jī)數(shù)據(jù)調(diào)試粥诫，沒有做修改崭庸。參考官方：配置文件

listen: localhost:8088        # 建議修改為具體的ip:port
.
.
.

7、執(zhí)行安裝命令:

ohpm-repo install

輸出以下信息表示安裝成功：

<git> ohpm-repo install
[2024-11-15T15:16:07.410] [WARN] default - "listen" protocol is set to 'http' in "config.yaml" file, which is insecure, advise to use the more secure 'https' protocol instead.
[2024-11-15T15:16:07.425] [INFO] default - initialize encryption component successfully.
[2024-11-15T15:16:07.426] [INFO] default - initialize "file database" successfully.
[2024-11-15T15:16:07.428] [INFO] default - initialize "file storage" successfully.
[2024-11-15T15:16:07.433] [INFO] default - insert repo success: repo's id is 5cdc28ee00c1428991f25b82f48c3741.
[2024-11-15T15:16:07.434] [INFO] default - insert systemSecurity config success: support anonymous access to ohpm-repo.
[2024-11-15T15:16:07.434] [INFO] console - install successfully.
[2024-11-15T15:16:07.445] [INFO] default - set "deploy_root" environment variables successfully: "OHPM_REPO_DEPLOY_ROOT = /Users/xxx/ohpm-repo".
[2024-11-15T15:16:07.445] [INFO] console - to make the environment variables of "deploy_root" take effect, please run the refresh command: "source ~/.zshrc " or ". ~/.zshrc".

mac 會自動(dòng)設(shè)置環(huán)境變量

export OHPM_REPO_DEPLOY_ROOT=/Users/wxq/ohpm-repo

所以需要再執(zhí)行一下環(huán)境變量保存命令：

source ~/.zshrc

8执赡、執(zhí)行啟動(dòng)命令:

ohpm-repo start

輸出以下信息表示啟動(dòng)成功：

<git> ohpm-repo start  
[2024-11-15T15:18:34.073] [WARN] default - "listen" protocol is set to 'http' in "config.yaml" file, which is insecure, advise to use the more secure 'https' protocol instead.
[2024-11-15T15:18:34.074] [INFO] default - config file path: "/Users/xxx/ohpm-repo/conf/config.yaml".
[2024-11-15T15:18:34.076] [INFO] default - initialize "file database" successfully.
[2024-11-15T15:18:34.076] [INFO] default - initialize "file storage" successfully.
[2024-11-15T15:18:34.089] [INFO] console - http address - localhost:8088 - ohpm-repo/5.0.7.

此時(shí)在瀏覽器打開 http://localhost:8088/熬粗，會看到構(gòu)建好的私倉頁面：

ohpm-repo私倉頁面

ohpm-repo 首次啟動(dòng)時(shí)，默認(rèn)創(chuàng)建一個(gè)管理員賬號驻呐，賬號名稱：admin，密碼：12345Qq! 含末。該賬號在首次登錄時(shí)佣盒，需要修改其密碼，請修改密碼后，重新登錄該賬號:

ohpm-repo登錄admin后主頁面

二紊搪、發(fā)布HAR包到ohpm-repo私倉

提示：發(fā)布HAR包到ohpm-repo和發(fā)布到官方OpenHarmony三方庫中心倉是一樣的邏輯。

1全景、創(chuàng)建發(fā)布組織

當(dāng)想要上傳一個(gè)含有組織（例如@wxqos/wxqcolor）的包時(shí)，在ohpm-repo中需要先創(chuàng)建出該組織（例如wxqos）才能進(jìn)行上傳爸黄。和發(fā)布到官方OpenHarmony三方庫中心倉不同的是，這個(gè)組織創(chuàng)建后不用審核炕贵，直接就可以使用。具體的申請称开，請參考官方文檔：組織管理。

創(chuàng)建發(fā)布組織

2钥弯、利用工具ssh-keygen生成公、私鑰总处，可通過執(zhí)行以下命令來生成公鑰和私鑰:

ssh-keygen -m PEM -t RSA -b 4096 -f ~/.ssh_ohpm/mykey 

在命令執(zhí)行過程中，會讓你輸入一個(gè)密碼睛蛛，這個(gè)密碼是后面用來上傳包用的，一定要記滓渖觥！？透浴！

Enter passphrase (empty for no passphrase): 
Enter same passphrase again:

如果本地 ~/ 路徑下沒有隱藏文件夾.ssh_ohpm场仲，需要先手動(dòng)創(chuàng)建一個(gè)：cd到 ~/ 下，執(zhí)行 mkdir .ssh_ohpm渠缕。
執(zhí)行成功后會生成以下私鑰和公鑰文件：

公鑰和私鑰路徑

官方說明：

• ~/.ssh_ohpm/mykey 為私鑰文件 mykey 的文件路徑，按照實(shí)際情況指定馍忽。指定的私鑰存儲目錄必須存在棒坏≡馑瘢【解釋：生成的mykey為私鑰，存儲到本地】
• 追加了.pub后綴的相應(yīng)公鑰文件會存放在和私鑰相同的目錄下坐梯。【解釋：生成的mykey.pub為公鑰吵血，后面會將公鑰內(nèi)容復(fù)制到OpenHarmony三方庫中心倉官網(wǎng)中個(gè)人信息下偷溺，參考步驟3】
• OHPM包管理器只支持加密密鑰認(rèn)證蹋辅，請?jiān)谏晒借€時(shí)輸入密碼挫掏。【解釋：就是上面說的密碼尉共，后面上傳包的時(shí)候會用】

3、登錄OpenHarmony三方庫中心倉官網(wǎng)袄友，單擊主頁右上角的個(gè)人中心殿托，新增OHPM公鑰剧蚣，將公鑰文件（mykey.pub）的內(nèi)容粘貼到公鑰輸入框中。

添加公鑰

公鑰添加成功后顯示：

公鑰添加成功

4鸠按、打開命令行工具，將對應(yīng)私鑰文件路徑配置到 .ohpmrc 文件中 key_path 字段上目尖。

執(zhí)行以下命令進(jìn)行配置：

ohpm config set key_path  ~/.ssh_ohpm/mykey

在ohpmrc文件中會填充一條內(nèi)容馒吴，表示命令執(zhí)行成功：

key_path=/Users/xxx/.ssh_ohpm/mykey

ohpmrc文件路徑

5瑟曲、登錄OpenHarmony三方庫中心倉官網(wǎng)，單擊主頁右上角的個(gè)人中心测蹲，復(fù)制發(fā)布碼，獲取發(fā)布碼并配置到 .ohpmrc 文件中扣甲，可執(zhí)行如下命令：

ohpm config set publish_id your_publish_id

執(zhí)行完成后齿椅，會在步驟6中的 ohpmrc文件中會新增一條內(nèi)容：

publish_id=your_publish_id

將其中的 your_publish_id 替換成你在官網(wǎng)復(fù)制的發(fā)布碼（比如：5UABCDEFGH）即可启泣。
也可以直接執(zhí)行以下命令即可：

ohpm config set publish_id 5UABCDEFGH

復(fù)制發(fā)布碼

6涣脚、發(fā)布 HAR包

執(zhí)行 ''ohpm publish <HAR包路徑>'' 命令發(fā)布 HAR包寥茫，<HAR包路徑> 指向的文件后綴需為 .har 文件的具體路徑。例如執(zhí)行以下命令：

ohpm config set publish_registry http://localhost:8088/repos/ohpm
ohpm publish /Users/xxx/WXQHMProject/wxqcolor/build/default/outputs/default/wxqcolor.har

或在命令行中配置參數(shù) --publish_registry 使用纱耻，例如以下命令：

ohpm publish /Users/xxx/WXQHMProject/wxqcolor/build/default/outputs/default/wxqcolor.har --publish_registry http://localhost:8088/repos/ohpm

注意：其中會讓你輸入一個(gè)密碼，就是上面說的上傳包的密碼弄喘。

終端打印以下信息就表示發(fā)布完成了：

<git> ohpm publish /Users/wxq/DevEcoStudioProjects/WXQColorHM/wxqcolor/build/default/outputs/default/wxqcolor.har
registry:http://localhost:8088/repos/ohpm/

package:@wxqos/wxqcolor@1.0.0

=== Harball Contents ===
519B    BuildProfile.ets
66B     CHANGELOG.md
198B    Index.ets
587B    LICENSE
1004B   README.md
27B     ResourceTable.txt
500B    build-profile.json5
0B      consumer-rules.txt
234B    hvigorfile.ts
93.3kB  img.png
1008B   obfuscation-rules.txt
300B    oh-package.json5
593B    src/main/module.json
274B    src/main/ets/components/MainPage.ets
1.1kB   src/main/ets/components/WXQColor.ets
96B     src/main/resources/base/element/string.json
96B     src/main/resources/en_US/element/string.json
96B     src/main/resources/zh_CN/element/string.json

=== Harball Details ===
name:           @wxqos/wxqcolor
version:        1.0.0
filename:       @wxqos/wxqcolor-1.0.0.har
package size:   95.7 kB
unpacked size:  99.8 kB
shasum:         TKIo4iIPMFmZMfG2MVlUPqH0O4U=
integrity:      sha512-yEZi/38AayT9zGjJxJWJxviuB9F4F7W6O9se2Ok49CYxVGiPDRSP+1qSWjRdj9WN9N9sv3++t6pOCRJl4foqYw==
total files:    18


ohpm WARN: The HAR package to be uploaded contains source code, which may cause code asset leakage. Please abort if you do not want to procceed.
what is your passphrase of the private key: *******
+@wxqos/wxqcolor 1.0.0 

之后就可以在私倉中搜到了：

搜索發(fā)布結(jié)果

7玖喘、發(fā)布動(dòng)態(tài)共享包 HSP 包

動(dòng)態(tài)共享包 HSP 包不能直接發(fā)布在ohpm-repo內(nèi)蘑志，需要先轉(zhuǎn)化為 .tgz 包，轉(zhuǎn)換方法見：編譯HSP模塊澎媒。TGZ 包的發(fā)布流程同 HAR 一致。
執(zhí)行 ''ohpm publish <TGZ 包路徑>'' 命令發(fā)布 TGZ 包戒努，< TGZ 包路徑> 指向的文件后綴需為 .tgz 文件的具體路徑。例如執(zhí)行以下命令：

ohpm config set publish_registry <ohpm-repo私倉管理地址>/repos/ohpmohpm 
publish demo.tgz

或在命令行中配置參數(shù) --publish_registry 使用柏卤，例如以下命令：

ohpm publish demo.tgz --publish_registry <ohpm-repo私倉管理地址>/repos/ohpm

8、Web頁面發(fā)布

以上是使用命令行工具發(fā)布匀油，也可以使用Web頁面發(fā)布。在Web頁面用管理員賬號登錄ohpm-repo私倉管理地址敌蚜，在個(gè)人中心 > 倉庫管理中，點(diǎn)擊管理三方包 > 上傳三方包弛车，包的后綴名必須為 .har 或者 .tgz。

管理三方包

上傳三方包

三喻括、發(fā)布成功后HAR包的導(dǎo)入和使用

1贫奠、從ohpm-repo獲取HAR包 @wxqos/wxqcolor

可以為所有項(xiàng)目配置該私有倉唬血，例如執(zhí)行以下命令：

ohpm config set registry http://localhost:8088/repos/ohpm
ohpm install

或者在命令行中配置參數(shù) --registry 使用，例如以下命令：

ohpm install @wxqos/wxqcolor --registry http://localhost:8088/repos/ohpm

輸出以下信息拷恨，表示導(dǎo)入成功：

<git> ohpm install @wxqos/wxqcolor --registry http://localhost:8088/repos/ohpm
ohpm INFO: MetaDataFetcher fetching meta info of package '@wxqos/wxqcolor' from http://localhost:8088/repos/ohpm/
ohpm INFO: fetch meta info of package '@wxqos/wxqcolor' success http://localhost:8088/repos/ohpm/@wxqos/wxqcolor

oh-package-lock.json5 中自動(dòng)導(dǎo)入信息：

    "@wxqos/wxqcolor@1.0.0": {
      "name": "@wxqos/wxqcolor",
      "version": "1.0.0",
      "integrity": "sha512-yEZi/38AayT9zGjJxJWJxviuB9F4F7W6O9se2Ok49CYxVGiPDRSP+1qSWjRdj9WN9N9sv3++t6pOCRJl4foqYw==",
      "resolved": "http://localhost:8088/repos/ohpm/@wxqos/wxqcolor/-/@wxqos/wxqcolor-1.0.0.har",
      "registryType": "ohpm"
    }

項(xiàng)目中導(dǎo)入成功截圖：

遠(yuǎn)程導(dǎo)入成功

2腕侄、HAR包的使用

pages引用：

import { WXQColor, firstPublicFuncColor } from '@wxqos/wxqcolor'

代碼使用參考：

this.CustomText('主題-紅色 firstColor', WXQColor.firstColor)
this.CustomText('文字-重要 textMajorColor', WXQColor.textMajorColor)
this.CustomText('激勵(lì)、價(jià)格等高亮 textLightColor', WXQColor.textLightColor)
this.CustomText('文字-不可用 textUnableColor', WXQColor.textUnableColor)
this.CustomText('-------------------------', WXQColor.lineColor)
this.CustomText('自定義內(nèi)部主顏色 firstInternalFuncColor', WXQColor.firstInternalFuncColor())
this.CustomText('自定義外部主顏色 firstPublicFuncColor', firstPublicFuncColor())

使用效果截圖

官方文檔參考：ohpm-repo私倉搭建工具