編寫(xiě)“Hello World”程序

下方將通過(guò)修改源碼的方式展示如何編寫(xiě)簡(jiǎn)單程序，輸出“Hello world”。請(qǐng)?jiān)谙螺d的源碼目錄中進(jìn)行下述操作。

前提條件

已參考鴻蒙開(kāi)發(fā)指導(dǎo)文檔：[gitee.com/li-shizhen-skin/harmony-os/blob/master/README.md]

操作步驟

1. 確定目錄結(jié)構(gòu)。
   開(kāi)發(fā)者編寫(xiě)業(yè)務(wù)代碼時(shí)，務(wù)必先在./applications/sample/wifi-iot/app路徑下新建一個(gè)目錄（或一套目錄結(jié)構(gòu)），用于存放業(yè)務(wù)源碼文件。
   例如：在app下新增業(yè)務(wù)my_first_app，其中hello_world.c為業(yè)務(wù)代碼，BUILD.gn為編譯腳本，具體規(guī)劃目錄結(jié)構(gòu)如下：

   .
   └── applications
       └── sample
           └── wifi-iot
               └── app
                   └── my_first_app
                     │── hello_world.c
                     └── BUILD.gn
   

2. 編寫(xiě)業(yè)務(wù)代碼。
   新建./applications/sample/wifi-iot/app/my_first_app下的hello_world.c文件，在hello_world.c中新建業(yè)務(wù)入口函數(shù)HelloWorld，并實(shí)現(xiàn)業(yè)務(wù)邏輯。并在代碼最下方，使用OpenHarmony啟動(dòng)恢復(fù)模塊接口SYS_RUN()啟動(dòng)業(yè)務(wù)。（SYS_RUN定義在ohos_init.h文件中）

   #include < stdio.h >
   #include "ohos_init.h"
   #include "ohos_types.h"
   
   void HelloWorld(void)
   {
       printf("[DEMO] Hello world.n");
   }
   SYS_RUN(HelloWorld);
   

3. 編寫(xiě)用于將業(yè)務(wù)構(gòu)建成靜態(tài)庫(kù)的BUILD.gn文件。
   新建./applications/sample/wifi-iot/app/my_first_app下的BUILD.gn文件，并完成如下配置。
   如步驟1所述，BUILD.gn文件由三部分內(nèi)容（目標(biāo)、源文件、頭文件路徑）構(gòu)成，需由開(kāi)發(fā)者完成填寫(xiě)。

   static_library("myapp") {
       sources = [
           "hello_world.c"
       ]
       include_dirs = [
           "http://utils/native/lite/include"
       ]
   }
   

   • static_library中指定業(yè)務(wù)模塊的編譯結(jié)果，為靜態(tài)庫(kù)文件libmyapp.a，開(kāi)發(fā)者根據(jù)實(shí)際情況完成填寫(xiě)。
   • sources中指定靜態(tài)庫(kù).a所依賴的.c文件及其路徑，若路徑中包含"http://"則表示絕對(duì)路徑（此處為代碼根路徑），若不包含"http://"則表示相對(duì)路徑。
   • include_dirs中指定source所需要依賴的.h文件路徑。

4. 添加新組件。
   修改文件build/lite/components/applications.json，添加組件hello_world_app的配置，如下所示為applications.json文件片段，"##start##"和"##end##"之間為新增配置（"##start##"和"##end##"僅用來(lái)標(biāo)識(shí)位置，添加完配置后刪除這兩行）：

   說(shuō)明： 本章節(jié)操作是以O(shè)penHarmony-v3.1-Release版本為例進(jìn)行操作的，該版本中，組件配置文件為build/lite/components/applications.json；若源碼版本大于等于OpenHarmony 3.2 Beta2時(shí)，組件配置文件為build/lite/components/communication.json。

   {
     "components": [
       {
         "component": "camera_sample_communication",
         "description": "Communication related samples.",
         "optional": "true",
         "dirs": [
           "applications/sample/camera/communication"
         ],
         "targets": [
           "http://applications/sample/camera/communication:sample"
         ],
         "rom": "",
         "ram": "",
         "output": [],
         "adapted_kernel": [ "liteos_a" ],
         "features": [],
         "deps": {
           "components": [],
           "third_party": []
         }
       },
   ##start##
       {
         "component": "hello_world_app",
         "description": "hello world samples.",
         "optional": "true",
         "dirs": [
           "applications/sample/wifi-iot/app/my_first_app"
         ],
         "targets": [
           "http://applications/sample/wifi-iot/app/my_first_app:myapp"
         ],
         "rom": "",
         "ram": "",
         "output": [],
         "adapted_kernel": [ "liteos_m" ],
         "features": [],
         "deps": {
           "components": [],
           "third_party": []
         }
       },
   ##end##
       {
         "component": "camera_sample_app",
         "description": "Camera related samples.",
         "optional": "true",
         "dirs": [
           "applications/sample/camera/launcher",
           "applications/sample/camera/cameraApp",
           "applications/sample/camera/setting",
           "applications/sample/camera/gallery",
           "applications/sample/camera/media"
         ],
   

5. 修改單板配置文件。
   修改文件vendor/hisilicon/hispark_pegasus/config.json，新增hello_world_app組件的條目，如下所示代碼片段為applications子系統(tǒng)配置，"##start##"和"##end##"之間為新增條目（"##start##"和"##end##"僅用來(lái)標(biāo)識(shí)位置，添加完配置后刪除這兩行）：

   {
           "subsystem": "applications",
           "components": [
   ##start##
             { "component": "hello_world_app", "features":[] },
   ##end##
             { "component": "wifi_iot_sample_app", "features":[] }
           ]
         },
   

審核編輯 黃宇