資料相關(guān)
鴻蒙文檔中心
鴻蒙論壇
鴻蒙社區(qū)
鴻蒙開發(fā)者學(xué)堂-華為認(rèn)證
OpenHarmony三方庫中心倉
鴻蒙CodeLab（示例項(xiàng)目）
鴻蒙API參考
ArkUI參考文檔
項(xiàng)目相關(guān)
三方庫管理工具名： ohpm
三方庫依賴配置文件名：oh-package.json5
ohpm指令
配置說明： https://zhuanlan.zhihu.com/p/683109843
系統(tǒng)權(quán)限
- 網(wǎng)絡(luò)權(quán)限配置： module.json5下配置
{
"module": {
"requestPermissions": [
{
"name": "ohos.permission.INTERNET"
}
]
}
}
DevEco操作
| 操作 | 功能路徑 | 快捷鍵 |
|---|---|---|
| 全局搜索 | 編輯->查找->在文件中查找... | Command+Shift+F |
| 全局替換 | 編輯->查找->在文件中替換... | Command+Shift+R |
| 搜索文件/配置 | 編輯器右上角搜索按鈕 | Double ? |
裝飾器 https://cloud.tencent.com/developer/article/2371806
| 裝飾器 | 功能 | 修飾對象 | 詳解 |
|---|---|---|---|
| @Entry | 標(biāo)記一個(gè)頁面的入口，一個(gè)頁面有且僅能有一個(gè)@Entry | struct / class | |
| @Component | 標(biāo)記一個(gè)UI組件 | struct / class | |
| @Preview | |||
| @Observed | |||
| @State | |||
| @Prop | |||
| @Link | |||
| @Watch | |||
| @Provide | |||
| @Consume | |||
| @ObjectLink | |||
| @Builder | 自定義構(gòu)建函數(shù) | 函數(shù) | 局部不需要 function，全局需要 function 關(guān)鍵字 |
| @Style | |||
| @Extend |
頁面生命周期
| method | 時(shí)機(jī) | 修飾器 |
|---|---|---|
| onPageShow | 頁面每次顯示時(shí)觸發(fā) | @Entry |
| onPageHide | 頁面每次隱藏時(shí)觸發(fā)一次 | @Entry |
| onBackPress | 當(dāng)用戶點(diǎn)擊返回按鈕時(shí)觸發(fā) | @Entry |
| aboutToAppear | 組件即將出現(xiàn)時(shí)執(zhí)行，build函數(shù)執(zhí)行之前 | @Component |
| aboutToDisappear | 組件即將析構(gòu)銷毀時(shí)執(zhí)行 | @Component |
UIAbility生命周期
| method | 時(shí)機(jī) |
|---|---|
| Create | 應(yīng)用加載過程中，UIAbility實(shí)例創(chuàng)建完成時(shí)觸發(fā)， |
| Foreground | UIAbility實(shí)例切換至前臺時(shí) 觸發(fā) |
| Background | UIAbility實(shí)例切換至后臺時(shí) 觸發(fā) |
| Destroy | UIAbility實(shí)例銷毀時(shí)觸發(fā) |
如何存放與獲取圖片等資源
參考官方文檔：資源分類與訪問
資源存放位置
resources
|---base
| |---element
| | |---string.json
| |---media /// # 圖片資源放該目錄下
| | |---icon.png
| |---profile
| | |---test_profile.json
|---en_US // 默認(rèn)存在的目錄，設(shè)備語言環(huán)境是美式英文時(shí)，優(yōu)先匹配此目錄下資源
| |---element
| | |---string.json
| |---media
| | |---icon.png
| |---profile
| | |---test_profile.json
|---zh_CN // 默認(rèn)存在的目錄，設(shè)備語言環(huán)境是簡體中文時(shí)，優(yōu)先匹配此目錄下資源
| |---element
| | |---string.json
| |---media
| | |---icon.png
| |---profile
| | |---test_profile.json
|---en_GB-vertical-car-mdpi // 自定義限定詞目錄示例，由開發(fā)者創(chuàng)建
| |---element
| | |---string.json
| |---media
| | |---icon.png
| |---profile
| | |---test_profile.json
|---rawfile // 其他類型文件，原始文件形式保存，不會被集成到resources.index文件中。文件名可自定義。
資源訪問
對于應(yīng)用資源，在工程中，通過"$r('app.type.name')"形式引用。其中，app為應(yīng)用內(nèi)resources目錄中定義的資源；type為資源類型或資源的存放位置，取值包含“color”、“float”、“string”、“plural”、“media”；name為資源命名，由開發(fā)者定義資源時(shí)確定。
常用組件（三方/鴻蒙）
- axios：第三方網(wǎng)絡(luò)請求框架
- wtr：加載彈框、消息彈框、下拉刷新、上拉加載（不支持Api9）
- ImageKnife：第三方圖片加載緩存庫
- MaterialProgressBar：第三方組件自定義進(jìn)度條
- zxing：解析和生成二維碼的庫
注意項(xiàng)
- 項(xiàng)目路徑上不可以有中文，如項(xiàng)目所在文件夾名為“鴻蒙”，將導(dǎo)致無法使用DevEco Studio打開項(xiàng)目。
- 非自建項(xiàng)目運(yùn)行起來，需要先在build-profile.json5文件中清空 signingConfigs 參數(shù)為[]，然后重新登錄簽名。
點(diǎn)擊DevEco Studio 菜單欄中的File（文件） -> Project Structure（項(xiàng)目結(jié)構(gòu)），選擇Project，在Signing Configs 頁面配置簽名信息。
3.新增Page頁面，使用之前須先在resources/base/profile/main_pages.json下的src數(shù)組中注冊page， 注冊所處的文件profile/main_pages.json可能是自定義，在module.json5下可查到注冊page的json文件
{
"module": {
// ...
"pages": "$profile:main_pages", // 通過profile下的資源文件配置
}
}
4.dataPreferences數(shù)據(jù)存儲后重新run項(xiàng)目獲取為空
Deveco-Studio默認(rèn)運(yùn)行配置是，每次都執(zhí)行卸載重裝，所以不會有上一次緩存的數(shù)據(jù)。
處理：修改運(yùn)行時(shí)配置，勾選 Keep Application Data
