OpenHarmony SystemUI開發記錄

来源:https://www.cnblogs.com/ChaseWindWu/archive/2023/04/20/17337084.html
-Advertisement-
Play Games

背景介紹 最近學習OpenHarmony應用開發， SDK版本是3.2.9.2 Beta4，IDE版本是3.1.0.200。參考官方文檔，做了個Demo應用，調試、運行非常順利。啟動應用後，狀態欄和導航欄占用的高度過高，顯得很奇怪，嘗試修改一下系統應用。 摸石頭過河 因為沒做過移動端開發，最初以為狀 ...


背景介紹

最近學習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

    image

  • 解決方案

    將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

    image

  • 解決方案：

    系統中使用的是SDK Beta2，而我編譯使用的是SDK Beta4，所以需要將SDK切換到Beta2版本（Beta2編譯Beta4版本代碼也會有問題，參考：SystemUI編譯報錯（SDK問題））。

4.安裝導航欄後狀態欄消失

  • 環境

    SDK：Beta4，代碼：Beta2

  • 現象

    單獨安裝狀態欄正常，安裝導航欄後狀態欄消失

  • 排查

    查看狀態欄日誌，發現有很多日誌沒有打出來，追蹤了一下，定位到features/statusbarcomponent/src/main/ets/com/ohos/common/StatusBarConfiguration.ts文件中，發現卡在這裡

    image

    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社區能夠建立起來，為開發者答疑解惑。
最後，感謝Haoc_小源同學的幫助，感謝TiZizzz的OpenHarmony應用簽名 - 系統應用簽名文章。


您的分享是我們最大的動力!

-Advertisement-
Play Games
更多相關文章
  • 讀SQL進階教程筆記13_SQL中的分組和層級
    1. 數據分組 1.1. SQL的語句中具有分組功能的是GROUP BY和PARTITION BY 1.1.1. 兩者都有數學的理論基礎 1.1.2. 都可以根據指定的列為表分組 1.1.3. 區別僅僅在於，GROUP BY在分組之後會把每個分組聚合成一行數據 1.1.4. GROUP BY的作用是 ...
  • day03-商家查詢緩存02
    功能02-商鋪查詢緩存02 知識補充 (1)緩存穿透 https://blog.csdn.net/qq_45637260/article/details/125866738 緩存穿透（cache penetration）是指用戶訪問的數據既不在緩存當中，也不在資料庫中。出於容錯的考慮，如果從底層數據 ...
  • MySQL 中常見的幾種高可用架構部署方案
    MySQL 中的集群部署方案 前言 MySQL Replication InnoDB Cluster InnoDB ClusterSet InnoDB ReplicaSet MMM MHA Galera Cluster MySQL Cluster MySQL Fabric 參考 MySQL 中的集群 ...
  • 創建本地yum倉庫
    本文分享自天翼雲開發者社區《創建本地yum倉庫》，作者: zzzzgj； 背景 有的部署環境不通外網，但希望繼續使用yum命令下載依賴包而不修改部署腳本邏輯。因此記錄一個本地repo的建立方法。 1、獲取依賴包 # 如在通網的機器上下載openssl-devel所有依賴yumdownloader - ...
  • 新起點！大數據分散式可視化的 DAG 任務調度系統 Taier 正式發佈1.4版本
    我們很高興向大家宣佈，2023年4月14日，Taier 正式發佈 1.4 版本。自2022年2月份 Taier 正式開源以來，收到了很多開發者和行業用戶的積極評價，在諸多生產環境中已得到充分應用。Taier 1.4版本正是吸收了各類實踐經驗及大家的建議，進行了此次迭代優化。 本次更新不僅包含了性能優 ...
  • 帶你掌握數倉的作業級監控TopSQL
    摘要：目前TopSQL功能被用戶廣泛使用，是性能定位、劣化分析、審計回溯等重要的基石，為用戶提供覆蓋記憶體、耗時、IO、網路、空間等多方面的監控能力。 本文分享自華為雲社區《GaussDB(DWS)監控工具指南（一）作業級監控TopSQL》，作者：幕後小黑爪 。 1、引言： 監控系統是智能化管理和自動 ...
  • 再獲殊榮！華為雲GaussDB喜提“科技進步一等獎”
    摘要：近日，中國電子學會科學技術獎勵大會頒發了2021-2022年度中國電子學會科學技術獎獲獎項目，華為雲主導的“GaussDB智能雲原生分散式資料庫”項目榮獲“科技進步一等獎”。 本文分享自華為雲社區《再獲殊榮！華為雲GaussDB喜提“科技進步一等獎”》，作者：GaussDB 資料庫 。 近日， ...
  • 徹底搞懂Redis持久化機制，輕鬆應對工作面試
    Redis是基於記憶體存儲的資料庫，如果遇到服務重啟或者崩潰，記憶體中的數據將會被清空。所以為了確保數據安全性和可靠性，我們需要將記憶體中的數據持久化到磁碟上。 持久化不僅可以防止由於系統故障、重啟或者其他原因導致的數據丟失。還可以用於備份、數據恢復和遷移等操作。 ...
