??想了解更多關于開源的內容，請訪問：??
??51CTO 開源基礎軟件社區??
??https://ost.51cto.com??
背景介紹
最近學習OpenHarmony應用開發， SDK版本是3.2.9.2 Beta4，IDE版本是3.1.0.200。參考官方文檔，做了個Demo應用，調試、運行非常順利。啟動應用后，狀態欄和導航欄占用的高度過高，顯得很奇怪，嘗試修改一下系統應用。
摸石頭過河
因為沒做過移動端開發，最初以為狀態欄和導航欄是由Launcher控制的，從示例中找了個launcher，按照文檔進行編譯，放在設備上怎么也起不來，Google查了半天，最后發現該版本中文檔描述不全，參考最新版本文檔進行編譯，運行成功。
有了經驗之后，使用系統Launcher進行編譯，報了一堆錯誤，哪里報錯改哪里，修改完之后編譯成功，因為是系統應用，不能使用自動簽名。根據官方提供的簽名方式進行簽名，放到設備中無法顯示應用中心和Dock。
看了系統Launcher代碼，感覺狀態欄和導航欄并不是由Launcher控制的，又下載了系統SystemUI代碼，編譯時也有幾個報錯，不知道怎么解決，后來發現下載的代碼不對，應該從分支中選擇版本，從標簽中選擇的版本代碼可能不全或者有問題。
編譯安裝踩坑
替換系統應用方法：
// 獲取系統目錄讀寫權限
hdc shell "mount -o remount,rw /"
// 拷貝應用到SystemUI目錄
hdc file send phone_statusbar-phone_entry-default-signed.hap /system/app/com.ohos.systemui/SystemUI-StatusBar.hap
// 應用放在/data目錄下，刪除/data目錄下的所有文件，系統會重新安裝系統應用。
hdc shell "rm -rf /data/*"
// 重啟設備
hdc shell reboot
1、系統應用簽名
- 環境
SDK：Beta4，代碼：Beta4 - 現象
系統應用無法使用自動簽名。 - 解決方案
參考鏈接：系統應用簽名，我使用的是標準簽名。下載material文件夾、OpenHarmony.p12文件、OpenHarmonyApplication.pem文件，放在signature目錄下，修改項目中的build-profile.json5文件，添加以下信息，重新編譯即可。
"products": [
{
"name": "default",
"signingConfig": "default"
}
],
"signingConfigs": [{
"name": "default",
"material": {
"storePassword": "00000016D9DCF063F0FC4BBD0E7FE1E3B06A67C07BECE1BDD4E2A3EFDAE20F890810EC02AA2A",
"certpath": "signature/OpenHarmonyApplication.pem",
"keyAlias": "OpenHarmony Application Release",
"keyPassword": "00000016FD3897FD4C46940ED39FFC652872B7B18BEDCCA07400A6EBEE307C9C41B96DB6B64D",
"profile": "signature/systemui.p7b",
"signAlg": "SHA256withECDSA",
"storeFile": "signature/OpenHarmony.p12"
}
}]
2、SystemUI編譯報錯（SDK問題）
- 環境
SDK：Beta4，代碼：Beta4 - 現象
編譯報錯，信息如下：
> hvigor ERROR: Failed :phone_statusbar:default@CompileArkTS...
> hvigor ERROR: Tools execution failed.
ArkTS:ERROR File: /xxx/applications_systemui-OpenHarmony-3.2-Beta4/features/batterycomponent/src/main/ets/default/batteryModel.ts:16:25
Cannot find module '@ohos.batteryinfo' or its corresponding type declarations.
Module not found: Error: Can't resolve 'bundle/extensionAbilityInfo' in '/xxx/applications_systemui-OpenHarmony-3.2-Beta4/common/src/main/ets/plugindatasource'
Module not found: Error: Can't resolve 'bundle/extensionAbilityInfo' in '/xxx/applications_systemui-OpenHarmony-3.2-Beta4/common/src/main/ets/plugindatasource/common'
Module not found: Error: Can't resolve 'bundle/metadata' in '/xxx/applications_systemui-OpenHarmony-3.2-Beta4/common/src/main/ets/plugindatasource/common'
- 排查查看API發現bundle目錄下沒有extensionAbilityInfo和metadata文件，而bundleManager中有這兩個文件。
- 解決方案在報錯的地方將bundle/extensionAbilityInfo改為bundleManager/extensionAbilityInfo，bundle/metadata改為bundleManager/metadata，編譯通過。
- 環境
SDK：Beta2，代碼：Beta4 - 現象
編譯報錯，信息如下：
> hvigor ERROR: Failed :pc_statusbar:default@CompileArkTS...
> hvigor ERROR: Tools execution failed.
ETS:ERROR File: /xxx/applications_systemui-OpenHarmony-3.2-Beta4/features/batterycomponent/src/main/ets/default/batteryModel.ts:16:25
Cannot find module '@ohos.batteryInfo' or its corresponding type declarations.
api中info的i為小寫，而文件中導入包的時候是大寫I。
- 解決方案
將batteryModel.ts文件中大寫I改為小寫i，即可編譯成功，如下：
import BatteryInfo from "@ohos.batteryinfo";
3、SystemUI應用安裝失敗
- 環境
SDK：Beta4，代碼：Beta4 - 現象
替換狀態欄應用后，狀態欄消失 - 排查
使用bm命令手動安裝應用報錯：
手動安裝應用
bm install -p /system/app/com.ohos.systemui/SystemUI-Status.hap -u 0
// 報錯信息
error: failed to install bundle.
error: install releaseType not same
報錯信息意思是設備中SystemUI中SDK版本與我自己編譯的SystemUI SDK版本不一致，查看一下設備中SystemUI的SDK版本：
hdc shell cat /data/app/el1/bundle/public/com.ohos.systemui/phone_statusbar/module.json
- 解決方案：
系統中使用的是SDK Beta2，而我編譯使用的是SDK Beta4，所以需要將SDK切換到Beta2版本（Beta2編譯Beta4版本代碼也會有問題，參考：SystemUI編譯報錯（SDK問題））。
4、安裝導航欄后狀態欄消失
- 環境
SDK：Beta4，代碼：Beta2 - 現象
單獨安裝狀態欄正常，安裝導航欄后狀態欄消失 - 排查
查看狀態欄日志，發現有很多日志沒有打出來，追蹤了一下，定位到features/statusbarcomponent/src/main/ets/com/ohos/common/StatusBarConfiguration.ts文件中，發現卡在這里
status_bar_size_landscape搜索一下這個字段，發現base/element/string.json文件中存在該字段，zh_CN/element/string.json文件中不存在該字段。(zh_CN/element/string.json添加字段后狀態欄正常顯示，是什么原因不清楚)
- 解決方案
product/phone/statusbar/src/main/resources/zh_CN/element/string.json文件中添加以下內容：
{
"name": "status_bar_size_portrait",
"value": "16"
},
{
"name": "status_bar_size_landscape",
"value": "16"
},
{
"name": "phone_status_bar_size_portrait",
"value": "16"
},
{
"name": "phone_status_bar_size_landscape",
"value": "16"
},定制化開發
經過摸索，狀態欄和導航欄布局在窗口管理中控制，可以修改模塊下的ServiceExtAbility.ts文件來自定義實現，也可以修改配置文件resources/zh_CN/element/string.json中的以下字段，來控制狀態欄和導航欄的高度（這里高度不能加單位，按照官網文檔的說法默認使用的VP單位）。
{
"name": "nav_bar_size_portrait",
"value": "26"
},
{
"name": "nav_bar_size_landscape",
"value": "26"
},
{
"name": "status_bar_size_portrait",
"value": "16"
},
{
"name": "status_bar_size_landscape",
"value": "16"
},總結
做普通應用Demo上手容易，ArkTS做頁面布局方便，使用組件點點點即可得到想要的樣式。因為使用的是Beta版本，修改SystemUI過程中遇到很多坑，比如編譯報錯，應用安裝失敗，應用消失等問題，在Google上基本搜不出來解決方案，只能在官方文檔、51CTO社區、華為開發者聯盟上搜索、提問來解決。像是安裝導航欄后狀態欄消失問題，解決起來很容易，但是尋找解決方法要花很長時間，這也是寫這篇文章的原因，希望可以幫助開發者解決問題，同時也希望OpenHarmony社區能夠建立起來，為開發者答疑解惑。
??想了解更多關于開源的內容，請訪問：??
??51CTO 開源基礎軟件社區??
??https://ost.51cto.com??
