HarmonyOS第一課 :
? ??????????????????????????從Hello World開始認識 DevEco Studio!
下載與安裝DevEco Studio
在HarmonyOS應用開發學習之前,需要進行一些準備工作,首先需要完成開發工具DevEco Studio的下載與安裝以及環境配置。
進入DevEco Studio下載官網,單擊“立即下載”進入下載頁面。
DevEco Studio提供了Windows版本和Mac版本選擇,可以根據操作系統選擇對應的版本進行下載。
這里以Windows為例進行安裝。
下載完成后,雙擊下載的“deveco-studio-xxxx.exe”,進入DevEco Studio安裝向導,在如下界面選擇安裝路徑,默認安裝于“C:\Program Files”下,也可以單擊“Browse...”指定其他安裝路徑,然后單擊“Next”。
如下安裝選項界面勾選DevEco Studio后,單擊“Next”,直至安裝完成。
安裝完成后,單擊“Finish”完成安裝。
配置環境
雙擊已安裝的DevEco Studio快捷方式進入配置頁面,IDE會進入配置向導,選擇Agree,同意相應的條款,進入配置頁。
進入DevEco Studio配置頁面,首先需要進行基礎配置,包括Node.js與Ohpm的安裝路徑設置,選擇從華為鏡像下載至合適的路徑。
單擊'Next'進入SDK配置,設置為合適的路徑,
點擊'Next'后會顯示'SDK License Agreement',閱讀相關協議后,勾選'Accept'。
單擊‘Next’進入配置預覽頁,在這里進行配置項的確認。
確認完成后,單擊'Next',進入下一步。
等待配置自動下載完成,完成后,單擊'Finish',IDE會進入歡迎頁,我們也就成功配置好了開發環境。
準備工作完成后,接下來將進入DevEco Studio進行工程創建和運行。
創建項目
如果你是首次打開DevEco Studio,那么首先會進入歡迎頁。
在歡迎頁中單擊Create Project,進入項目創建頁面。
選擇‘Application’,然后選擇‘Empty Ability’,單擊‘Next’進入工程配置頁。
配置頁中,詳細信息如下:
Project name是開發者可以自行設置的項目名稱,這里根據自己選擇修改為自己項目名稱。
Bundle name是包名稱,默認情況下應用ID也會使用該名稱,應用發布時對應的ID需要保持一致。
Save location為工程保存路徑,建議用戶自行設置相應位置。
Compile SDK是編譯的API版本,這里默認選擇API9。
Model選擇Stage模型,其他保持默認即可。
然后單擊“Finish”完成工程創建,等待工程同步完成。
認識DevEco Studio界面
進入IDE后,我們首先了解一下基礎的界面。整個IDE的界面大致上可以分為四個部分,分別是代碼編輯區、通知欄、工程目錄區以及預覽區。
代碼編輯區
中間的是代碼編輯區,你可以在這里修改你的代碼,以及切換顯示的文件。通過按住Ctrl加鼠標滾輪,可以實現界面的放大與縮小。
通知欄
在編輯器底部有一行工具欄,主要介紹常用信息欄,其中Run是項目運行時的信息欄,Problems是當前工程錯誤與提醒信息欄,Terminal是命令行終端,在這里執行命令行操作,PreviewerLog是預覽器日志輸出欄,Log是模擬器和真機運行時的日志輸出欄。在后續使用中會陸續接觸。
工程目錄區
預覽區
單擊右上角Previewer,可以預覽相應的文件UI展示效果。
預覽器提供了一些基本功能,包括旋轉屏幕,切換顯示設備及多設備預覽等。單擊旋轉按鈕,可以切換豎屏和橫屏顯示的效果。
也可以單擊如下列表按鈕,切換顯示的設備類型。彈出框內會顯示Available Profiles,即可用的設備類型。
如單擊Foldable切換設備,也可以單擊旋轉按鈕切換Foldable的橫豎屏顯示模式。
打開Muti-profile preview開關,可以實現多個尺寸設備的實時預覽。
單擊預覽器右上角組件預覽按鈕,可以進入組件預覽界面。
組件預覽模式可以預覽當前組件對應的代碼塊。
點擊相應組件,代碼文件中會框選對應的組件代碼部分,下方則對應當前組件的基本屬性。
運行Hello World
IDE提供了本地模擬器供開發者使用,我們首先需要下載安裝本地模擬器,然后進行運行工程。
單擊頂部工具欄Tools>Device Manager。
選擇Local Emulator,設置合適的Local Emulator Location存儲地址,然后單擊’+New Emulator’。
選擇Huawei_Phone手機模擬器,單擊'Next',進入模擬器系統下載頁。
選擇下載api9的系統鏡像,然后單擊'Next’,等待下載完成。
下載完成后,進行創建相應的手機模擬器,單擊Finish完成創建。
下載完成后,在Local Emulator頁面中會出現創建的手機模擬器,點擊Actions按鈕,就能夠啟動模擬器。
模擬器啟動后,點擊上方啟動按鈕,將Hello World工程運行到模擬器上。
IDE構建完成后,即可在模擬器上看到運行效果,我們也就完成了Hello World工程在模擬器上的運行。
了解基本工程目錄
工程級目錄
工程的目錄結構如下。
其中詳細如下:
AppScope中存放應用全局所需要的資源文件。
entry是應用的主模塊,存放HarmonyOS應用的代碼、資源等。
oh_modules是工程的依賴包,存放工程依賴的源文件。
build-profile.json5是工程級配置信息,包括簽名、產品配置等。
hvigorfile.ts是工程級編譯構建任務腳本,hvigor是基于任務管理機制實現的一款全新的自動化構建工具,主要提供任務注冊編排,工程模型管理、配置管理等核心能力。
oh-package.json5是工程級依賴配置文件,用于記錄引入包的配置信息。
在AppScope,其中有resources文件夾和配置文件app.json5。AppScope>resources>base中包含element和media兩個文件夾,
其中element文件夾主要存放公共的字符串、布局文件等資源。
media存放全局公共的多媒體資源文件。
模塊級目錄
entry>src目錄中主要包含總的main文件夾,單元測試目錄ohosTest,以及模塊級的配置文件。
main文件夾中,ets文件夾用于存放ets代碼,resources文件存放模塊內的多媒體及布局文件等,module.json5文件為模塊的配置文件。
ohosTest是單元測試目錄。
build-profile.json5是模塊級配置信息,包括編譯構建配置項。
hvigorfile.ts文件是模塊級構建腳本。
oh-package.json5是模塊級依賴配置信息文件。
進入src>main>ets目錄中,其分為entryability、pages兩個文件夾。
entryability存放ability文件,用于當前ability應用邏輯和生命周期管理。
pages存放UI界面相關代碼文件,初始會生成一個Index頁面。
resources目錄下存放模塊公共的多媒體、字符串及布局文件等資源,分別存放在element、media文件夾中。
app.json5
AppScope>app.json5是應用的全局的配置文件,用于存放應用公共的配置信息。
其中配置信息如下:
bundleName是包名。
vendor是應用程序供應商。
versionCode是用于區分應用版本。
versionName是版本號。
icon對應于應用的顯示圖標。
label是應用名。
module.json5
entry>src>main>module.json5是模塊的配置文件,包含當前模塊的配置信息。
其中module對應的是模塊的配置信息,一個模塊對應一個打包后的hap包,hap包全稱是HarmonyOS Ability Package,其中包含了ability、第三方庫、資源和配置文件。其具體屬性及其描述可以參照下表1。
表1?module.json5默認配置屬性及描述
屬性描述
name該標簽標識當前module的名字,module打包成hap后,表示hap的名稱,標簽值采用字符串表示(最大長度31個字節),該名稱在整個應用要唯一。
type表示模塊的類型,類型有三種,分別是entry、feature和har。
srcEntry當前模塊的入口文件路徑。
description當前模塊的描述信息。
mainElement該標簽標識hap的入口ability名稱或者extension名稱。只有配置為mainElement的ability或者extension才允許在服務中心露出。
deviceTypes該標簽標識hap可以運行在哪類設備上,標簽值采用字符串數組的表示。
deliveryWithInstall標識當前Module是否在用戶主動安裝的時候安裝,表示該Module對應的HAP是否跟隨應用一起安裝。- true:主動安裝時安裝。- false:主動安裝時不安裝。
installationFree標識當前Module是否支持免安裝特性。- true:表示支持免安裝特性,且符合免安裝約束。- false:表示不支持免安裝特性。
pages對應的是main_pages.json文件,用于配置ability中用到的page信息。
abilities是一個數組,存放當前模塊中所有的ability元能力的配置信息,其中可以有多個ability。
對于abilities中每一個ability的屬性項,其描述信息如下表2。
表2?abilities中對象的默認配置屬性及描述
屬性描述
name該標簽標識當前ability的邏輯名,該名稱在整個應用要唯一,標簽值采用字符串表示(最大長度127個字節)。
srcEntryability的入口代碼路徑。
descriptionability的描述信息。
iconability的圖標。該標簽標識ability圖標,標簽值為資源文件的索引。該標簽可缺省,缺省值為空。如果ability被配置為MainElement,該標簽必須配置。
labelability的標簽名。
startWindowIcon啟動頁面的圖標。
startWindowBackground啟動頁面的背景色。
exported? ? ?ability是否可以被其他應用程序調用,true表示可以被其它應用調用, false表示不可以被其它應用調用。
skills標識能夠接收的意圖的action值的集合,取值通常為系統預定義的action值,也允許自定義。
entities標識能夠接收的Want的Action值的集合,取值通常為系統預定義的action值,也允許自定義。
actions標識能夠接收Want的Entity值的集合。
main_pages.json
src/main/resources/base/profile/main_pages.json文件保存的是頁面page的路徑配置信息,所有需要進行路由跳轉的page頁面都要在這里進行配置。
參考鏈接
DevEco Studio下載與安裝:DevEco Studio下載與安裝
配置開發環境:配置開發環境