@gkd-kit/docs 0.0.1721398242559 → 0.0.1721407959802

package/.vitepress/dist/assets/selector_example.md._hQerSjN.lean.js

@@ -1 +0,0 @@
-import{_ as e,c as a,o as t,a8 as r}from"./chunks/framework.DAuRlsJR.js";const u=JSON.parse('{"title":"选择示例","description":"","frontmatter":{},"headers":[],"relativePath":"selector/example.md","filePath":"selector/example.md","lastUpdated":1721398220000}'),o={name:"selector/example.md"},l=r("",7),i=[l];function c(d,n,s,_,h,p){return t(),a("div",null,i)}const f=e(o,[["render",c]]);export{u as __pageData,f as default};

package/.vitepress/dist/assets/selector_optimize.md.BnHmHuNq.js

@@ -1 +0,0 @@
-import{_ as t,c,o as d,a8 as o,j as e,a as i}from"./chunks/framework.DAuRlsJR.js";const q=JSON.parse('{"title":"查询优化","description":"","frontmatter":{},"headers":[],"relativePath":"selector/optimize.md","filePath":"selector/optimize.md","lastUpdated":1721398220000}'),l={name:"selector/optimize.md"},a=o('<h1 id="title" tabindex="-1">查询优化 <a class="header-anchor" href="#title" aria-label="Permalink to &quot;查询优化 {#title}&quot;">​</a></h1><p>一些关于查询优化的说明</p><h2 id="query-root" tabindex="-1">查找根节点 <a class="header-anchor" href="#query-root" aria-label="Permalink to &quot;查找根节点 {#query-root}&quot;">​</a></h2><p>选择器通过满足下列格式的属性选择器标识根节点</p><ul><li><code>[parent=null]</code></li><li><code>A[id=&#39;xxx&#39;][parent=null][text=&#39;xxx&#39;]</code></li></ul><p>即只需存在一个 <code>[parent=null]</code> 就满足条件, 以下是对此的优化</p><h3 id="enforce" tabindex="-1">主动查询 <a class="header-anchor" href="#enforce" aria-label="Permalink to &quot;主动查询 {#enforce}&quot;">​</a></h3><p>一般的选择器如 <code>LinearLayout &gt; TextView</code>, 选择器需要从 根节点/事件节点 使用深度先序顺序遍历子孙节点并判断是否满足条件</p><p>如果屏幕上有 n 个节点, 判断逻辑需要运行 n 次</p><p>但是如果选择器是类似 <code>TextView &lt;3 LinearLayout &lt;2 [parent=null]</code>, 由于在右侧标明了从根节点查找</p><p>因此上面的 <code>深度先序顺序遍历子孙节点</code> 将省略, 只进行一次判断, 不需要判断 n 次</p><p>但是如果你在子查询里使用 <code>&lt;&lt;n</code>, 例如 <code>TextView &lt;&lt;n [parent=null]</code></p><p>根据上面说明的优化, 虽然也只有一次判断, 但是由于 <code>&lt;&lt;n</code> 导致内部的子判断也是 n 次, 实际上没有优化判断次数</p><div class="tip custom-block github-alert"><p class="custom-block-title">提示</p><p>实际上从根节点开始匹配的选择器如 <code>A &gt; B</code> 都可等价为 <code>A &gt; @B &lt;&lt;n [parent=null]</code></p></div><h3 id="ancestor" tabindex="-1">祖先节点 <a class="header-anchor" href="#ancestor" aria-label="Permalink to &quot;祖先节点 {#ancestor}&quot;">​</a></h3><p>在示例 <code>A &lt;3 [parent=null] &gt;n TextView</code> 中, 选择器找到 <code>TextView</code> 后, 根据 <code>&gt;n</code> 表示任意祖先节点</p><p>在默认情况下, 如果 <code>TextView</code> 的层级很深, 那必然需要多次调用 获取父节点 才能最终匹配</p><p>但是如果左侧的选择器是 <code>[parent=null] &gt;n</code>, 这表示找到根节点, 选择器此时不会去执行多次调用 获取父节点</p><p>在 GKD 内部, 根节点可以直接通过 API 获取, 因此 <code>[parent=null] &gt;n</code> 只需要调用一次方法</p><h2 id="fast-query" tabindex="-1">快速查询 <a class="header-anchor" href="#fast-query" aria-label="Permalink to &quot;快速查询 {#fast-query}&quot;">​</a></h2><div class="note custom-block github-alert"><p class="custom-block-title">注意</p><p>此优化需要设置 <a href="/api/interfaces/RawCommonProps#fastquery">fastQuery</a> 来启用</p></div><h3 id="query-scene" tabindex="-1">查询场景 <a class="header-anchor" href="#query-scene" aria-label="Permalink to &quot;查询场景 {#query-scene}&quot;">​</a></h3><p>一般情况下, 选择器 <code>[vid=&quot;name&quot;]</code> 需要从 根节点/事件节点 使用深度先序顺序遍历子孙节点并判断是否满足条件</p><p>但是 Android 提供了如下两个快速获取节点的 Api</p><ul><li><a href="https://developer.android.google.cn/reference/android/view/accessibility/AccessibilityNodeInfo#findAccessibilityNodeInfosByViewId(java.lang.String)" target="_blank" rel="noreferrer">findAccessibilityNodeInfosByViewId</a></li><li><a href="https://developer.android.google.cn/reference/android/view/accessibility/AccessibilityNodeInfo#findAccessibilityNodeInfosByText(java.lang.String)" target="_blank" rel="noreferrer">findAccessibilityNodeInfosByText</a></li></ul><p>这使得可以通过 <code>id</code>/<code>vid</code>/<code>text</code> 直接获取子孙节点</p><p>对此我们需要规定符合特定条件的选择器来调用这些 Api 从而跳过手动遍历子孙节点</p><h3 id="rule-format" tabindex="-1">规定格式 <a class="header-anchor" href="#rule-format" aria-label="Permalink to &quot;规定格式 {#rule-format}&quot;">​</a></h3><p>所有 <code>末尾属性选择器</code>的<code>第一个属性选择表达式</code>符合下面的结构之一</p><ul><li><code>[id=&#39;abc&#39;]</code></li><li><code>[vid=&#39;abc&#39;]</code></li><li><code>[text=&#39;abc&#39;]</code></li><li><code>[text^=&#39;abc&#39;]</code></li><li><code>[text*=&#39;abc&#39;]</code></li><li><code>[text$=&#39;abc&#39;]</code></li></ul><p>或者使用 <code>||</code> 将它们连接形成的逻辑表达式也符合条件, 即如下格式</p><ul><li><code>[id=&#39;abc&#39; || id=&#39;abc2&#39;]</code></li><li><code>[id=&#39;abc&#39; || vid=&#39;abc&#39; || text=&#39;abc&#39; || text^=&#39;abc&#39; || text*=&#39;abc&#39; || text$=&#39;abc&#39;]</code></li></ul><p>这些规定的格式都是为了提取 <code>id</code>/<code>vid</code>/<code>text</code> 来调用上面的两个 Android Api</p><p>下面给出实际示例: ✅ 表示符合格式, ❎ 表示不符合格式</p><ul><li><code>A &gt; B + C[id=&#39;x&#39;][childCount=2]</code> ✅</li><li><code>A &gt; B + C[childCount=2][id=&#39;x&#39;]</code> ❎</li><li><code>A &gt; B + C[id=&#39;x&#39; || text=&#39;manbaout&#39; || text*=&#39;ikun&#39;][childCount=2]</code> ✅</li><li><code>A &gt; B + C[childCount=2][id=&#39;x&#39; || text=&#39;manbaout&#39; || text*=&#39;ikun&#39;]</code> ❎</li></ul><p>这样一个选择器只能在右侧使用快速查询, 为了在中间的子选择器也能使用</p><p>额外规定如果属性选择器如果符合上面格式并且右侧是 <code>&lt;&lt;n</code>, 也能在局部使用快速查找</p><p>示例 <code>A &gt; B + C[id=&#39;x&#39;][childCount=2] &lt;&lt;n D</code> 中的 <code>C[id=&#39;x&#39;][childCount=2] &lt;&lt;n</code> 可以使用局部快速查找</p><p>下面给出满足局部查询优化的示例: ✅ 表示符合格式, ❎ 表示不符合格式</p><ul><li><code>A &gt; B + C[id=&#39;x&#39;][childCount=2] &lt;&lt;n D</code> ✅</li><li><code>A &gt; B + C[childCount=2][id=&#39;x&#39;] &lt;&lt;n D</code> ❎</li></ul><p>上面介绍的是只有一个局部选择器的情况, 下面给出多个局部快速查找的的示例</p><p>如 <code>A &gt; C[id=&#39;x&#39;] &lt;&lt;n D[id=&#39;y&#39;] &lt;&lt;n E</code>, 其中的 <code>C[id=&#39;x&#39;] &lt;&lt;n</code> 和 <code>D[id=&#39;y&#39;] &lt;&lt;n</code> 都可以使用局部快速查找</p><div class="note custom-block github-alert"><p class="custom-block-title">注意</p><p>如果选择器不存在满足快速查找的格式, fastQuery 是否开启都不影响查询复杂度</p></div>',43),n=e("h3",{"optimize-example":"",id:"优化示例",tabindex:"-1"},[i("优化示例 "),e("a",{class:"header-anchor",href:"#优化示例","aria-label":'Permalink to "优化示例 {optimize-example}"'},"​")],-1),r=o('<p>以 <a href="https://i.gkd.li/i/16201605?gkd=W3ZpZD0iaW1hZ2UiXSA8PG4gW3ZpZD0icmVjeWNsZXJWaWV3Il0gPDxuIFt2aWQ9ImNvbnRlbnRfbGF5b3V0Il0" target="_blank" rel="noreferrer"><code>[vid=&quot;image&quot;] &lt;&lt;n [vid=&quot;recyclerView&quot;] &lt;&lt;n [vid=&quot;content_layout&quot;]</code></a> 为例</p><p>上面的选择器存在 3 个快速查找优化</p><ul><li><code>[vid=&quot;content_layout&quot;]</code> 从 根节点 优化查询找到 <code>content_layout</code></li><li><code>[vid=&quot;recyclerView&quot;]</code> 从 <code>content_layout</code> 优化查询找到 <code>recyclerView</code></li><li><code>[vid=&quot;image&quot;]</code> 从 <code>recyclerView</code> 优化查询找到 <code>image</code></li></ul><p>也就是只需要调用 <code>findAccessibilityNodeInfosByViewId</code> 3 次即可得到目标节点</p><p>如果是从根节点开始查询, 根据快照内的 选择器路径视图</p><ul><li><code>[vid=&quot;content_layout&quot;]</code> 从 根节点 需要 7 次找到 <code>content_layout</code></li><li><code>[vid=&quot;recyclerView&quot;]</code> 从 <code>content_layout</code> 需要 48 次找到 <code>recyclerView</code></li><li><code>[vid=&quot;image&quot;]</code> 从 <code>recyclerView</code> 需要 44 次找到 <code>image</code></li></ul>',6),p=[a,n,r];function u(s,h,b,x,_,f){return d(),c("div",null,p)}const y=t(l,[["render",u]]);export{q as __pageData,y as default};

package/.vitepress/dist/assets/selector_optimize.md.BnHmHuNq.lean.js

@@ -1 +0,0 @@
-import{_ as t,c,o as d,a8 as o,j as e,a as i}from"./chunks/framework.DAuRlsJR.js";const q=JSON.parse('{"title":"查询优化","description":"","frontmatter":{},"headers":[],"relativePath":"selector/optimize.md","filePath":"selector/optimize.md","lastUpdated":1721398220000}'),l={name:"selector/optimize.md"},a=o("",43),n=e("h3",{"optimize-example":"",id:"优化示例",tabindex:"-1"},[i("优化示例 "),e("a",{class:"header-anchor",href:"#优化示例","aria-label":'Permalink to "优化示例 {optimize-example}"'},"​")],-1),r=o("",6),p=[a,n,r];function u(s,h,b,x,_,f){return d(),c("div",null,p)}const y=t(l,[["render",u]]);export{q as __pageData,y as default};