中国 帮助

在应用市场里找应用

应用市场是宿主前端里的一个页面:路由 /appmarket/market,源码 wujiesadmin/src/views/appstore/market/index.vue。它只负责浏览与安装; 装完之后的版本、启停、卸载在 [安装、升级

在应用市场里找应用
封面

> 本文整理自平台文档 docs/wujies/5.x/platform/app-market/market.mdx,用于站点内容演示。

(https://console.wujies.cn/remote-apps/cms-assets/doc-0fbbd5a3c51c-cover.svg)

应用市场是宿主前端里的一个页面:路由 /appmarket/market,源码 wujies-admin/src/views/appstore/market/index.vue。它只负责浏览与安装; 装完之后的版本、启停、卸载在 [安装、升级、卸载与启停](/docs/wujies/5.x/platform/app-market/install)。

浏览市场需要权限 app:market:list;卡片上的「安装」按钮需要 app:install:add。 没有权限时页面照常打开,只是按钮不出现。接口清单见 [HTTP 接口索引](/docs/wujies/5.x/platform/reference/api)。

从哪进

入口位置
侧边栏应用市场(菜单 appmarket)
工作台「我的应用」卡片右上角的「前往应用市场」;本租户一个应用都没有时,空态里还有一个「去应用市场看看」

页面上有什么

工具栏从左到右:

控件行为
关键词搜索框回车触发。走后端,搜索在目录里做,中文正常
「已安装」复选框前端过滤,只留本租户装过的
排序「最近更新」(默认)与「最新创建」,前端排序
网格 / 列表切换本地记住(localStorage 的 app-store-list-view)
刷新重新拉一次市场列表与本租户的安装列表

左侧筛选:

  • 类型:全部 / 应用(app)/ 插件(plugin)/ 内置模块(module)—— 前端过滤。

分类(app_category)现在只在中心上架服务里维护,本部署的市场页不再提供分类筛选控件。

卡片上能看到:封面(没有封面时用图标 + 渐变兜底)、「官方」角标(清单里 officialFlag 为 1 时)、 类型角标、应用名、最新版本号、相对时间(「x 天前更新」)、一行简介、 作者(没填时显示「未知作者」),以及右下角那个按钮 —— 已安装时只显示状态且不可点,未安装时是「安装」。

卡片中间还会多出一行:本租户装过、且装着的版本低于市场最新版时,出现 「有新版本(x.y.z),查看详情 或 立即更新」。升级不必先去「我的应用」,在市场卡片上就能做。

详情与版本

点封面或应用名打开详情抽屉(市场页与已安装页共用同一个组件),分三块:

1. 头部:图标、名称、「官方」标签、安装状态标签(只有已安装页会传这个)、「N 次安装」、 应用编码、「最新 vX」、简介; 2. 左侧元信息:作者(填了主页时是可点链接)、版本、平台版本(engineRange,「需要平台 …」)、 协议(license)、类型、标签,以及「更多」里的收录时间 / 最后发布 / 当前已装; 3. 右侧两个标签页: - 「简介」:应用自己的说明; - 「版本 N」:左边是版本列表(新版本在前,标出「最新」与「已装」,带发布时间), 右边是选中版本的平台版本约束、制品大小、发布日期与更新日志。

它是上架中心填的多行文本、没有经过 HTML 消毒,所以只做文本插值。 写 <b> 这样的标签只会看到标签本身,不会被当富文本执行。

详情接口或版本列表接口失败(权限不足、应用已下架)时,抽屉仍会用列表页已经拿到的字段展示 (名称、图标、编码、类型、当前已装版本),不会开出一片空白。

想上架应用

上架这件事不在本部署里做。平台侧的上架端(原 /appconsole:应用、版本、分类、安装包上传)已在 2026-11-01 整体下线,本部署只剩「浏览与安装」这一侧(/app/market、/app/install)。 应用、版本、分类、安装包的上传与发布,都归中心上架服务 wujies-market 维护(它是私有服务, 没有公开仓库,也没有对外文档链接)。本部署通过 IAppCatalogService 读取它发布出来的目录, 读本机还是读中心怎么切换见 [应用目录](/docs/wujies/5.x/platform/app-market/catalog) 与 [多套部署](/docs/wujies/5.x/deploy/multi-deployment)。

安装包存在哪

中心把包存在本机磁盘或者对象存储里,两种模式共用 market_storage_config 那两列:endpoint 存访问站点, bucket_name 在对象存储模式下存桶名、在本机模式下存落盘目录。这张表恒为一行,页面改完即刻生效, 下一次上传就走新配置;库里没有这一行时按本机磁盘处理。

三个后果要在改之前看清楚。目录里的 package_url 是长期有效的公开直链,平台安装时直接下载、不带签名, 所以桶必须开公开读;换落盘目录或换桶会让已经发出去的 package_url 集体 404,老版本安装不上。 访问密钥(secretKey)在库里是 Base64 编码后存的,这只防肉眼可读,库权限还在的人一样解得开, 备份库文件时把它当成含密文件处理。

标记为私有的应用与对象存储互斥,两头各有一道闸:已经是对象存储时设私有会被拒(AppAdminController#normalizeVisibility), 已经是私有时切对象存储也会被拒(StorageConfigService#assertNoPrivateApps,报错里直接告诉你有几个私有条目)。 只挡一头等于没挡,换个顺序就绕过去了。

冲突的根子在 app_version.package_url 存的是一个长期有效的地址,而桶必须开公开读(私有桶的临时签名链接等到安装现场早过期了)。 私有包一旦进了桶,「私有」就只剩「列表里看不见」,任何拿到链接的人都能下载。本地磁盘这一路才有真鉴权: 下载走中心的 /packages/<sha256>.zip,它会按授权凭证判一次。

把配置放进库而不是环境变量,为的是在线更新与多实例共用一份:环境变量要重启才换, 而中心升级之后不该丢掉运维在页面上填过的那次改动。跟这台机器的磁盘和网关绑在一起的两项仍留在 yml 里, 运行中改它们没有意义:market.packages.dir(本机落盘目录,默认 ./data/packages)与 market.packages.base-url(本站访问前缀;留空时目录里写出的下载地址是相对路径 /packages/<sha256>.zip)。

相关阅读

  • [安装、升级、卸载与启停](/docs/wujies/5.x/platform/app-market/install) —— 装完之后在哪儿操作
  • [应用目录](/docs/wujies/5.x/platform/app-market/catalog) —— 本部署的目录数据与安装侧的唯一读入口
  • [应用生态](/docs/wujies/5.x/platform/ecosystem/) —— 应用目录里现有哪些应用

界面截图

本文导览

(https://console.wujies.cn/remote-apps/cms-assets/doc-0fbbd5a3c51c-guide.svg)

章节导览
THE END

喜欢就支持以下吧

评论区需要浏览器启用 JavaScript 才能加载。

回到内容