diff --git a/zh-cn/device-dev/quick-start/quickstart-standard-running-hi3516-create.md b/zh-cn/device-dev/quick-start/quickstart-standard-running-hi3516-create.md index 1a6786fdd740ca930ac1d38f525acbb594909cfd..9fab1cd171780c18c170118777415572f5d437d2 100644 --- a/zh-cn/device-dev/quick-start/quickstart-standard-running-hi3516-create.md +++ b/zh-cn/device-dev/quick-start/quickstart-standard-running-hi3516-create.md @@ -1,31 +1,34 @@ -# 创建应用程序 +# 编写“Hello World”程序 -下方将通过修改源码的方式展示如何在单板上运行第一个应用程序,其中包括新建应用程序、编译、烧写、运行等步骤,最终输出“Hello World!”。 -这里演示在原有applications子系统下,添加hello部件以及该部件下的helloworld模块。 +下方将展示如何在单板上运行第一个应用程序,其中包括新建应用程序、编译、烧写、运行等步骤,最终输出“Hello World!”。 + +## 示例目录 示例完整目录如下。 ``` -applications/standard/hello -├── helloworld -│ ├── BUILD.gn -│ ├── include +applications/sample/hello +│ │── BUILD.gn +│ │── include │ │ └── helloworld.h -│ └── src -│ └── helloworld.c -├── ohos.build -│ +│ │── src +│ │ └── helloworld.c +│ └── bundle.json +build +└── subsystem_config.json productdefine/common └── products - └── Hi3516DV300.json + └── Hi3568DV300.json ``` -下方为新建应用程序步骤,请在[获取源码](quickstart-standard-sourcecode-acquire.md)章节下载的源码目录中进行下述操作: +## 开发步骤 + +请在源码目录中通过以下步骤创建“Hello World”应用程序: -1. 新建目录及源码。 +1. 创建目录,编写业务代码。 - 新建applications/standard/hello/helloworld/src/helloworld.c目录及文件,代码如下所示,用户可以自定义修改打印内容(例如:修改World为OHOS)。其中helloworld.h包含字符串打印函数HelloPrint的声明。当前应用程序可支持标准C及C++的代码开发。 + 新建applications/sample/hello/src/helloworld.c目录及文件,代码如下所示,用户可以自定义修改打印内容(例如:修改World为OH)。其中helloworld.h包含字符串打印函数HelloPrint的声明。当前应用程序可支持标准C及C++的代码开发。 ``` #include @@ -45,7 +48,7 @@ productdefine/common } ``` - 再添加头文件applications/standard/hello/helloworld/include/helloworld.h,代码如下所示。 + 再添加头文件applications/sample/hello/include/helloworld.h,代码如下所示。 ``` #ifndef HELLOWORLD_H @@ -67,13 +70,13 @@ productdefine/common ``` 2. 新建编译组织文件。 - 1. 新建applications/standard/hello/helloworld/BUILD.gn文件,内容如下所示: + 1. 新建applications/sample/hello/BUILD.gn文件,内容如下所示: ``` import("//build/ohos.gni") # 导入编译模板 ohos_executable("helloworld") { # 可执行模块 sources = [ # 模块源码 - "src/helloworld.c" + "src/helloworld.c" ] include_dirs = [ # 模块依赖头文件目录 "include" @@ -84,46 +87,69 @@ productdefine/common ldflags = [] configs = [] deps =[] # 部件内部依赖 - part_name = "hello" # 所属部件名称,必选 install_enable = true # 是否默认安装(缺省默认不安装),可选 } ``` - 2. 新建applications/standard/hello/ohos.build文件,添加hello部件描述,内容如下所示。 + 2. 新建applications/sample/hello/bundle.json文件,添加sample部件描述,内容如下所示。 ``` { - "subsystem": "applications", # 子系统名 - "parts": { # 包含部件 - "hello": { # 新建部件名 - "version": "1.0.0", # 版本 - "variants": [ # 变种版本 - "wearable", - "phone" - ], - "module_list": [ # 部件包含模块的gn目标 - "//applications/standard/hello/helloworld:helloworld" - ], - "inner_kits": [ # 提供给其他部件的接口 - ], - "test_list": [ # 测试用例 - ] + "name": "@ohos/hello", + "description": "Hello world example.", + "version": "3.1", + "license": "Apache License 2.0", + "publishAs": "code-segment", + "segment": { + "destPath": "applications/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": [] + }, + "build": { + "sub_component": [ + "//applications/sample/hello:helloworld" + ], + "inner_kits": [], + "test": [] + } } - } } ``` - ohos.build文件包含两个部分,第一部分subsystem说明该子系统的名称,parts定义该子系统包含的部件,要添加一个部件,需要把该部件对应的内容添加进parts中去。添加的时候需要指明该部件包含的模块module\_list,假如有提供给其它部件的接口,需要在inner\_kits中说明,假如有测试用例,需要在test\_list中说明,inner\_kits与test\_list没有也可以不添加。 + bundle.json文件包含两个部分,第一部分描述该部件所属子系统的信息,第二部分component则定义该部件构建相关配置。添加的时候需要指明该部件包含的模块sub\_component,假如有提供给其它部件的接口,需要在inner\_kits中说明,假如有测试用例,需要在test中说明,inner\_kits与test没有也可以不添加。 + +3. 修改子系统配置文件。 + + 在build/subsystem\_config.json中添加新建的子系统的配置。 + + ``` + "sample": { + "path": "applications/sample/hello", + "name": "sample" + }, + ``` -3. 修改产品配置文件。 +4. 修改产品配置文件。 - 在productdefine\\common\\products\\Hi3516DV300.json中添加对应的hello部件,直接添加到原有部件后即可。 + 在productdefine/common/products/Hi3516DV300.json中添加对应的hello部件,直接添加到原有部件后即可。 ``` "usb:usb_manager_native":{}, "applications:prebuilt_hap":{}, - "applications:hello":{}, + "sample:hello":{}, "wpa_supplicant-2.9:wpa_supplicant-2.9":{}, ```