项目介绍

优雅地在Linux环境下构建uni-app项目的wgt热更新包

Entities should not be multiplied unnecessarily. —— William of Occam

HBuilderX Vanilla 提供了一个小巧的容器环境以及一套对外暴露的api,用来构建Uniapp-Vite-Vue 3项目的wgt热更新包。

特性

容器化部署

基于Docker的轻量级容器环境,开箱即用

简单易用

提供简洁的REST API接口,一键构建

热更新支持

专门用于构建wgt热更新包,支持增量更新

版本灵活

支持Vue2和Vue3项目,适配多种场景

快速开始

容器启动

docker run -d --restart=always -v <projects_folder>:/projects -p 13300:3000 --name hbuilder-vanilla flymyd114/hbuilderx-vanilla:latest

初始化依赖

容器首次启动后,执行如下命令以初始化依赖:

docker exec -it hbuilder-vanilla sh -c "chmod +x /root/core-install.sh && /root/core-install.sh"

访问http://127.0.0.1:13300以检查API服务是否正确启动。

打包示例

curl --location 'http://127.0.0.1:13300/build?project=crp-app&vueVersion=3'

使用场景

CI/CD 集成

在持续集成环境中使用 HBuilderX Vanilla 可以实现自动化的wgt包构建:

# GitHub Actions 示例
steps:
  - name: Start HBuilderX Vanilla
    run: |
      docker run -d --name hbuilderx-vanilla \
        -v ${{ github.workspace }}:/projects \
        -p 13300:3000 \
        flymyd114/hbuilderx-vanilla:latest

  - name: Initialize dependencies (first run only)
    run: |
      docker exec hbuilderx-vanilla sh -c "chmod +x /root/core-install.sh && /root/core-install.sh"

  - name: Build wgt package
    run: |
      curl -fS "http://localhost:13300/build?project=my-app&vueVersion=3"

  - name: Stop container
    if: always()
    run: docker rm -f hbuilderx-vanilla

### 本地开发

对于需要频繁构建wgt包的开发场景,可以保持容器运行状态:

```bash
# 启动容器
docker run -d --name hbuilder-vanilla -p 13300:3000 -v /path/to/projects:/projects flymyd114/hbuilderx-vanilla:latest

# 构建项目
curl "http://localhost:13300/build?project=my-project"

注意事项

This site is powered by Nuxt