Skip to content
体验新版
项目
组织
正在加载...
登录
切换导航
打开侧边栏
DCloud
unidocs-zh
提交
945a6f99
unidocs-zh
项目概览
DCloud
/
unidocs-zh
通知
3172
Star
105
Fork
804
代码
文件
提交
分支
Tags
贡献者
分支图
Diff
Issue
93
列表
看板
标记
里程碑
合并请求
67
DevOps
流水线
流水线任务
计划
Wiki
0
Wiki
分析
仓库
DevOps
项目成员
Pages
unidocs-zh
项目概览
项目概览
详情
发布
仓库
仓库
文件
提交
分支
标签
贡献者
分支图
比较
Issue
93
Issue
93
列表
看板
标记
里程碑
合并请求
67
合并请求
67
Pages
DevOps
DevOps
流水线
流水线任务
计划
分析
分析
仓库分析
DevOps
Wiki
0
Wiki
成员
成员
收起侧边栏
关闭侧边栏
动态
分支图
创建新Issue
流水线任务
提交
Issue看板
未验证
提交
945a6f99
编写于
7月 22, 2022
作者:
DCloud-yyl
提交者:
Gitee
7月 22, 2022
浏览文件
操作
浏览文件
下载
电子邮件补丁
差异文件
update docs/tutorial/run/run-app.md.
上级
ba655e17
变更
1
隐藏空白更改
内联
并排
Showing
1 changed file
with
52 addition
and
36 deletion
+52
-36
docs/tutorial/run/run-app.md
docs/tutorial/run/run-app.md
+52
-36
未找到文件。
docs/tutorial/run/run-app.md
浏览文件 @
945a6f99
因手机差异较大,HBuilder并没有提供App的
PC模拟器。不管uni-app的App端或5+App、wap2app,都需要连接真实的手机或专业
模拟器来运行测试,称之为“真机运行”。
因手机差异较大,HBuilder并没有提供App的
模拟器。不管uni-app或5+App/wap2app项目,都需要连接真实的手机或手机
模拟器来运行测试,称之为“真机运行”。
-
对于Android平台,HBuilder支持adb协议,在HBuilder运行的电脑上,可以使用usb线连接Android设备,也可以使用安装在电脑里的Android模拟器(包括google官方模拟器和三方模拟器)
-
对于iOS平台,HBuilder支持itunes协议,在HBuilder运行的电脑上,使用usb线连接iphone或ipad;如果是mac电脑,则可以连接xocde自带的iOS模拟器。如果是arm架构cpu,还可以直接启动真机运行基座。
-
Android平台
HBuilder支持adb协议,在HBuilder运行的电脑上,可以使用usb线连接Android设备,也可以使用安装在电脑上的Android模拟器(包括google官方模拟器,三方模拟器如“雷电”、“夜神”等)
-
iOS平台
HBuilder支持itunes协议,在HBuilder运行的电脑上,使用usb线连接iPhone或iPad;如果是mac电脑,则可以连接xocde自带的iOS模拟器。如果是arm架构cpu,还可以直接启动真机运行基座。
真机运行的目的,是为了实现代码修改的热刷新,避免打包才能看到效果。在HBuilder中编辑代码,在手机上实时看到修改效果,并且可以在HBuilder控制台看到日志。
## 运行入口
### 运行入口
通过HBuilder顶部运行菜单、或工具栏运行按钮、或快捷键,均可激活运行入口。
1.
HBuilder顶部运行菜单
1.
HBuilder顶部运行菜单
![](
https://vkceyugu.cdn.bspapp.com/VKCEYUGU-f184e7c3-1912-41b2-b81f-435d1b37c7b4/c4d3c057-40dc-4dea-9277-be1c33a252ed.png
)
2.
工具栏运行按钮
2.
工具栏运行按钮
![](
https://vkceyugu.cdn.bspapp.com/VKCEYUGU-f184e7c3-1912-41b2-b81f-435d1b37c7b4/1f9bb269-0534-4562-ba90-a96c01a6f221.png
)
可以按数字快速选择菜单项。比如按“4”选择“运行到Android App基座”。也可以按上下键然后回车选择。
相比于HBuilder顶部运行菜单,工具栏运行按钮下的运行菜单内容较少,只保留了最常见的运行。
3.
快捷键【Ctrl+r】
3.
快捷键【Ctrl+r】
实际上激活了工具栏运行按钮。可继续搭配数字键,实现无鼠标快捷运行操作。
## 连接设备
点击运行到iOS或Android设备时,会弹出选择界面,需选择要连接的手机设备或模拟器。
-
Android设备选择
### 连接设备
点击运行到iOS或Android设备时,会弹出选择界面,需选择要连接的手机设备或模拟器。
可以多设备运行,每个运行设备会在HBuilder底部控制台新开一个独立窗口,互不干扰。
但一个设备同时只能运行一个项目,不同的项目运行到相同手机只有最后一个项目生效。
> 连接设备过程中如果找不到手机,可以尝试点击“刷新”按钮,如果还是无法找到手机请参考[真机运行常见问题](run-app-faq.md)
#### Android设备选择
![](
https://vkceyugu.cdn.bspapp.com/VKCEYUGU-f184e7c3-1912-41b2-b81f-435d1b37c7b4/51434ff0-fff6-4006-a1a0-9db800393d60.jpg
)
-
iOS设备选择
![](
https://vkceyugu.cdn.bspapp.com/VKCEYUGU-f184e7c3-1912-41b2-b81f-435d1b37c7b4/04b9d6fa-51f5-4ca7-8301-9200cbe935eb.jpg
)
**注意事项**
-
如果电脑里安装有模拟器(Android模拟器需要先启动),HBuilder会直接检测到设备并显示在候选列表中。可以参考
[
如何安装模拟器
](
installSimulator.md
)
-
确认Android手机设置中
`USB调试`
模式已开启。通常在手机的【设置】【开发者选项】里,有的手机在插上数据线后在系统通知栏里也可以设置,注意不能设置为u盘模式,如果是充电模式则必须同时设置充电时
`允许usb调试`
。
如果是Mac电脑安装xcode后,上面的界面会额外显示搜索框。因xcode的iOS模拟器非常多,有搜索框过滤会更高效。
#### iOS设备选择
![](
https://vkceyugu.cdn.bspapp.com/VKCEYUGU-f184e7c3-1912-41b2-b81f-435d1b37c7b4/04b9d6fa-51f5-4ca7-8301-9200cbe935eb.jpg
)
如果电脑里安装有模拟器(Android模拟器需要先启动),HBuilder会直接检测到设备并显示在候选列表中。可以参考
[
如何安装模拟器
](
installSimulator.md
)
**注意事项**
-
确保usb线的连接通畅(有些数据线质量不佳,需使用高电压usb端口,如果无法识别时候请尝试更换数据线)
-
如果windows电脑连接iOS设备需电脑安装iTunes软件,并确保apple的mobile device服务开启、iTunes可找到手机
-
手机连接电脑后,确保在手机上弹出的“要信任此电脑吗?”提示框中点了“信任”按钮
如果是usb线连接手机或pad等设备,需要
1.
确保usb线的连接通畅(有些数据线质量不佳,需使用高电压usb端口或更换线)
2.
如果windows电脑连接iOS设备需电脑安装itunes,确保apple的mobile device服务开启、itunes可找到手机
3.
确认Android手机设置中
`USB调试`
模式已开启。这个设置一般在【设置】【开发者选项】里。有的手机在插上数据线后在push通知栏里也可以设置。注意不能设置为u盘模式,如果是充电模式则必须同时设置充电时
`允许usb调试`
。
4.
确保手机上点了同意授权按钮,以允许电脑像手机传输命令
这个过程可能有各种情况导致找不到手机设备,参考
[
真机运行常见问题
](
run-app-faq.md
)
如果是Mac电脑安装XCode后,“标准运行基座”支持使用iOS模拟器
![](
https://native-res.dcloud.net.cn/images/hx/run/ios-sim.png
)
点击后进入iOS模拟器选择界面
![](
https://native-res.dcloud.net.cn/images/hx/run/ios-sim-select.png
)
上面的界面会额外显示搜索框,因XCode的iOS模拟器非常多,可通过搜索框过滤快速选择需要使用的模拟器。
可以多设备运行,每个运行设备会在HBuilder底部控制台新开一个独立窗口,互不干扰。
但一个设备同时只能运行一个项目,不同的项目运行到相同手机只有最后一个项目生效。
##
运行流程
##
# 运行流程
初次运行时会提示安装“真机运行插件”。
该插件内置“标准运行基座”,这个基座使用的是DCloud的包名、证书和三方SDK配置。如果要自定义,则需要使用
[
自定义运行基座
](
#customplayground
)
在运行菜单中选择要运行的手机设备或模拟器,点击运行按钮,会执行如下流程:
1.
uni-app编译(如果是5+App和wap2app则不需要编译)
2.
通过数据线给手机安装真机运行基座(需要手机屏幕高亮并在手机端点击允许)
3.
编译后的代码同步到手机设备上
4.
呼起手机端的真机运行基座,加载同步到手机的代码(iOS需手动启动)
1.
uni-app项目编译(5+ App/Wap2App项目无需编译)
2.
通过数据线给手机安装真机运行基座(需要手机屏幕高亮并在手机端点击允许)
3.
编译后的代码同步到手机设备上
4.
启动手机端的真机运行基座,加载同步到手机的代码(iPhone手机需手动点击桌面图标启动)
运行成功后,HBuilder底部的控制台显示成功日志。此后修改代码会差量同步到手机上,手机程序会动态热刷。同时console.log代码会打印到控制台上,点击打印日志可以跳转到相关代码。
![](
https://vkceyugu.cdn.bspapp.com/VKCEYUGU-f184e7c3-1912-41b2-b81f-435d1b37c7b4/ac78ba4d-16c2-4ca0-8cf8-2c8bb7260052.jpg
)
运行成功后,HBuilder底部的控制台显示成功日志。此后修改代码会差量同步到手机上,手机程序会动态热刷。同时console.log代码会打印到控制台上,点击打印日志可以跳转到相关代码。
![](
https://vkceyugu.cdn.bspapp.com/VKCEYUGU-f184e7c3-1912-41b2-b81f-435d1b37c7b4/ac78ba4d-16c2-4ca0-8cf8-2c8bb7260052.jpg
)
##
标准基座和自定义基座@customplayground
##
# 标准基座和自定义基座@customplayground
标准运行基座,是DCloud为方便开发者低门槛调试而提供的,
这个基座
使用的是DCloud的包名、证书和三方SDK配置。
标准运行基座,是DCloud为方便开发者低门槛调试而提供的,
此基座App
使用的是DCloud的包名、证书和三方SDK配置。
在原生层不变的情况下,js等动态代码可以在运行基座上动态加载,实现热重载运行。
如果要自定义原生层,则需要走一遍iOS或Android的打包流程,由
xcode或Android studio编译打包形成新的ipa或apk
。
如果要自定义原生层,则需要走一遍iOS或Android的打包流程,由
XCode或Android studio编译打包生成ipa或apk安装包
。
但打包后无法方便调试,不能热重载和显示控制台日志。所以HBuilder在打包时提供了一个特殊选项,打包“自定义运行基座”。
...
...
@@ -79,10 +94,11 @@
> 打包App的入口在HBuilder顶部发行菜单,或快捷键【Ctrl+u】
自定义运行基座可以定制所有原生层变更。这些变更主要体现在manifest.json的配置中。包括但不限于
-
app名称、图标、封面splash、包名、证书
-
app模块变更、三方sdk配置(如微信、推送、地图、语音识别等三方sdk配置)、app原生插件
-
app权限变更
自定义运行基座可以所有配置生效(主要是manifest.json的配置),包括:
-
App名称、图标、封面splash、包名、证书
-
App模块配置、三方sdk配置(如微信、推送、地图、语音识别等三方sdk配置)
-
App权限配置
-
uni原生插件
-
其他manifest.json文档提到的需打包生效的配置
打包自定义运行基座后,HBuilder会自动将生成后的apk和ipa包存放在 项目目录/unpackage/debug目录下,文件名分别为
`android_debug.apk`
和
`iOS_debug.ipa`
。
...
...
编辑
预览
Markdown
is supported
0%
请重试
或
添加新附件
.
添加附件
取消
You are about to add
0
people
to the discussion. Proceed with caution.
先完成此消息的编辑!
取消
想要评论请
注册
或
登录