From e88ea5fe72887b12601644b68169cb1e62acc936 Mon Sep 17 00:00:00 2001 From: handyohos Date: Mon, 11 Apr 2022 14:56:33 +0800 Subject: [PATCH] feat: add group information to each git repo. MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 1）为每个git仓添加组信息，便于按组下载代码。 Signed-off-by: handyohos Change-Id: I5d45d3dfa4527b4a7447ce271a6b07f8ce5812bd --- README.md | 71 +++++- default.xml | 704 +++++++++++++++++++++++++--------------------------- 2 files changed, 415 insertions(+), 360 deletions(-) mode change 100644 => 100755 default.xml diff --git a/README.md b/README.md index 1618668..1b558f7 100644 --- a/README.md +++ b/README.md @@ -1,8 +1,77 @@ # OpenHarmony Community 欢迎来到OpenHarmony社区！ +## 1. 仓的分类说明 -## [matrix_product.csv文件](https://gitee.com/openharmony/manifest/blob/master/matrix_product.csv)说明 +为了支持按照不同类型下载代码，OpenHarmony为每个代码仓定义了以下类别： + +| 分类 | 分类说明 | group | +| -------------- | ------------------------------------------------------------ | ------------- | +| **轻量系统仓** | 适用于轻量系统的代码仓 | ohos:mini | +| **小型系统仓** | 适用于小型系统的代码仓 | ohos:small | +| **标准系统仓** | 适用于标准系统的代码仓 | ohos:standard | +| 系统组件仓 | 标准系统中与硬件无关的代码仓，构建产物都部署在/system目录下。 | ohos:system | +| 芯片组件仓 | 标准系统中与芯片或硬件相关的仓，构建产物部署在/vendor或/chipset目录下。 | ohos:chipset | + +一个仓可以归属于多个group，如下代码所示，groups中多个group以","连接在一起。 + +```xml + + + +``` + +每个仓可以适用于mini,small或standard系统，如果适用于standard系统，同时需要明确是ohos:system类型还是ohos:chipset类型。 + +每个仓都需要加入默认的default组。 + +## 2. 平台仓和芯片仓 + +OpenHarmony会支持越来越多的芯片平台，每个芯片平台会在device和vendor目录下创建相应的仓；为了区分，我们把这类仓称为芯片仓，其它的仓称为平台仓。平台仓和芯片仓具有不同的生命周期，芯片仓可能会随着硬件的演进而逐渐废弃，而平台仓相对与具体的硬件关系不大，生命周期相对更长。 + +平台仓都组织在**manifests/ohos/ohos.xml**文件中，而芯片仓都组织在**manifests/chipsets/**目录下。全量的代码仓组织形式如下所示： + +``` +manifest + ├── default.xml + │ └── ohos + │ └── ohos.xml + └── chipsets +    ├── all.xml +    ├── chipset1.xml +    ├── chipset2.xml +    ├── chipsetN.xml +    ├── chipset1 +    │   └── chipset1-detail.xml +    ├── chipset2 +    │   └── chipset2-detail.xml +    └── chipsetN +       └── chipsetN-detail.xml +``` + +- default.xml由ohos/ohos.xml和chipsets/all.xml组成，是所有平台仓和芯片仓的集合；通过此方式可以下载所有代码仓。 +- chipsets/chipsetN/chipsetN-detail.xml是单个芯片平台所引入的仓集合，chipsets/chipsetN.xml是由ohos/ohos.xml和chipsetN-detail.xml仓组合而成，用于下载该芯片平台的全量仓。 +- chipsets/all.xml则是所有芯片平台xxx/xxx-detail.xml的仓组合，用于汇总所有芯片仓。 + +按照上述分类，可支持各种代码下载方式： + +| **统分类** | **代码下载方式** | **下载命令** | **说明** | +| ---------- | ---------------- | ------------------------------------------------------------ | --------------------------------------------------- | +| 所有系统 | 全量代码 | repo init -u *URL* -b master | 默认下载OpenHarmony的全量代码（兼容已有下载命令）。 | +| 轻量系统 | 全量代码 | repo init -u *URL* -b master **-g ohos:mini** | 下载轻量系统全量代码。 | +| 轻量系统 | 指定芯片代码 | repo init -u *URL* -b master **-m chipsets/chipsetN.xml -g ohos:mini** | 下载轻量系统指定芯片的代码。 | +| 小型系统 | 全量代码 | repo init -u *URL* -b master **-g ohos:small** | 下载小型系统全量代码。 | +| 小型系统 | 指定芯片代码 | repo init -u *URL* -b master **-m chipsets/chipsetN.xml -g ohos:small** | 下载小型系统指定芯片的代码。 | +| 标准系统 | 全量代码 | repo init -u *URL* -b master **-g ohos:standard** | 下载标准系统的全量代码。 | +| 标准系统 | 指定芯片代码 | repo init -u *URL* -b master **-m chipsets/chipsetN.xml -g ohos:standard** | 下载标准系统指定芯片的代码。 | +| 标准系统 | 系统组件代码 | repo init -u *URL* -b master **-g ohos:system** | 下载标准系统系统组件的代码。 | +| 标准系统 | 芯片组件代码 | repo init -u *URL* -b master **-g ohos:chipset** | 下载芯片组件的代码（所有芯片平台）。 | +| 标准系统 | 指定芯片组件代码 | repo init -u *URL* -b master **-m chipsets/chipsetN.xml -g ohos:chipset** | 下载指定芯片chipsetN的芯片组件代码。 | + + + + +## 3. [matrix_product.csv文件](https://gitee.com/openharmony/manifest/blob/master/matrix_product.csv)说明 matrix_product.csv用于管理OpenHarmony代码仓对应的编译形态，以及每个设备形态下面对应的测试用例。 diff --git a/default.xml b/default.xml old mode 100644 new mode 100755 index b7828ca..594b328 --- a/default.xml +++ b/default.xml @@ -3,368 +3,354 @@ - - - - - - - - - - - - + + + + + + + + + + + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + - - - - - - - - + + + + + + -- GitLab