README_zh.md
1# vendor_kaihong
2
3## 介绍
4
5该仓库托管深圳开鸿数字产业发展有限公司开发的产品样例代码，主要包括深开鸿【金星】系列智慧屏khdvk_3566b开发板的相关案例代码。
6
7## 目录
8
9```
10vendor/kaihong
11├── khdvk_3566b # khdvk_3566b开发板
12├── khdvk_450a # khdvk_450a开发板
13└── ...
14```
15
16## 新建产品工程
17
18这里以深开鸿【金星】系列智慧屏（khdvk_3566b）开发板为例，用户可以将 "khdvk_3566b"样例复制一份，然后进行裁剪或者修改，实现自己的产品工程，下面举例说明如何新建一个工程。
19
20#### 新建产品工程
21
221、复制一份 vendor/kaihong目录下的"khdvk_3566b"放在同级目录下，并改名为自己产品工程的名称(例如：xxx_3566)；
23
242、进入 xxx_3566目录, 编辑config.json文件，修改product_name：
25
26```
27"product_name": "xxx_3566"
28```
29
303、在config.json中可删除xts、kv_store、文件管理子系统，保留kernel、startup、hiviewdfx、distributedschedule等必要的子系统，可移除如下代码段：
31
32```
33{
34 "subsystem": "utils",
35 "components": [
36 {
37 "component": "utils_base",
38 "features": []
39 },
40 {
41 "component": "jsapi_sys",
42 "features": []
43 },
44 {
45 "component": "jsapi_api",
46 "features": []
47 },
48 {
49 "component": "jsapi_util",
50 "features": []
51 },
52 {
53 "component": "jsapi_worker",
54 "features": []
55 },
56 {
57 "component": "utils_memory",
58 "features": []
59 }
60 ]
61},
62{
63 "subsystem": "xts",
64 "components": [
65 {
66 "component": "xts_acts",
67 "features": []
68 },
69 {
70 "component": "xts_hats",
71 "features": []
72 },
73 {
74 "component": "xts_dcts",
75 "features": []
76 }
77 ]
78}
79```
80
814、同时board/kaihong目录新建xxx_3566目录，编辑 "xxx_3566/BUILD.gn"，group名：
82
83```
84group("xxx_3566") {
85}
86```
87
885、在OpenHarmony源码根目录下，执行./build.sh --product-name xxx_3566, out目录出现自己的产品名称 "xxx_3566"：
89
90
91
92至此，一个简单的产品工程搭建完成，用户可按此方法，搭建自己产品工程。
93
94详细的产品编译构建适配流程，请参考[编译构建适配流程](https://gitee.com/openharmony/docs/blob/master/zh-cn/device-dev/porting/porting-chip-prepare-process.md)
95
966、XTS编译方法
97
986.1、acts测试
99
100进入到源码目录：test/xts/hats/
101
102执行编译命令：
103
104```
105./build.sh suite=acts system_size=standard product_name=khdvk_3566b target_arch=arm64
106```
107
108输出目录：
109
110out/khdvk_3566b/suites/acts/testcases/
111
1126.2、hats测试
113
114进入到源码目录：test/xts/hats/
115
116执行编译命令：
117
118```
119./build.sh suite=hats system_size=standard product_name=khdvk_3566b target_arch=arm64
120```
121
122输出目录：
123
124out/khdvk_3566b/suites/hats/testcases/
125
126## 贡献
127
128[如何参与](https://gitee.com/openharmony/docs/blob/HEAD/zh-cn/contribute/%E5%8F%82%E4%B8%8E%E8%B4%A1%E7%8C%AE.md)
129
130[Commit message规范](https://gitee.com/openharmony/device_qemu/wikis/Commit%20message%E8%A7%84%E8%8C%83?sort_id=4042860)
131
132## 相关仓
133
134* [device/board/kaihong](https://gitee.com/openharmony-sig/device_board_kaihong)
135* [device/soc/rockchip](https://gitee.com/openharmony-sig/device_soc_rockchip)
136* [device_soc_gigadevice](https://gitee.com/openharmony-sig/device_soc_gigadevice)
137
138