Skip to content
体验新版
项目
组织
正在加载...
登录
切换导航
打开侧边栏
DCloud
unidocs-zh
提交
a7932d57
unidocs-zh
项目概览
DCloud
/
unidocs-zh
通知
3200
Star
106
Fork
813
代码
文件
提交
分支
Tags
贡献者
分支图
Diff
Issue
94
列表
看板
标记
里程碑
合并请求
70
DevOps
流水线
流水线任务
计划
Wiki
0
Wiki
分析
仓库
DevOps
项目成员
Pages
unidocs-zh
项目概览
项目概览
详情
发布
仓库
仓库
文件
提交
分支
标签
贡献者
分支图
比较
Issue
94
Issue
94
列表
看板
标记
里程碑
合并请求
70
合并请求
70
Pages
DevOps
DevOps
流水线
流水线任务
计划
分析
分析
仓库分析
DevOps
Wiki
0
Wiki
成员
成员
收起侧边栏
关闭侧边栏
动态
分支图
创建新Issue
流水线任务
提交
Issue看板
提交
a7932d57
编写于
9月 14, 2024
作者:
雪洛
浏览文件
操作
浏览文件
下载
电子邮件补丁
差异文件
docs: 更新4.27版本鸿蒙开发文档
上级
1cb970a6
变更
2
展开全部
隐藏空白更改
内联
并排
Showing
2 changed file
with
768 addition
and
52 deletion
+768
-52
docs/tutorial/harmony/dev-v1.md
docs/tutorial/harmony/dev-v1.md
+753
-0
docs/tutorial/harmony/dev.md
docs/tutorial/harmony/dev.md
+15
-52
未找到文件。
docs/tutorial/harmony/dev-v1.md
0 → 100644
浏览文件 @
a7932d57
此差异已折叠。
点击以展开。
docs/tutorial/harmony/dev.md
浏览文件 @
a7932d57
# uni-app 开发鸿蒙应用
> 此文档适用于HBuilderX 4.27及之后的版本,4.26及之前的版本请移步:[开发鸿蒙应用](./dev-v1.md)
> [uni-app鸿蒙化技术交流群](https://im.dcloud.net.cn/#/?joinGroup=668685db8185e1e6e7b7b15e)
## 兼容性说明
...
...
@@ -26,14 +28,6 @@
![](
https://web-ext-storage.dcloud.net.cn/uni-app/harmony/dev/1720085210915b1knhu7l3u8.png
)
## 配置鸿蒙离线SDK(鸿蒙项目模板)@harmonysdk
1.
下载 uni-app 鸿蒙离线SDK template-1.3.7.tgz
[
下载地址
](
https://web-ext-storage.dcloud.net.cn/uni-app/harmony/zip/template-1.3.7.tgz
)
2.
解压刚下载的压缩包,将解压后的模板工程在 DevEco-Studio 中打开
3.
等待 Sync 结束,再
[
启动鸿蒙模拟器
](
#connectvirtually
)
或
[
连接鸿蒙真机
](
#connectmobile
)
### 启动鸿蒙模拟器@connectvirtually
![](
https://web-ext-storage.dcloud.net.cn/uni-app/harmony/dev/1720085379828ap3pkhhfmig.png
)
...
...
@@ -92,35 +86,27 @@
![](
https://web-ext-storage.dcloud.net.cn/uni-app/harmony/171981598089431le57049d.png
)
##
配置 uni-app 工程@uniappproject
##
运行uni-app项目
1.
HBuilderX 新建一个空白的 uniapp 项目,选vue3
2.
在 manifest.json 文件中配置鸿蒙离线SDK路径
编辑 manifest.json 文件,新增如下配置:
2.
编译 uni-app 到鸿蒙
```
json
"app-harmony"
:
{
"projectPath"
:
"上一步下载的template-1.3.7.tgz的解压地址/package"
}
```
点击 HBuilderX 上方【运行】菜单,运行到鸿蒙 DevEco Studio
![](
https://web-ext-storage.dcloud.net.cn/uni-app/harmony/
1719816197812rg4fsafg2io
.png
)
![](
https://web-ext-storage.dcloud.net.cn/uni-app/harmony/
dev/20240914151457
.png
)
3.
编译 uni-app 到鸿蒙
3.
【首次运行】此时如果是第一次运行本项目会在项目根目录下生成harmony-configs目录用于存放鸿蒙配置文件
点击 HBuilderX 上方【运行】菜单,运行到鸿蒙 DevEco Studio
![](
https://web-ext-storage.dcloud.net.cn/uni-app/harmony/dev/20240914151712.png
)
![](
https://web-ext-storage.dcloud.net.cn/uni-app/harmony/17183338900070pjn2uj49t8.png
)
4.
【首次运行】配置签名信息、包名到鸿蒙配置文件内
如果没有出现此菜单,请确认你的 HBuilderX 版本是否是 4.22 及以上
参考:
[
修改鸿蒙工程配置
](
https://uniapp.dcloud.net.cn/tutorial/run/run-app-harmony.html#configs
)
4.
在 DevEco-Studio 重新编译或运行
5.
再次运行项目,选择目标设备
先等待 HBuilderX 编译完成,然后打开 DevEco-Studio,点击运行
![](
https://web-ext-storage.dcloud.net.cn/uni-app/harmony/dev/1720086018931faq60pigq9g.png
)
![](
https://web-ext-storage.dcloud.net.cn/uni-app/harmony/dev/20240914152406.jpg
)
## 使用uts调用鸿蒙原生API@nativeapi
...
...
@@ -653,30 +639,9 @@ map组件、getLocation、openLocation、chooseLocation依赖于地图厂商。
## 常见问题@question
### 如何修改应用包名@q1
1.
打开
`AppScope\app.json5`
修改
`bundleName`
![](
https://web-ext-storage.dcloud.net.cn/uni-app/harmony/dev/17202578113708uo26uaj0vg.png
)
2.
删除
`build-profile.json5`
内旧的签名信息
3.
重启鸿蒙 DevEco Studio,启动模拟器或连接真机后,重新
[
配置签名
](
#signature
)
### 如何修改应用名称、图标、权限等信息
### 如何修改应用名称@q2
1.
打开
`AppScope\resources\base\element\string.json`
修改数组元素 name 值为 app_name 对应的 value 的值
2.
打开
`entry\src\main\resources\base\element\string.json`
修改数组元素 name 值为 EntryAbility_label 对应的 value 的值
3.
打开
`entry\src\main\resources\en_US\element\string.json`
修改数组元素 name 值为 EntryAbility_label 对应的 value 的值
4.
打开
`entry\src\main\resources\zh_CN\element\string.json`
修改数组元素 name 值为 EntryAbility_label 对应的 value 的值
### 如何修改应用图标@q3
替换以下文件,注意文件不要改名
1.
AppScope
\r
esources
\b
ase
\m
edia
\a
pp_icon.png
2.
entry
\s
rc
\m
ain
\r
esources
\b
ase
\m
edia
\f
oreground.png
3.
entry
\s
rc
\m
ain
\r
esources
\b
ase
\m
edia
\s
tartIcon.png
参考鸿蒙官方文档:
[
应用/组件级配置
](
https://developer.huawei.com/consumer/cn/doc/harmonyos-guides-V5/application-component-configuration-stage-V5
)
### 鸿蒙DevEco Studio如何开启热重载@q4
...
...
@@ -684,12 +649,10 @@ map组件、getLocation、openLocation、chooseLocation依赖于地图厂商。
### 如何查看console打印的日志@q5
目前编译到鸿蒙时,在uniapp页面通过console.log打印日志
无法在 HBuilderX 直接查看,需要在鸿蒙DevEco Studio内查看,具体查看方法如下图所示
目前编译到鸿蒙时,在uniapp页面通过console.log打印日志
可以直接在 HBuilderX 查看
注意:在uniapp页面打印对象或数组时,需要
`JSON.stringify`
,如
`console.log("obj", JSON.stringify(obj))`
![](
https://web-ext-storage.dcloud.net.cn/uni-app/harmony/dev/17210155750168uc4maboupo.png
)
### 运行出现白屏或闪退怎么解决?@q6
首先尝试重新编译uniapp项目,并重启模拟器或真机,如果依然白屏或闪退,那可能是你项目中有用到了鸿蒙不支持的组件或者api,可以尝试pages.json进行代码二分法排查(删除一半页面如果正常了代表被删除的那一半页面中有造成白屏或闪退的页面)
...
...
编辑
预览
Markdown
is supported
0%
请重试
或
添加新附件
.
添加附件
取消
You are about to add
0
people
to the discussion. Proceed with caution.
先完成此消息的编辑!
取消
想要评论请
注册
或
登录