一周排行
    -Advertisement-
    Play Games
  • WPF 已知問題 監聽 WMI 事件導致觸摸失效
    示例項目結構 在 Visual Studio 中創建一個 WinForms 應用程式後，項目結構如下所示： MyWinFormsApp/ │ ├───Properties/ │ └───Settings.settings │ ├───bin/ │ ├───Debug/ │ └───Release/ ...
  • [STAThread]特性
    [STAThread] 特性用於需要與 COM 組件交互的應用程式，尤其是依賴單線程模型（如 Windows Forms 應用程式）的組件。在 STA 模式下，線程擁有自己的消息迴圈，這對於處理用戶界面和某些 COM 組件是必要的。 [STAThread] static void Main(stri ...
  • UWP WinUI3 傳入 AddHandler 的 RoutedEventHandler 類型與事件所需不匹配將拋出參數異常
    在WinForm中使用全局異常捕獲處理 在WinForm應用程式中，全局異常捕獲是確保程式穩定性的關鍵。通過在Program類的Main方法中設置全局異常處理，可以有效地捕獲並處理未預見的異常，從而避免程式崩潰。 註冊全局異常事件 [STAThread] static void Main() { / ...
  • .NET 多版本 WinForm 開源控制項庫 SunnyUI
    前言 給大家推薦一款開源的 Winform 控制項庫，可以幫助我們開發更加美觀、漂亮的 WinForm 界面。 項目介紹 SunnyUI.NET 是一個基於 .NET Framework 4.0+、.NET 6、.NET 7 和 .NET 8 的 WinForm 開源控制項庫，同時也提供了工具類庫、擴展 ...
  • .net core8 使用Swagger（附當前源碼）
    說明 該文章是屬於OverallAuth2.0系列文章，每周更新一篇該系列文章（從0到1完成系統開發）。 該系統文章，我會儘量說的非常詳細，做到不管新手、老手都能看懂。 說明：OverallAuth2.0 是一個簡單、易懂、功能強大的許可權+可視化流程管理系統。 有興趣的朋友，請關註我吧(*^▽^*) ...
  • WPF 什麼時候 VisualTreeHelper.GetDescendantBounds 將返回無窮大
    一、下載安裝 1.下載git 必須先下載並安裝git，再TortoiseGit下載安裝 git安裝參考教程：https://blog.csdn.net/mukes/article/details/115693833 2.TortoiseGit下載與安裝 TortoiseGit，Git客戶端，32/6 ...
  • C# 開源教程帶你輕鬆掌握數據結構與演算法
    前言 在項目開發過程中，理解數據結構和演算法如同掌握蓋房子的秘訣。演算法不僅能幫助我們編寫高效、優質的代碼，還能解決項目中遇到的各種難題。 給大家推薦一個支持C#的開源免費、新手友好的數據結構與演算法入門教程：Hello演算法。 項目介紹 《Hello Algo》是一本開源免費、新手友好的數據結構與演算法入門 ...
  • 第22篇 生成proto文件bat腳本
    1.生成單個Proto.bat內容 @rem Copyright 2016, Google Inc. @rem All rights reserved. @rem @rem Redistribution and use in source and binary forms, with or with ...
  • 記一次 .NET某上位機視覺程式 卡死分析
    一：背景 1. 講故事 前段時間有位朋友找到我，說他的窗體程式在客戶這邊出現了卡死，讓我幫忙看下怎麼回事？dump也生成了，既然有dump了那就上 windbg 分析吧。 二：WinDbg 分析 1. 為什麼會卡死 窗體程式的卡死，入口門檻很低，後續往下分析就不一定了，不管怎麼說先用 !clrsta ...
  • 醫學DICOM文件與PACS系統進行數據傳輸
    前言 人工智慧時代，人臉識別技術已成為安全驗證、身份識別和用戶交互的關鍵工具。 給大家推薦一款.NET 開源提供了強大的人臉識別 API，工具不僅易於集成，還具備高效處理能力。 本文將介紹一款如何利用這些API，為我們的項目添加智能識別的亮點。 項目介紹 GitHub 上擁有 1.2k 星標的 C# ...
所有分類