uniapp-x的HarmonyOS鸿蒙应用开发：tabbar底部导航栏的实现

优质文章学习记录

— 8 min read
uniapp-x的HarmonyOS鸿蒙应用开发：tabbar底部导航栏的实现
假期期间，百无聊赖。空闲时间够多了吧？有时候感觉特别的百无聊赖。不睡懒觉，电影不看，手机不刷，游戏不玩，也无处可去。那么做什么呢? 于是翻出来之前做过的“爱影家”影视app项目，找个跨多端的技术栈实战学习一把。我先后尝试了kuikly、flutter 、arkui-x等框架，结果。。。，额，这几个没少踩坑做不动了。真想向天问一下，跨平台框架开发哪家强？最后尝试了下uni-app x，被惊艳到了。果然dcloud很给力啊。且uni-app-x的性能很给力。还停留在uniapp只擅长小程序吗？唯独被诟病的是：uniapp-x的uts语法很难受啊，写法跟ts差异很大，且大模型不认识uts语法。

可以体验打包后的hello uni-app x这个demo项目，地址是：https://hellouniappx.dcloud.net.cn/

可以看到组件很全面啊，我先后体验了android端，鸿蒙端和小程序端，界面UI效果一致，且鸿蒙端运行相当流畅。可以看到组件还是很丰富的。浏览器端的体检们可以直接访问：https://hellouniappx.dcloud.net.cn/web#/pages/component/view/view

UTS语法介绍：https://doc.dcloud.net.cn/uni-app-x/uts/

鸿蒙next手机端的体验：

使用鸿蒙next手机的应用商店，搜索“DCloud开发者中心系统”可以下载安装体验。据说渲染速度超过了原生写法，你说牛不牛吧？

HBuilderX 5.0先推出了鸿蒙版的蒸汽模式介绍：https://doc.dcloud.net.cn/uni-app-x/app-harmony/harmony-vapor.html

这个无名的渲染系统，实现了跨平台App框架的历史突破，即：基于原生渲染管线，但超越了原生的渲染速度。

• vue蒸气模式（Vapor），免除vnode的创建耗时，渲染速度更快。
• 新版App渲染系统，依然是基于原生渲染管线，但渲染速度超过原生写法。

项目概述

本文基于爱影家（imovie）项目，介绍如何使用uni-app x技术栈在鸿蒙平台上实现tabBar底部导航栏。uni-app x是DCloud推出的新一代跨平台开发框架，支持将代码编译为多个平台的原生代码，包括：

  • Android平台：编译为Kotlin
  • iOS平台：编译为Swift
  • 鸿蒙Next平台：编译为ArkTS
  • Web和小程序平台：编译为JS

在Android平台，uni-app x的工程被整体编译为Kotlin代码，本质上是换了Vue写法的原生Kotlin应用，在性能上与原生Kotlin一致。

在这里插入图片描述

实现步骤

环境准备：

下载安装hbuilderx的当前最新版本4.87,下载链接：https://www.dcloud.io/hbuilderx.html
下载安装devStudio当前最新版本6.0.2，下载链接：https://developer.huawei.com/consumer/cn/develop/

1. 目录结构准备

打开hbuilderx的IDE,新建项目，选择第一个默认模板即可。注意一定要勾选下面的uniapp-x，这样生成的才是uniapp-x的项目工程。

在这里插入图片描述

以下是几个关键目录和文件：

  • pages/：存放应用页面
  • static/：存放静态资源，包括tabBar图标
  • pages.json：配置应用页面和tabBar
  • theme.json：配置主题变量

在本项目中，我们创建了以下目录结构：

pages/ └── tabBar/ ├── home.uvue # 首页 ├── zhihu.uvue # 日报页 └── mine.uvue # 我的页面 static/ ├── ic_tab_home.png # 首页默认图标 ├── ic_tab_active_home.png # 首页选中图标 ├── ic_tab_ribao.png # 日报默认图标 ├── ic_tab_ribao_active.png # 日报选中图标 ├── ic_tab_me.png # 我的默认图标 └── ic_tab_active_me.png # 我的选中图标

