Skip to content

Commit 2f0a70e

Browse files
committed
feat(topic-update-manifest): add definition for the packages-v2 amendment
1 parent 1d010a0 commit 2f0a70e

File tree

2 files changed

+34
-1
lines changed

2 files changed

+34
-1
lines changed

content/developer/packaging/topic-update-manifest.md

Lines changed: 17 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -59,6 +59,23 @@ topics = [
5959
]
6060
```
6161

62+
Amendment: packages-v2
63+
---
64+
65+
{% card(type="success") %}
66+
This amendment has not been deployed yet - we will update the main text to reflect its replacement for `packages` following its deployment.
67+
此规范更新目前尚未实装;实装后将并入规范正文。
68+
{% end %}
69+
70+
In August 2025, we introduced the `[packages-v2]` section to help marking version ranges for important (and especially security) updates. The version range compares with the package version *before* the update, resolving an issue where, if the user happens to have missed the exact version defined in the metadata, they would never be prompted about the updates (in oma and potentially other package management frontends).
71+
72+
```toml
73+
[packages-v2]
74+
firefox = "<= 142"
75+
thunderbird = ">= 108 && < 142"
76+
seamonkey = "141 || 142 || 143"
77+
```
78+
6279
Files
6380
===
6481

content/developer/packaging/topic-update-manifest.zh.md

Lines changed: 17 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
+++
2-
title = "更新主题元数据"
2+
title = "更新主题元数据规范"
33
description = "安同 OS 更新元数据规范"
44
+++
55

@@ -56,6 +56,22 @@ topics = [
5656
]
5757
```
5858

59+
规范更新:packages-v2
60+
---
61+
62+
{% card(type="success") %}
63+
此规范更新目前尚未实装;实装后将并入规范正文。
64+
{% end %}
65+
66+
2025 年 8 月,我们引入了 `[packages-v2]` 字段,以便定义重要更新(尤其是安全更新)波及的软件包范围,并以更新前的软件包作为对比基准,解决用户因错过特定版本软件包更新而在 oma 等包管理前端中收不到更新公告的问题。该字段的写入样例如下:
67+
68+
```toml
69+
[packages-v2]
70+
firefox = "<= 142"
71+
thunderbird = ">= 108 && < 142"
72+
seamonkey = "141 || 142 || 143"
73+
```
74+
5975
文件存放
6076
===
6177

0 commit comments

Comments
 (0)