Skip to content

D
Docs

OpenHarmony / Docs
1 年多 前同步成功

通知 159
Star 292
Fork 28
D
Docs
未验证 提交 b24160f2 编写于 作者: O openharmony_ci 提交者： Gitee
浏览文件
操作

!13987 【轻量级 PR】：修正rk3568新增helloword部件指导文档 

Merge pull request !13987 from lwx1153805/N/A
上级 b5e931c5 d11b4b12
隐藏空白更改
内联 并排
Showing with 103 addition and 75 deletion
zh-cn/device-dev/quick-start/quickstart-ide-3568-helloworld.md
浏览文件 @ b24160f2
......@@ -11,11 +11,12 @@
## 示例目录
拉取openharmony项目代码，在代码根目录创建sample子系统文件夹，在子系统目录下创建hello部件文件夹，hello文件夹中创建hello源码目录，构建文件BUILD.gn及部件配置文件bundle.json。
示例完整目录如下。
```
applications/sample/hello
sample/hello
│── BUILD.gn
│── include
│ └── helloworld.h
......@@ -24,9 +25,9 @@ applications/sample/hello
├── bundle.json
build
└── subsystem_config.json
productdefine/common
└── products
└── rk3568.json
vendor/hihope
└── rk3568
└── config.json
```
......@@ -36,7 +37,7 @@ productdefine/common
1. 创建目录，编写业务代码。
新建applications/sample/hello/src/helloworld.c目录及文件，代码如下所示，用户可以自定义修改打印内容（例如：修改World为OHOS）。其中helloworld.h包含字符串打印函数HelloPrint的声明。当前应用程序可支持标准C及C++的代码开发。
新建sample/hello/src/helloworld.c目录及文件，代码如下所示，用户可以自定义修改打印内容（例如：修改World为OHOS）。其中helloworld.h包含字符串打印函数HelloPrint的声明。当前应用程序可支持标准C及C++的代码开发。
```
......@@ -57,7 +58,7 @@ productdefine/common
}
```
再添加头文件applications/sample/hello/include/helloworld.h，代码如下所示。
再添加头文件sample/hello/include/helloworld.h，代码如下所示。
```
......@@ -80,88 +81,115 @@ productdefine/common
```
2. 新建编译组织文件。
1. 新建applications/sample/hello/BUILD.gn文件，内容如下所示：
新建sample/hello/BUILD.gn，创建方法可参考：[模块配置规则](https://gitee.com/openharmony/docs/blob/master/zh-cn/device-dev/subsystems/subsys-build-module.md)。
创建
BUILD.gn内容如下所示：
```
import("//build/ohos.gni") # 导入编译模板
ohos_executable("helloworld") { # 可执行模块
sources = [ # 模块源码
"src/helloworld.c"
]
include_dirs = [ # 模块依赖头文件目录
"include"
]
cflags = []
cflags_c = []
cflags_cc = []
ldflags = []
configs = []
deps =[] # 部件内部依赖
part_name = "hello" # 所属部件名称，必选
install_enable = true # 是否默认安装（缺省默认不安装），可选
}
```
2. 新建applications/sample/hello/bundle.json文件，添加sample部件描述，内容如下所示。
```
import("//build/ohos.gni") # 导入编译模板
ohos_executable("helloworld") { # 可执行模块
sources = [ # 模块源码
"src/helloworld.c"
]
include_dirs = [ # 模块依赖头文件目录
"include"
]
cflags = []
cflags_c = []
cflags_cc = []
ldflags = []
configs = []
deps =[] # 部件内部依赖
part_name = "hello" # 所属部件名称，必选
install_enable = true # 是否默认安装（缺省默认不安装），可选
}
```
3. 新建部件配置规则文件
新建sample/hello/bundle.json文件，添加sample部件描述，创建方法可参考：[部件配置规则](https://gitee.com/openharmony/docs/blob/master/zh-cn/device-dev/subsystems/subsys-build-component.md)。
bundle.json内容如下所示。
```
{
"name": "@ohos/hello",
"description": "Hello world example.",
"version": "3.1",
"license": "Apache License 2.0",
"publishAs": "code-segment",
"segment": {
"destPath": "applications/sample/hello"
```
{
"name": "@ohos/hello",
"description": "Hello world example.",
"version": "3.1",
"license": "Apache License 2.0",
"publishAs": "code-segment",
"segment": {
"destPath": "sample/hello"
},
"dirs": {},
"scripts": {},
"component": {
"name": "hello",
"subsystem": "sample",
"syscap": [],
"features": [],
"adapted_system_type": [ "mini", "small", "standard" ],
"rom": "10KB",
"ram": "10KB",
"deps": {
"components": [],
"third_party": []
},
"dirs": {},
"scripts": {},
"component": {
"name": "hello",
"subsystem": "sample",
"syscap": [],
"features": [],
"adapted_system_type": [ "mini", "small", "standard" ],
"rom": "10KB",
"ram": "10KB",
"deps": {
"components": [],
"third_party": []
},
"build": {
"sub_component": [
"//applications/sample/hello:helloworld"
],
"inner_kits": [],
"test": []
}
"build": {
"sub_component": [
"//sample/hello:helloworld"
],
"inner_kits": [],
"test": []
}
}
```
}
```
bundle.json文件包含两个部分，第一部分描述该部件所属子系统的信息，第二部分component则定义该部件构建相关配置。添加的时候需要指明该部件包含的模块sub_component，假如有提供给其它部件的接口，需要在inner_kits中说明，假如有测试用例，需要在test中说明，inner_kits与test没有也可以不添加。
bundle.json文件包含两个部分，第一部分描述该部件所属子系统的信息，第二部分component则定义该部件构建相关配置。添加的时候需要指明该部件包含的模块sub_component，假如有提供给其它部件的接口，需要在inner_kits中说明，假如有测试用例，需要在test中说明，inner_kits与test没有也可以不添加。
3. 修改子系统配置文件。
4. 修改子系统配置文件。
在build/subsystem_config.json中添加新建的子系统的配置。
在build/subsystem_config.json中添加新建的子系统的配置。修改方法可参考：[子系统配置规则](https://gitee.com/openharmony/docs/blob/master/zh-cn/device-dev/subsystems/subsys-build-subsystem.md)。
新增子系统的配置如下所示。
```
"sample": {
"path": "applications/sample/hello",
"path": "sample",
"name": "sample"
},
```
4. 修改产品配置文件。
在productdefine/common/products/rk3568.json中添加对应的hello部件，直接添加到原有部件后即可。
> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明：**
> 本章节操作是以OpenHarmony-v3.1-Release版本为例进行操作的，该版本中，RK3568的配置文件为productdefine/common/products/rk3568.json；从OpenHarmony-v3.2-Beta2版本开始，RK3568的配置文件为vendor/hihope/rk3568/config.json。
5. 修改产品配置文件。
> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明：**
> OpenHarmony-v3.2-Beta2之前版本，RK3568的产品配置文件为productdefine/common/products/rk3568.json；从OpenHarmony-v3.2-Beta2版本开始，RK3568的产品配置文件为vendor/hihope/rk3568/config.json。
- 3.2-Beta2之前版本
在productdefine/common/products/rk3568.json中添加对应的hello部件，直接添加到原有部件后即可。
```
"usb:usb_manager_native":{},
"applications:prebuilt_hap":{},
"sample:hello":{},
"wpa_supplicant-2.9:wpa_supplicant-2.9":{},
```
```
"usb:usb_manager_native":{},
"applications:prebuilt_hap":{},
"sample:hello":{},
"wpa_supplicant-2.9:wpa_supplicant-2.9":{},
```
- 3.2-Beta2及之后版本
在vendor/hihope/rk3568/config.json中添加对应的hello部件，直接添加到原有部件后即可。
```
{
"subsystem": "sample",
"components": [
{
"component": "hello",
"features": []
}
]
},
```
Markdown is supported
0% 或 .
You are about to add 0 people to the discussion. Proceed with caution.
先完成此消息的编辑！
想要评论请 注册 或