GKD

https://gkd.li/guide
Admin
GKD is an Android application that automates repetitive tasks and interactions through accessibility...
Tokens:15,856
Snippets:98
Trust Score:7.3
Update:1 month ago
Show doc for...
Tokens:
Raw
### 添加订阅的链接

Source: https://gkd.li/guide/subscription

用于添加订阅的链接，指向 gkd.json5 文件。

```txt
https://gist.github.com/lisonge/3f5693182ad4ef5e307be760dba22bcb/raw/gkd.json5
```

--------------------------------

### 空规则订阅文件 (gkd.json5)

Source: https://gkd.li/guide/subscription

一个最简单的空规则订阅文件，包含 id、name、version、author、updateUrl、checkUpdateUrl、supportUri 等字段，以及空的 categories、globalGroups、apps 数组。

```json5
// gkd.json5
{
  id: 233,
  name: 'Subscription',
  version: 0,
  author: 'author',
  updateUrl: 'https://gist.github.com/lisonge/3f5693182ad4ef5e307be760dba22bcb/raw/gkd.json5',
  checkUpdateUrl: 'https://gist.github.com/lisonge/3f5693182ad4ef5e307be760dba22bcb/raw/gkd.json5',
  supportUri: 'https://gkd.li/',
  categories: [],
  globalGroups: [],
  apps: [],
}
```

--------------------------------

### 取反表达式示例：!(name$='TextView') 和 !(name='TextView'||name$='.TextView')

Source: https://gkd.li/guide/selector

展示取反表达式的两种形式。

```text
!(name$='TextView')
```

```text
!(name='TextView'||name$='.TextView')
```

--------------------------------

### 布尔表达式示例：name='TextView'

Source: https://gkd.li/guide/selector

展示布尔表达式的基本形式。

```text
name='TextView'
```

--------------------------------

### 逻辑表达式示例：name='TextView'||name$='.TextView'

Source: https://gkd.li/guide/selector

展示逻辑表达式使用 || 操作符的示例。

```text
name='TextView'||name$='.TextView'
```

--------------------------------

### 全局规则示例 (开屏广告)

Source: https://gkd.li/guide/subscription

一个简单的全局规则示例，包含 key、name、fastQuery、matchTime、actionMaximum、resetMatch、rules 等字段，用于匹配开屏广告。

```json5
{
  key: 0,
  name: '开屏广告',
  fastQuery: true,
  matchTime: 10000,
  actionMaximum: 1,
  resetMatch: 'app',
  rules: [
    {
      key: 0,
      matches: '[text*="跳过"][text.length<10][visibleToUser=true]',
    },
  ],
}
```

--------------------------------

### 优化示例：多级快速查询

Source: https://gkd.li/guide/optimize

以 `[vid="image"] <<n [vid="recyclerView"] <<n [vid="content_layout"]` 为例，展示快速查询只需调用 `findAccessibilityNodeInfosByViewId` 3 次，而普通查询需要更多次数。

```text
[vid="image"] <<n [vid="recyclerView"] <<n [vid="content_layout"]
```

--------------------------------

### 通过调用服务启动快照示例

Source: https://gkd.li/guide/snapshot

通过 shell 命令启动 GKD 内部暴露的服务来捕获快照，适用于自定义手势等外部应用。

```sh
sh /storage/emulated/0/Android/data/li.songe.gkd/files/sh/expose.sh
```

--------------------------------

### 正确的分享链接示例

Source: https://gkd.li/guide/snapshot

快照页面右上角分享生成的链接，可被其他设备正常打开。

```text
https://i.gkd.li/i/18135562
```

--------------------------------

### 祖先节点优化示例

Source: https://gkd.li/guide/optimize

当左侧选择器为 `[parent=null] >n` 时，选择器可直接获取根节点，无需多次调用获取父节点。

```text
A <3 [parent=null] >n TextView
```

```text
[parent=null] >n
```

--------------------------------

### 根节点属性选择器示例

Source: https://gkd.li/guide/optimize

选择器通过 `[parent=null]` 属性选择器标识根节点，只需存在一个 `[parent=null]` 即可满足条件。

```text
[parent=null]
```

```text
A[id='xxx'][parent=null][text='xxx']
```

--------------------------------

### 选择器示例：div > img

Source: https://gkd.li/guide/selector

展示选择器的基本结构：属性选择器、关系选择器、属性选择器。表示选择父节点是 div 的 img 节点。

```text
div > img
```

--------------------------------

### 快速查询格式符合与不符合示例

Source: https://gkd.li/guide/optimize

✅ 表示符合快速查询格式，❎ 表示不符合。注意 `id` 属性必须位于第一个属性选择表达式。

```text
A > B + C[id='x'][childCount=2] ✅
```

```text
A > B + C[childCount=2][id='x'] ❎
```

```text
A > B + C[id='x' || text='manbaout' || text*='ikun'][childCount=2] ✅
```

```text
A > B + C[childCount=2][id='x' || text='manbaout' || text*='ikun'] ❎
```

--------------------------------

### 非法标识符示例：a.1, a.null, a.true

Source: https://gkd.li/guide/selector

展示非法的成员表达式示例。

```text
a.1
```

```text
a.null
```

```text
a.true
```

--------------------------------

### 值表达式示例：a, a.b, a(b,c)

Source: https://gkd.li/guide/selector

展示变量、成员表达式和调用表达式的示例。

```text
a
```

```text
a.b
```

```text
a(b,c)
```

--------------------------------

### 应用规则组示例 (全屏广告-会员活动弹窗)

