??想了解更多關(guān)于開源的內(nèi)容，請(qǐng)?jiān)L問：??

??51CTO 開源基礎(chǔ)軟件社區(qū)??

??https://ost.51cto.com??

背景介紹

最近學(xué)習(xí)OpenHarmony應(yīng)用開發(fā)， SDK版本是3.2.9.2 Beta4，IDE版本是3.1.0.200。參考官方文檔，做了個(gè)Demo應(yīng)用，調(diào)試、運(yùn)行非常順利。啟動(dòng)應(yīng)用后，狀態(tài)欄和導(dǎo)航欄占用的高度過高，顯得很奇怪，嘗試修改一下系統(tǒng)應(yīng)用。

摸石頭過河

因?yàn)闆]做過移動(dòng)端開發(fā)，最初以為狀態(tài)欄和導(dǎo)航欄是由Launcher控制的，從示例中找了個(gè)launcher，按照文檔進(jìn)行編譯，放在設(shè)備上怎么也起不來，Google查了半天，最后發(fā)現(xiàn)該版本中文檔描述不全，參考最新版本文檔進(jìn)行編譯，運(yùn)行成功。

有了經(jīng)驗(yàn)之后，使用系統(tǒng)Launcher進(jìn)行編譯，報(bào)了一堆錯(cuò)誤，哪里報(bào)錯(cuò)改哪里，修改完之后編譯成功，因?yàn)槭窍到y(tǒng)應(yīng)用，不能使用自動(dòng)簽名。根據(jù)官方提供的簽名方式進(jìn)行簽名，放到設(shè)備中無法顯示應(yīng)用中心和Dock。

看了系統(tǒng)Launcher代碼，感覺狀態(tài)欄和導(dǎo)航欄并不是由Launcher控制的，又下載了系統(tǒng)SystemUI代碼，編譯時(shí)也有幾個(gè)報(bào)錯(cuò)，不知道怎么解決，后來發(fā)現(xiàn)下載的代碼不對(duì)，應(yīng)該從分支中選擇版本，從標(biāo)簽中選擇的版本代碼可能不全或者有問題。

編譯安裝踩坑

替換系統(tǒng)應(yīng)用方法：

// 獲取系統(tǒng)目錄讀寫權(quán)限
hdc shell "mount -o remount,rw /"
// 拷貝應(yīng)用到SystemUI目錄
hdc file send phone_statusbar-phone_entry-default-signed.hap /system/app/com.ohos.systemui/SystemUI-StatusBar.hap
// 應(yīng)用放在/data目錄下，刪除/data目錄下的所有文件，系統(tǒng)會(huì)重新安裝系統(tǒng)應(yīng)用。
hdc shell "rm -rf /data/*"
// 重啟設(shè)備
hdc shell reboot

1、系統(tǒng)應(yīng)用簽名

• 環(huán)境
  SDK：Beta4，代碼：Beta4
• 現(xiàn)象
  系統(tǒng)應(yīng)用無法使用自動(dòng)簽名。
• 解決方案
  參考鏈接：系統(tǒng)應(yīng)用簽名，我使用的是標(biāo)準(zhǔn)簽名。下載material文件夾、OpenHarmony.p12文件、OpenHarmonyApplication.pem文件，放在signature目錄下，修改項(xiàng)目中的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編譯報(bào)錯(cuò)（SDK問題）

• 環(huán)境
  SDK：Beta4，代碼：Beta4
• 現(xiàn)象
  編譯報(bào)錯(cuò)，信息如下：

> 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發(fā)現(xiàn)bundle目錄下沒有extensionAbilityInfo和metadata文件，而bundleManager中有這兩個(gè)文件。
• 解決方案在報(bào)錯(cuò)的地方將bundle/extensionAbilityInfo改為bundleManager/extensionAbilityInfo，bundle/metadata改為bundleManager/metadata，編譯通過。
• 環(huán)境
  SDK：Beta2，代碼：Beta4
• 現(xiàn)象
  編譯報(bào)錯(cuò)，信息如下：