2. 配置pages.json

在pages.json文件中，我们需要配置应用页面和tabBar。uni-app x支持条件编译，可以为不同平台配置不同的tabBar参数。

页面配置

首先，在pages数组中定义应用的页面：

{"pages":[{"path":"pages/tabBar/home","style":{"navigationBarTitleText":"首页","backgroundColorContent":"@tabBarPagebackgroundColorContent"}},// #ifdef APP-ANDROID || APP-IOS || WEB || MP-WEIXIN || APP-HARMONY{"path":"pages/tabBar/zhihu","style":{"navigationBarTitleText":"日报","backgroundColorContent":"@tabBarPagebackgroundColorContent"}},// #endif// #ifdef APP-ANDROID || APP-IOS || WEB || MP-WEIXIN || APP-HARMONY{"path":"pages/tabBar/mine","style":{"navigationBarTitleText":"我的","backgroundColorContent":"@tabBarPagebackgroundColorContent"}}// #endif]}
tabBar配置

然后，在tabBar对象中配置底部导航栏。由于鸿蒙平台的特殊性，我们使用条件编译为鸿蒙平台单独配置：

// #ifndef APP-HARMONY"tabBar":{"color":"@tabBarColor","selectedColor":"@tabBarSelectedColor","borderStyle":"@tabBarBorderStyle","backgroundColor":"@tabBarBackgroundColor","list":[{"pagePath":"pages/tabBar/home","iconPath":"@tabBarHomeIconPath","selectedIconPath":"@tabBarHomeSelectedIconPath","text":"首页"},{"pagePath":"pages/tabBar/zhihu","iconPath":"@tabBarZhiHuIconPath","selectedIconPath":"@tabBarZhiHuSelectedIconPath","text":"日报"},{"pagePath":"pages/tabBar/mine","iconPath":"@tabBarMineIconPath","selectedIconPath":"@tabBarMineSelectedIconPath","text":"我的"}]},// #endif// #ifdef APP-HARMONY"tabBar":{"color":"@tabBarColor","selectedColor":"@tabBarSelectedColor","borderStyle":"@tabBarBorderStyle","backgroundColor":"@tabBarBackgroundColor","list":[{"pagePath":"pages/tabBar/home","iconPath":"static/ic_tab_home.png","selectedIconPath":"static/ic_tab_active_home.png","text":"首页"},{"pagePath":"pages/tabBar/zhihu","iconPath":"static/ic_tab_ribao.png","selectedIconPath":"static/ic_tab_ribao_active.png","text":"日报"},{"pagePath":"pages/tabBar/mine","iconPath":"static/ic_tab_me.png","selectedIconPath":"static/ic_tab_active_me.png","text":"我的"}]},// #endif

3. 配置theme.json

在theme.json文件中，我们定义了tabBar相关的主题变量，包括颜色、图标路径等：

{"light":{"navigationBarTextStyle":"white","navigationBarBackgroundColor":"#007AFF","backgroundColorContent":"#efeff4","tabBarPagebackgroundColorContent":"#efeff4","backgroundColor":"#efeff4","backgroundTextStyle":"dark","tabBarColor":"#7A7E83","tabBarSelectedColor":"#007AFF","tabBarBorderStyle":"black","tabBarBackgroundColor":"#F8F8F8","tabBarHomeIconPath":"static/ic_tab_home.png","tabBarHomeSelectedIconPath":"static/ic_tab_active_home.png","tabBarZhiHuIconPath":"static/ic_tab_ribao.png","tabBarZhiHuSelectedIconPath":"static/ic_tab_ribao_active.png","tabBarMineIconPath":"static/ic_tab_me.png","tabBarMineSelectedIconPath":"static/ic_tab_active_me.png"},"dark":{"navigationBarTextStyle":"white","navigationBarBackgroundColor":"#1F1F1F","backgroundColor":"#1F1F1F","backgroundColorContent":"#646464","tabBarPagebackgroundColorContent":"#1F1F1F","backgroundTextStyle":"light","tabBarColor":"#cacaca","tabBarSelectedColor":"#007AFF","tabBarBorderStyle":"white","tabBarBackgroundColor":"#1F1F1F","tabBarHomeIconPath":"static/ic_tab_home.png","tabBarHomeSelectedIconPath":"static/ic_tab_active_home.png","tabBarZhiHuIconPath":"static/ic_tab_ribao.png","tabBarZhiHuSelectedIconPath":"static/ic_tab_ribao_active.png","tabBarMineIconPath":"static/ic_tab_me.png","tabBarMineSelectedIconPath":"static/ic_tab_active_me.png"}}

这样，我们就可以在pages.json中使用@tabBarColor等变量来引用这些配置。

4. 创建页面文件

在pages/tabBar/目录下创建三个页面文件：

  • home.uvue：首页
  • zhihu.uvue：日报页
  • mine.uvue：我的页面

这些页面文件使用.uvue后缀，这是uni-app x的特有文件格式，支持Vue语法和原生能力。

技术要点

1. 条件编译

uni-app x支持条件编译，可以为不同平台编写不同的代码。在本项目中，我们使用条件编译为鸿蒙平台配置了专门的tabBar：

// #ifdef APP-HARMONY"tabBar":{// 鸿蒙平台特有的配置},// #endif

2. 主题变量

通过在theme.json中定义主题变量，我们可以实现统一的主题管理，并且支持浅色和深色模式：

  • tabBarColor：tabBar文字默认颜色
  • tabBarSelectedColor：tabBar文字选中颜色
  • tabBarBackgroundColor：tabBar背景颜色
  • tabBarBorderStyle：tabBar边框样式

3. 图标资源

tabBar图标资源放在static文件夹下，包括默认状态和选中状态的图标：

  • 默认图标：ic_tab_home.png、ic_tab_ribao.png、ic_tab_me.png
  • 选中图标：ic_tab_active_home.png、ic_tab_ribao_active.png、ic_tab_active_me.png

平台差异处理

鸿蒙平台

在鸿蒙平台上，uni-app x将代码编译为ArkTS，实现原生性能。我们为鸿蒙平台单独配置了tabBar，使用了直接的图标路径引用。

其他平台

在其他平台（Android、iOS、Web、小程序）上，我们使用了主题变量来引用图标路径，这样可以更方便地管理主题。

优势分析

使用uni-app x实现tabBar底部导航栏相比原生ArkUI开发有以下优势：

  1. 跨平台：一套代码可以在多个平台运行，包括鸿蒙、Android、iOS、Web和小程序
  2. 开发效率高：使用Vue语法，开发速度快，学习成本低
  3. 原生性能：编译为各平台的原生代码，性能与原生应用一致
  4. 配置简单：通过pages.json配置即可实现tabBar，无需编写复杂的原生代码
  5. 主题管理：支持通过theme.json统一管理主题，方便实现浅色/深色模式

体验与测试

不得不说，如今的uni-app x打包编译鸿蒙应用太方便了，竟不用再打开鸿蒙原生开发IDE工具devstudio来配置签名了，全部在HbuilerX的IDE中完成。且可以自动申请调试证书和自动签名，省去了其他繁琐的操作，很快可以运行在模拟器或者真机上。

本案例项目地址：https://gitcode.com/qq8864/uniappx_imovie

在这里插入图片描述


在这里插入图片描述


真机上运行效果截图：

在这里插入图片描述

总结

通过本文的介绍，我们了解了如何使用uni-app x在鸿蒙平台上实现tabBar底部导航栏。uni-app x提供了简洁的配置方式，通过pages.json和theme.json即可完成tabBar的配置，相比原生ArkUI开发更加简单高效。同时，uni-app x支持跨平台开发，一套代码可以在多个平台运行，大大提高了开发效率。

Read more

《C++ Web 自动化测试实战：常用函数全解析与场景化应用指南》

《C++ Web 自动化测试实战：常用函数全解析与场景化应用指南》

🔥草莓熊Lotso：个人主页 ❄️个人专栏: 《C++知识分享》《Linux 入门到实践：零基础也能懂》 ✨生活是默默的坚持，毅力是永久的享受！ 🎬 博主简介： 文章目录 * 前言： * 一. 元素定位：自动化测试的 “精准导航” * 1.1 cssSelector：简洁高效的选择器 * 1.2 xpath：灵活强大的路径语言 * 二. 测试对象操作：定位后的 “核心动作” * 2.1 点击与提交：触发页面交互 * 2.2 文本输入与清除：模拟用户输入 * 2.3 文本与属性获取：验证测试结果 * 三. 窗口与弹窗控制：解决 “多窗口与弹窗干扰” * 3.1 窗口控制：句柄是关键 * 3.

libwebkit2gtk-4.1-0安装全流程：超详细版配置说明

从零搞定 libwebkit2gtk-4.1-0 安装：开发者避坑全指南 你有没有遇到过这样的场景？刚写好一个基于 GTK4 的 Web 嵌入应用，信心满满地编译运行，结果终端弹出一行红字： error while loading shared libraries: libwebkit2gtk-4.1.so.0: cannot open shared object file 或者更糟——明明安装了库，却提示 undefined symbol: webkit_web_view_new ，程序直接崩溃。 别急，这几乎是每个尝试在 Linux 上集成现代 Web 内容的开发者都会踩的“第一颗雷”。而罪魁祸首，往往就是那个看似普通、实则牵一发而动全身的核心库： libwebkit2gtk-4.1-0 。 今天，

Flutter 三方库 serial 的鸿蒙化适配指南 - 在鸿蒙系统上构建极致、稳定的 Web 串口通信与工业硬软连接实战

欢迎加入开源鸿蒙跨平台社区：https://openharmonycrossplatform.ZEEKLOG.net Flutter 三方库 serial 的鸿蒙化适配指南 - 在鸿蒙系统上构建极致、稳定的 Web 串口通信与工业硬软连接实战 在鸿蒙（OpenHarmony）系统的工业平板、手持 PDA 及桌面协同场景中，如何通过 Web 容器直接操控外部硬件设备（如扫码枪、打印机、传感器）？serial 做为一个优秀的 window.navigator.serial API 的 Flutter 封装库，为鸿蒙开发者提供了跨平台的硬件底座。本文将深入探讨其在鸿蒙生态中的适配要点。 前言 什么是 Web Serial？它允许鸿蒙应用内的 Web 组件直接请求访问用户的串行设备。在 Flutter for OpenHarmony 的实际开发中，serial
【前端】使用Vue3过程中遇到加载无效设置点击方法提示不存在的情况，原来是少加了一个属性

【前端】使用Vue3过程中遇到加载无效设置点击方法提示不存在的情况，原来是少加了一个属性

🌹欢迎来到《小5讲堂》🌹 🌹这是《前端》系列文章，每篇文章将以博主理解的角度展开讲解。🌹 🌹温馨提示：博主能力有限，理解水平有限，若有不对之处望指正！🌹 目录 * 前言 * 提示报错 * 问题分析 * 1. **Options API vs Composition API 风格差异** * ✅ **Options API 写法（方法直接放在外面）** * ✅ **Composition API 写法（方法必须在 setup 中定义）** * ✅ **`<script setup>` 语法糖（最简洁的 Composition API）** * 2. **为什么你的代码会报错？** * 3. **解决方案** * 方案 1：改用 **Options API**（适合从 Vue