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