uniapp for Harmony FAQ汇总一

2024-08-30 16:46:13 浏览数 (1)

我们在开发的过程中,或多或少会遇到一些开发方面的问

今天就来罗列一下

目录结构

一个 uni-app 工程,默认包含如下目录及文件:

代码语言:javascript复制
│─components            符合vue组件规范的uni-app组件目录
│  └─comp-a.vue         可复用的a组件
├─utssdk                存放uts文件
├─pages                 业务页面文件存放的目录
│  ├─index
│  │  └─index.vue       index页面
│  └─list
│     └─list.vue        list页面
├─static                存放应用引用的本地静态资源(如图片、视频等)的目录,注意:静态资源都应存放于此目录
├─uni_modules           存放uni_module 详见
├─platforms             存放各平台专用页面的目录,详见
├─nativeplugins         App原生语言插件 详见
├─nativeResources       App端原生资源目录
│  ├─android            Android原生资源目录 详见
|  └─ios                iOS原生资源目录 详见
├─hybrid                App端存放本地html文件的目录,详见
├─wxcomponents          存放小程序组件的目录,详见
├─unpackage             非工程代码,一般存放运行或发行的编译结果
├─main.js               Vue初始化入口文件
├─App.vue               应用配置,用来配置App全局样式以及监听 应用生命周期
├─pages.json            配置页面路由、导航条、选项卡等页面类信息,详见
├─manifest.json         配置应用名称、appid、logo、版本等打包信息,详见
├─AndroidManifest.xml   Android原生应用清单文件 详见
├─Info.plist            iOS原生应用配置文件 详见
└─uni.scss              内置的常用样式变量

uts 语言在 uni-app 和 uni-app x 下的编译关系

uni-app

uni-app x

普通页面和脚本

uts 插件

普通页面和脚本

uts 插件

Web 和小程序

JS

JS

JS

JS

Android

JS

Kotlin

Kotlin

Kotlin

iOS

JS

Swift

JS(JS 驱动时)

Swift

HarmonyNext

JS

ArkTS

x

x

条件编译仅 APP-HARMONY、APP 可以命中鸿蒙平台

现阶段条件编译仅 APP-HARMONY、APP 可以命中鸿蒙平台

代码语言:javascript复制
// #ifdef APP-HARMONY
console.log("仅鸿蒙会编译")
// #endif

// #ifndef APP-HARMONY
console.log("仅非鸿蒙会编译")
// #endif

// #ifdef APP
console.log("安卓、苹果、鸿蒙会编译,小程序和Web不会编译")
// #endif

// #ifndef APP
console.log("安卓、苹果、鸿蒙不会编译,小程序和Web会编译")
// #endif

// #ifdef APP-PLUS
console.log("安卓、苹果会编译,鸿蒙不会编译,小程序和Web也不会编译")
// #endif

// #ifndef APP-PLUS
console.log("安卓、苹果不会编译,鸿蒙会编译,小程序和Web也会编译")
// #endif

如何修改应用包名

打开 AppScopeapp.json5 修改 bundleName

如何修改应用名称

  1. 打开 AppScoperesourcesbaseelementstring.json 修改数组元素 name 值为 app_name 对应的 value 的值
  1. 打开 entrysrcmainresourcesbaseelementstring.json 修改数组元素 name 值为 EntryAbility_label 对应的 value 的值
  2. 打开 entrysrcmainresourcesen_USelementstring.json 修改数组元素 name 值为 EntryAbility_label 对应的 value 的值
  3. 打开 entrysrcmainresourceszh_CNelementstring.json 修改数组元素 name 值为 EntryAbility_label 对应的 value 的值

如何修改应用图标

替换以下文件,注意文件不要改名

  1. AppScoperesourcesbasemediaapp_icon.png
  2. entrysrcmainresourcesbasemediaforeground.png
  3. entrysrcmainresourcesbasemediastartIcon.png

报启动鸿蒙失败,请手动启动鸿蒙

Windows 系统

  1. 确保路径是正确的
  2. 注意:复制后的 要改成 /
  3. 如果步骤 1 操作完还是不行,请尝试

原路径后面添加 /bin/devecostudio64.exe,然后重启 HBuilderX

Mac 系统

  1. 确保路径是正确的(Mac 系统快速复制路径方法按住 option 键)
  2. 如果步骤 1 操作完还是不行,请尝试原路径后面添加 /Contents/MacOS/devecostudio,然后重启 HBuilderX

通过 app-plus:titleNView 配置页面右上角按钮未生效

当前导航栏未支持,可以尝试关闭原生导航栏,使用自己的自定义导航栏组件实现。

注意事项

  1. 移植已有的 uni-app 项目源码时,如有其他 npm 依赖,请自行安装
  2. 现阶段条件编译仅 APP-HARMONY、APP 可以命中鸿蒙平台
  3. 每次 HBuilderX 改动源码后,DevEco-Studio 内需要点重新运行才能生效
  4. 如果模拟器白屏了,尝试重启软件 DevEco-Studio,再重启项目
  5. 如果模拟器无法连接了,尝试重启电脑
  6. 在 HBuilderX 里运行后,需要再去鸿蒙 DevEco Studio 里运行
  7. 在 HBuilderX 里修改代码后,需要去鸿蒙 DevEco Studio 里重新运行
  8. 如果有多个 uni-app 项目要编译到鸿蒙,那么鸿蒙离线 sdk 需要放置多份,每个 uni-app 的 manifest 中配置不同的离线 sdk 地址,否则会冲突,鸿蒙设备上目前没有基座概念。

以上开发问题参考:https://uniapp.dcloud.net.cn/tutorial/harmony/dev.html

0 人点赞