quickstart-standard-running-rk3568-create.md 4.3 KB
Newer Older
D
duangavin123 已提交
1 2
# 编写“Hello World”程序

D
duangavin123 已提交
3

4
下方将展示如何在单板上运行第一个应用程序,其中包括新建应用程序、编译、烧写、运行等步骤,最终输出“Hello World!”。
D
duangavin123 已提交
5 6


D
duangavin123 已提交
7
## 示例目录
D
duangavin123 已提交
8

D
duangavin123 已提交
9 10
  示例完整目录如下。
  
D
duangavin123 已提交
11
```
12 13 14
applications/sample/hello
│   │── BUILD.gn
│   │── include
D
duangavin123 已提交
15
│   │   └── helloworld.h
16 17 18
│   │── src
│   │   └── helloworld.c
│   └── bundle.json
Y
yudechen 已提交
19
build
20
└── subsystem_config.json
L
liyan 已提交
21 22 23
vendor/hihope
└── rk3568
    └── config.json
D
duangavin123 已提交
24 25 26
```


D
duangavin123 已提交
27
## 开发步骤
D
duangavin123 已提交
28

D
duangavin123 已提交
29
请在源码目录中通过以下步骤创建“Hello World”应用程序:
D
duangavin123 已提交
30

D
duangavin123 已提交
31
1. 创建目录,编写业务代码。
L
liyan 已提交
32

D
duangavin123 已提交
33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76
   新建applications/sample/hello/src/helloworld.c目录及文件,代码如下所示,用户可以自定义修改打印内容(例如:修改World为OH)。其中helloworld.h包含字符串打印函数HelloPrint的声明。当前应用程序可支持标准C及C++的代码开发。

     
   ```
   #include <stdio.h>
   #include "helloworld.h"
   
   int main(int argc, char **argv)
   {
       HelloPrint();
       return 0;
   }
   
   void HelloPrint()
   {
       printf("\n\n");
       printf("\n\t\tHello World!\n");
       printf("\n\n");
   }
   ```

   再添加头文件applications/sample/hello/include/helloworld.h,代码如下所示。

     
   ```
   #ifndef HELLOWORLD_H
   #define HELLOWORLD_H
   #ifdef __cplusplus
   #if __cplusplus
   extern "C" {
   #endif
   #endif
   
   void HelloPrint();
   
   #ifdef __cplusplus
   #if __cplusplus
   }
   #endif
   #endif
   #endif // HELLOWORLD_H
   ```

2. 新建编译组织文件。
L
liyan 已提交
77

D
duangavin123 已提交
78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138
   1. 新建applications/sample/hello/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部件描述,内容如下所示。
         
       ```
       {
           "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": []
               }
           }
       }
       ```

       bundle.json文件包含两个部分,第一部分描述该部件所属子系统的信息,第二部分component则定义该部件构建相关配置。添加的时候需要指明该部件包含的模块sub_component,假如有提供给其它部件的接口,需要在inner_kits中说明,假如有测试用例,需要在test中说明,inner_kits与test没有也可以不添加。

3. 修改子系统配置文件。
L
liyan 已提交
139

D
duangavin123 已提交
140 141 142 143 144 145 146 147 148 149 150
   在build/subsystem_config.json中添加新建的子系统的配置。

     
   ```
   "sample": {
       "path": "applications/sample/hello",
       "name": "sample"
     },
   ```

4. 修改产品配置文件。
L
liyan 已提交
151

L
liyan 已提交
152
   在vendor/hihope/rk3568/config.json中添加对应的hello部件,直接添加到原有部件后即可。
D
duangavin123 已提交
153 154 155 156 157 158 159
     
   ```
       "usb:usb_manager_native":{},
       "applications:prebuilt_hap":{},
       "sample:hello":{},
       "wpa_supplicant-2.9:wpa_supplicant-2.9":{},
   ```