OpenHarmony设备开发基于IDE开发 标准系统（基于RK3568开发板）

编写“Hello World”程序

下方将展示如何在单板上运行第一个应用程序，其中包括新建应用程序、编译、烧写、运行等步骤，最终输出“Hello World！”。

前提条件

已参考​​创建工程并获取源码​​，创建RK3568开发板的源码工程。

示例目录

拉取openharmony项目代码，在代码根目录创建sample子系统文件夹，在子系统目录下创建hello部件文件夹，hello文件夹中创建hello源码目录，构建文件BUILD.gn及部件配置文件bundle.json。 示例完整目录如下。

sample/hello
│── BUILD.gn
│── include
│   └── helloworld.h
│── src
│   └── helloworld.c
├── bundle.json
build
└── subsystem_config.json
vendor/hihope
└── rk3568
    └── config.json

开发步骤

请在源码目录中通过以下步骤创建“Hello World”应用程序。

1. 创建目录，编写业务代码。
   新建sample/hello/src/helloworld.c目录及文件，代码如下所示，用户可以自定义修改打印内容（例如：修改World为OHOS）。其中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");
}

再添加头文件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.新建编译组织文件。
 新建sample/hello/BUILD.gn，创建方法可参考：​​​模块配置规则​​​。
创建 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  # 是否默认安装（缺省默认不安装），可选
}

3.新建部件配置规则文件
新建sample/hello/bundle.json文件，添加sample部件描述，创建方法可参考：​​​部件配置规则​​​。
bundle.json内容如下所示。

{
    "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": []
        },
        "build": {
            "sub_component": [
                "//sample/hello:helloworld"
            ],
            "inner_kits": [],
            "test": []
        }
    }
}

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

4.修改子系统配置文件。
在build/subsystem_config.json中添加新建的子系统的配置。修改方法可参考：​​​子系统配置规则​​​。
新增子系统的配置如下所示。

"sample": {
    "path": "sample",
    "name": "sample"
  },

5.修改产品配置文件。

说明： 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":{},

• 3.2-Beta2及之后版本
  在vendor/hihope/rk3568/config.json中添加对应的hello部件，直接添加到原有部件后即可。

{
  "subsystem": "sample",
  "components": [
    {
      "component": "hello",
      "features": []
    }
  ]
},     

编译

DevEco Device Tool支持Rockchip RK3568开发板的源码一键编译功能，提供编译工具链和编译环境依赖的检测及一键安装，简化复杂编译环境的同时，提升了编译的效率。

说明： RK3568编译环境为Ubuntu环境。

1. 在菜单栏中点击Project Settings，进入RK3568工程配置界面。
2. 在Tool Chain页签中，DevEco Device Tool会自动检测依赖的编译工具链是否完备，如果提示部分工具缺失，可点击Install，自动安装所需工具链。

说明：如果出现安装pip组件失败，可参考​​修改Python源的方法​​进行修改，完成尝试重新安装。

• 若出现安装apt组件失败，可参考​​修改apt源的方法​​进行修改，完成后尝试重新安装。

TERMINAL窗口输入 用户密码进行安装

工具链自动安装完成后如下图所示。

3.在rk3568配置页签中，设置源码的编译类型build_type，默认为"debug"类型，请根据需要进行修改。

4.在DevEco Device Tool界面的PROJECT TASKS中，点击对应开发板下的Build，执行编译。

5.等待编译完成，在TERMINAL窗口输出“SUCCESS”，编译完成。

编译完成后，可以在工程的out目录下，查看编译生成的文件，用于后续的​​RK3568开发板烧录​​。

烧录

烧录是指将编译后的程序文件下载到芯片开发板上的动作，为后续的程序调试提供基础。DevEco Device Tool提供一键烧录功能，操作简单，能快捷、高效的完成程序烧录，提升烧录的效率。

RK3568的镜像烧录通过Windows环境进行烧录，开发者启动烧录操作后，DevEco Device Tool通过Remote远程模式，将Ubuntu环境下编译生成的待烧录程序文件拷贝至Windows目录下，然后通过Windows的烧录工具将程序文件烧录至开发板中。

前提条件

​​下载​​并安装驱动DriverInstall.exe。

说明： 如果已经安装旧版本的烧写工具，请先点击"驱动卸载"按钮卸载驱动，然后再点击"驱动安装"按钮安装驱动。

操作步骤

1. 请连接好电脑和待烧录开发板，连接USB接口，具体可参考​​RK3568开发板介绍​​。
2. 在DevEco Device Tool中，选择REMOTE DEVELOPMENT > Local PC，查看远程计算机（Ubuntu开发环境）与本地计算机（Windows开发环境）的连接状态。

• 如果Local PC右边连接按钮为

，则远程计算机与本地计算机为已连接状态，不需要执行其他操作。

• 如果Local PC右边连接按钮为

，则点击绿色按钮进行连接。连接时DevEco Device Tool会重启服务，因此请不要在下载源码或源码编译过程中进行连接，否则会中断任务。

3. 在菜单栏中点击Project Settings按钮，进入RK3568工程配置界面。

4.在Tool Chain页签，设置Uploader烧录器工具，可以通过Tool Chain页签中的Install按钮在线安装。

5.在rk3568页签，设置烧录选项，包括upload_partitions和upload_protocol。配置完成后工程将自动保存。

• upload_partitions_profile：选择待烧录程序的配置文件，该配置文件会指定烧录文件名称、起始烧录地址、地址长度等信息；同时请勾选Enable to use upload_partitions_profile for upload选项。

说明：如需修改烧录profile文件，在设置烧录分区起始地址和分区长度时，应根据实际待烧录文件的大小进行设置，要求设置的烧录分区大小，要大于待烧录文件的大小；同时，各烧录文件的分区地址设置不能出现重叠。

首次烧录，请勾选Enable to use upload_partitions_profile for upload选项，会自动生成upload_partitions文件。再次烧录时，可根据实际情况选择生成upload_partitions文件进行自定义烧录，也可以再勾选Enable to use upload_partitions_profile for upload选项，使用upload_partitions_profile重新生成upload_partitions文件用于烧录。

• upload_protocol：选择烧录协议，固定选择“upgrade”。

6.在PROJECT TASKS中，点击rk3568下的Upload按钮启动烧录。

7.当屏幕提示“Operation paused，Please press Enter key to continue”，请按回车键继续。

说明： 如果开发板未处于烧录模式，屏幕会提示“The board is not in Loader mode.Please Hold on the VOL+key…”，此时，请长按音量+键，3秒后点击RESET

键，然后再过3秒放开音量+键，使开发板进入烧录模式。

等待开发板烧录完成，当屏幕提示如下信息时，表示烧录成功。

运行

启动系统

烧录完成重启开发板后，系统将会自动启动。开发板附带的屏幕呈现以下界面，表明系统已运行成功。

图1 系统启动效果图

运行“Hello World”

1. 设备启动后打开串口工具（以putty为例），波特率设置为1500000，连接设备。

2. 打开串口后，在任意目录（以设备根目录为例）下输入命令helloworld后回车，界面打印“Hello World！”，程序运行成功。

文章转载自：​​https://docs.openharmony.cn/pages/v3.2Beta/zh-cn/device-dev/quick-start/quickstart-ide-3568-helloworld.md/​​