how_to_use_codelocator_zh.md

English | 简体中文

CodeLocator使用说明

1. 安装插件

点此下载最新版插件

选择 Android Studio > Preferences > Plugins > Install Plugin from Disk

选择下载的Zip文件安装即可

2. 界面介绍

CodeLocator 插件是一个侧边栏插件, 安装后会在Android Studio的右侧, 点击Tab即可展开插件, 初始状态如下

3. 功能介绍

CodeLocator目前支持二十六种按钮操作, 当按钮呈现绿色高亮时表示可点击, 当按钮处于灰色状态时表示不可点击, 鼠标悬停一段时候后会出现具体的功能描述

抓取	暂停动画抓取	加载文件	跳转Find	跳转Click	跳转Touch	跳转xml	跳转Holder	跳转Fragment

跳转Activity	StartActivity	点击事件追踪	弹窗追溯	复制截图	获取View数据	编辑View属性	修复项目依赖	打开新窗口

显示抓取历史	修复跳转错误	安装Apk	保存抓取数据	工具箱	使用说明	反馈问题	设置

4. 使用方法

抓取

确保应用在前台, 然后点击抓取按钮, 即可获取界面信息

此模式为直接抓取

此模式为暂停界面动画并抓取

选择View

点击左侧图片可选中View, 或者选择右侧的View Tree视图中的Item都可以选择View

面板上选择View有如下几种模式:

直接单击: 会按照可点击属性查找View, 上层可点击View会覆盖底部View
Alt + 单击: 会按照View面积去查找当前点击的View, 可能会出现点击穿透问题
Shift + 单击: 多选View, 同时可对比最后选中的两个View的间距

代码跳转

选择View后 对应的跳转代码按钮会根据当前信息变化, 点击对应的按钮可跳转View的FindViewById, Xml, ViewHolder, Fragment等代码位置

Tab切换

默认包含四个Tab, 分别是View, Activity, File, AppInfo
View Tab 包含View树浏览功能 底部为View详情Table
Activity Tab 包含Activity 和 Fragment树 底部为Fragment详情Table
File Tab 包含应用目录下的所有文件
AppInfo面板 包含App运行时信息, 点击自动复制
同时支持App添加自定义Tab

Tree展示

除AppInfo面板, 其他面板都是以Tree的形式组织展示的

View Tree 的展示格式为: [(子View数量) [当前View深度] (可设置显示) 类名 左上顶点坐标 右下顶点坐标 宽度px 高度px 宽度dp 高度dp ]
Fragment Tree 的展示格式为: [(子Fragment数量) (*表示当前Fragment可见) 类名]
File Tree 的展示格式为: [(子文件数量) 文件名 [文件总大小 (文件夹大小会包含子文件)]]

Tree搜索

View Tree 和 File Tree支持搜索, 键盘输入任意内容可进行搜索, 支持模糊匹配, 会匹配View的Class, Text, id内容

点击事件追踪

可追踪当前点击事件的传递链, 需要在设备上触摸View同时点击追踪按钮

弹窗追溯

可追溯App显示的弹窗代码位置

获取截图

可复制当前截图到剪切板或者某个View的绘制内容

获取View数据

可获取当前View绑定的数据内容

修改View属性

可实时修改当前选中View的属性

新建窗口

可根据当前抓取内容新开窗口展示

展示历史抓取

可打开最近抓取的30条内容

安装Apk

可查找安装当前项目内的Apk文件

保存抓取信息

可保存当前抓取信息到指定位置并加载

CodeLocator工具集合

可快速打开布局边界, 显示触摸位置, 显示过渡绘制等开发工具