Source: https://gkd.li/guide/subscription

一个简单的规则示例，由快照-14310618 而来，包含 key、name、rules 等字段，用于匹配全屏广告弹窗。

```json5
{
  key: 1,
  name: '全屏广告-会员活动弹窗',
  rules: [
    {
      key: 0,
      fastQuery: true,
      activityIds: 'com.blued.android.core.ui.TransparentActivity',
      matches: '[vid="img_close"]',
      snapshotUrls: 'https://i.gkd.li/i/14310618',
    },
  ],
}
```

--------------------------------

### 快速查询规定格式示例

Source: https://gkd.li/guide/optimize

末尾属性选择器的第一个属性选择表达式需符合这些结构之一，或使用 `||` 连接，才能调用 Android 快速获取节点的 API。

```text
[id='abc']
```

```text
[vid='abc']
```

```text
[text='abc']
```

```text
[text^='abc']
```

```text
[text*='abc']
```

```text
[text$='abc']
```

```text
[id='abc' || id='abc2']
```

```text
[id='abc' || vid='abc' || text='abc' || text^='abc' || text*='abc' || text$='abc']
```

--------------------------------

### 局部快速查找示例

Source: https://gkd.li/guide/optimize

当属性选择器符合快速查询格式且右侧为 `<<n` 时，可在局部使用快速查找。

```text
A > B + C[id='x'][childCount=2] <<n D
```

```text
A > B + C[childCount=2][id='x'] <<n D
```

--------------------------------

### 多个局部快速查找示例

Source: https://gkd.li/guide/optimize

多个局部选择器可同时使用快速查找，如 `C[id='x'] <<n` 和 `D[id='y'] <<n`。

```text
A > C[id='x'] <<n D[id='y'] <<n E
```

--------------------------------

### 非法调用表达式示例：a()()

Source: https://gkd.li/guide/selector

展示非法的调用表达式，因为调用者不能是调用表达式。

```text
a()()
```

--------------------------------

### activityid 示例

Source: https://gkd.li/guide/subscription

一个简单的 activityid 示例，包含两个 activityid 值。

```json5
com.tencent.mm.plugin.sns.ui.SnsTimeLineUI
com.tencent.mm.plugin.sns.ui.improve.ImproveSnsTimelineUI
```

--------------------------------

### 并列属性选择器示例：a=1 和 b=1

Source: https://gkd.li/guide/selector

展示并列的 [] 视为使用 && 的逻辑表达式。

```text
[a=1][b=1]
```

```text
[a=1&&b=1]
```

--------------------------------

### 转义字符示例：\\, \', \", \`, \n, \r, \t, \b, \xfF, \uffFF

Source: https://gkd.li/guide/selector

展示所有转义字符的示例。

```text
\\
```

```text
\'
```

```text
\"
```

```text
\`
```

```text
\n
```

```text
\r
```

```text
\t
```

```text
\b
```

```text
\xfF
```

```text
\uffFF
```

--------------------------------

### 快速查询并集与取反示例

Source: https://gkd.li/guide/optimize

使用 `||`、`&&` 连接多个选择器时，快速查询为它们的并集；`!(xxx)` 会取消内部所有快速查询，但局部快速查找仍独立成立。

```text
(A + B[id='b']) || (C + D[id='d'])
```

```text
(A + B[id='b']) && (C + D[id='d'])
```

```text
(A + B[id='b']) && !(C + D[id='d'])
```

```text
(X[id='x'] <<n A + B[id='b']) && !(Y[id='y'] <<n C + D[id='d'])
```

--------------------------------

### 属性选择器示例：@TextView[a=1][b^='2'][c*='a'||d.length>7&&e=false][!(f=true)][g.plus(1)>0]

Source: https://gkd.li/guide/selector

展示属性选择器的完整语法，包括逻辑表达式、布尔表达式和取反表达式。

```text
@TextView[a=1][b^='2'][c*='a'||d.length>7&&e=false][!(f=true)][g.plus(1)>0]
```

--------------------------------

### 逻辑表达式优先级示例：a>1||b>1&&c>1||d>1

Source: https://gkd.li/guide/selector

展示 && 优先级高于 || 的示例。

```text
[a>1||b>1&&c>1||d>1]
```

```text
[a>1||(b>1&&c>1)||d>1]
```

--------------------------------

### 调用表达式示例：a.b(c,d).e(f).g(1,2,true)

Source: https://gkd.li/guide/selector

展示合法的调用表达式示例。

```text
a.b(c,d).e(f).g(1,2,true)
```

--------------------------------

### 错误的分享链接示例

Source: https://gkd.li/guide/snapshot

地址栏复制的链接只能在当前用户浏览器上打开，其他设备打开会显示“快照缺失”。

```text
https://i.gkd.li/snapshot/1734099604908
```

--------------------------------

### 主动查询优化示例

Source: https://gkd.li/guide/optimize

当选择器右侧标明从根节点查找（如 `[parent=null]`）时，可省略深度优先遍历，只进行一次判断。但使用 `<<n` 时内部子判断仍为 n 次，优化无效。

```text
LinearLayout > TextView
```

```text
TextView <3 LinearLayout <2 [parent=null]
```

```text
TextView <<n [parent=null]
```

```text
A > B
```

```text
A > @B <<n [parent=null]
```

--------------------------------

### 字面量示例：null, false, 114514, 'ikun'

Source: https://gkd.li/guide/selector

展示四种字面量类型的示例。

```text
null
```

```text
false
```

```text
114514
```

```text
'ikun'
```
Tokens:
Raw