3.5.2代码实战1：Hello World

Hello World

在这个教程中，我们将引导开发者完成一个简单的组件开发。

建议没有了解 VPA运行流程 和 本地开发配置 的伙伴回头看一下！！

1. 开发前准备

开发环境

在开发组件之前，我们确保已经正确的检出了仓库，并且已经正确的设置好了开发环境。

资源 ID

术语：资源ID（vpaUIResourceID）

所有的自定义组件的加载都是围绕着资源 ID 进行的，所以在开发组件之前，我们需要先获取一个资源 ID。

获取资源 ID 的方式有两种：

  • 通过 VPA 意图管理和移动资源平台 创建真实的去配置意图，关联资源 ID。（适合有账号的情况下使用）
  • 通过本地 定制响应数据 (本地开发配置)，假设一个资源 ID。（适合没有账号的情况下使用）

2. 进入开发阶段

在本地关联资源 ID 和源码

当我们拿到资源 ID 以后，就可以针对这个资源 ID 进行开发了。但是在开发之前，我们需要先关联资源 ID 和源码的位置。 这样一来，VPA 在得到资源 ID 以后，就能够正确的从开发环境中加载我们的组件源码了。

关联资源 ID 和源码的方式参考 本地开发拦截。

初始化组件

首先在 /src/@remote 目录下新建文件夹，命名为 Hello ，文件夹下新建 index.tsx 文件。

也可以在 /src/@remote 目录下直接新建 Hello.tsx 文件。（其实两种方式都是一样的，如果有一些附件或者是 css 等资源，建议使用文件夹的方式，来统一收纳资源）

export default function Hello () {
  return (
    <div>Hello world</div>
  )
}

以及可以参考开发规范相关的内容，来完善组件的开发。

这里作为 Hello World 教程，我们就不再过多的介绍开发规范的内容了。直接进入下一步。

开发和测试阶段

可以在浏览器中打开 VPA 的页面，然后在输入框中输入我们的意图，然后点击回车，就可以看到我们的组件已经被加载出来了。然后根据我们的开发需求，和数据模型进行开发和测试。

3. 打包发布

当我们完成了组件的开发以后，就需要对组件进行打包构建了。

打包组件，生成 zip 包

打包方式有两种：任选其一。

  • 配置要打包的环境变量BUILD_CARD，使用 npm run buildCard 命令进行打包。
  • 使用 npm run buildCard [卡片路径] 命令进行打包。

打包完成以后，会在 /${process.env.OUTPUT_DIST} 目录下生成一个 vc_Hello.20230623.xxx.zip 的压缩包，这个压缩包就是我们的组件包。

上传组件包

进入【移动资源管理后台】，然后找到相应的组件，进行编辑，然后上传组件包。

是否仍需要帮助？ 请保持联络！
最后更新于 2024/11/18