Skip to content
体验新版
项目
组织
正在加载...
登录
切换导航
打开侧边栏
littlefishear
unidocs-zh
提交
945a6f99
unidocs-zh
项目概览
littlefishear
/
unidocs-zh
与 Fork 源项目一致
Fork自
DCloud / unidocs-zh
通知
1
Star
0
Fork
0
代码
文件
提交
分支
Tags
贡献者
分支图
Diff
Issue
0
列表
看板
标记
里程碑
合并请求
0
DevOps
流水线
流水线任务
计划
Wiki
0
Wiki
分析
仓库
DevOps
项目成员
Pages
unidocs-zh
项目概览
项目概览
详情
发布
仓库
仓库
文件
提交
分支
标签
贡献者
分支图
比较
Issue
0
Issue
0
列表
看板
标记
里程碑
合并请求
0
合并请求
0
Pages
DevOps
DevOps
流水线
流水线任务
计划
分析
分析
仓库分析
DevOps
Wiki
0
Wiki
成员
成员
收起侧边栏
关闭侧边栏
动态
分支图
创建新Issue
流水线任务
提交
Issue看板
体验新版 GitCode,发现更多精彩内容 >>
未验证
提交
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.
先完成此消息的编辑!
取消
想要评论请
注册
或
登录