Merge pull request #229 from xen0n/wider-distro-compatibility

Document the deps baseline for platform support

docs/README.md

@@ -1,4 +1,7 @@
-# RuyiSDK 包管理器开发文档
+# RuyiSDK 包管理器的技术文档
+
+以下是一些面向 RuyiSDK 贡献者、打包者群体的技术文档。如果您是使用 RuyiSDK
+开发自己项目的用户，请参考 [RuyiSDK 官网文档](https://ruyisdk.org/docs/intro)。
 
 ## 第三方 RuyiSDK 生态
 
@@ -9,6 +12,7 @@
 * [`ruyi` 的构建方式](./building.md)
 * [CI: 自动化版本发布](./ci-release-automation.md)
 * [Repo CI: Self-hosted runner 管理](./ci-self-hosted-runner.md)
+* [`ruyi` 的依赖兼容基线](./dep-baseline.md)
 
 ## 软件源
 

docs/dep-baseline.md

@@ -0,0 +1,34 @@
+# `ruyi` 的依赖兼容基线
+
+为降低发行版打包的工作量，以及保证非单文件形式分发的 `ruyi` 能与发行版在系统级提供的各种依赖组件正常交互，有必要认真对待
+`ruyi` 的各种依赖的版本。在实现或修复某些功能的时候，如果涉及新增依赖或变更依赖版本，需要谨慎行事。
+
+本文档是对 RuyiSDK 文档站[《RuyiSDK 的平台支持情况》](https://ruyisdk.org/docs/Other/platform-support/)一文，从开发角度进行的补充：为了实现 RuyiSDK 所承诺的平台兼容性，在代码层面需要考虑的各项依赖的最低版本。
+
+以下是 `ruyi` 重点依赖的 **架构相关** 软件包在一些发行版的提供情况：
+
+| 发行版版本          | Python | pygit2 | pyyaml                 |
+|---------------------|--------|--------|------------------------|
+| Debian 12           | 3.1x   | 1.11.1 | 6.0   [^debian-pyyaml] |
+| Fedora 39           | 3.12   | 1.14.0 | 6.0.1                  |
+| Fedora 40           | 3.12   | 1.14.0 | 6.0.1                  |
+| Fedora 41           | 3.13   | 1.15.1 | 6.0.1                  |
+| openEuler 24.03 LTS | 3.11   | :x:    | 6.0.1                  |
+| openEuler 24.09     | 3.11   | :x:    | 6.0.1                  |
+| Ubuntu 22.04 LTS    | 3.10   | 1.6.1  | 5.4.1 [^debian-pyyaml] |
+| Ubuntu 24.04 LTS    | 3.12   | 1.14.1 | 6.0.1 [^debian-pyyaml] |
+
+[^debian-pyyaml]: 包名为 `python3-yaml`
+
+以下是 `ruyi` 依赖的 **架构无关** 软件包在一些发行版的提供情况：
+
+| 发行版版本          | arpy  | certifi    | jinja2 | packaging | requests | rich   | semver | tomlkit | typing\_extensions |
+|---------------------|-------|------------|--------|-----------|----------|--------|--------|---------|--------------------|
+| Debian 12           | 1.1.1 | 2020.6.20  | 3.0.3  | 21.3      | 2.25.1   | 11.2.0 | 2.10.2 | 0.9.2   | 3.10.0.2           |
+| Fedora 39           | 2.3.0 | 2023.05.07 | 3.1.4  | 23.1      | 2.28.2   | 13.5.2 | 3.0.2  | 0.11.4  | 4.12.2             |
+| Fedora 40           | 2.3.0 | 2023.05.07 | 3.1.4  | 23.2      | 2.31.0   | 13.7.0 | 3.0.2  | 0.12.3  | 4.12.2             |
+| Fedora 41           | 2.3.0 | 2023.05.07 | 3.1.4  | 24.1      | 2.32.3   | 13.7.1 | 3.0.2  | 0.12.4  | 4.12.2             |
+| openEuler 24.03 LTS | :x:   | 2024.2.2   | 3.1.3  | 23.2      | 2.31.0   | 13.7.1 | 3.0.2  | 0.12.3  | 4.10.0             |
+| openEuler 24.09     | :x:   | 2024.7.4   | 3.1.3  | 23.2      | 2.31.0   | 13.7.1 | 3.0.2  | 0.12.3  | 4.12.2             |
+| Ubuntu 22.04 LTS    | 1.1.1 | 2020.6.20  | 3.0.3  | 21.3      | 2.25.1   | 11.2.0 | 2.10.2 | 0.9.2   | 3.10.0.2           |
+| Ubuntu 24.04 LTS    | 1.1.1 | 2023.11.17 | 3.1.2  | 24.0      | 2.31.0   | 13.7.1 | 2.10.2 | 0.12.4  | 4.10.0             |