Skip to content

D
Docs

OpenHarmony / Docs
大约 2 年 前同步成功

通知 161
Star 293
Fork 28
D
Docs
未验证 提交 bb75667e 编写于 作者: L lwx1153805 提交者： Gitee
浏览文件
操作

update zh-cn/device-dev/quick-start/quickstart-pkg-3568-helloworld.md. 

Signed-off-by: Nlwx1153805 <longshining2@huawei.com>
上级 d72aed53
隐藏空白更改
内联 并排
Showing with 102 addition and 70 deletion
zh-cn/device-dev/quick-start/quickstart-pkg-3568-helloworld.md
浏览文件 @ bb75667e
...@@ -4,13 +4,15 @@ ...@@ -4,13 +4,15 @@
下方将展示如何在单板上运行第一个应用程序，其中包括新建应用程序、编译、烧写、运行等步骤，最终输出“Hello World！”。 下方将展示如何在单板上运行第一个应用程序，其中包括新建应用程序、编译、烧写、运行等步骤，最终输出“Hello World！”。
## 示例目录 ## 示例目录
拉取openharmony项目代码，在代码根目录创建sample子系统文件夹，在子系统目录下创建hello部件文件夹，hello文件夹中创建hello源码目录，构建文件BUILD.gn及部件配置文件bundle.json。
示例完整目录如下。 示例完整目录如下。
``` ```
applications/sample/hello sample/hello
│── BUILD.gn │── BUILD.gn
│── include │── include
│ └── helloworld.h │ └── helloworld.h
...@@ -31,7 +33,7 @@ vendor/hihope ...@@ -31,7 +33,7 @@ vendor/hihope
1. 创建目录，编写业务代码。 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++的代码开发。
``` ```
...@@ -52,7 +54,7 @@ vendor/hihope ...@@ -52,7 +54,7 @@ vendor/hihope
} }
``` ```
再添加头文件applications/sample/hello/include/helloworld.h，代码如下所示。 再添加头文件sample/hello/include/helloworld.h，代码如下所示。
``` ```
...@@ -75,85 +77,115 @@ vendor/hihope ...@@ -75,85 +77,115 @@ vendor/hihope
``` ```
2. 新建编译组织文件。 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") # 导入编译模板 import("//build/ohos.gni") # 导入编译模板
ohos_executable("helloworld") { # 可执行模块 ohos_executable("helloworld") { # 可执行模块
sources = [ # 模块源码 sources = [ # 模块源码
"src/helloworld.c" "src/helloworld.c"
] ]
include_dirs = [ # 模块依赖头文件目录 include_dirs = [ # 模块依赖头文件目录
"include" "include"
] ]
cflags = [] cflags = []
cflags_c = [] cflags_c = []
cflags_cc = [] cflags_cc = []
ldflags = [] ldflags = []
configs = [] configs = []
deps =[] # 部件内部依赖 deps =[] # 部件内部依赖
part_name = "hello" # 所属部件名称，必选 part_name = "hello" # 所属部件名称，必选
install_enable = true # 是否默认安装（缺省默认不安装），可选 install_enable = true # 是否默认安装（缺省默认不安装），可选
} }
``` ```
2. 新建applications/sample/hello/bundle.json文件，添加sample部件描述，内容如下所示。
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", "name": "@ohos/hello",
"description": "Hello world example.", "description": "Hello world example.",
"version": "3.1", "version": "3.1",
"license": "Apache License 2.0", "license": "Apache License 2.0",
"publishAs": "code-segment", "publishAs": "code-segment",
"segment": { "segment": {
"destPath": "applications/sample/hello" "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": {}, "build": {
"scripts": {}, "sub_component": [
"component": { "//sample/hello:helloworld"
"name": "hello", ],
"subsystem": "sample", "inner_kits": [],
"syscap": [], "test": []
"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": []
}
} }
} }
``` }
```
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": { "sample": {
"path": "applications/sample/hello", "path": "sample",
"name": "sample" "name": "sample"
}, },
``` ```
4. 修改产品配置文件。 5. 修改产品配置文件。
在vendor/hihope/rk3568/config.json中添加对应的hello部件，直接添加到原有部件后即可。 > ![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。
```
"usb:usb_manager_native":{}, - 3.2-Beta2之前版本
"applications:prebuilt_hap":{},
"sample:hello":{}, 在productdefine/common/products/rk3568.json中添加对应的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.
先完成此消息的编辑！
想要评论请 注册 或