1# 编写“Hello World”程序 2 3 4下方将展示如何在单板上运行第一个应用程序，其中包括新建应用程序、编译、烧写、运行等步骤，最终输出“Hello World！”。 5 6 7## 前提条件 8 9已参考[创建工程并获取源码](quickstart-ide-import-project.md)，创建RK3568开发板的源码工程。 10 11 12## 示例目录 13 14拉取openharmony项目代码，在代码根目录创建sample子系统文件夹，在子系统目录下创建hello部件文件夹，hello文件夹中创建hello源码目录，构建文件BUILD.gn及部件配置文件bundle.json。 15示例完整目录如下。 16 17 18``` 19sample/hello 20│── BUILD.gn 21│── include 22│ └── helloworld.h 23│── src 24│ └── helloworld.c 25├── bundle.json 26build 27└── subsystem_config.json 28vendor/hihope 29└── rk3568 30 └── config.json 31``` 32 33 34## 开发步骤 35 36请在源码目录中通过以下步骤创建“Hello World”应用程序。 37 381. 创建目录，编写业务代码。 39 40 新建sample/hello/src/helloworld.c目录及文件，代码如下所示，用户可以自定义修改打印内容（例如：修改World为OHOS）。其中helloworld.h包含字符串打印函数HelloPrint的声明。当前应用程序可支持标准C及C++的代码开发。 41 42 43 ``` 44 #include <stdio.h> 45 #include "helloworld.h" 46 47 int main(int argc, char **argv) 48 { 49 HelloPrint(); 50 return 0; 51 } 52 53 void HelloPrint() 54 { 55 printf("\n\n"); 56 printf("\n\t\tHello World!\n"); 57 printf("\n\n"); 58 } 59 ``` 60 61 再添加头文件sample/hello/include/helloworld.h，代码如下所示。 62 63 64 ``` 65 #ifndef HELLOWORLD_H 66 #define HELLOWORLD_H 67 #ifdef __cplusplus 68 #if __cplusplus 69 extern "C" { 70 #endif 71 #endif 72 73 void HelloPrint(); 74 75 #ifdef __cplusplus 76 #if __cplusplus 77 } 78 #endif 79 #endif 80 #endif // HELLOWORLD_H 81 ``` 82 832. 新建编译组织文件。 84 85 新建sample/hello/BUILD.gn，创建方法可参考：[模块配置规则](../subsystems/subsys-build-module.md)。 86 创建 87 BUILD.gn内容如下所示： 88 89 ``` 90 import("//build/ohos.gni") # 导入编译模板 91 ohos_executable("helloworld") { # 可执行模块 92 sources = [ # 模块源码 93 "src/helloworld.c" 94 ] 95 include_dirs = [ # 模块依赖头文件目录 96 "include" 97 ] 98 cflags = [] 99 cflags_c = [] 100 cflags_cc = [] 101 ldflags = [] 102 configs = [] 103 deps =[] # 部件内部依赖 104 part_name = "hello" # 所属部件名称，必选 105 install_enable = true # 是否默认安装（缺省默认不安装），可选 106 } 107 ``` 108 1093. 新建部件配置规则文件 110 111 新建sample/hello/bundle.json文件，添加sample部件描述，创建方法可参考：[部件配置规则](../subsystems/subsys-build-component.md)。 112 113 bundle.json内容如下所示。 114 115 ``` 116 { 117 "name": "@ohos/hello", 118 "description": "Hello world example.", 119 "version": "3.1", 120 "license": "Apache License 2.0", 121 "publishAs": "code-segment", 122 "segment": { 123 "destPath": "sample/hello" 124 }, 125 "dirs": {}, 126 "scripts": {}, 127 "component": { 128 "name": "hello", 129 "subsystem": "sample", 130 "syscap": [], 131 "features": [], 132 "adapted_system_type": [ "mini", "small", "standard" ], 133 "rom": "10KB", 134 "ram": "10KB", 135 "deps": { 136 "components": [], 137 "third_party": [] 138 }, 139 "build": { 140 "sub_component": [ 141 "//sample/hello:helloworld" 142 ], 143 "inner_kits": [], 144 "test": [] 145 } 146 } 147 } 148 ``` 149 150 bundle.json文件包含两个部分，第一部分描述该部件所属子系统的信息，第二部分component则定义该部件构建相关配置。添加的时候需要指明该部件包含的模块sub_component，假如有提供给其它部件的接口，需要在inner_kits中说明，假如有测试用例，需要在test中说明，inner_kits与test没有也可以不添加。 151 1524. 修改子系统配置文件。 153 154 在build/subsystem_config.json中添加新建的子系统的配置。修改方法可参考：[子系统配置规则](../subsystems/subsys-build-subsystem.md)。 155 156 新增子系统的配置如下所示。 157 158 ``` 159 "sample": { 160 "path": "sample", 161 "name": "sample" 162 }, 163 ``` 164 1655. 修改产品配置文件。 166 167 >  **说明：** 168 > OpenHarmony-v3.2-Beta2之前版本，RK3568的产品配置文件为productdefine/common/products/rk3568.json；从OpenHarmony-v3.2-Beta2版本开始，RK3568的产品配置文件为vendor/hihope/rk3568/config.json。 169 170 - 3.2-Beta2之前版本 171 172 在productdefine/common/products/rk3568.json中添加对应的hello部件，直接添加到原有部件后即可。 173 174 ``` 175 "usb:usb_manager_native":{}, 176 "applications:prebuilt_hap":{}, 177 "sample:hello":{}, 178 "wpa_supplicant-2.9:wpa_supplicant-2.9":{}, 179 ``` 180 181 - 3.2-Beta2及之后版本 182 183 在vendor/hihope/rk3568/config.json中添加对应的hello部件，直接添加到原有部件后即可。 184 185 ``` 186 { 187 "subsystem": "sample", 188 "components": [ 189 { 190 "component": "hello", 191 "features": [] 192 } 193 ] 194 }, 195 ``` 196
