Skip to content
体验新版
项目
组织
正在加载...
登录
切换导航
打开侧边栏
DCloud
unidocs-zh
提交
19bb5372
unidocs-zh
项目概览
DCloud
/
unidocs-zh
通知
3593
Star
108
Fork
920
代码
文件
提交
分支
Tags
贡献者
分支图
Diff
Issue
120
列表
看板
标记
里程碑
合并请求
108
DevOps
流水线
流水线任务
计划
Wiki
0
Wiki
分析
仓库
DevOps
项目成员
Pages
unidocs-zh
项目概览
项目概览
详情
发布
仓库
仓库
文件
提交
分支
标签
贡献者
分支图
比较
Issue
120
Issue
120
列表
看板
标记
里程碑
合并请求
108
合并请求
108
Pages
DevOps
DevOps
流水线
流水线任务
计划
分析
分析
仓库分析
DevOps
Wiki
0
Wiki
成员
成员
收起侧边栏
关闭侧边栏
动态
分支图
创建新Issue
流水线任务
提交
Issue看板
提交
19bb5372
编写于
11月 04, 2023
作者:
DCloud-yyl
浏览文件
操作
浏览文件
下载
电子邮件补丁
差异文件
添加android平台layout inspector使用教程
上级
88baee3a
变更
1
隐藏空白更改
内联
并排
Showing
1 changed file
with
54 addition
and
0 deletion
+54
-0
docs/uni-app-x/debug/android-inspector.md
docs/uni-app-x/debug/android-inspector.md
+54
-0
未找到文件。
docs/uni-app-x/debug/android-inspector.md
0 → 100644
浏览文件 @
19bb5372
HBuilderX暂时不支持 uni-app x 项目 uvue 页面的元素审查,无法查看页面中元素的排版布局情况。
在开发中如果 uvue 页面中的元素无法显示或显示位置不符合预期,可以利用 Android Studio 自带的 Layout Inpector 工具查看元素布局相关信息。

**准备环境**
-
安装 Android Studio,可到
[
Google Android官网下载
](
https://developer.android.google.cn/studio?hl=zh-cn
)
,更多安装细节可参考
[
Android官方文档
](
https://developer.android.google.cn/studio/install?hl=zh-cn
)
-
开发电脑连接Android设备(推荐使用Google官方模拟器),设备需
[
启用开发者选项
](
https://developer.android.google.cn/studio/debug/dev-options?hl=zh-cn#enable
)
### 运行uni-app x项目
启动HBuilderX,创建 uni-app x 项目(已创建项目忽略此步骤)。
打开项目的manifest.json文件,选择 "运行" -> "运行到手机或模拟器" -> "运行到Android App基座":

在运行项目界面选择要使用的设备,点击"运行":

确保应用编译成功,在手机上操作安装真机运行基座App,安装成功后HBuilderX会自动启动App。
### Layout Inspector 审查元素
启动 Android Studio,首次运行需要
[
创建Android原生项目
](
https://developer.android.google.cn/studio/projects/create-project?hl=zh-cn
)
。
打开项目,选择 "Tools" -> "Layout Inspector",启动 Layout Inspector:

在 Layout Inspector 界面选择要操作的设备:

连接正常将会在 Layout Inspector 界面中显示手机端应用的截屏。
> 注意:需要确保uni-app x项目在设备前台运行
左侧 Component Tree 中展开所有子节点,查找到 DecorView -> LinearLayout -> content -> PageFrameView -> RenderContainer,下面就是 uvue 页面 template 中元素对应的原生View:

> view 组件对应原生 UniView
> image 组件对应原生 UniImageView
> text 组件对应原生 UniTextView
在左侧 Component Tree 中选择要查看的view,对应右侧 Attributes 中显示其排版计算后的原生属性,如width是原生view的宽度,height是原生view的高度。
可切换到3D模式,查看原生组件的层级关系:

### 注意事项
-
uni-app x项目需使用标准基座或自定义基座运行,发布为正式包后无法使用 Layout Inpector
-
如果启动 Layout Inspector 报错,请更新 Android Studio 到最新版本再重试
-
在部分设备连接 Layout Inspector 后应用可能会导致 App 退出,这时需换其它设备,建议使用Google官方提供的模拟器
### 参考
-
[
Android Studio 使用布局检查器和布局验证工具调试布局
](
https://developer.android.google.cn/studio/debug/layout-inspector?hl=zh-cn
)
-
[
Android检查GPU渲染速度和过渡绘制
](
https://developer.android.google.cn/topic/performance/rendering/inspect-gpu-rendering?hl=zh-cn
)
编辑
预览
Markdown
is supported
0%
请重试
或
添加新附件
.
添加附件
取消
You are about to add
0
people
to the discussion. Proceed with caution.
先完成此消息的编辑!
取消
想要评论请
注册
或
登录