1. 功能与应用目标
“应用库”模块是 KiwiCloud 平台面向 SaaS 服务商、系统集成商和总部管理者的企业应用分发入口，用于发布 企业公有应用，并可对使用企业进行授权控制。该模块允许管理员上传 APK 文件，配置应用信息、权限及版本管理，并提交平台审核后正式发布。
发布成功的公有应用将出现在指定客户的“我的应用 > 添加企业公有应用”列表中，客户可将其添加至本企业 “我的应用” 中，并用于后续的策略下发与版本管理。
该机制支持企业间共享 App 能力，并保障版本一致性、权限透明与分发可控，是 KiwiCloud 多租户架构中“应用共享与复用”的关键组件。
注意事项
“应用库”中的应用仅支持发布为“企业公有应用”，不可直接用于本企业设备策略；
应用必须经过发布审批流程，状态为“已发布”时，目标企业才可见；
应用发布后需由 KiwiCloud 的应用管理员审批通过，方可完成正式发布流程；
可按企业维度配置“发布范围”，确保应用只对被授权客户开放；
当前仅支持 Android 平台的
.apk安装包；所有版本管理、上架/下架操作需谨慎处理，将影响所有添加该应用的企业策略执行。
主要操作
操作项 | 说明 |
发布企业公有应用 | 向平台发布一个新的公有应用，进入草稿状态，提交待审核后发布。 |
查看详情 | 查看应用版本、权限、发布范围、日志等信息，支持版本切换查看。 |
次要操作
操作项 | 说明 |
提交 | 提交草稿应用进入待审核状态，平台管理员将进行审批。 |
修改应用信息 | 修改应用基本信息，如分类、描述、适配范围等。权限、发布范围、图标等变更将重新进入待审核流程。 |
添加新版本 | 在已有应用下上传新版本 APK，版本号需高于现有版本，提交后进入审核流程。 |
版本管理 | 管理所有版本的版本信息与状态，包括查看详情、上架、下架、编辑等操作。 |
取消发布 | 仅限待审核状态应用使用，取消后应用变为草稿，可重新修改提交。 |
应用下架 / 上架 | 管理已发布 / 下架状态的应用可见性，控制是否展示给企业客户，影响策略执行。 |
删除应用 | 删除草稿或下架状态的应用，删除后无法恢复；若其他企业已添加此应用，不会影响其使用。 |
典型使用场景
SaaS 服务商将核心 App 发布至平台供指定企业客户使用；
总部 IT 管理人员为多地区分支机构共享标准业务 App；
渠道集成商为多个客户发布统一的工具类或服务类 App；
定制开发厂商通过 KiwiCloud 分发专属 APK，客户可按需添加。
2. 主要操作
2.1 发布公有应用
操作说明
该功能用于将本企业拥有的公有应用发布至平台供其他企业使用。通过上传应用包、填写应用信息、配置权限后，即可设定发布范围（本企业、子企业、其他企业），以企业级共享的方式进行版本传播与统一部署。
该操作适用于企业希望将某个自研应用提供给其他客户或子公司使用；
所有发布的应用将以“企业公有应用”形式出现在其他企业的“我的应用”模块中；
发布后，应用处于“待审核”状态，审批通过后才正式生效。
注意事项
发布对象包括本企业、子企业及其他平台企业；
选择企业支持展示当前企业及子机构；
导入/输入企业ID 用于发布给外部企业，确保 ID 正确；
发布后进入“待审核”状态，必须由 KiwiCloud 的管理员审核通过才能正式生效；
处于“待审核”状态的应用支持【审批】和【取消发布】两项操作；
若需更新应用内容，建议取消发布后重新提交。
操作流程
同意《公有应用发布协议》
在发布页面，系统将弹出发布协议；
勾选“我已阅读并同意《公有应用发布协议》”，否则无法上传应用包。
上传应用
点击【上传文件】，选择需发布的 APK 文件；
系统自动解析包名、应用名称与版本信息；
上传完成后点击【下一步】。
配置应用信息
选择应用类目（由系统提供分类信息）；
选择适配范围（全部 / 机型 / 型号）；
填写支持的设备信息与应用描述；
系统将读取权限项，可按需配置权限控制方式（允许 / 拒绝 / 用户控制）。
设置发布范围
可选择以下发布对象：
全部：发布给平台内所有企业；
部分：
选择企业：系统将列出本企业及子机构；
导入企业ID：上传企业 ID 列表；
输入企业ID：手动输入企业 ID；
每种方式支持多选。
提交审核
完成配置后点击【提交】；
应用状态变为“待审核”；
只有 KiwiCloud 应用管理员审批通过后，应用状态才变为“已发布”，其他企业才能看到并添加使用。
2.2 详情
操作说明
该功能用于查看企业已上传的公有应用详情信息，适用于草稿、已发布、已下架状态。详情页集中展示应用的基础信息、权限配置、发布范围、日志记录等内容，有助于管理者在发布前或维护期间，全面审查与追踪应用配置和发布情况。
注意事项
当前仅支持查看“草稿 / 已发布 / 已下架”状态应用的详情；
各个页签展示内容基于“当前选中版本”，可通过顶部下拉框切换版本；
权限为系统解析后的配置结果，详情页不可修改；
若需编辑版本内容，请返回主列表页面，使用【修改】或【添加新版本】操作。
操作流程
进入详情页
在「应用库」模块，定位目标应用，点击右侧【详情】按钮；
页面打开后进入“应用详情”弹窗。
查看顶部概览信息
页面顶部展示当前应用的基本概览信息：
应用名称：当前版本的应用显示名
创建人：初次上传该应用的账号
创建时间：应用初次创建的时间戳
版本列表：当前应用的所有版本号（下拉框支持版本切换）
发布组织：当前应用的发布者（企业名称）
安装设备数量：当前版本被安装到的设备数量
详情页签内容说明
详情区域分为多个页签（Tab），内容如下：
1. 应用信息
展示该版本应用的基本信息，包括：
应用类目（Tool、Security）
应用包名
应用版本代码
适配范围
支持的设备
描述等内容
2. 应用权限
展示当前版本应用请求的敏感权限清单，包括：
权限项（如存储、相机、定位等）
权限控制策略（允许 / 拒绝 / 用户控制）
注意：该权限为上传时自动解析。
3. 发布范围
展示当前版本已配置的发布范围，包括：
发布范围：全部 / 部分；
企业数量及列表（企业名称、ID、所在地）；
发布范围如果是“全部”，则不展示企业客户清单信息。
4. 操作日志
记录当前版本的全部用户操作记录，包括：
操作类型（发布公有应用、公有应用编辑等）
操作人、执行结果、时间戳
支持分页与导出
5. 系统日志
展示系统自动执行的操作记录，例如：
系统响应时间与结果（成功/失败）
支持按时间范围筛选
3. 次要操作
3.1 提交
操作说明
该功能用于将状态为“草稿”的公有应用提交至平台审核流程，提交后应用状态变为“待审核”，需KiwiCloud的应用管理员进行审批，审批通过后才可正式发布使用。
说明：
仅“草稿”状态的应用可执行提交操作；
提交后将出现【取消发布】按钮；
审批未通过时，应用将回退为草稿状态，需重新修改后再次提交；
提交后应用即进入发布流程，不支持再次编辑，建议在提交前确认所有配置项无误。
注意事项
提交后的应用不可修改，如需调整请先取消发布；
审批通过前应用不会对其他企业可见，不会出现在“企业公有应用”列表中；
所有提交与审批操作将记录在操作日志中，支持后续审计；
系统不弹出二次确认窗口，提交前请仔细核查版本信息与配置内容。
操作流程
进入应用列表
打开「我的应用」页面；
定位状态为“草稿”的公有应用（如 Easy Dialer）。
点击【操作】>【提交】
系统将立即执行提交操作，无需弹窗确认；
提交后，应用状态更新为“待审核”，操作项显示为【取消发布】。
查看提交状态
提交成功后，可继续执行【取消发布】，撤销此次发布。
3.2 修改
操作说明
该功能用于对已创建的公有应用版本进行内容修改，适用于草稿、已发布、公有应用下架等状态。管理员可重新编辑应用信息、权限设置、适配范围等内容。修改后是否需重新审批，取决于修改的字段类型。
注意事项
所有字段均可修改。描述与类目修改无需审批，保存即生效；涉及图标、APK 文件、权限配置、发布范围等关键字段修改时，需重新提交审批；
修改过程中不会影响该版本已安装设备的使用情况；
若需发布为全新版本，建议通过“版本管理 > 添加版本”完成；
正在审批中的应用不可再次发起修改，需等待审核结果或取消后重试；
修改记录将记录在操作日志中，便于后续追踪。
操作流程
点击【操作】>【修改】
进入「应用库」；
找到需修改的公有应用，在右侧点击【操作】>【修改】按钮；
页面跳转至应用信息编辑界面。
编辑应用信息
所有字段都可修改。
提交修改
若仅修改描述或类目，可直接点击【保存】，无需审批立即生效；
若修改了权限、发布范围、图标或重新上传 APK 文件，点击【保存】后，系统将提示进入“待审核”流程；
修改提交后应用状态更新为“待审核”，等待平台管理员审批通过后正式发布。
查看修改结果
返回“应用库”主列表页，可看到状态变更为“待审核”；
此时仍保留“取消发布”操作，如需撤回修改可直接点击取消。
3.3 添加版本
操作说明
该功能用于在已有公有应用下添加新的版本。适用于应用升级、功能更新、漏洞修复等场景。新版本将在审批通过后替代旧版本成为默认分发版本。新版本添加流程与“发布公有应用”基本一致，但版本号需满足唯一性与递增要求。
注意事项
支持通过两种入口进入添加版本流程：
应用列表中点击【操作】>【添加版本】
【操作】>【版本列表】中点击【添加新版本】
新版本的 APK 包名必须与原版本一致，版本号必须高于当前最高版本；
添加版本后，系统将进入“待审核”状态，审批通过后新版本生效；
旧版本不受影响，多个版本可共存；
若企业在应用发布策略或更新策略中选择了“最新版本”选项，新版本在审批通过后将自动推送至该企业的目标设备，触发自动更新流程；
若需灰度发布新版本，可通过设置“发布范围”为“部分企业”进行控制。
操作流程
上传应用文件
上传 APK 文件，系统自动解析应用包名与版本号；
勾选并同意《公有应用发布协议》后进入下一步；
上传成功后将自动验证包名一致性与版本号递增性。
配置应用信息
配置应用图标、分类、适配设备、应用描述等；
设置权限项，选择“允许 / 拒绝 / 用户控制”；
设置发布范围
可选择发布范围为：
全部企业；
指定企业（选择企业 / 导入企业 ID / 手动输入 ID）；
支持精确指定目标客户，确保版本控制灵活可控。
提交审核
提交后应用状态变为“待审核”；
等待 KiwiCloud 管理员审批通过后才可正式生效；
可在列表页通过【取消发布】撤回当前版本。
3.4 版本列表
操作说明
该功能用于查看当前公有应用的所有版本记录，支持对单个版本进行管理操作，包括版本详情、版本编辑、版本下架、版本删除。
适用于运维管理、版本切换、灰度控制等场景，便于管理员清晰掌握版本分发状态。
注意事项
当前页面展示的是“应用版本维度”，不同版本的状态互不影响；
草稿版本可继续编辑并提交；已发布版本可下架，不可编辑；
若企业使用“最新版本”策略，添加新版本并发布后将自动触发更新；
若存在多个版本为“已发布”状态，仅最新版本将作为默认推荐版本；
“版本下架”不会影响已安装设备上的旧版本使用，仅影响后续分发与策略匹配。
操作流程
进入版本列表
在「应用库」列表中点击【操作】>【版本列表】；
页面将展示该应用的全部历史版本。
查看版本记录
每一行记录表示一个版本，包含以下信息：
版本号
应用版本代码
状态（已发布 / 已下架 / 草稿）
支持分页浏览多个版本。
执行操作
每个版本右侧提供下拉操作菜单，包括：
【版本详情】：查看该版本的完整配置信息；
【版本编辑】：仅限草稿或已下架状态可编辑；
【版本下架】：对已发布版本进行下架处理；
【版本删除】：对已下架的版本进行逻辑删除。
顶部可点击【添加新版本】，跳转至“添加版本”流程。
3.5 版本详情
与 【详情】相同，详情请查看
3.6 版本编辑
与【修改】相同，详情请查看
3.7 版本下架
操作说明
该功能用于将某一“已发布”状态的公有应用版本进行下架处理。下架操作适用于版本废弃、Bug 累积、合规问题或计划停止分发等场景。
注意事项
仅“已发布”状态的版本支持下架操作；
此操作为不可撤回操作，如需重新上架该版本，需重新执行版本上架操作；
下架操作一旦生效，将产生以下影响：
新客户无法添加该版本至策略或进行分发部署；
已经安装了该版本的企业客户仍可继续使用，不受影响；
已经添加了该版本的应用发布策略、应用更新策略、Kiosk策略，如果还未执行，将不会再安装已下架的应用版本；
下架后禁止重新上传相同版本号的 APK 文件，若需上传请更换版本号；
被下架版本将保留在“版本列表”中，状态显示为“已下架”，供查看历史版本使用；
下架仅影响平台分发与可见性，不会自动卸载终端设备已安装的该版本。
操作流程
进入版本列表
在应用库中点击【操作】>【版本列表】；
找到需下架的目标版本。
发起版本下架
在目标版本右侧点击【操作】>【版本下架】；
系统弹窗提示“确定要下架应用吗”，点击【确定】提交申请；
应用版本状态变更为“已下架”。
3.8 版本上架
操作说明
该功能用于将已下架的应用版本重新恢复为“已发布”状态。上架后，该版本将重新对其原发布范围内的企业可见，并可被用于添加至应用发布策略或更新策略中。
注意事项
仅“已下架”状态的版本支持“版本上架”操作；
发起操作后，系统将弹出确认提示，点击【确定】后生效；
上架后，该版本将恢复在“我的应用”添加企业公有应用中的可见性；
此操作不会影响其他版本状态，也不会替换当前默认分发版本；
如需推广新版，建议通过“添加版本”而非重复上架旧版本。
操作流程
进入应用的【版本列表】页面；
在目标“已下架”版本的中点击【版本上架】；
系统弹窗提示“确定要上架应用吗”，点击【确定】发起操作；
提交后版本自动变更为“已发布”状态。
3.9 取消发布
操作说明
该功能用于撤回尚未正式发布的公有应用（即处于“待审核”状态）。取消发布后，应用状态将回退为“草稿”，用户可继续编辑并重新提交审核。
注意事项
仅支持“待审核”状态的应用执行取消发布操作；
取消发布后，当前发布流程将被终止，应用将从“应用发布队列”中移除；
该操作会弹出确认提示，用户确认后即执行，不可恢复；
应用状态变更为“草稿”，可再次编辑后重新提交审核；
已发布的其他版本不受影响；
若需完全移除应用，请前往“版本下架”或执行删除操作（如开放）；
取消发布不会影响已部署设备的使用情况。
操作流程
在“公有应用”页面中，找到状态为“待审核”的目标应用；
点击对应应用操作列中的【取消发布】按钮；
在弹窗提示中确认操作，点击【确定】即撤回当前发布流程；
操作成功后，应用状态自动回退为“草稿”，支持后续修改与重新提交。
3.10 下架
操作说明
该功能用于将已发布的公有应用整体下架。下架后，该应用将不再对任何企业展示和分发，系统内相关策略在执行时也将跳过该应用。适用于停止分发、应用淘汰、业务调整等场景。
该操作具有不可逆性，确认操作后将立即生效，仅平台管理员具备权限执行此操作。
注意事项
仅“已发布”状态的应用支持执行下架；
下架操作生效前，系统将弹出确认提示，提示影响范围与不可撤销的后果；
操作生效后，将产生以下影响：
此操作不可撤回，如需恢复分发，需通过“版本上架”操作重新提交审批；
与“版本下架”不同，应用下架是对整个应用维度的操作，所有版本均不再展示；
应用下架不影响操作日志、系统日志等历史记录的保留。
可见性与访问影响：
应用将从企业用户的“添加企业公有应用”界面中隐藏；
其他企业用户依然不能重新上传该应用包（包名冲突限制仍生效）；
已将该应用添加到“我的应用”的企业，其应用状态将显示为“已下架”；
安装与策略影响：
企业已部署的旧版本仍可保留并继续使用，不受影响；
若该应用被配置在【应用发布策略】、【应用更新策略】或【Kiosk策略】中，且对应策略尚未执行：
执行时将自动跳过下架的应用；
策略不会安装或更新已下架的应用版本；
若策略中仅包含该应用，将导致策略整体不生效。
操作流程
在【公有应用】列表中，找到目标“已发布”状态的应用；
点击【操作】>【下架】；
系统弹出提示，明确列出下架行为的影响，点击【确定】提交；
应用立即变更为“已下架”状态，所有企业将不再可见；
可在列表顶部切换到“已下架应用”页签查看已下架记录。
3.11 上架
操作说明
该功能用于将处于“已下架”状态的公有应用重新发布，恢复其对企业用户的可见性与分发能力。上架后，该应用可被重新添加到策略或部署流程中，实现正常使用。
注意事项
仅“已下架”状态的应用支持执行“上架”操作；
执行操作前系统会弹出确认弹窗，需用户主动确认；
操作一旦确认提交即生效，不可撤回；
上架后，将对系统与企业产生以下影响：
可见性与访问恢复：
企业用户在【应用库】-【添加企业公有应用】界面中可重新看到该应用；
已将该应用添加至【我的应用】的企业，将恢复显示为“已发布”状态；
策略与部署影响：
若该应用包含于以下策略中，且策略尚未执行，则策略将在执行时安装此应用：
应用发布策略；
应用更新策略；
Kiosk策略；
应用恢复上架后，即重新参与策略执行逻辑。
操作流程
在【公有应用】>【已下架应用】页签中，定位目标应用；
点击【操作】>【上架】；
系统弹出确认提示，提示应用名称与发布组织；
点击【确定】，应用状态变更为“已发布”，恢复正常分发；
可在【全部】页签中确认应用状态已变更为“已发布”。
3.12 删除应用
操作说明
该功能用于删除处于草稿或已下架状态的公有应用。删除后，该应用将从应用库中移除，不再支持后续管理与操作。
注意事项
仅“草稿”或“已下架”状态的应用支持执行“删除”操作；
操作一旦确认提交即生效，不可撤回；
删除应用将彻底移除该条记录，不影响已部署企业的使用；
删除后可重新上传相同包名的应用。
可见性与访问恢复：
企业用户在【应用库】-【添加企业公有应用】界面中将无法再看到该应用；
已将该应用添加至【我的应用】的企业，列表中状态仍显示为“已下架”；
策略与部署影响：
若该应用已包含于以下策略中，且策略尚未执行，则策略将在执行时跳过安装此应用：
应用发布策略；
应用更新策略；
Kiosk策略；
应用若重新发布上架，不会参与原策略执行逻辑。尽管包名与图标相同，但视为不同应用。
操作流程
在【应用库】页面，找到状态为草稿或已下架的目标应用；
点击【操作】>【删除应用】；
弹窗提示：“是否删除 [应用名称] 应用，发布组织：[组织名]”；
点击【确认】后完成删除；
应用从列表中移除，不可恢复。
4. 配置项说明
应用库模块支持发布企业级公有应用，并管理其基本信息、权限配置、版本状态与发布流程。下列为主要配置项与其含义：
4.1 应用基本属性
配置项 | 说明 |
应用名称 | 平台中展示的应用名称，支持中文/英文。 |
包名 | Android 应用的唯一标识，由系统自动解析，不可编辑。 |
应用图标 | 展示用图标，支持 PNG/JPG 格式，建议尺寸 512×512 像素。 |
应用分类 | 应用所属类目，由上传者选择，如：工具类、支付类、零售类等。 |
创建人 | 首次上传应用的操作用户名称，仅展示，不可修改。 |
创建时间 | 应用首次创建的时间，由系统记录并展示。 |
发布组织 | 当前应用归属的企业主体，用于区分管理主体与使用权限。 |
安装设备数 | 当前应用在终端设备上的安装数量，仅统计启用设备。 |
4.2 权限配置
权限配置由系统自动解析 APK 中请求的权限项，发布者可设置默认权限控制方式，供后续策略继承。
权限项 | 控制方式 | 说明 |
摄像头访问 | 允许 / 拒绝 / 用户控制 | 控制应用是否允许使用摄像头。 |
位置信息 | 允许 / 拒绝 / 用户控制 | 控制应用是否可读取 GPS、Wi-Fi 或基站位置信息。 |
存储读写权限 | 允许 / 拒绝 / 用户控制 | 控制应用是否可访问设备的内部/外部存储空间。 |
麦克风访问 | 允许 / 拒绝 / 用户控制 | 控制应用是否允许录音。 |
设备信息 | 允许 / 拒绝 / 用户控制 | 控制应用是否可读取设备标识符、状态等信息。 |
…… | …… | …… |
4.3 版本管理
配置项 | 说明 |
版本号 | 应用版本名称（versionName），由 APK 自动解析，示例：1.0.0。 |
版本代码 | 应用版本编号（versionCode），必须为整数，且新版本需递增。 |
状态 | 当前版本的发布状态，包括：草稿 / 待审核 / 已发布 / 已下架。 |
添加版本 | 在已有应用下新增版本，支持版本共存，新版本需包名一致、版本号递增。 |
修改应用信息 | 对当前版本进行图标、类目、描述等字段的调整，部分字段修改需审批。 |
删除版本/应用 | 草稿或已下架状态可删除，不可恢复；已发布版本需先下架，待审核版本需取消发布后再删除。 |
4.4 状态
配置项 | 说明 |
草稿 | 应用初次创建但未提交审核的状态，支持修改与删除。 |
待审核 | 应用提交审核后等待平台管理员审批，期间不可修改。 |
已发布 | 应用审核通过后正式发布，可被其他企业添加使用。 |
已下架 | 应用被手动下架，不再对企业可见，但已安装设备仍可使用。 |
已删除 | 应用被彻底移除，不再保留历史记录，包名可被其他企业再次上传。 |
取消发布 | 撤回待审核应用，状态回退为草稿。 |
下架 | 将已发布应用转为下架状态，不可再被添加使用。 |
上架 | 将下架应用恢复为已发布状态，恢复其可见性与策略可用性。 |