百积木文档
开发指南前端开发

前端开发

开发并发布独立 Web 前端,再按需要接入平台应用。

前端开发负责浏览器中的页面、交互、状态管理和 API 调用。前端项目先生成独立 Web 构建产物并发布到稳定地址;需要成为工作区产品入口时,再由平台应用版本引用该地址。

两种交付方式

场景交付方式
普通网站、官网、活动页直接发布前端站点,不创建平台应用
工作区产品入口、需要平台身份或能力发布前端站点,再创建 TRUSTED_EXTERNAL_APP 平台应用并纳入 Bundle

前端源代码和构建产物不直接写进 Bundle Manifest。Bundle 锁定的是平台应用版本,平台应用版本再保存入口 URL、打开方式和授权能力。

开发重点

  • 路由和刷新行为在目标托管环境中可用。
  • 环境配置不硬编码到源码。
  • 浏览器端不保存长期平台密钥或后端服务密钥。
  • 需要平台身份时使用平台网页授权码与 PKCE。
  • 相对 API 请求通过受控网关或明确的后端 Endpoint。
  • 构建后使用真实访问地址完成端到端验证。

继续阅读:

  1. 项目结构与平台接入
  2. 构建、发布与验证

本页内容