> 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為小寫，而文件中導(dǎo)入包的時(shí)候是大寫I。

• 解決方案
  將batteryModel.ts文件中大寫I改為小寫i，即可編譯成功，如下：

import BatteryInfo from "@ohos.batteryinfo";

3、SystemUI應(yīng)用安裝失敗

• 環(huán)境
  SDK：Beta4，代碼：Beta4
• 現(xiàn)象
  替換狀態(tài)欄應(yīng)用后，狀態(tài)欄消失
• 排查
  使用bm命令手動(dòng)安裝應(yīng)用報(bào)錯(cuò)：

手動(dòng)安裝應(yīng)用
bm install -p /system/app/com.ohos.systemui/SystemUI-Status.hap -u 0
// 報(bào)錯(cuò)信息
error: failed to install bundle.
error: install releaseType not same

報(bào)錯(cuò)信息意思是設(shè)備中SystemUI中SDK版本與我自己編譯的SystemUI SDK版本不一致，查看一下設(shè)備中SystemUI的SDK版本：

hdc shell cat /data/app/el1/bundle/public/com.ohos.systemui/phone_statusbar/module.json

• 解決方案：
  系統(tǒng)中使用的是SDK Beta2，而我編譯使用的是SDK Beta4，所以需要將SDK切換到Beta2版本（Beta2編譯Beta4版本代碼也會(huì)有問題，參考：SystemUI編譯報(bào)錯(cuò)（SDK問題））。

4、安裝導(dǎo)航欄后狀態(tài)欄消失

• 環(huán)境
  SDK：Beta4，代碼：Beta2
• 現(xiàn)象
  單獨(dú)安裝狀態(tài)欄正常，安裝導(dǎo)航欄后狀態(tài)欄消失
• 排查

查看狀態(tài)欄日志，發(fā)現(xiàn)有很多日志沒有打出來，追蹤了一下，定位到features/statusbarcomponent/src/main/ets/com/ohos/common/StatusBarConfiguration.ts文件中，發(fā)現(xiàn)卡在這里

status_bar_size_landscape搜索一下這個(gè)字段，發(fā)現(xiàn)base/element/string.json文件中存在該字段，zh_CN/element/string.json文件中不存在該字段。(zh_CN/element/string.json添加字段后狀態(tài)欄正常顯示，是什么原因不清楚)

• 解決方案
  product/phone/statusbar/src/main/resources/zh_CN/element/string.json文件中添加以下內(nèi)容：

{
      "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"
    },

定制化開發(fā)

經(jīng)過摸索，狀態(tài)欄和導(dǎo)航欄布局在窗口管理中控制，可以修改模塊下的ServiceExtAbility.ts文件來自定義實(shí)現(xiàn)，也可以修改配置文件resources/zh_CN/element/string.json中的以下字段，來控制狀態(tài)欄和導(dǎo)航欄的高度（這里高度不能加單位，按照官網(wǎng)文檔的說法默認(rèn)使用的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"
    },

總結(jié)

做普通應(yīng)用Demo上手容易，ArkTS做頁面布局方便，使用組件點(diǎn)點(diǎn)點(diǎn)即可得到想要的樣式。因?yàn)槭褂玫氖荁eta版本，修改SystemUI過程中遇到很多坑，比如編譯報(bào)錯(cuò)，應(yīng)用安裝失敗，應(yīng)用消失等問題，在Google上基本搜不出來解決方案，只能在官方文檔、51CTO社區(qū)、華為開發(fā)者聯(lián)盟上搜索、提問來解決。像是安裝導(dǎo)航欄后狀態(tài)欄消失問題，解決起來很容易，但是尋找解決方法要花很長(zhǎng)時(shí)間，這也是寫這篇文章的原因，希望可以幫助開發(fā)者解決問題，同時(shí)也希望OpenHarmony社區(qū)能夠建立起來，為開發(fā)者答疑解惑。

??想了解更多關(guān)于開源的內(nèi)容，請(qǐng)?jiān)L問：??

??51CTO 開源基礎(chǔ)軟件社區(qū)??

??https://ost.51cto.com??