create-zleap-app 0.10.4 → 0.10.6
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/index.js +3 -0
- package/package.json +3 -3
- package/skills/zleap-cloud-app/SKILL.md +3 -3
- package/skills/zleap-cloud-app/references/app-runtime.md +3 -3
- package/skills/zleap-cloud-app/references/cloud-functions.md +25 -18
- package/skills/zleap-cloud-app/references/console-members.md +8 -16
- package/skills/zleap-cloud-app/references/limits.md +27 -36
- package/skills/zleap-cloud-app/references/manifest.md +26 -58
- package/skills/zleap-cloud-app/references/permissions.md +21 -21
- package/skills/zleap-cloud-app/references/sdk-database-files.md +12 -10
- package/skills/zleap-cloud-app/references/status-codes.md +117 -136
- package/skills/zleap-cloud-app/references/triggers.md +4 -4
- package/skills/zleap-cloud-app-release/SKILL.md +39 -82
- package/skills/zleap-cloud-app-release/references/app-center-install.md +22 -23
- package/skills/zleap-cloud-app-release/references/app-center-publish.md +56 -142
- package/skills/zleap-cloud-app-release/references/console-functions.md +12 -28
- package/skills/zleap-cloud-app-release/references/console-members.md +8 -16
- package/skills/zleap-cloud-app-release/references/console-release.md +18 -24
- package/skills/zleap-cloud-app-release/references/console-workspace.md +23 -90
- package/skills/zleap-cloud-app-release/references/dev-to-production.md +79 -349
- package/skills/zleap-cloud-app-release/references/permissions.md +21 -21
- package/skills/zleap-cloud-app-release/references/status-codes.md +117 -136
- package/templates/react-ts/scripts/zleap.mjs +14 -0
- package/templates/react-ts/src/cloud/client.ts +3 -3
- package/skills/zleap-cloud-app-release/references/console-legacy-release.md +0 -411
|
@@ -1,16 +1,16 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: zleap-cloud-app-release
|
|
3
|
-
description: Ship a zleapOS 云开发 (App Cloud) app beyond the developer's own desktop —
|
|
3
|
+
description: Ship a zleapOS 云开发 (App Cloud) app beyond the developer's own desktop — publishing a development version as the live version (版本管理 → 发布为线上版本 / 回退到此版本, npm run release / zleap-app release), automatic production preparation and its failure reasons, running cloud functions / background capabilities / triggers in the dev environment (自动签名、允许后台运行、invoke), sharing with colleagues, and version switching / rollback. Use when the user asks to 上线, 发布, 上生产, 分享给同事, 回退, 让云函数或定时任务跑起来, 升级或回退版本 for a zleap.app/2 app.
|
|
4
4
|
---
|
|
5
5
|
|
|
6
6
|
# zleapOS 云开发应用:从开发到上线
|
|
7
7
|
|
|
8
8
|
前置:应用已能用 `npm run deploy`(或 `zleap-app publish` + `install`)装到开发者自己的桌面并读写数据——那部分见 skill `zleap-cloud-app`。
|
|
9
|
-
下文的 `npx zleap-app` 指项目里安装的 `@zleap-ai/app-cli`;不在这样的项目里时换成 `npx @zleap-ai/app-cli`。本 skill
|
|
9
|
+
下文的 `npx zleap-app` 指项目里安装的 `@zleap-ai/app-cli`;不在这样的项目里时换成 `npx @zleap-ai/app-cli`。本 skill 处理之后的事:后台能力、发布上线、分享给同事、版本迭代。完整版流程:references/dev-to-production.md。
|
|
10
10
|
|
|
11
|
-
##
|
|
11
|
+
## 1. 上线:「版本管理」→ 发布为线上版本
|
|
12
12
|
|
|
13
|
-
manifest 里是 `"appid": "zl…"
|
|
13
|
+
manifest 里是 `"appid": "zl…"`(控制台「创建应用」得到的 appid)。上线只有两步,不需要手动签名、激活或上架:
|
|
14
14
|
|
|
15
15
|
1. **上传开发版本**:`npm run deploy`(会把上传者本人的安装切到这个版本)。
|
|
16
16
|
2. **发布**:用户明确要求上线后,在项目里 `npm run release -- --notes "本次更新说明" --yes`(发布最近一次 deploy 的版本;
|
|
@@ -31,119 +31,76 @@ manifest 里是 `"appid": "zl…"`(控制台「创建应用」得到的平台
|
|
|
31
31
|
**发布影响全企业使用者:只有用户明确说「发布 / 上线 / 回退到 x」时才执行,执行前复述要发布的版本号。**
|
|
32
32
|
- 带云函数的版本在开发环境调试**不需要签名 / 激活操作**:上传时平台自动签名,安装 / 切换版本 / 在应用窗口「权限」里允许后台运行时自动绑定
|
|
33
33
|
(版本还没签名时当场补签)。用户在应用窗口「权限」里允许后台运行后,`npx zleap-app invoke <app_id> --capability <id> --environment dev` 调试。
|
|
34
|
-
|
|
35
|
-
- `npx zleap-app prepare`
|
|
36
|
-
|
|
37
|
-
旧 `app_key` 命名空间应用(`com.example.xxx`)继续按下文走「版本与激活」(references/console-legacy-release.md)。
|
|
34
|
+
控制台没有单独的签名 / 激活界面。
|
|
35
|
+
- `npx zleap-app prepare` 只是兜底:仅当 `npx zleap-app diagnose` 返回 `next_action: app_prepare` 时用,只准备开发环境、不碰生产,只能准备本人上传的版本。
|
|
38
36
|
|
|
39
37
|
完整说明:references/console-release.md。
|
|
40
38
|
|
|
41
|
-
##
|
|
42
|
-
|
|
43
|
-
| 问题 | 怎么判断 | 影响 |
|
|
44
|
-
| --- | --- | --- |
|
|
45
|
-
| 应用有后台部分吗? | manifest 有 `runtime.backend`、`functions`,或 `provides` 里有 `execution:"headless"` | 有 → 必须签名并激活 |
|
|
46
|
-
| 部署开放生产了吗? | 控制台「版本与激活」显示「生产环境已开放」,或侧栏环境出现「开发环境 / 生产环境」下拉 | 开放 → 其他使用者一律走**生产数据域**(应用没有生产环境时打不开,`ENV_FORBIDDEN`),发布者在应用有生产环境后也走生产,必须做生产激活;未开放 → 所有人走开发数据域 |
|
|
47
|
-
|
|
48
|
-
生产是否开放由部署决定(发布信任配置就绪即开放,运维自动配置),控制台没有开关。不知道就问用户,或让用户看控制台。
|
|
49
|
-
|
|
50
|
-
## 2. 只有前端的应用
|
|
51
|
-
|
|
52
|
-
- **生产未开放**:开发环境就是唯一数据域,且默认**只有发布者本人**能访问(其他人 `PUBLISHER_REQUIRED`)。能自用,但同事装了也读不到数据——如实告诉用户,这是平台边界。
|
|
53
|
-
- **生产已开放**:用一条命令准备好生产(会创建开发+生产环境、开通数据库、签名、**激活到生产**):
|
|
54
|
-
|
|
55
|
-
```bash
|
|
56
|
-
npx zleap-app prepare <app_id> --version-id <version_id> # --request-id 不传时自动生成;重试时用回执里的同一个
|
|
57
|
-
```
|
|
58
|
-
|
|
59
|
-
应用没有声明任何云资源(无 `cloud.*`、无后台能力、无集合)时直接返回 `not_required`,装上就能用。
|
|
39
|
+
## 2. 云函数 / 后台能力(开发环境)
|
|
60
40
|
|
|
61
|
-
|
|
62
|
-
**它会直接激活到生产并启用全部 headless 能力——执行前必须得到用户明确同意。**
|
|
41
|
+
AI 能做的是命令与代码,界面操作要请用户完成:
|
|
63
42
|
|
|
64
|
-
|
|
65
|
-
|
|
66
|
-
|
|
67
|
-
|
|
68
|
-
1. **上传**:`npm run deploy`。带 headless 能力的版本上传时平台自动签名,deploy 把本人安装切到新版本时自动绑定。
|
|
69
|
-
2. **允许后台运行**(用户):应用窗口顶部「权限」→ 勾选「后台能力(定时任务 / 云函数)」下的能力 →「保存并重新加载」。版本还没签名时保存这一步会自动补签并绑定。
|
|
70
|
-
3. **试调**:同下文第 5 步(`invoke` / `invocation` / `runtime-logs`)。报 `FUNCTION_RELEASE_REQUIRED`:请用户在「权限」里重新保存一次或在「版本管理」切换一次版本(会自动补签);仍失败说明部署的签名服务不可用,交给平台管理员。
|
|
71
|
-
4. **触发器**:同下文第 6 步。控制台「云函数」页允许 / 撤销授权**不会**解除 appid 应用的发布绑定。
|
|
72
|
-
|
|
73
|
-
**旧 `app_key` 应用**,顺序很重要,按此执行:
|
|
74
|
-
|
|
75
|
-
1. **上传**:`npm run deploy`(含 `cloudfunctions/` 的包也可以,校验规则与应用中心上传一致);也可由用户在应用中心「我的发布」→「上传应用包」上传,再在应用详情「安装」。
|
|
76
|
-
2. **签名**(用户):云开发控制台 →「版本与激活」,在该版本的草稿候选上点「验证并签发」→ 状态变「已就绪」。没有草稿就「新建发布候选」。
|
|
77
|
-
3. **允许后台运行**(用户):应用窗口顶部「权限」→「应用权限」对话框里勾选「后台能力(定时任务 / 云函数)」下的能力 →「保存并重新加载」。已有就绪发布时这一步会自动绑定发布。
|
|
78
|
-
4. **核对激活**:控制台概览第 5 步显示「已激活到开发环境」、「云函数」页状态「可调用」即完成;否则点「激活开发」,或用概览的「升级到 vX 并激活」。
|
|
79
|
-
5. **试调**(AI 可做):`npx zleap-app invoke <app_id> --capability <能力 ID> --environment dev --input-file in.json`,
|
|
43
|
+
1. **上传**:`npm run deploy`(含 `cloudfunctions/` 的包也可以)。带 headless 能力的版本上传时平台自动签名,deploy 把本人安装切到新版本时自动绑定。
|
|
44
|
+
2. **允许后台运行**(用户):应用窗口顶部「权限」→「应用权限」对话框里勾选「后台能力(定时任务 / 云函数)」下的能力 →「保存并重新加载」
|
|
45
|
+
(或控制台「云函数」→「后台能力」里允许)。版本还没签名时这一步会自动补签并绑定。
|
|
46
|
+
3. **试调**(AI 可做):`npx zleap-app invoke <app_id> --capability <能力 ID> --environment dev --input-file in.json`,
|
|
80
47
|
再 `npx zleap-app invocation <app_id> <调用编号>`;函数日志 `npx zleap-app runtime-logs <app_id> <调用编号> --environment dev`(看 `function_logs`)。
|
|
81
|
-
|
|
82
|
-
|
|
48
|
+
- `CAPABILITY_NOT_ACTIVE` = 用户还没允许后台运行,开发工具不能代为允许。
|
|
49
|
+
- `FUNCTION_RELEASE_REQUIRED`:请用户在「权限」里重新保存一次或在「版本管理」切换一次版本(会自动补签);仍失败说明部署的签名服务不可用,交给平台管理员。
|
|
50
|
+
4. **触发器**(用户):控制台「云函数」→ 能力 →「触发器」里启用。manifest 的 `background.modes` 要含 `scheduled`/`events`,事件名 `^[a-z][a-z0-9_.]{0,63}$`。
|
|
83
51
|
**线上让使用者自己开**:触发器声明加 `"user_configurable": true` 并发布;每个使用者在应用窗口「权限」里允许后台能力后,在能力下面打开开关(以本人身份运行,时间和参数用声明值)。没开放的触发器在生产环境启用报 `TRIGGER_NOT_USER_CONFIGURABLE`。
|
|
84
52
|
|
|
85
53
|
坑:
|
|
86
|
-
-
|
|
87
|
-
- 旧 `app_key` 应用:在控制台「云函数」页点「允许后台运行 / 撤销授权 / 重新授权」会**解除发布绑定**,之后要重新「激活开发」(appid 应用不会解除)。
|
|
54
|
+
- 控制台「云函数」页允许 / 撤销授权**不会**解除发布绑定。
|
|
88
55
|
- `managed_function` 必须绑定就绪发布,否则 `FUNCTION_RELEASE_REQUIRED`;`builtin`、`logic_unit` 在开发环境不需要。
|
|
89
|
-
-
|
|
56
|
+
- 切换到新版本后旧会话失效(`RELEASE_UNAVAILABLE`),宿主会自动重开。
|
|
90
57
|
- 云函数里 `zl.cloud.os.database.query` / `mutate` **都必须带 `request_id`**(非空、≤128,用 `` `${context.invocationId}:用途` ``),否则网关拒绝、未捕获时整次调用 `USER_EXCEPTION`。
|
|
91
58
|
- 云函数里读操作只有 `get`(单条)和 `count`(计数,可带 `filter`);`operation: 'query'` 会被拒(`GATEWAY_QUERY_OPERATION_UNSUPPORTED`)。
|
|
92
59
|
- 触发器 `id` 只能是 `^[a-z][a-z0-9_]{0,63}$`(**不能有 `-`**):上传不报错,但启用时会被拒。
|
|
93
|
-
- 升级到新版本后,已启用的触发器会变成停用(`authorization_changed
|
|
60
|
+
- 升级到新版本后,已启用的触发器会变成停用(`authorization_changed`),要在新版本上重新启用。
|
|
94
61
|
- 函数里 `query` / `mutate` 失败时 `error.code` 是错误码、`error.message` 是平台给的中文说明(含具体上限);先 `try/catch` 把它放进返回值
|
|
95
62
|
(`output_schema` 里声明对应字段),再排查。日志库刚开通时可能暂时查不到日志(`LOG_UNAVAILABLE`),函数照常执行。
|
|
96
63
|
|
|
97
|
-
##
|
|
98
|
-
|
|
99
|
-
1. 「版本与激活」→ 对已就绪候选「查看生产门禁」,7 项全部通过(发布就绪、签名证明、审批窗口、策略绑定、当前信任根、运行快照、生产 Provider)。
|
|
100
|
-
2. 「激活到生产」→ 确认后显示「已激活生产」。生产环境不存在时**激活会自动创建**,但**不建集合**。
|
|
101
|
-
3. **马上开通生产集合**:控制台切到「生产环境」→「数据库」开通(按声明建集合)。否则所有人(含发布者)的窗口都切到生产后报 `COLLECTION_NOT_FOUND`。
|
|
102
|
-
4. 有后台能力的:应用窗口「权限」此时作用于生产数据域,在那里勾选要运行的后台能力。
|
|
103
|
-
5. 审批窗口只有**签名后 7 天**;过期后需为同一应用包新建候选重新签名(已就绪候选不能重签)。
|
|
104
|
-
|
|
105
|
-
手动路线容易漏第 3 步,能用 `prepare` 就用 `prepare`。生产环境里控制台的数据库、文件可直接修改(影响线上用户);云函数、日志只读。
|
|
64
|
+
## 3. 生产环境
|
|
106
65
|
|
|
107
|
-
|
|
66
|
+
- 生产是否开放由部署决定(发布信任配置就绪即开放,运维自动配置),控制台没有开关。未开放时带云资源的版本发布会在生产准备阶段失败——如实告诉用户这是平台边界。
|
|
67
|
+
- 生产数据域面向全体使用者、与开发数据域完全隔离:开发数据不会带过去。发布前确认同一版本已在开发环境验证过。
|
|
68
|
+
- 生产环境里控制台的数据库、文件可直接修改(影响线上用户);云函数、日志只读。
|
|
69
|
+
- 应用窗口「权限」在生产数据域单独授权:使用者要在那里勾选要运行的后台能力。
|
|
108
70
|
|
|
109
|
-
##
|
|
71
|
+
## 4. 分享给同事
|
|
110
72
|
|
|
111
|
-
-
|
|
112
|
-
-
|
|
113
|
-
-
|
|
114
|
-
- 让同事**一起开发**(上传、在控制台管理)是另一回事:管理员在控制台「团队」→「成员」里把他加为开发者。所有成员的上传都在「版本管理」里,成员之间可以用「切换到此版本」互相使用(含未发布的版本)。
|
|
115
|
-
- **撤回企业目录会让其他人已安装的该版本无法打开**——执行前告诉用户。
|
|
116
|
-
- 应用中心上传的新版本,若该应用已有企业可见版本会自动继承企业可见;`zleap-app publish` 永远是 private。
|
|
117
|
-
- 同事用「更新」升级到新版本,**新版本必须先签成「已就绪」**,否则更新被拦下。
|
|
73
|
+
- 给全企业用 = 「发布为线上版本」(见第 1 节)。同事在应用中心「发现」里安装;后台能力仍需同事自己在应用窗口「权限」里允许。
|
|
74
|
+
- 让同事**一起开发**(上传、在控制台管理)是另一回事:管理员在控制台「团队」→「成员」里把他加为开发者。所有成员的上传都在「版本管理」里。
|
|
75
|
+
- 开发版本只对成员可见,开发数据域也只对成员开放;非成员要等发布为线上版本后才能用。
|
|
118
76
|
|
|
119
|
-
##
|
|
77
|
+
## 5. 版本迭代
|
|
120
78
|
|
|
121
79
|
| 场景 | 做法 |
|
|
122
80
|
| --- | --- |
|
|
123
|
-
| 自己换到新版本 | `npm run deploy`;或 `npx zleap-app update <app_id> --expected-version-id <当前> --version-id
|
|
124
|
-
|
|
|
81
|
+
| 自己换到新版本 | `npm run deploy`;或 `npx zleap-app update <app_id> --expected-version-id <当前> --version-id <新>`;或控制台「切换到此版本」 |
|
|
82
|
+
| 线上回退 | 把旧版本再发布一次:`npm run release -- --version-id <旧> --yes`,或控制台「回退到此版本」(**不回退数据**) |
|
|
83
|
+
| 本人安装回退 | `npx zleap-app rollback <app_id> --expected-version-id <当前> --version-id <旧>` |
|
|
125
84
|
| 改了 data/storage 声明 | CLI 返回 `DATA_MIGRATION_REQUIRED` 并保持原版本;平台不做迁移。已建集合结构不会变,改结构 = 新集合 + 迁移 |
|
|
126
|
-
|
|
|
85
|
+
| 查看版本 | `npm run versions`(`npx zleap-app releases <app_id>`);本人安装 `npx zleap-app diagnose <app_id>` |
|
|
127
86
|
|
|
128
87
|
所有写操作结果未知(`COMMIT_UNKNOWN`,退出码 6)时:先 `diagnose` / `status` / `operation --request-id` 核对,**不要盲目重试**。
|
|
129
88
|
|
|
130
|
-
##
|
|
89
|
+
## 6. 上线前检查清单(逐项向用户确认)
|
|
131
90
|
|
|
132
91
|
- [ ] 集合结构已定稿(上线后不能改)
|
|
133
92
|
- [ ] `npx zleap-app check <dist 或项目> --target <OS>` 在目标部署上通过
|
|
134
|
-
- [ ]
|
|
135
|
-
- [ ]
|
|
93
|
+
- [ ] 控制台概览开通清单完成,「运行体检」通过
|
|
94
|
+
- [ ] (有后台)后台能力已允许、函数「可调用」,`invoke --environment dev` 结果正确
|
|
136
95
|
- [ ] 同一版本完成真实读写验证(用户手动,或 `zleap-app test` 浏览器验收)
|
|
137
|
-
- [ ]
|
|
138
|
-
- [ ] 已发布到企业目录,同事侧安装后能打开并读写
|
|
96
|
+
- [ ] 用户明确要求发布,并确认了要发布的版本号
|
|
139
97
|
|
|
140
98
|
## 参考资料
|
|
141
99
|
|
|
142
|
-
- references/dev-to-production.md —
|
|
143
|
-
- references/console-release.md —
|
|
144
|
-
- references/console-legacy-release.md — 「版本与激活」页(旧应用:候选、签名、激活、生产门禁、使用情况)
|
|
100
|
+
- references/dev-to-production.md — 端到端流程与常见卡点
|
|
101
|
+
- references/console-release.md — 「版本管理」:发布线上版本、回退、切换版本、命令行发布
|
|
145
102
|
- references/console-functions.md — 后台能力授权、试运行、触发器
|
|
146
103
|
- references/console-workspace.md — 概览开通清单与运行体检
|
|
147
|
-
- references/app-center-publish.md / app-center-install.md —
|
|
104
|
+
- references/app-center-publish.md / app-center-install.md — 上传、安装授权、更新
|
|
148
105
|
- references/console-members.md — 创建应用(appid)、成员与角色
|
|
149
106
|
- references/permissions.md、references/status-codes.md
|
|
@@ -16,8 +16,8 @@
|
|
|
16
16
|
>
|
|
17
17
|
> 「安装」装的是目录里该应用的**当前版本**:
|
|
18
18
|
>
|
|
19
|
-
> -
|
|
20
|
-
> -
|
|
19
|
+
> - 已发布过线上版本时,装的就是**线上版本**;
|
|
20
|
+
> - 还没发布过线上版本时,只有应用成员能安装和使用开发版本。
|
|
21
21
|
>
|
|
22
22
|
> 创建了但还没上传过任何版本的应用是草稿,不会出现在应用中心。
|
|
23
23
|
>
|
|
@@ -63,12 +63,12 @@
|
|
|
63
63
|
|
|
64
64
|
安装授权**不等于**一切就绪:
|
|
65
65
|
|
|
66
|
-
| 安装之后 | 还需要什么
|
|
67
|
-
| ----------------------- |
|
|
68
|
-
| 云数据库 / 存储能读写 | 云环境、数据库、集合已就绪(声明了集合的应用安装时会自动创建开发环境并开通,通常一分钟内),且仍要过数据面的 ACL 检查
|
|
69
|
-
| 后台任务 / 云函数会运行 |
|
|
70
|
-
| 定时任务 | 开发者开放了的定时任务,在「权限」里对应后台能力下面有开关,自己决定开不开;时间和内容由开发者定
|
|
71
|
-
| Agent 能调用你的应用 | 安装不授予 Agent 调用权限
|
|
66
|
+
| 安装之后 | 还需要什么 |
|
|
67
|
+
| ----------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
|
68
|
+
| 云数据库 / 存储能读写 | 云环境、数据库、集合已就绪(声明了集合的应用安装时会自动创建开发环境并开通,通常一分钟内),且仍要过数据面的 ACL 检查 |
|
|
69
|
+
| 后台任务 / 云函数会运行 | **不会自动启动**:安装时后台能力被预置为「停用」,需要在应用窗口「权限」里允许后台运行;绑定就绪发布由平台自动完成(上传自动签名,缺签时当场补签并绑定) |
|
|
70
|
+
| 定时任务 | 开发者开放了的定时任务,在「权限」里对应后台能力下面有开关,自己决定开不开;时间和内容由开发者定 |
|
|
71
|
+
| Agent 能调用你的应用 | 安装不授予 Agent 调用权限 |
|
|
72
72
|
|
|
73
73
|
所以「装上了但读不到数据」通常是云资源还没准备好,而不是没授权。排查顺序见 [从开发到上线](dev-to-production.md)。
|
|
74
74
|
|
|
@@ -85,7 +85,7 @@
|
|
|
85
85
|
| 被拒绝 | 「操作已被拒绝」 |
|
|
86
86
|
| 打开失败 | 「暂时无法打开应用,请刷新后重试。」 |
|
|
87
87
|
|
|
88
|
-
服务端常见拒绝原因:「该 APP
|
|
88
|
+
服务端常见拒绝原因:「该 APP 已在此空间安装」、「当前应用版本不可安装」(当前版本已停用或不可见)、「APP id=… 不存在或已停用」。
|
|
89
89
|
|
|
90
90
|
链接里带了空间范围参数时,会提示:
|
|
91
91
|
|
|
@@ -130,9 +130,9 @@
|
|
|
130
130
|
|
|
131
131
|
## 更新与回滚
|
|
132
132
|
|
|
133
|
-
###
|
|
133
|
+
### 自动跟随线上版本
|
|
134
134
|
|
|
135
|
-
|
|
135
|
+
不需要使用者手动更新:
|
|
136
136
|
|
|
137
137
|
- 成员在控制台「版本管理」里发布新版本(或回退到旧版本)后,**不是应用成员的使用者下次打开应用时**,
|
|
138
138
|
宿主发现线上版本和自己装的不一样,会先把安装切到线上版本,显示「**正在更新到最新版本…**」,再加载应用;
|
|
@@ -179,8 +179,7 @@
|
|
|
179
179
|
> **目标版本必须有「就绪」的发布**(注意)
|
|
180
180
|
>
|
|
181
181
|
> 应用中心前端还会检查目标版本的 `release_id`:为空时显示「该版本尚未发布(release)。切过去后云函数等后台能力无法激活,请先由发布者签发该版本。」并阻止升级——包括没有云函数的纯前端应用(服务端预检对纯前端应用其实不拦,这是前后端判定不一致)。
|
|
182
|
-
>
|
|
183
|
-
> 平台 `appid` 应用不需要手动签发:声明了后台能力的版本上传时平台已自动签名,使用者也会自动跟随线上版本(见上文)。
|
|
182
|
+
> 带云函数 / 后台能力的版本上传时平台已自动签名;切换版本、重新保存权限或允许后台运行时,平台会自动补签并绑定,正常不需要发布者手动签发。
|
|
184
183
|
|
|
185
184
|
**更新时授权怎么处理**(`appversion/apply.go`):
|
|
186
185
|
|
|
@@ -277,8 +276,8 @@ CLI 走的是开发会话接口(`appinstallation/version.go` 的 `SwitchVersio
|
|
|
277
276
|
|
|
278
277
|
> 授权后,本应用可在关窗后按你勾选的能力运行(如定时巡检),以你的身份读写你在本应用中的数据。
|
|
279
278
|
|
|
280
|
-
|
|
281
|
-
|
|
279
|
+
勾选了但该版本还没有可用的签名发布时,会提示:「该版本还没有可用的签名发布,暂时无法执行。重新保存一次权限会自动补签。」
|
|
280
|
+
正常不会看到这条提示:上传时平台已自动签名,保存权限或允许后台运行时会自动绑定(必要时当场补签)。
|
|
282
281
|
|
|
283
282
|
**主按钮**:**保存并重新加载**。二次确认:
|
|
284
283
|
|
|
@@ -291,15 +290,15 @@ CLI 走的是开发会话接口(`appinstallation/version.go` 的 `SwitchVersio
|
|
|
291
290
|
|
|
292
291
|
声明了安装级权限的应用,对话框底部还有一行「设置存储、空间文件、通知等其他权限」和「**管理其他权限**」按钮,点开即下文的「数据权限」对话框。
|
|
293
292
|
|
|
294
|
-
| 提示 | 含义
|
|
295
|
-
| ---------------------------------------------- |
|
|
296
|
-
| 当前安装未申请此能力,或你无权访问应用云空间。 | 读取授权失败。常见原因:在 dev
|
|
297
|
-
| 授权保存未确认,请重新读取后核对。 | 保存失败或结果不明,关掉重开对话框核对当前状态
|
|
293
|
+
| 提示 | 含义 |
|
|
294
|
+
| ---------------------------------------------- | ------------------------------------------------------------------------------- |
|
|
295
|
+
| 当前安装未申请此能力,或你无权访问应用云空间。 | 读取授权失败。常见原因:在 dev 数据域下你不是应用成员——dev 默认只对应用成员开放 |
|
|
296
|
+
| 授权保存未确认,请重新读取后核对。 | 保存失败或结果不明,关掉重开对话框核对当前状态 |
|
|
298
297
|
|
|
299
298
|
> **生产未开放时,同事用不了 Cloud 数据**(注意)
|
|
300
299
|
>
|
|
301
|
-
> 部署未开放生产环境时,所有人都走 dev 数据域,而 dev
|
|
302
|
-
>
|
|
300
|
+
> 部署未开放生产环境时,所有人都走 dev 数据域,而 dev 默认**只允许应用成员**访问(部署可另行放开)。
|
|
301
|
+
> 此时你把应用发布为线上版本后,同事能安装、能打开,但云数据读写会被拒绝。这属于「平台未开放」,不是你的代码写错了。
|
|
303
302
|
|
|
304
303
|
### 「数据权限」(安装级权限)
|
|
305
304
|
|
|
@@ -364,12 +363,12 @@ CLI 走的是开发会话接口(`appinstallation/version.go` 的 `SwitchVersio
|
|
|
364
363
|
| **站点打开失败,请重试** | 空间站点票据获取失败 | 重试 |
|
|
365
364
|
| **文件打开失败,请检查应用或文件权限后重新打开。** | 用「打开方式」启动应用失败 | 检查文件权限 |
|
|
366
365
|
|
|
367
|
-
|
|
366
|
+
应用被管理员下架、被删除,或你的安装版本变化时,已打开的窗口会失效并显示「无法加载应用,请重试。」
|
|
368
367
|
|
|
369
368
|
## 相关
|
|
370
369
|
|
|
371
370
|
- 应用中心界面总览(文档站 ./overview)
|
|
372
371
|
- [上传与发布应用](app-center-publish.md)
|
|
373
372
|
- [权限与授权](permissions.md) — 权限模型完整说明
|
|
374
|
-
- [云开发控制台 · 版本管理
|
|
373
|
+
- [云开发控制台 · 版本管理](console-release.md) — 发布线上版本、切换版本与发布记录
|
|
375
374
|
- [状态与错误码](status-codes.md)
|