<?xml version="1.0" encoding="utf-8"?><feed xmlns="http://www.w3.org/2005/Atom" ><generator uri="https://jekyllrb.com/" version="4.3.2">Jekyll</generator><link href="https://www.yfmingo.cn/feed.xml" rel="self" type="application/atom+xml" /><link href="https://www.yfmingo.cn/" rel="alternate" type="text/html" /><updated>2026-11-02T03:21:36+00:00</updated><id>https://www.yfmingo.cn/feed.xml</id><title type="html">袁凤鸣的博客 | Fleeming’s Blog</title><subtitle>前端开发与设计 | 袁凤鸣，Web &amp; Mobile Lover，Front-End Engineer | 这里是 @Fleeming袁凤鸣 的个人博客，与你一起发现更大的世界。</subtitle><entry><title type="html">Flutter 混编场景下 flutter_screenutil 踩坑与架构防坑实战指南</title><link href="https://www.yfmingo.cn/2026/10/29/flutter-screenutil-hybrid-pitfalls-guide/" rel="alternate" type="text/html" title="Flutter 混编场景下 flutter_screenutil 踩坑与架构防坑实战指南" /><published>2026-10-29T00:00:00+00:00</published><updated>2026-10-29T00:00:00+00:00</updated><id>https://www.yfmingo.cn/2026/10/29/flutter-screenutil-hybrid-pitfalls-guide</id><content type="html" xml:base="https://www.yfmingo.cn/2026/10/29/flutter-screenutil-hybrid-pitfalls-guide/"><![CDATA[<ul id="markdown-toc">
  <li><a href="#一-问题背景与混编特质" id="markdown-toc-一-问题背景与混编特质">一、 问题背景与混编特质</a></li>
  <li><a href="#二-核心坑点复盘与源码深度剖析" id="markdown-toc-二-核心坑点复盘与源码深度剖析">二、 核心坑点复盘与源码深度剖析</a>    <ul>
      <li><a href="#坑点一ensurescreensize-混编后台预热死锁导致全屏黑屏" id="markdown-toc-坑点一ensurescreensize-混编后台预热死锁导致全屏黑屏">坑点一：<code class="language-plaintext highlighter-rouge">ensureScreenSize()</code> 混编后台预热死锁导致全屏黑屏</a></li>
      <li><a href="#坑点二rebuildfactor-盲信-native-首帧-0x0-脏尺寸全局单例被洗劫" id="markdown-toc-坑点二rebuildfactor-盲信-native-首帧-0x0-脏尺寸全局单例被洗劫">坑点二：<code class="language-plaintext highlighter-rouge">rebuildFactor</code> 盲信 Native 首帧 <code class="language-plaintext highlighter-rouge">0x0</code> 脏尺寸，全局单例被洗劫</a></li>
      <li><a href="#坑点三screenutilinitinitstate-把外部守卫冲刷为-null" id="markdown-toc-坑点三screenutilinitinitstate-把外部守卫冲刷为-null">坑点三：<code class="language-plaintext highlighter-rouge">ScreenUtilInit.initState()</code> 把外部守卫冲刷为 <code class="language-plaintext highlighter-rouge">null</code></a></li>
      <li><a href="#坑点四业务层字段级初始化field-initializer的死锁陷阱" id="markdown-toc-坑点四业务层字段级初始化field-initializer的死锁陷阱">坑点四：业务层“字段级初始化（Field Initializer）”的死锁陷阱</a></li>
      <li><a href="#坑点五tabbar-契约违背与极限紧约束裁剪" id="markdown-toc-坑点五tabbar-契约违背与极限紧约束裁剪">坑点五：TabBar 契约违背与极限紧约束裁剪</a></li>
      <li><a href="#坑点六被废弃的-useinheritedmediaquery-传闻" id="markdown-toc-坑点六被废弃的-useinheritedmediaquery-传闻">坑点六：被废弃的 <code class="language-plaintext highlighter-rouge">useInheritedMediaQuery</code> 传闻</a></li>
    </ul>
  </li>
  <li><a href="#三-框架层彻底根治方案-零侵入业务代码" id="markdown-toc-三-框架层彻底根治方案-零侵入业务代码">三、 框架层彻底根治方案 (零侵入业务代码)</a>    <ul>
      <li><a href="#完整实现代码-maindart" id="markdown-toc-完整实现代码-maindart">完整实现代码 (<code class="language-plaintext highlighter-rouge">main.dart</code>)</a></li>
    </ul>
  </li>
  <li><a href="#四-运行机制全生命周期对照" id="markdown-toc-四-运行机制全生命周期对照">四、 运行机制全生命周期对照</a></li>
  <li><a href="#五-业务层研发防护黄金准则" id="markdown-toc-五-业务层研发防护黄金准则">五、 业务层研发防护黄金准则</a></li>
  <li><a href="#六-总结" id="markdown-toc-六-总结">六、 总结</a></li>
</ul>
<hr />

<blockquote>
  <p><strong>文档信息</strong></p>
  <ul>
    <li><strong>作者</strong>：袁凤鸣</li>
    <li><strong>日期</strong>：2026-10-29</li>
    <li><strong>适用环境</strong>：Flutter 3.x / FlutterBoost 混编架构 / Android &amp; iOS 混合栈</li>
    <li><strong>核心组件</strong>：<code class="language-plaintext highlighter-rouge">flutter_screenutil</code> (v5.9.x)</li>
  </ul>
</blockquote>

<hr />

<h2 id="一-问题背景与混编特质">一、 问题背景与混编特质</h2>

<p>在纯 Flutter 独立应用中，<code class="language-plaintext highlighter-rouge">flutter_screenutil</code> 是业界最普及的屏幕适配插件，通常仅需在入口包裹 <code class="language-plaintext highlighter-rouge">ScreenUtilInit</code>，即可无感使用 <code class="language-plaintext highlighter-rouge">.w</code>、<code class="language-plaintext highlighter-rouge">.h</code>、<code class="language-plaintext highlighter-rouge">.r</code>、<code class="language-plaintext highlighter-rouge">.sp</code> 完成自适应布局。</p>

<p>然而，在大型商业工程由原生（Android / iOS）为主体、Flutter 作为混合栈运行（例如基于 <strong>FlutterBoost</strong> 等单引擎多容器架构）的复杂场景下，频繁暴露出极其隐蔽且难以稳定复现的线上偶发 Bug：</p>
<ul>
  <li><strong>原生跳转进入 Flutter 页面瞬间，Tab 标题或某些文本完全消失，仅绘制出下划线指示器</strong>；</li>
  <li><strong>偶发性整页所有文字和间距缩小为 0</strong>；</li>
  <li><strong>盲目尝试 <code class="language-plaintext highlighter-rouge">await ScreenUtil.ensureScreenSize()</code> 导致 Flutter 引擎彻底卡死、整机黑屏</strong>。</li>
</ul>

<p>本文基于真实的生产级排查过程与 <code class="language-plaintext highlighter-rouge">flutter_screenutil 5.9.3</code> 底层源码，逐层剥离时序与生命周期脱节的底层真相，并给出框架层<strong>零侵入、不改动任何业务页面</strong>的终极治理方案。</p>

<hr />

<h2 id="二-核心坑点复盘与源码深度剖析">二、 核心坑点复盘与源码深度剖析</h2>

<h3 id="坑点一ensurescreensize-混编后台预热死锁导致全屏黑屏">坑点一：<code class="language-plaintext highlighter-rouge">ensureScreenSize()</code> 混编后台预热死锁导致全屏黑屏</h3>

<p>很多开发者在查阅文档后，尝试在 <code class="language-plaintext highlighter-rouge">main()</code> 函数中加入官方推荐的预热代码：</p>
<div class="language-dart highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="c1">// ❌ 混编致命陷阱</span>
<span class="kt">void</span> <span class="nf">main</span><span class="p">()</span> <span class="kd">async</span> <span class="p">{</span>
  <span class="n">WidgetsFlutterBinding</span><span class="o">.</span><span class="na">ensureInitialized</span><span class="p">();</span>
  <span class="k">await</span> <span class="n">ScreenUtil</span><span class="o">.</span><span class="na">ensureScreenSize</span><span class="p">();</span>
  <span class="n">runApp</span><span class="p">(</span><span class="kd">const</span> <span class="n">MyApp</span><span class="p">());</span>
<span class="p">}</span>
</code></pre></div></div>
<p><strong>现象</strong>：在原生混编项目中加上这行代码后，点击任何入口打开 Flutter 页面，<strong>全屏漆黑、彻底挂死，没有任何 Dart 日志输出</strong>！</p>

<p><strong>源码追踪 (<code class="language-plaintext highlighter-rouge">screen_util.dart</code>)</strong>：</p>
<div class="language-dart highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="kd">static</span> <span class="n">Future</span><span class="p">&lt;</span><span class="kt">void</span><span class="p">&gt;</span> <span class="n">ensureScreenSize</span><span class="p">([</span>
  <span class="n">ui</span><span class="o">.</span><span class="na">FlutterView</span><span class="o">?</span> <span class="n">window</span><span class="p">,</span>
  <span class="n">Duration</span> <span class="n">duration</span> <span class="o">=</span> <span class="kd">const</span> <span class="n">Duration</span><span class="p">(</span><span class="nl">milliseconds:</span> <span class="mi">10</span><span class="p">),</span>
<span class="p">])</span> <span class="kd">async</span> <span class="p">{</span>
  <span class="kd">final</span> <span class="n">binding</span> <span class="o">=</span> <span class="n">WidgetsFlutterBinding</span><span class="o">.</span><span class="na">ensureInitialized</span><span class="p">();</span>
  <span class="n">binding</span><span class="o">.</span><span class="na">deferFirstFrame</span><span class="p">();</span> <span class="c1">// 🔴 致命点 1：通知引擎挂起首帧，不允许渲染任何内容</span>

  <span class="k">await</span> <span class="n">Future</span><span class="o">.</span><span class="na">doWhile</span><span class="p">(()</span> <span class="p">{</span>
    <span class="k">if</span> <span class="p">(</span><span class="n">window</span> <span class="o">==</span> <span class="kc">null</span><span class="p">)</span> <span class="p">{</span>
      <span class="n">window</span> <span class="o">=</span> <span class="n">binding</span><span class="o">.</span><span class="na">platformDispatcher</span><span class="o">.</span><span class="na">implicitView</span><span class="p">;</span>
    <span class="p">}</span>
    <span class="c1">// 🔴 致命点 2：若 View 为空或尺寸为空，每隔 10ms 循环一次</span>
    <span class="k">if</span> <span class="p">(</span><span class="n">window</span> <span class="o">==</span> <span class="kc">null</span> <span class="o">||</span> <span class="n">window</span><span class="o">!.</span><span class="na">physicalSize</span><span class="o">.</span><span class="na">isEmpty</span><span class="p">)</span> <span class="p">{</span>
      <span class="k">return</span> <span class="n">Future</span><span class="o">.</span><span class="na">delayed</span><span class="p">(</span><span class="n">duration</span><span class="p">,</span> <span class="p">()</span> <span class="o">=</span><span class="p">&gt;</span> <span class="kc">true</span><span class="p">);</span>
    <span class="p">}</span>
    <span class="k">return</span> <span class="kc">false</span><span class="p">;</span>
  <span class="p">});</span>

  <span class="n">binding</span><span class="o">.</span><span class="na">allowFirstFrame</span><span class="p">();</span> <span class="c1">// 🔴 永远走不到这里</span>
<span class="p">}</span>
</code></pre></div></div>
<ul>
  <li><strong>混编机制剖析</strong>：FlutterBoost 等混编框架在原生 <code class="language-plaintext highlighter-rouge">Application.onCreate</code> 时就会在后台预热 Flutter 引擎并执行 <code class="language-plaintext highlighter-rouge">main()</code>。<strong>此时原生端尚未打开任何 <code class="language-plaintext highlighter-rouge">Activity</code> 或 <code class="language-plaintext highlighter-rouge">FlutterView</code></strong>，底层的 <code class="language-plaintext highlighter-rouge">implicitView</code> 为空或物理尺寸为 <code class="language-plaintext highlighter-rouge">Size.zero</code>。</li>
  <li><code class="language-plaintext highlighter-rouge">Future.doWhile</code> 在 <code class="language-plaintext highlighter-rouge">main()</code> 中陷入无休止死循环，且首帧被 <code class="language-plaintext highlighter-rouge">deferFirstFrame()</code> 挂起，导致 <code class="language-plaintext highlighter-rouge">runApp()</code> 永远无法被执行，引擎在启动第一微秒即被冻结死锁。</li>
</ul>

<hr />

<h3 id="坑点二rebuildfactor-盲信-native-首帧-0x0-脏尺寸全局单例被洗劫">坑点二：<code class="language-plaintext highlighter-rouge">rebuildFactor</code> 盲信 Native 首帧 <code class="language-plaintext highlighter-rouge">0x0</code> 脏尺寸，全局单例被洗劫</h3>

<p>即使避免了 <code class="language-plaintext highlighter-rouge">ensureScreenSize()</code>，在 <code class="language-plaintext highlighter-rouge">main()</code> 里通过 <code class="language-plaintext highlighter-rouge">ScreenUtil.configure</code> 预设了兜底尺寸，从原生跳转到 Flutter 时依然会偶发字号归零。</p>

<p><strong>源码追踪 (<code class="language-plaintext highlighter-rouge">screenutil_init.dart</code>)</strong>：</p>
<div class="language-dart highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="kt">void</span> <span class="nf">_revalidate</span><span class="p">([</span><span class="kt">void</span> <span class="kt">Function</span><span class="p">()</span><span class="o">?</span> <span class="n">callback</span><span class="p">])</span> <span class="p">{</span>
  <span class="kd">final</span> <span class="n">oldData</span> <span class="o">=</span> <span class="n">_mediaQueryData</span><span class="p">;</span>
  <span class="kd">final</span> <span class="n">newData</span> <span class="o">=</span> <span class="n">_newData</span><span class="p">();</span>
  <span class="k">if</span> <span class="p">(</span><span class="n">newData</span> <span class="o">==</span> <span class="kc">null</span><span class="p">)</span> <span class="k">return</span><span class="p">;</span>

  <span class="c1">// 🔴 致命点：默认的 rebuildFactor 仅仅比较 oldData.size != newData.size</span>
  <span class="k">if</span> <span class="p">(</span><span class="n">oldData</span> <span class="o">==</span> <span class="kc">null</span> <span class="o">||</span> <span class="n">widget</span><span class="o">.</span><span class="na">rebuildFactor</span><span class="p">(</span><span class="n">oldData</span><span class="p">,</span> <span class="n">newData</span><span class="p">))</span> <span class="p">{</span>
    <span class="n">setState</span><span class="p">(()</span> <span class="p">{</span>
      <span class="n">_mediaQueryData</span> <span class="o">=</span> <span class="n">newData</span><span class="p">;</span> <span class="c1">// 接收了 newData</span>
      <span class="n">_updateTree</span><span class="p">(</span><span class="n">context</span> <span class="k">as</span> <span class="n">Element</span><span class="p">);</span>
      <span class="n">callback</span><span class="o">?.</span><span class="na">call</span><span class="p">();</span>
    <span class="p">});</span>
  <span class="p">}</span>
<span class="p">}</span>
</code></pre></div></div>
<ul>
  <li><strong>时序断层</strong>：当原生 <code class="language-plaintext highlighter-rouge">BoostFlutterActivity</code> 被拉起瞬间，Android Surface 尚未完成 layout，向 Flutter 派发了首个 Metrics 变更事件，此时获取到的 <code class="language-plaintext highlighter-rouge">newData.size</code> 是 <strong><code class="language-plaintext highlighter-rouge">Size(0, 0)</code></strong>！</li>
  <li>默认的 <code class="language-plaintext highlighter-rouge">rebuildFactor</code> 发现 <code class="language-plaintext highlighter-rouge">old(375x812) != new(0x0)</code> 为 <code class="language-plaintext highlighter-rouge">true</code>，<strong>直接将 <code class="language-plaintext highlighter-rouge">0x0</code> 脏尺寸存入 <code class="language-plaintext highlighter-rouge">_mediaQueryData</code></strong>！</li>
  <li>紧接着 <code class="language-plaintext highlighter-rouge">ScreenUtilInit.build()</code> 被触发，调用 <code class="language-plaintext highlighter-rouge">ScreenUtil.configure(data: Size(0, 0))</code>，<strong>开发者在启动期设置的所有保底尺寸瞬间被强行洗劫覆盖为 0</strong>！</li>
</ul>

<hr />

<h3 id="坑点三screenutilinitinitstate-把外部守卫冲刷为-null">坑点三：<code class="language-plaintext highlighter-rouge">ScreenUtilInit.initState()</code> 把外部守卫冲刷为 <code class="language-plaintext highlighter-rouge">null</code></h3>

<p>部分开发者尝试在 <code class="language-plaintext highlighter-rouge">main()</code> 里使用 <code class="language-plaintext highlighter-rouge">ScreenUtil.enableScale</code> 进行熔断防护：</p>
<div class="language-dart highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="n">ScreenUtil</span><span class="o">.</span><span class="na">enableScale</span><span class="p">(</span>
  <span class="nl">enableWH:</span> <span class="p">()</span> <span class="o">=</span><span class="p">&gt;</span> <span class="n">ScreenUtil</span><span class="p">()</span><span class="o">.</span><span class="na">screenWidth</span> <span class="p">&gt;</span> <span class="mi">0</span><span class="p">,</span>
  <span class="nl">enableText:</span> <span class="p">()</span> <span class="o">=</span><span class="p">&gt;</span> <span class="n">ScreenUtil</span><span class="p">()</span><span class="o">.</span><span class="na">screenWidth</span> <span class="p">&gt;</span> <span class="mi">0</span><span class="p">,</span>
<span class="p">);</span>
</code></pre></div></div>
<p>但很快发现该守卫完全未生效。</p>

<p><strong>源码追踪 (<code class="language-plaintext highlighter-rouge">screenutil_init.dart</code>)</strong>：</p>
<div class="language-dart highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nd">@override</span>
<span class="kt">void</span> <span class="nf">initState</span><span class="p">()</span> <span class="p">{</span>
  <span class="p">...</span>
  <span class="c1">// 🔴 致命点：ScreenUtilInit 初始化时直接将 widget.enableScaleWH 写入单例</span>
  <span class="n">ScreenUtil</span><span class="o">.</span><span class="na">enableScale</span><span class="p">(</span><span class="nl">enableWH:</span> <span class="n">widget</span><span class="o">.</span><span class="na">enableScaleWH</span><span class="p">,</span> <span class="nl">enableText:</span> <span class="n">widget</span><span class="o">.</span><span class="na">enableScaleText</span><span class="p">);</span>
  <span class="p">...</span>
<span class="p">}</span>
</code></pre></div></div>
<ul>
  <li>如果未在 <code class="language-plaintext highlighter-rouge">ScreenUtilInit</code> 的构造入参中显式传递 <code class="language-plaintext highlighter-rouge">enableScaleWH</code> / <code class="language-plaintext highlighter-rouge">enableScaleText</code>，默认入参为 <code class="language-plaintext highlighter-rouge">null</code>。</li>
  <li>当 <code class="language-plaintext highlighter-rouge">ScreenUtilInit</code> 挂载执行 <code class="language-plaintext highlighter-rouge">initState()</code> 时，<strong>会直接把全局单例中的两个守卫重置回 <code class="language-plaintext highlighter-rouge">() =&gt; true</code>（默认始终允许缩放）</strong>，使外部在 <code class="language-plaintext highlighter-rouge">main()</code> 写的任何防护被彻底清空。</li>
</ul>

<hr />

<h3 id="坑点四业务层字段级初始化field-initializer的死锁陷阱">坑点四：业务层“字段级初始化（Field Initializer）”的死锁陷阱</h3>

<p>在实际业务代码中，常常存在如下习惯写法：</p>
<div class="language-dart highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="kd">class</span> <span class="nc">_MyPageState</span> <span class="kd">extends</span> <span class="n">State</span><span class="p">&lt;</span><span class="n">MyPage</span><span class="p">&gt;</span> <span class="p">{</span>
  <span class="c1">// ❌ 致命隐患：State 的实例属性字段求值</span>
  <span class="kd">final</span> <span class="n">_tabs</span> <span class="o">=</span> <span class="p">[</span>
    <span class="n">Text</span><span class="p">(</span><span class="s">'我接的订单'</span><span class="p">,</span> <span class="nl">style:</span> <span class="n">TextStyle</span><span class="p">(</span><span class="nl">fontSize:</span> <span class="mi">14</span><span class="o">.</span><span class="na">sp</span><span class="p">)),</span>
    <span class="n">Text</span><span class="p">(</span><span class="s">'我发的订单'</span><span class="p">,</span> <span class="nl">style:</span> <span class="n">TextStyle</span><span class="p">(</span><span class="nl">fontSize:</span> <span class="mi">14</span><span class="o">.</span><span class="na">sp</span><span class="p">)),</span>
  <span class="p">];</span>

  <span class="nd">@override</span>
  <span class="n">Widget</span> <span class="n">build</span><span class="p">(</span><span class="n">BuildContext</span> <span class="n">context</span><span class="p">)</span> <span class="p">{</span>
    <span class="k">return</span> <span class="n">TabBar</span><span class="p">(</span><span class="nl">tabs:</span> <span class="n">_tabs</span><span class="p">);</span>
  <span class="p">}</span>
<span class="p">}</span>
</code></pre></div></div>
<ul>
  <li><strong>生命周期脱节</strong>：<code class="language-plaintext highlighter-rouge">final _tabs = [...]</code> 是 Dart 类的字段声明（Field Initializer），在 State 类的构造函数被调用时立即求值，此时当前页面尚未挂载进 Element 树。</li>
  <li><strong>不可恢复性</strong>：若恰好遇到 Native Activity 启动瞬间尺寸为 0 的毫秒级窗口，<code class="language-plaintext highlighter-rouge">14.sp</code> 算出 <code class="language-plaintext highlighter-rouge">0</code>，<code class="language-plaintext highlighter-rouge">_tabs</code> 作为一个 <code class="language-plaintext highlighter-rouge">final</code> 对象将<strong>永久固化持有字号为 0 的 Text 实例</strong>！后续即便屏幕尺寸正常测量并触发 <code class="language-plaintext highlighter-rouge">setState()</code> 重建，由于 <code class="language-plaintext highlighter-rouge">_tabs</code> 未被重新计算，文字依然永远不可见！</li>
</ul>

<hr />

<h3 id="坑点五tabbar-契约违背与极限紧约束裁剪">坑点五：TabBar 契约违背与极限紧约束裁剪</h3>

<p>很多开发者以为文字不见是纯粹的缩放 Bug，但排查发现有时字号正常，文字却依然看不见：</p>
<ul>
  <li>在 <code class="language-plaintext highlighter-rouge">AppTabBar</code> 外层强行套了 <code class="language-plaintext highlighter-rouge">SizedBox(height: 22.r)</code>；</li>
  <li><code class="language-plaintext highlighter-rouge">TabBar(tabs: ...)</code> 中直接传入纯 <code class="language-plaintext highlighter-rouge">Text</code>，而非标准的 <code class="language-plaintext highlighter-rouge">Tab(text: ...)</code>。</li>
  <li><strong>源码规范</strong>：Flutter 官方契约要求 TabBar 的子项必须是 <code class="language-plaintext highlighter-rouge">Tab</code> 或具备显式高度的 <code class="language-plaintext highlighter-rouge">PreferredSizeWidget</code>。<code class="language-plaintext highlighter-rouge">Tab</code> 内部自带 <code class="language-plaintext highlighter-rouge">Center(heightFactor: 1.0, child: label)</code> 垂直居中容器。</li>
  <li>纯 <code class="language-plaintext highlighter-rouge">Text</code> 缺少居中保护，在 <code class="language-plaintext highlighter-rouge">22.r</code> 极限紧约束与指示器高度挤压下，中文字体行高被 <code class="language-plaintext highlighter-rouge">TabBar</code> 物理视口直接裁剪抛弃，只留下底部下划线。</li>
</ul>

<hr />

<h3 id="坑点六被废弃的-useinheritedmediaquery-传闻">坑点六：被废弃的 <code class="language-plaintext highlighter-rouge">useInheritedMediaQuery</code> 传闻</h3>

<p>很多旧博客文章建议开启 <code class="language-plaintext highlighter-rouge">useInheritedMediaQuery: true</code>。但在 <code class="language-plaintext highlighter-rouge">flutter_screenutil 5.9.x</code> 官方 <code class="language-plaintext highlighter-rouge">CHANGELOG.md</code> 中已有确凿声明：</p>
<blockquote>
  <p><code class="language-plaintext highlighter-rouge">- useInheritedMediaQuery has not effect, and will be removed in next release</code></p>
</blockquote>

<p>自 Flutter 3.7+ 官方引入多视图架构（<code class="language-plaintext highlighter-rouge">FlutterView</code> / <code class="language-plaintext highlighter-rouge">View.of(context)</code>）后，该参数已沦为空占位符，配置它无法解决任何尺寸异常问题。</p>

<hr />

<h2 id="三-框架层彻底根治方案-零侵入业务代码">三、 框架层彻底根治方案 (零侵入业务代码)</h2>

<p>为了避免去重构庞大工程里的每一个业务页面，我们应当在<strong>混编入口与 <code class="language-plaintext highlighter-rouge">ScreenUtilInit</code> 处建立全局多重防御盾牌</strong>：</p>
<ol>
  <li><strong>纯同步设计稿预设（0ms，杜绝黑屏死锁）</strong>；</li>
  <li><strong>拦截 Native 首帧 <code class="language-plaintext highlighter-rouge">0x0</code> 脏尺寸，拒绝污染全局单例</strong>；</li>
  <li><strong>注入全局安全字体解析器，当 scaleText &lt;= 0 时强制按设计尺寸 1.0 保底</strong>；</li>
  <li><strong>注入 <code class="language-plaintext highlighter-rouge">enableScaleWH / enableScaleText</code> 熔断守卫</strong>。</li>
</ol>

<h3 id="完整实现代码-maindart">完整实现代码 (<code class="language-plaintext highlighter-rouge">main.dart</code>)</h3>

<div class="language-dart highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="kn">import</span> <span class="s">'package:flutter/material.dart'</span><span class="o">;</span>
<span class="kn">import</span> <span class="s">'package:flutter_screenutil/flutter_screenutil.dart'</span><span class="o">;</span>
<span class="kn">import</span> <span class="s">'package:flutter_boost/flutter_boost.dart'</span><span class="o">;</span>

<span class="c1">// 设计稿基础尺寸（按实际业务标准设定）</span>
<span class="kd">const</span> <span class="n">Size</span> <span class="n">designSize</span> <span class="o">=</span> <span class="n">Size</span><span class="p">(</span><span class="mi">375</span><span class="p">,</span> <span class="mi">812</span><span class="p">);</span>

<span class="c1">/// 混编安全字体缩放解析器：防止首帧尺寸未就绪时 scaleText &lt;= 0 导致字号计算为 0</span>
<span class="kt">double</span> <span class="nf">_safeFontSizeResolver</span><span class="p">(</span><span class="kt">num</span> <span class="n">fontSize</span><span class="p">,</span> <span class="n">ScreenUtil</span> <span class="n">instance</span><span class="p">)</span> <span class="p">{</span>
  <span class="k">try</span> <span class="p">{</span>
    <span class="kd">final</span> <span class="n">scale</span> <span class="o">=</span> <span class="n">instance</span><span class="o">.</span><span class="na">scaleText</span><span class="p">;</span>
    <span class="k">if</span> <span class="p">(</span><span class="n">scale</span> <span class="p">&lt;</span><span class="o">=</span> <span class="mi">0</span> <span class="o">||</span> <span class="n">scale</span><span class="o">.</span><span class="na">isNaN</span><span class="p">)</span> <span class="k">return</span> <span class="n">fontSize</span><span class="o">.</span><span class="na">toDouble</span><span class="p">();</span>
    <span class="k">return</span> <span class="n">fontSize</span> <span class="o">*</span> <span class="n">scale</span><span class="p">;</span>
  <span class="p">}</span> <span class="k">catch</span> <span class="p">(</span><span class="n">_</span><span class="p">)</span> <span class="p">{</span>
    <span class="k">return</span> <span class="n">fontSize</span><span class="o">.</span><span class="na">toDouble</span><span class="p">();</span>
  <span class="p">}</span>
<span class="p">}</span>

<span class="kt">void</span> <span class="nf">main</span><span class="p">()</span> <span class="kd">async</span> <span class="p">{</span>
  <span class="n">CustomFlutterBinding</span><span class="p">();</span>
  <span class="n">WidgetsFlutterBinding</span><span class="o">.</span><span class="na">ensureInitialized</span><span class="p">();</span>

  <span class="c1">// 1. 全局单例直接注入安全解析器，杜绝任何时间点调用 .sp 返回 0</span>
  <span class="n">ScreenUtil</span><span class="p">()</span><span class="o">.</span><span class="na">fontSizeResolver</span> <span class="o">=</span> <span class="n">_safeFontSizeResolver</span><span class="p">;</span>

  <span class="c1">// 2. 混编首帧安全保底：同步预设标准设计尺寸（纯同步无 await，杜绝黑屏卡死）</span>
  <span class="n">ScreenUtil</span><span class="o">.</span><span class="na">configure</span><span class="p">(</span>
    <span class="nl">data:</span> <span class="kd">const</span> <span class="n">MediaQueryData</span><span class="p">(</span><span class="nl">size:</span> <span class="n">designSize</span><span class="p">),</span>
    <span class="nl">designSize:</span> <span class="n">designSize</span><span class="p">,</span>
    <span class="nl">minTextAdapt:</span> <span class="kc">true</span><span class="p">,</span>
    <span class="nl">splitScreenMode:</span> <span class="kc">true</span><span class="p">,</span>
    <span class="nl">fontSizeResolver:</span> <span class="n">_safeFontSizeResolver</span><span class="p">,</span>
  <span class="p">);</span>

  <span class="c1">// 3. 初始防缩放熔断</span>
  <span class="n">ScreenUtil</span><span class="o">.</span><span class="na">enableScale</span><span class="p">(</span>
    <span class="nl">enableWH:</span> <span class="p">()</span> <span class="o">=</span><span class="p">&gt;</span> <span class="n">ScreenUtil</span><span class="p">()</span><span class="o">.</span><span class="na">screenWidth</span> <span class="p">&gt;</span> <span class="mi">0</span><span class="p">,</span>
    <span class="nl">enableText:</span> <span class="p">()</span> <span class="o">=</span><span class="p">&gt;</span> <span class="n">ScreenUtil</span><span class="p">()</span><span class="o">.</span><span class="na">screenWidth</span> <span class="p">&gt;</span> <span class="mi">0</span><span class="p">,</span>
  <span class="p">);</span>

  <span class="n">runApp</span><span class="p">(</span><span class="kd">const</span> <span class="n">MyApp</span><span class="p">());</span>
<span class="p">}</span>

<span class="kd">class</span> <span class="nc">MyApp</span> <span class="kd">extends</span> <span class="n">StatefulWidget</span> <span class="p">{</span>
  <span class="kd">const</span> <span class="n">MyApp</span><span class="p">({</span><span class="k">super</span><span class="o">.</span><span class="na">key</span><span class="p">});</span>

  <span class="nd">@override</span>
  <span class="n">State</span><span class="p">&lt;</span><span class="n">MyApp</span><span class="p">&gt;</span> <span class="n">createState</span><span class="p">()</span> <span class="o">=</span><span class="p">&gt;</span> <span class="n">_MyAppState</span><span class="p">();</span>
<span class="p">}</span>

<span class="kd">class</span> <span class="nc">_MyAppState</span> <span class="kd">extends</span> <span class="n">State</span><span class="p">&lt;</span><span class="n">MyApp</span><span class="p">&gt;</span> <span class="p">{</span>
  <span class="n">Widget</span> <span class="n">appBuilder</span><span class="p">(</span><span class="n">Widget</span> <span class="n">home</span><span class="p">)</span> <span class="p">{</span>
    <span class="k">return</span> <span class="n">ScreenUtilInit</span><span class="p">(</span>
      <span class="nl">designSize:</span> <span class="n">designSize</span><span class="p">,</span>
      <span class="nl">minTextAdapt:</span> <span class="kc">true</span><span class="p">,</span>
      <span class="nl">splitScreenMode:</span> <span class="kc">true</span><span class="p">,</span>

      <span class="c1">// 4. 核心关键点：拦截原生拉起瞬间的 0x0 脏尺寸，防止全局 ScreenUtil 被重置为 0</span>
      <span class="nl">rebuildFactor:</span> <span class="p">(</span><span class="n">oldData</span><span class="p">,</span> <span class="n">newData</span><span class="p">)</span> <span class="p">{</span>
        <span class="k">if</span> <span class="p">(</span><span class="n">newData</span><span class="o">.</span><span class="na">size</span><span class="o">.</span><span class="na">isEmpty</span> <span class="o">||</span> <span class="n">newData</span><span class="o">.</span><span class="na">size</span><span class="o">.</span><span class="na">width</span> <span class="p">&lt;</span><span class="o">=</span> <span class="mi">0</span> <span class="o">||</span> <span class="n">newData</span><span class="o">.</span><span class="na">size</span><span class="o">.</span><span class="na">height</span> <span class="p">&lt;</span><span class="o">=</span> <span class="mi">0</span><span class="p">)</span> <span class="p">{</span>
          <span class="k">return</span> <span class="kc">false</span><span class="p">;</span> <span class="c1">// 拒绝 0x0 脏数据污染全局单例！</span>
        <span class="p">}</span>
        <span class="k">return</span> <span class="n">oldData</span><span class="o">.</span><span class="na">size</span> <span class="o">!=</span> <span class="n">newData</span><span class="o">.</span><span class="na">size</span><span class="p">;</span>
      <span class="p">},</span>

      <span class="c1">// 5. 传入专属熔断函数，防止 ScreenUtilInit 内部将 enableScale 重置为 null</span>
      <span class="nl">enableScaleWH:</span> <span class="p">()</span> <span class="o">=</span><span class="p">&gt;</span> <span class="n">ScreenUtil</span><span class="p">()</span><span class="o">.</span><span class="na">screenWidth</span> <span class="p">&gt;</span> <span class="mi">0</span><span class="p">,</span>
      <span class="nl">enableScaleText:</span> <span class="p">()</span> <span class="o">=</span><span class="p">&gt;</span> <span class="n">ScreenUtil</span><span class="p">()</span><span class="o">.</span><span class="na">screenWidth</span> <span class="p">&gt;</span> <span class="mi">0</span><span class="p">,</span>

      <span class="c1">// 6. 绑定安全字体解析器</span>
      <span class="nl">fontSizeResolver:</span> <span class="n">_safeFontSizeResolver</span><span class="p">,</span>

      <span class="nl">builder:</span> <span class="p">(</span><span class="n">context</span><span class="p">,</span> <span class="n">child</span><span class="p">)</span> <span class="p">{</span>
        <span class="k">return</span> <span class="n">MaterialApp</span><span class="p">(</span>
          <span class="nl">home:</span> <span class="n">home</span><span class="p">,</span>
          <span class="c1">// ... 其它全局主题与路由配置</span>
        <span class="p">);</span>
      <span class="p">},</span>
    <span class="p">);</span>
  <span class="p">}</span>

  <span class="nd">@override</span>
  <span class="n">Widget</span> <span class="n">build</span><span class="p">(</span><span class="n">BuildContext</span> <span class="n">context</span><span class="p">)</span> <span class="p">{</span>
    <span class="k">return</span> <span class="n">FlutterBoostApp</span><span class="p">(</span>
      <span class="n">_customRouteFactory</span><span class="p">,</span>
      <span class="nl">appBuilder:</span> <span class="n">appBuilder</span><span class="p">,</span>
    <span class="p">);</span>
  <span class="p">}</span>
<span class="p">}</span>
</code></pre></div></div>

<hr />

<h2 id="四-运行机制全生命周期对照">四、 运行机制全生命周期对照</h2>

<table>
  <thead>
    <tr>
      <th style="text-align: left">阶段 / 场景</th>
      <th style="text-align: left">ScreenUtil 状态</th>
      <th style="text-align: left"><code class="language-plaintext highlighter-rouge">.sp / .r / .w / .h</code> 表现</th>
      <th style="text-align: left">页面渲染状态</th>
    </tr>
  </thead>
  <tbody>
    <tr>
      <td style="text-align: left"><strong>1. 引擎后台预热阶段</strong></td>
      <td style="text-align: left">具备 <code class="language-plaintext highlighter-rouge">375x812</code> 同步保底数据</td>
      <td style="text-align: left">缩放比精确为 <code class="language-plaintext highlighter-rouge">1.0</code>（如 <code class="language-plaintext highlighter-rouge">14.sp = 14</code>），绝不为 0</td>
      <td style="text-align: left">正常启动（无 await 死锁）</td>
    </tr>
    <tr>
      <td style="text-align: left"><strong>2. 原生唤起路由与 State 实例化</strong></td>
      <td style="text-align: left">尺寸暂处于未测量间隙（0x0）</td>
      <td style="text-align: left"><code class="language-plaintext highlighter-rouge">_safeFontSizeResolver</code> 与 <code class="language-plaintext highlighter-rouge">rebuildFactor</code> 拦截生效，强制按 <code class="language-plaintext highlighter-rouge">1.0</code> 保底返回</td>
      <td style="text-align: left">文字可见，绝不归零</td>
    </tr>
    <tr>
      <td style="text-align: left"><strong>3. 原生 Activity 挂载完成</strong></td>
      <td style="text-align: left">测量到手机真实物理尺寸（如 411.4）</td>
      <td style="text-align: left"><code class="language-plaintext highlighter-rouge">rebuildFactor</code> 放行通过，更新为真实设备缩放比（<code class="language-plaintext highlighter-rouge">411.4/375 ≈ 1.097</code>）</td>
      <td style="text-align: left">页面高精度自适应渲染</td>
    </tr>
  </tbody>
</table>

<hr />

<h2 id="五-业务层研发防护黄金准则">五、 业务层研发防护黄金准则</h2>

<p>除框架层兜底外，团队内部应普及并推行以下 Flutter UI 规范：</p>

<ol>
  <li><strong>绝对禁止在 State 属性定义处（字段初始化）直接调用 <code class="language-plaintext highlighter-rouge">.sp / .r / .w / .h</code></strong>：
    <div class="language-dart highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="c1">// ❌ 错误做法：在构造函数执行前求值，只执行一次，生命周期不可逆</span>
<span class="kd">final</span> <span class="n">_titleStyle</span> <span class="o">=</span> <span class="n">TextStyle</span><span class="p">(</span><span class="nl">fontSize:</span> <span class="mi">16</span><span class="o">.</span><span class="na">sp</span><span class="p">);</span>

<span class="c1">// ✅ 正确做法 1：常量或纯数据结构 + build 中动态计算</span>
<span class="nd">@override</span>
<span class="n">Widget</span> <span class="nf">build</span><span class="p">(</span><span class="n">BuildContext</span> <span class="n">context</span><span class="p">)</span> <span class="p">{</span>
  <span class="k">return</span> <span class="n">Text</span><span class="p">(</span><span class="s">'标题'</span><span class="p">,</span> <span class="nl">style:</span> <span class="n">TextStyle</span><span class="p">(</span><span class="nl">fontSize:</span> <span class="mi">16</span><span class="o">.</span><span class="na">sp</span><span class="p">));</span>
<span class="p">}</span>

<span class="c1">// ✅ 正确做法 2：使用 Getter</span>
<span class="n">TextStyle</span> <span class="kd">get</span> <span class="n">titleStyle</span> <span class="o">=</span><span class="p">&gt;</span> <span class="n">TextStyle</span><span class="p">(</span><span class="nl">fontSize:</span> <span class="mi">16</span><span class="o">.</span><span class="na">sp</span><span class="p">);</span>
</code></pre></div>    </div>
  </li>
  <li><strong>严格遵守组件设计契约</strong>：
    <ul>
      <li>使用 <code class="language-plaintext highlighter-rouge">TabBar</code> 时，子项优先使用 <code class="language-plaintext highlighter-rouge">Tab(text: ...)</code>，让组件内部自带的 <code class="language-plaintext highlighter-rouge">Center</code> 约束和 <code class="language-plaintext highlighter-rouge">PreferredSizeWidget</code> 参与排版。</li>
      <li>避免为 <code class="language-plaintext highlighter-rouge">TabBar</code> 施加过于极端的紧约束高度（建议至少保留 <code class="language-plaintext highlighter-rouge">26.r ~ 28.r</code> 容纳文字行高与指示器）。</li>
    </ul>
  </li>
</ol>

<hr />

<h2 id="六-总结">六、 总结</h2>

<p>在复杂大型混合栈工程中，<strong>生命周期的交汇点时序</strong>往往比单纯的代码语法更易产生幽灵 Bug。面对跨平台与原生通信间隙的“尺寸真空期”，<strong>以纯同步手段注入安全保底、拒绝脏数据覆盖、配置兜底解析器</strong>，是保证高可用与视觉一致性的最稳健架构方案。</p>]]></content><author><name>袁凤鸣</name></author><category term="flutter" /><category term="flutter" /><category term="screenutil" /><category term="hybrid" /><category term="flutter_boost" /><summary type="html"><![CDATA[深度复盘在 FlutterBoost 原生混合栈架构下，flutter_screenutil 偶发字体/尺寸缩放归零、ensureScreenSize死锁黑屏、rebuildFactor空尺寸污染等核心痛点，并提供框架层零侵入防坑治理方案。]]></summary></entry><entry><title type="html">Flutter-Skill MCP 安装与配置踩坑深度复盘指南</title><link href="https://www.yfmingo.cn/2026/09/20/flutter-skill-mcp-troubleshooting/" rel="alternate" type="text/html" title="Flutter-Skill MCP 安装与配置踩坑深度复盘指南" /><published>2026-09-20T00:00:00+00:00</published><updated>2026-09-20T00:00:00+00:00</updated><id>https://www.yfmingo.cn/2026/09/20/flutter-skill-mcp-troubleshooting</id><content type="html" xml:base="https://www.yfmingo.cn/2026/09/20/flutter-skill-mcp-troubleshooting/"><![CDATA[<ul id="markdown-toc">
  <li><a href="#一-项目背景与接入目标" id="markdown-toc-一-项目背景与接入目标">一、 项目背景与接入目标</a></li>
  <li><a href="#二-踩坑全景与底层根因剖析" id="markdown-toc-二-踩坑全景与底层根因剖析">二、 踩坑全景与底层根因剖析</a>    <ul>
      <li><a href="#坑一ide-面板无限期卡在-refreshing" id="markdown-toc-坑一ide-面板无限期卡在-refreshing">坑一：IDE 面板无限期卡在 “Refreshing…”</a></li>
      <li><a href="#坑二ide-重启后必现红字-error-calling-initialize-eof" id="markdown-toc-坑二ide-重启后必现红字-error-calling-initialize-eof">坑二：IDE 重启后必现红字 <code class="language-plaintext highlighter-rouge">Error: calling "initialize": EOF.</code></a></li>
      <li><a href="#坑三gui-进程环境变量-path-缺失" id="markdown-toc-坑三gui-进程环境变量-path-缺失">坑三：GUI 进程环境变量 PATH 缺失</a></li>
      <li><a href="#坑四社区官方现状未修复的已知架构缺陷" id="markdown-toc-坑四社区官方现状未修复的已知架构缺陷">坑四：社区官方现状（未修复的已知架构缺陷）</a></li>
    </ul>
  </li>
  <li><a href="#三-终极解决方案与架构落地" id="markdown-toc-三-终极解决方案与架构落地">三、 终极解决方案与架构落地</a>    <ul>
      <li><a href="#1-核心架构逻辑" id="markdown-toc-1-核心架构逻辑">1. 核心架构逻辑</a></li>
      <li><a href="#2-补丁代理脚本完整源码-flutter_skill_wrapperjs" id="markdown-toc-2-补丁代理脚本完整源码-flutter_skill_wrapperjs">2. 补丁代理脚本完整源码 (<code class="language-plaintext highlighter-rouge">flutter_skill_wrapper.js</code>)</a></li>
      <li><a href="#3-mcp-最终配置文件规范" id="markdown-toc-3-mcp-最终配置文件规范">3. MCP 最终配置文件规范</a></li>
    </ul>
  </li>
  <li><a href="#四-压测与修复验证" id="markdown-toc-四-压测与修复验证">四、 压测与修复验证</a></li>
</ul>
<hr />

<blockquote>
  <p><strong>文档信息</strong></p>
  <ul>
    <li><strong>作者</strong>：袁凤鸣</li>
    <li><strong>日期</strong>：2026-09-20</li>
    <li><strong>适用环境</strong>：macOS (Apple Silicon) / Antigravity IDE (VSCode OSS 架构) / Flutter FVM / Node.js</li>
    <li><strong>目标组件</strong>：<code class="language-plaintext highlighter-rouge">flutter_skill</code> (v0.9.37, GitHub: <a href="https://github.com/ai-dashboad/flutter-skill">ai-dashboad/flutter-skill</a>)</li>
  </ul>
</blockquote>

<hr />

<h2 id="一-项目背景与接入目标">一、 项目背景与接入目标</h2>

<p><code class="language-plaintext highlighter-rouge">flutter-skill</code> 是一个面向 AI 辅助研发与端到端自动化测试的 MCP (Model Context Protocol) 插件。接入后可赋予 Antigravity IDE / Claude Code 等 AI 助手如下核心能力：</p>
<ul>
  <li>跨平台 Flutter UI 语义层遍历与元素定位；</li>
  <li>自动化模拟交互（点击 <code class="language-plaintext highlighter-rouge">tap</code>、输入 <code class="language-plaintext highlighter-rouge">enter_text</code>、滚动 <code class="language-plaintext highlighter-rouge">scroll</code>）；</li>
  <li>运行时截屏与视觉比对验证；</li>
  <li>动态热重载（<code class="language-plaintext highlighter-rouge">hot_reload</code>）与热重启（<code class="language-plaintext highlighter-rouge">hot_restart</code>）；</li>
  <li>移动端（iOS / Android / Web）真机与模拟器设备调度。</li>
</ul>

<p>但在实际接入 Antigravity IDE 的过程中，由于该开源项目底层在 MCP 协议规范实现以及进程并发控制上的缺陷，引发了一连串致命阻碍。以下为完整踩坑与彻底解决的复盘记录。</p>

<hr />

<h2 id="二-踩坑全景与底层根因剖析">二、 踩坑全景与底层根因剖析</h2>

<h3 id="坑一ide-面板无限期卡在-refreshing">坑一：IDE 面板无限期卡在 “Refreshing…”</h3>

<ul>
  <li><strong>表面现象</strong>：在 Manage MCP servers 界面添加配置或刷新时，状态圈一直旋转，页面挂死在 “Refreshing…”，无法加载任何工具。</li>
  <li><strong>底层根因</strong>：
    <ol>
      <li><strong>虚假协议声明</strong>：原生 <code class="language-plaintext highlighter-rouge">flutter_skill</code> 源码在 <code class="language-plaintext highlighter-rouge">server.dart</code> 的 <code class="language-plaintext highlighter-rouge">initialize</code> 初始化握手响应中，硬编码返回了 <code class="language-plaintext highlighter-rouge">"capabilities": { "resources": {} }</code>，声称自身支持资源管理协议。</li>
      <li><strong>缺少对应路由实现</strong>：Antigravity IDE 严格遵循 MCP 规范，收到该声明后立刻向 Server 发送 <code class="language-plaintext highlighter-rouge">resources/list</code> 请求以拉取列表。但作者在路由分支中<strong>完全漏写了 <code class="language-plaintext highlighter-rouge">resources/list</code> 的处理分支</strong>。</li>
      <li><strong>静默丢弃未匹配帧</strong>：其底层缺乏未知 JSON-RPC 方法的默认兜底分支（未匹配方法直接丢弃，不返回任何结果也不返回错误），导致 IDE 客户端陷入无休止的阻塞等待，面板永久卡死。</li>
    </ol>
  </li>
</ul>

<hr />

<h3 id="坑二ide-重启后必现红字-error-calling-initialize-eof">坑二：IDE 重启后必现红字 <code class="language-plaintext highlighter-rouge">Error: calling "initialize": EOF.</code></h3>

<ul>
  <li><strong>表面现象</strong>：在界面手动点击一次 “Refresh 🔄” 按钮有时可以勉强加载成功；但<strong>一旦完全关闭 Antigravity IDE 并重新打开，必定弹出红色报错：<code class="language-plaintext highlighter-rouge">Error: calling "initialize": EOF.</code></strong>，无法随 IDE 自动初始化。</li>
  <li><strong>底层根因（核心链路）</strong>：
    <ol>
      <li><strong>IDE 双进程架构机制</strong>：
        <ul>
          <li>Antigravity IDE 启动时，会在底层并发启动两个独立的后台 Language Server：
            <ul>
              <li><code class="language-plaintext highlighter-rouge">Language Server 1</code>：全局实例（负责跨窗口调度与全局 MCP 服务管理面板）；</li>
              <li><code class="language-plaintext highlighter-rouge">Language Server 2</code>：当前 Workspace 项目实例（负责当前项目的代码解析、LSP 与工作区工具）。</li>
            </ul>
          </li>
          <li>这两个后台服务启动时，均会读取 <code class="language-plaintext highlighter-rouge">mcp_config.json</code>，并在<strong>同一毫秒内并发拉起两路 <code class="language-plaintext highlighter-rouge">flutter-skill</code> 进程</strong>。</li>
        </ul>
      </li>
      <li><strong>原生硬编码全局文件锁冲突</strong>：
        <ul>
          <li>原生 <code class="language-plaintext highlighter-rouge">flutter_skill</code> 在 <code class="language-plaintext highlighter-rouge">server.dart</code> 中内置了单例文件锁机制（硬编码路径为 <code class="language-plaintext highlighter-rouge">$HOME/.flutter_skill.lock</code>）。</li>
          <li>只要检测到该文件存在且修改时间在 10 分钟以内，后起的实例就会判定为“已有实例运行”，直接打印错误并执行 <code class="language-plaintext highlighter-rouge">exit(1)</code> 退出。</li>
        </ul>
      </li>
      <li><strong>早期脚本全局 <code class="language-plaintext highlighter-rouge">pkill</code> 引发并发互杀</strong>：
        <ul>
          <li>先前为了避免孤儿进程残留，在脚本启动前加入了 <code class="language-plaintext highlighter-rouge">pkill -9 flutter_skill...</code>。</li>
          <li>在双 Language Server 并发拉起的毫秒级瞬间：进程 A 刚拉起 Dart 子进程，进程 B 启动时执行 <code class="language-plaintext highlighter-rouge">pkill</code> 瞬间杀死了进程 A 的子进程。</li>
          <li>进程 A 捕获到子进程暴毙立即异常终止，导致管道破裂，向 IDE 抛出 <code class="language-plaintext highlighter-rouge">initialize: EOF</code>。</li>
        </ul>
      </li>
      <li><strong>为什么点击 Refresh 偶尔能好？</strong>：
        <ul>
          <li>在已打开的 IDE 中手动点击 Refresh 时，仅重载当前管理面板对应的单个 Language Server，属于<strong>单实例冷启动</strong>，无并发竞争，所以能碰巧成功；但重启 IDE 是两路必定并发，因此必现 EOF。</li>
        </ul>
      </li>
    </ol>
  </li>
</ul>

<hr />

<h3 id="坑三gui-进程环境变量-path-缺失">坑三：GUI 进程环境变量 PATH 缺失</h3>

<ul>
  <li><strong>表面现象</strong>：在配置中直接指定 <code class="language-plaintext highlighter-rouge">node</code> 或 <code class="language-plaintext highlighter-rouge">flutter_skill</code> 时，报错 <code class="language-plaintext highlighter-rouge">spawn ENOENT</code> 或退出码 <code class="language-plaintext highlighter-rouge">127</code>。</li>
  <li><strong>底层根因</strong>：macOS GUI 应用程序（从 Dock / Spotlight 启动的 Antigravity IDE）默认继承的 <code class="language-plaintext highlighter-rouge">PATH</code> 仅包含 <code class="language-plaintext highlighter-rouge">/usr/bin:/bin</code> 等极简系统路径，无法自动感知 Homebrew（<code class="language-plaintext highlighter-rouge">/opt/homebrew/bin</code>）或 FVM / Flutter SDK 路径。</li>
</ul>

<hr />

<h3 id="坑四社区官方现状未修复的已知架构缺陷">坑四：社区官方现状（未修复的已知架构缺陷）</h3>

<p>经过排查 <a href="https://github.com/ai-dashboad/flutter-skill/issues">ai-dashboad/flutter-skill/issues</a> 发现，该问题在开源社区中早已有人反馈，但官方至今未能妥善修复：</p>
<ol>
  <li><strong><a href="https://github.com/ai-dashboad/flutter-skill/issues/66">Issue #66</a></strong>（2026-09-17）：<br />
<em>“Flutter-skill completely breaks if you have multiple instances running”</em>  <br />
开发者明确抗议：一台机器上应该能够独立运行多个实例而互不干扰，不应因全局单例锁而彻底崩溃。</li>
  <li><strong><a href="https://github.com/ai-dashboad/flutter-skill/issues/50">Issue #50</a></strong>：<br />
<em>“MCP Error on Antigravity IDE on Mac: Error upon restarting IDE … calling initialize: EOF”</em>  <br />
与本次遇到的 IDE 重启必报 EOF 完全一致。</li>
</ol>

<hr />

<h2 id="三-终极解决方案与架构落地">三、 终极解决方案与架构落地</h2>

<p>为规避修改第三方 pub 缓存包源码的风险，同时彻底解决双实例并发互杀与协议漏帧问题，我们采用了 <strong>“透明协议补丁代理 + 动态沙箱环境隔离”</strong> 的全套架构设计。</p>

<h3 id="1-核心架构逻辑">1. 核心架构逻辑</h3>

<ul>
  <li><strong>动态沙箱 HOME 隔离</strong>：在代理层为每个 Language Server 实例分配专属临时主目录 <code class="language-plaintext highlighter-rouge">/tmp/flutter_skill_mcp_&lt;PID&gt;</code>，将 <code class="language-plaintext highlighter-rouge">.flutter_skill.lock</code> 彻底关入私有沙箱，解除全局单例互斥；</li>
  <li><strong>真实配置软链接映射</strong>：在沙箱内自动软链接用户主目录下的 <code class="language-plaintext highlighter-rouge">.pub-cache</code>、<code class="language-plaintext highlighter-rouge">.flutter-skill</code>、<code class="language-plaintext highlighter-rouge">.fvm</code> 等，功能 100% 保持原生完备；</li>
  <li><strong>严禁全局滥杀</strong>：彻底删除跨进程的 <code class="language-plaintext highlighter-rouge">pkill</code> 指令，每个 wrapper 实例仅精准持有并杀死自己 <code class="language-plaintext highlighter-rouge">spawn</code> 的 Dart 子进程；</li>
  <li><strong>全协议兼容兜底</strong>：过滤无效的 <code class="language-plaintext highlighter-rouge">resources</code> 声明，主动应答握手探测，未实现方法统一返回标准 <code class="language-plaintext highlighter-rouge">-32601</code> 错误码；</li>
  <li><strong>绝对路径与 PATH 注入</strong>：显式注入 Homebrew 及 Dart/Flutter SDK 路径，彻底解决 GUI 环境缺失 PATH 问题。</li>
</ul>

<hr />

<h3 id="2-补丁代理脚本完整源码-flutter_skill_wrapperjs">2. 补丁代理脚本完整源码 (<code class="language-plaintext highlighter-rouge">flutter_skill_wrapper.js</code>)</h3>

<p>文件路径：<code class="language-plaintext highlighter-rouge">/Users/mingo/.gemini/config/scripts/flutter_skill_wrapper.js</code></p>

<div class="language-javascript highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="cp">#!/usr/bin/env node
</span><span class="cm">/**
 * flutter_skill MCP 协议透明补丁代理
 * 
 * 核心特性与加固：
 * 1. 【实例环境隔离】：为每个 MCP 客户端实例创建独立运行沙箱（独立隔离 HOME 目录），
 *    彻底解决原生 flutter_skill 的 ~/.flutter_skill.lock 单例锁冲突，
 *    允许多个 Language Server（全局实例 + Workspace 实例）并发拉起而不发生抢锁崩溃。
 * 2. 【严禁跨进程滥杀】：移除所有全局 pkill 命令，每个 wrapper 实例严格仅管理和销毁自身的 child 进程。
 * 3. 【协议兼容兜底】：
 *    - 拦截 resources/list, resources/templates/list, prompts/list, ping, roots/list, server/discover 等
 *    - 剥离 capabilities 中的 resources 声明，避免客户端拉取无效资源
 *    - 未知请求自动返回 JSON-RPC 2.0 Method not found 错误，防止 IDE 握手阶段挂起
 * 4. 【生命周期守卫与优雅回收】：
 *    - 监听 process exit, SIGINT, SIGTERM, SIGHUP, stdin close 等事件
 *    - 进程销毁时同步终止子进程并递归清理专属沙箱目录
 * 5. 【日志隔离】：子进程 stderr 与调试信息写入 /tmp/flutter_skill_mcp.log，保持 stdio 管道纯净
 */</span>

<span class="kd">const</span> <span class="p">{</span> <span class="nx">spawn</span> <span class="p">}</span> <span class="o">=</span> <span class="nf">require</span><span class="p">(</span><span class="dl">"</span><span class="s2">child_process</span><span class="dl">"</span><span class="p">);</span>
<span class="kd">const</span> <span class="nx">readline</span> <span class="o">=</span> <span class="nf">require</span><span class="p">(</span><span class="dl">"</span><span class="s2">readline</span><span class="dl">"</span><span class="p">);</span>
<span class="kd">const</span> <span class="nx">fs</span> <span class="o">=</span> <span class="nf">require</span><span class="p">(</span><span class="dl">"</span><span class="s2">fs</span><span class="dl">"</span><span class="p">);</span>
<span class="kd">const</span> <span class="nx">path</span> <span class="o">=</span> <span class="nf">require</span><span class="p">(</span><span class="dl">"</span><span class="s2">path</span><span class="dl">"</span><span class="p">);</span>
<span class="kd">const</span> <span class="nx">os</span> <span class="o">=</span> <span class="nf">require</span><span class="p">(</span><span class="dl">"</span><span class="s2">os</span><span class="dl">"</span><span class="p">);</span>

<span class="kd">const</span> <span class="nx">realHome</span> <span class="o">=</span> <span class="nx">os</span><span class="p">.</span><span class="nf">homedir</span><span class="p">();</span>
<span class="kd">const</span> <span class="nx">logFile</span> <span class="o">=</span> <span class="dl">"</span><span class="s2">/tmp/flutter_skill_mcp.log</span><span class="dl">"</span><span class="p">;</span>

<span class="kd">function</span> <span class="nf">debugLog</span><span class="p">(</span><span class="nx">msg</span><span class="p">)</span> <span class="p">{</span>
  <span class="k">try</span> <span class="p">{</span>
    <span class="nx">fs</span><span class="p">.</span><span class="nf">appendFileSync</span><span class="p">(</span><span class="nx">logFile</span><span class="p">,</span> <span class="s2">`[</span><span class="p">${</span><span class="k">new</span> <span class="nc">Date</span><span class="p">().</span><span class="nf">toISOString</span><span class="p">()}</span><span class="s2">][PID </span><span class="p">${</span><span class="nx">process</span><span class="p">.</span><span class="nx">pid</span><span class="p">}</span><span class="s2">] </span><span class="p">${</span><span class="nx">msg</span><span class="p">}</span><span class="s2">\n`</span><span class="p">);</span>
  <span class="p">}</span> <span class="k">catch </span><span class="p">(</span><span class="nx">e</span><span class="p">)</span> <span class="p">{}</span>
<span class="p">}</span>

<span class="c1">// 捕获未处理异常，防止无声崩溃</span>
<span class="nx">process</span><span class="p">.</span><span class="nf">on</span><span class="p">(</span><span class="dl">"</span><span class="s2">uncaughtException</span><span class="dl">"</span><span class="p">,</span> <span class="p">(</span><span class="nx">err</span><span class="p">)</span> <span class="o">=&gt;</span> <span class="p">{</span>
  <span class="nf">debugLog</span><span class="p">(</span><span class="s2">`Uncaught exception: </span><span class="p">${</span><span class="nx">err</span> <span class="p">?</span> <span class="nx">err</span><span class="p">.</span><span class="nx">stack</span> <span class="o">||</span> <span class="nx">err</span> <span class="p">:</span> <span class="dl">""</span><span class="p">}</span><span class="s2">`</span><span class="p">);</span>
<span class="p">});</span>
<span class="nx">process</span><span class="p">.</span><span class="nf">on</span><span class="p">(</span><span class="dl">"</span><span class="s2">unhandledRejection</span><span class="dl">"</span><span class="p">,</span> <span class="p">(</span><span class="nx">reason</span><span class="p">)</span> <span class="o">=&gt;</span> <span class="p">{</span>
  <span class="nf">debugLog</span><span class="p">(</span><span class="s2">`Unhandled rejection: </span><span class="p">${</span><span class="nx">reason</span><span class="p">}</span><span class="s2">`</span><span class="p">);</span>
<span class="p">});</span>

<span class="c1">// 清理已消亡进程遗留的全局锁文件（如有）</span>
<span class="k">try</span> <span class="p">{</span>
  <span class="kd">const</span> <span class="nx">staleLock</span> <span class="o">=</span> <span class="nx">path</span><span class="p">.</span><span class="nf">join</span><span class="p">(</span><span class="nx">realHome</span><span class="p">,</span> <span class="dl">"</span><span class="s2">.flutter_skill.lock</span><span class="dl">"</span><span class="p">);</span>
  <span class="k">if </span><span class="p">(</span><span class="nx">fs</span><span class="p">.</span><span class="nf">existsSync</span><span class="p">(</span><span class="nx">staleLock</span><span class="p">))</span> <span class="p">{</span>
    <span class="kd">const</span> <span class="nx">content</span> <span class="o">=</span> <span class="nx">fs</span><span class="p">.</span><span class="nf">readFileSync</span><span class="p">(</span><span class="nx">staleLock</span><span class="p">,</span> <span class="dl">"</span><span class="s2">utf8</span><span class="dl">"</span><span class="p">);</span>
    <span class="kd">const</span> <span class="nx">oldPid</span> <span class="o">=</span> <span class="nf">parseInt</span><span class="p">(</span><span class="nx">content</span><span class="p">.</span><span class="nf">split</span><span class="p">(</span><span class="dl">"</span><span class="se">\n</span><span class="dl">"</span><span class="p">)[</span><span class="mi">0</span><span class="p">].</span><span class="nf">trim</span><span class="p">(),</span> <span class="mi">10</span><span class="p">);</span>
    <span class="kd">let</span> <span class="nx">isAlive</span> <span class="o">=</span> <span class="kc">false</span><span class="p">;</span>
    <span class="k">if </span><span class="p">(</span><span class="nx">oldPid</span><span class="p">)</span> <span class="p">{</span>
      <span class="k">try</span> <span class="p">{</span>
        <span class="nx">process</span><span class="p">.</span><span class="nf">kill</span><span class="p">(</span><span class="nx">oldPid</span><span class="p">,</span> <span class="mi">0</span><span class="p">);</span>
        <span class="nx">isAlive</span> <span class="o">=</span> <span class="kc">true</span><span class="p">;</span>
      <span class="p">}</span> <span class="k">catch </span><span class="p">(</span><span class="nx">e</span><span class="p">)</span> <span class="p">{</span>
        <span class="nx">isAlive</span> <span class="o">=</span> <span class="kc">false</span><span class="p">;</span>
      <span class="p">}</span>
    <span class="p">}</span>
    <span class="k">if </span><span class="p">(</span><span class="o">!</span><span class="nx">isAlive</span><span class="p">)</span> <span class="p">{</span>
      <span class="nx">fs</span><span class="p">.</span><span class="nf">unlinkSync</span><span class="p">(</span><span class="nx">staleLock</span><span class="p">);</span>
      <span class="nf">debugLog</span><span class="p">(</span><span class="s2">`Cleaned stale ~/.flutter_skill.lock for dead PID </span><span class="p">${</span><span class="nx">oldPid</span><span class="p">}</span><span class="s2">`</span><span class="p">);</span>
    <span class="p">}</span>
  <span class="p">}</span>
<span class="p">}</span> <span class="k">catch </span><span class="p">(</span><span class="nx">e</span><span class="p">)</span> <span class="p">{}</span>

<span class="c1">// 1. 创建属于当前实例的沙箱 HOME 目录，隔离 .flutter_skill.lock</span>
<span class="kd">const</span> <span class="nx">instanceHome</span> <span class="o">=</span> <span class="nx">path</span><span class="p">.</span><span class="nf">join</span><span class="p">(</span><span class="nx">os</span><span class="p">.</span><span class="nf">tmpdir</span><span class="p">(),</span> <span class="s2">`flutter_skill_mcp_</span><span class="p">${</span><span class="nx">process</span><span class="p">.</span><span class="nx">pid</span><span class="p">}</span><span class="s2">`</span><span class="p">);</span>
<span class="k">try</span> <span class="p">{</span>
  <span class="k">if </span><span class="p">(</span><span class="o">!</span><span class="nx">fs</span><span class="p">.</span><span class="nf">existsSync</span><span class="p">(</span><span class="nx">instanceHome</span><span class="p">))</span> <span class="p">{</span>
    <span class="nx">fs</span><span class="p">.</span><span class="nf">mkdirSync</span><span class="p">(</span><span class="nx">instanceHome</span><span class="p">,</span> <span class="p">{</span> <span class="na">recursive</span><span class="p">:</span> <span class="kc">true</span> <span class="p">});</span>
  <span class="p">}</span>
  <span class="c1">// 软链接用户主目录下的重要配置，保证 flutter_skill 工具能力完备</span>
  <span class="kd">const</span> <span class="nx">dirsToLink</span> <span class="o">=</span> <span class="p">[</span><span class="dl">"</span><span class="s2">.pub-cache</span><span class="dl">"</span><span class="p">,</span> <span class="dl">"</span><span class="s2">.flutter-skill</span><span class="dl">"</span><span class="p">,</span> <span class="dl">"</span><span class="s2">.fvm</span><span class="dl">"</span><span class="p">,</span> <span class="dl">"</span><span class="s2">.android</span><span class="dl">"</span><span class="p">,</span> <span class="dl">"</span><span class="s2">Library</span><span class="dl">"</span><span class="p">,</span> <span class="dl">"</span><span class="s2">allRepos</span><span class="dl">"</span><span class="p">];</span>
  <span class="k">for </span><span class="p">(</span><span class="kd">const</span> <span class="nx">dir</span> <span class="k">of</span> <span class="nx">dirsToLink</span><span class="p">)</span> <span class="p">{</span>
    <span class="kd">const</span> <span class="nx">target</span> <span class="o">=</span> <span class="nx">path</span><span class="p">.</span><span class="nf">join</span><span class="p">(</span><span class="nx">realHome</span><span class="p">,</span> <span class="nx">dir</span><span class="p">);</span>
    <span class="kd">const</span> <span class="nx">link</span> <span class="o">=</span> <span class="nx">path</span><span class="p">.</span><span class="nf">join</span><span class="p">(</span><span class="nx">instanceHome</span><span class="p">,</span> <span class="nx">dir</span><span class="p">);</span>
    <span class="k">if </span><span class="p">(</span><span class="nx">fs</span><span class="p">.</span><span class="nf">existsSync</span><span class="p">(</span><span class="nx">target</span><span class="p">)</span> <span class="o">&amp;&amp;</span> <span class="o">!</span><span class="nx">fs</span><span class="p">.</span><span class="nf">existsSync</span><span class="p">(</span><span class="nx">link</span><span class="p">))</span> <span class="p">{</span>
      <span class="k">try</span> <span class="p">{</span>
        <span class="nx">fs</span><span class="p">.</span><span class="nf">symlinkSync</span><span class="p">(</span><span class="nx">target</span><span class="p">,</span> <span class="nx">link</span><span class="p">);</span>
      <span class="p">}</span> <span class="k">catch </span><span class="p">(</span><span class="nx">e</span><span class="p">)</span> <span class="p">{}</span>
    <span class="p">}</span>
  <span class="p">}</span>
  <span class="nf">debugLog</span><span class="p">(</span><span class="s2">`Initialized sandbox HOME at </span><span class="p">${</span><span class="nx">instanceHome</span><span class="p">}</span><span class="s2">`</span><span class="p">);</span>
<span class="p">}</span> <span class="k">catch </span><span class="p">(</span><span class="nx">e</span><span class="p">)</span> <span class="p">{</span>
  <span class="nf">debugLog</span><span class="p">(</span><span class="s2">`Sandbox init error: </span><span class="p">${</span><span class="nx">e</span><span class="p">.</span><span class="nx">message</span><span class="p">}</span><span class="s2">`</span><span class="p">);</span>
<span class="p">}</span>

<span class="kd">const</span> <span class="nx">dartBin</span> <span class="o">=</span> <span class="dl">"</span><span class="s2">/Users/mingo/fvm/versions/3.38.10/bin/cache/dart-sdk/bin/dart</span><span class="dl">"</span><span class="p">;</span>
<span class="kd">const</span> <span class="nx">snapshot</span> <span class="o">=</span> <span class="dl">"</span><span class="s2">/Users/mingo/.pub-cache/global_packages/flutter_skill/bin/flutter_skill.dart-3.10.9.snapshot</span><span class="dl">"</span><span class="p">;</span>

<span class="c1">// 2. 拉起原生 Dart MCP 进程</span>
<span class="kd">const</span> <span class="nx">child</span> <span class="o">=</span> <span class="nf">spawn</span><span class="p">(</span><span class="nx">dartBin</span><span class="p">,</span> <span class="p">[</span><span class="nx">snapshot</span><span class="p">,</span> <span class="dl">"</span><span class="s2">server</span><span class="dl">"</span><span class="p">],</span> <span class="p">{</span>
  <span class="na">stdio</span><span class="p">:</span> <span class="p">[</span><span class="dl">"</span><span class="s2">pipe</span><span class="dl">"</span><span class="p">,</span> <span class="dl">"</span><span class="s2">pipe</span><span class="dl">"</span><span class="p">,</span> <span class="dl">"</span><span class="s2">pipe</span><span class="dl">"</span><span class="p">],</span>
  <span class="na">env</span><span class="p">:</span> <span class="p">{</span>
    <span class="p">...</span><span class="nx">process</span><span class="p">.</span><span class="nx">env</span><span class="p">,</span>
    <span class="na">HOME</span><span class="p">:</span> <span class="nx">instanceHome</span><span class="p">,</span>
    <span class="na">USERPROFILE</span><span class="p">:</span> <span class="nx">instanceHome</span><span class="p">,</span>
    <span class="na">PATH</span><span class="p">:</span> <span class="dl">"</span><span class="s2">/Users/mingo/fvm/versions/3.38.10/bin/cache/dart-sdk/bin:/Users/mingo/fvm/versions/3.38.10/bin:/Users/mingo/Library/Android/sdk/platform-tools:/opt/homebrew/bin:/usr/local/bin:/usr/bin:/bin:</span><span class="dl">"</span> <span class="o">+</span> <span class="p">(</span><span class="nx">process</span><span class="p">.</span><span class="nx">env</span><span class="p">.</span><span class="nx">PATH</span> <span class="o">||</span> <span class="dl">""</span><span class="p">)</span>
  <span class="p">}</span>
<span class="p">});</span>

<span class="nf">debugLog</span><span class="p">(</span><span class="s2">`Spawned child process PID </span><span class="p">${</span><span class="nx">child</span><span class="p">.</span><span class="nx">pid</span><span class="p">}</span><span class="s2">`</span><span class="p">);</span>

<span class="kd">let</span> <span class="nx">isCleanedUp</span> <span class="o">=</span> <span class="kc">false</span><span class="p">;</span>
<span class="kd">function</span> <span class="nf">cleanup</span><span class="p">()</span> <span class="p">{</span>
  <span class="k">if </span><span class="p">(</span><span class="nx">isCleanedUp</span><span class="p">)</span> <span class="k">return</span><span class="p">;</span>
  <span class="nx">isCleanedUp</span> <span class="o">=</span> <span class="kc">true</span><span class="p">;</span>
  <span class="nf">debugLog</span><span class="p">(</span><span class="dl">"</span><span class="s2">Cleaning up child process and sandbox...</span><span class="dl">"</span><span class="p">);</span>
  <span class="k">try</span> <span class="p">{</span>
    <span class="k">if </span><span class="p">(</span><span class="nx">child</span> <span class="o">&amp;&amp;</span> <span class="o">!</span><span class="nx">child</span><span class="p">.</span><span class="nx">killed</span><span class="p">)</span> <span class="p">{</span>
      <span class="nx">child</span><span class="p">.</span><span class="nf">kill</span><span class="p">(</span><span class="dl">"</span><span class="s2">SIGTERM</span><span class="dl">"</span><span class="p">);</span>
      <span class="nf">setTimeout</span><span class="p">(()</span> <span class="o">=&gt;</span> <span class="p">{</span>
        <span class="k">try</span> <span class="p">{</span> <span class="k">if </span><span class="p">(</span><span class="o">!</span><span class="nx">child</span><span class="p">.</span><span class="nx">killed</span><span class="p">)</span> <span class="nx">child</span><span class="p">.</span><span class="nf">kill</span><span class="p">(</span><span class="dl">"</span><span class="s2">SIGKILL</span><span class="dl">"</span><span class="p">);</span> <span class="p">}</span> <span class="k">catch </span><span class="p">(</span><span class="nx">e</span><span class="p">)</span> <span class="p">{}</span>
      <span class="p">},</span> <span class="mi">500</span><span class="p">);</span>
    <span class="p">}</span>
  <span class="p">}</span> <span class="k">catch </span><span class="p">(</span><span class="nx">e</span><span class="p">)</span> <span class="p">{}</span>

  <span class="k">try</span> <span class="p">{</span>
    <span class="k">if </span><span class="p">(</span><span class="nx">fs</span><span class="p">.</span><span class="nf">existsSync</span><span class="p">(</span><span class="nx">instanceHome</span><span class="p">))</span> <span class="p">{</span>
      <span class="nx">fs</span><span class="p">.</span><span class="nf">rmSync</span><span class="p">(</span><span class="nx">instanceHome</span><span class="p">,</span> <span class="p">{</span> <span class="na">recursive</span><span class="p">:</span> <span class="kc">true</span><span class="p">,</span> <span class="na">force</span><span class="p">:</span> <span class="kc">true</span> <span class="p">});</span>
    <span class="p">}</span>
  <span class="p">}</span> <span class="k">catch </span><span class="p">(</span><span class="nx">e</span><span class="p">)</span> <span class="p">{}</span>
<span class="p">}</span>

<span class="nx">process</span><span class="p">.</span><span class="nf">on</span><span class="p">(</span><span class="dl">"</span><span class="s2">exit</span><span class="dl">"</span><span class="p">,</span> <span class="nx">cleanup</span><span class="p">);</span>
<span class="nx">process</span><span class="p">.</span><span class="nf">on</span><span class="p">(</span><span class="dl">"</span><span class="s2">SIGINT</span><span class="dl">"</span><span class="p">,</span> <span class="p">()</span> <span class="o">=&gt;</span> <span class="p">{</span> <span class="nf">cleanup</span><span class="p">();</span> <span class="nx">process</span><span class="p">.</span><span class="nf">exit</span><span class="p">(</span><span class="mi">0</span><span class="p">);</span> <span class="p">});</span>
<span class="nx">process</span><span class="p">.</span><span class="nf">on</span><span class="p">(</span><span class="dl">"</span><span class="s2">SIGTERM</span><span class="dl">"</span><span class="p">,</span> <span class="p">()</span> <span class="o">=&gt;</span> <span class="p">{</span> <span class="nf">cleanup</span><span class="p">();</span> <span class="nx">process</span><span class="p">.</span><span class="nf">exit</span><span class="p">(</span><span class="mi">0</span><span class="p">);</span> <span class="p">});</span>
<span class="nx">process</span><span class="p">.</span><span class="nf">on</span><span class="p">(</span><span class="dl">"</span><span class="s2">SIGHUP</span><span class="dl">"</span><span class="p">,</span> <span class="p">()</span> <span class="o">=&gt;</span> <span class="p">{</span> <span class="nf">cleanup</span><span class="p">();</span> <span class="nx">process</span><span class="p">.</span><span class="nf">exit</span><span class="p">(</span><span class="mi">0</span><span class="p">);</span> <span class="p">});</span>
<span class="nx">process</span><span class="p">.</span><span class="nx">stdin</span><span class="p">.</span><span class="nf">on</span><span class="p">(</span><span class="dl">"</span><span class="s2">end</span><span class="dl">"</span><span class="p">,</span> <span class="p">()</span> <span class="o">=&gt;</span> <span class="p">{</span> <span class="nf">cleanup</span><span class="p">();</span> <span class="nx">process</span><span class="p">.</span><span class="nf">exit</span><span class="p">(</span><span class="mi">0</span><span class="p">);</span> <span class="p">});</span>
<span class="nx">process</span><span class="p">.</span><span class="nx">stdin</span><span class="p">.</span><span class="nf">on</span><span class="p">(</span><span class="dl">"</span><span class="s2">close</span><span class="dl">"</span><span class="p">,</span> <span class="p">()</span> <span class="o">=&gt;</span> <span class="p">{</span> <span class="nf">cleanup</span><span class="p">();</span> <span class="nx">process</span><span class="p">.</span><span class="nf">exit</span><span class="p">(</span><span class="mi">0</span><span class="p">);</span> <span class="p">});</span>

<span class="nx">child</span><span class="p">.</span><span class="nf">on</span><span class="p">(</span><span class="dl">"</span><span class="s2">error</span><span class="dl">"</span><span class="p">,</span> <span class="p">(</span><span class="nx">err</span><span class="p">)</span> <span class="o">=&gt;</span> <span class="p">{</span>
  <span class="nf">debugLog</span><span class="p">(</span><span class="s2">`Child process error: </span><span class="p">${</span><span class="nx">err</span><span class="p">.</span><span class="nx">message</span><span class="p">}</span><span class="s2">`</span><span class="p">);</span>
  <span class="nf">cleanup</span><span class="p">();</span>
  <span class="nx">process</span><span class="p">.</span><span class="nf">exit</span><span class="p">(</span><span class="mi">1</span><span class="p">);</span>
<span class="p">});</span>

<span class="nx">child</span><span class="p">.</span><span class="nf">on</span><span class="p">(</span><span class="dl">"</span><span class="s2">exit</span><span class="dl">"</span><span class="p">,</span> <span class="p">(</span><span class="nx">code</span><span class="p">,</span> <span class="nx">signal</span><span class="p">)</span> <span class="o">=&gt;</span> <span class="p">{</span>
  <span class="nf">debugLog</span><span class="p">(</span><span class="s2">`Child exited with code </span><span class="p">${</span><span class="nx">code</span><span class="p">}</span><span class="s2">, signal </span><span class="p">${</span><span class="nx">signal</span><span class="p">}</span><span class="s2">`</span><span class="p">);</span>
  <span class="nf">cleanup</span><span class="p">();</span>
  <span class="nx">process</span><span class="p">.</span><span class="nf">exit</span><span class="p">(</span><span class="nx">code</span> <span class="o">||</span> <span class="mi">0</span><span class="p">);</span>
<span class="p">});</span>

<span class="nx">child</span><span class="p">.</span><span class="nx">stderr</span><span class="p">.</span><span class="nf">on</span><span class="p">(</span><span class="dl">"</span><span class="s2">data</span><span class="dl">"</span><span class="p">,</span> <span class="p">(</span><span class="nx">chunk</span><span class="p">)</span> <span class="o">=&gt;</span> <span class="p">{</span>
  <span class="nf">debugLog</span><span class="p">(</span><span class="s2">`[child stderr] </span><span class="p">${</span><span class="nx">chunk</span><span class="p">.</span><span class="nf">toString</span><span class="p">().</span><span class="nf">trim</span><span class="p">()}</span><span class="s2">`</span><span class="p">);</span>
<span class="p">});</span>

<span class="c1">// 支持的原生方法集合</span>
<span class="kd">const</span> <span class="nx">SUPPORTED_NATIVE_METHODS</span> <span class="o">=</span> <span class="k">new</span> <span class="nc">Set</span><span class="p">([</span>
  <span class="dl">"</span><span class="s2">initialize</span><span class="dl">"</span><span class="p">,</span>
  <span class="dl">"</span><span class="s2">notifications/initialized</span><span class="dl">"</span><span class="p">,</span>
  <span class="dl">"</span><span class="s2">tools/list</span><span class="dl">"</span><span class="p">,</span>
  <span class="dl">"</span><span class="s2">tools/call</span><span class="dl">"</span>
<span class="p">]);</span>

<span class="c1">// 处理从 IDE 客户端发来的请求</span>
<span class="kd">const</span> <span class="nx">rlStdin</span> <span class="o">=</span> <span class="nx">readline</span><span class="p">.</span><span class="nf">createInterface</span><span class="p">({</span> <span class="na">input</span><span class="p">:</span> <span class="nx">process</span><span class="p">.</span><span class="nx">stdin</span><span class="p">,</span> <span class="na">terminal</span><span class="p">:</span> <span class="kc">false</span> <span class="p">});</span>

<span class="nx">rlStdin</span><span class="p">.</span><span class="nf">on</span><span class="p">(</span><span class="dl">"</span><span class="s2">line</span><span class="dl">"</span><span class="p">,</span> <span class="p">(</span><span class="nx">line</span><span class="p">)</span> <span class="o">=&gt;</span> <span class="p">{</span>
  <span class="kd">const</span> <span class="nx">trimmed</span> <span class="o">=</span> <span class="nx">line</span><span class="p">.</span><span class="nf">trim</span><span class="p">();</span>
  <span class="k">if </span><span class="p">(</span><span class="o">!</span><span class="nx">trimmed</span><span class="p">)</span> <span class="k">return</span><span class="p">;</span>
  <span class="k">try</span> <span class="p">{</span>
    <span class="kd">const</span> <span class="nx">req</span> <span class="o">=</span> <span class="nx">JSON</span><span class="p">.</span><span class="nf">parse</span><span class="p">(</span><span class="nx">trimmed</span><span class="p">);</span>
    <span class="kd">const</span> <span class="nx">method</span> <span class="o">=</span> <span class="nx">req</span><span class="p">.</span><span class="nx">method</span><span class="p">;</span>
    <span class="kd">const</span> <span class="nx">id</span> <span class="o">=</span> <span class="nx">req</span><span class="p">.</span><span class="nx">id</span><span class="p">;</span>

    <span class="c1">// 1. 特殊已知方法主动应答</span>
    <span class="k">if </span><span class="p">(</span><span class="nx">method</span> <span class="o">===</span> <span class="dl">"</span><span class="s2">server/discover</span><span class="dl">"</span><span class="p">)</span> <span class="p">{</span>
      <span class="kd">const</span> <span class="nx">resp</span> <span class="o">=</span> <span class="p">{</span> <span class="na">jsonrpc</span><span class="p">:</span> <span class="dl">"</span><span class="s2">2.0</span><span class="dl">"</span><span class="p">,</span> <span class="na">id</span><span class="p">:</span> <span class="nx">id</span><span class="p">,</span> <span class="na">error</span><span class="p">:</span> <span class="p">{</span> <span class="na">code</span><span class="p">:</span> <span class="o">-</span><span class="mi">32601</span><span class="p">,</span> <span class="na">message</span><span class="p">:</span> <span class="dl">"</span><span class="s2">Method not found</span><span class="dl">"</span> <span class="p">}</span> <span class="p">};</span>
      <span class="nx">process</span><span class="p">.</span><span class="nx">stdout</span><span class="p">.</span><span class="nf">write</span><span class="p">(</span><span class="nx">JSON</span><span class="p">.</span><span class="nf">stringify</span><span class="p">(</span><span class="nx">resp</span><span class="p">)</span> <span class="o">+</span> <span class="dl">"</span><span class="se">\n</span><span class="dl">"</span><span class="p">);</span>
      <span class="k">return</span><span class="p">;</span>
    <span class="p">}</span>

    <span class="k">if </span><span class="p">(</span><span class="nx">method</span> <span class="o">===</span> <span class="dl">"</span><span class="s2">resources/list</span><span class="dl">"</span><span class="p">)</span> <span class="p">{</span>
      <span class="kd">const</span> <span class="nx">resp</span> <span class="o">=</span> <span class="p">{</span> <span class="na">jsonrpc</span><span class="p">:</span> <span class="dl">"</span><span class="s2">2.0</span><span class="dl">"</span><span class="p">,</span> <span class="na">id</span><span class="p">:</span> <span class="nx">id</span><span class="p">,</span> <span class="na">result</span><span class="p">:</span> <span class="p">{</span> <span class="na">resources</span><span class="p">:</span> <span class="p">[]</span> <span class="p">}</span> <span class="p">};</span>
      <span class="nx">process</span><span class="p">.</span><span class="nx">stdout</span><span class="p">.</span><span class="nf">write</span><span class="p">(</span><span class="nx">JSON</span><span class="p">.</span><span class="nf">stringify</span><span class="p">(</span><span class="nx">resp</span><span class="p">)</span> <span class="o">+</span> <span class="dl">"</span><span class="se">\n</span><span class="dl">"</span><span class="p">);</span>
      <span class="k">return</span><span class="p">;</span>
    <span class="p">}</span>

    <span class="k">if </span><span class="p">(</span><span class="nx">method</span> <span class="o">===</span> <span class="dl">"</span><span class="s2">resources/templates/list</span><span class="dl">"</span><span class="p">)</span> <span class="p">{</span>
      <span class="kd">const</span> <span class="nx">resp</span> <span class="o">=</span> <span class="p">{</span> <span class="na">jsonrpc</span><span class="p">:</span> <span class="dl">"</span><span class="s2">2.0</span><span class="dl">"</span><span class="p">,</span> <span class="na">id</span><span class="p">:</span> <span class="nx">id</span><span class="p">,</span> <span class="na">result</span><span class="p">:</span> <span class="p">{</span> <span class="na">resourceTemplates</span><span class="p">:</span> <span class="p">[]</span> <span class="p">}</span> <span class="p">};</span>
      <span class="nx">process</span><span class="p">.</span><span class="nx">stdout</span><span class="p">.</span><span class="nf">write</span><span class="p">(</span><span class="nx">JSON</span><span class="p">.</span><span class="nf">stringify</span><span class="p">(</span><span class="nx">resp</span><span class="p">)</span> <span class="o">+</span> <span class="dl">"</span><span class="se">\n</span><span class="dl">"</span><span class="p">);</span>
      <span class="k">return</span><span class="p">;</span>
    <span class="p">}</span>

    <span class="k">if </span><span class="p">(</span><span class="nx">method</span> <span class="o">===</span> <span class="dl">"</span><span class="s2">prompts/list</span><span class="dl">"</span><span class="p">)</span> <span class="p">{</span>
      <span class="kd">const</span> <span class="nx">resp</span> <span class="o">=</span> <span class="p">{</span> <span class="na">jsonrpc</span><span class="p">:</span> <span class="dl">"</span><span class="s2">2.0</span><span class="dl">"</span><span class="p">,</span> <span class="na">id</span><span class="p">:</span> <span class="nx">id</span><span class="p">,</span> <span class="na">result</span><span class="p">:</span> <span class="p">{</span> <span class="na">prompts</span><span class="p">:</span> <span class="p">[]</span> <span class="p">}</span> <span class="p">};</span>
      <span class="nx">process</span><span class="p">.</span><span class="nx">stdout</span><span class="p">.</span><span class="nf">write</span><span class="p">(</span><span class="nx">JSON</span><span class="p">.</span><span class="nf">stringify</span><span class="p">(</span><span class="nx">resp</span><span class="p">)</span> <span class="o">+</span> <span class="dl">"</span><span class="se">\n</span><span class="dl">"</span><span class="p">);</span>
      <span class="k">return</span><span class="p">;</span>
    <span class="p">}</span>

    <span class="k">if </span><span class="p">(</span><span class="nx">method</span> <span class="o">===</span> <span class="dl">"</span><span class="s2">ping</span><span class="dl">"</span><span class="p">)</span> <span class="p">{</span>
      <span class="kd">const</span> <span class="nx">resp</span> <span class="o">=</span> <span class="p">{</span> <span class="na">jsonrpc</span><span class="p">:</span> <span class="dl">"</span><span class="s2">2.0</span><span class="dl">"</span><span class="p">,</span> <span class="na">id</span><span class="p">:</span> <span class="nx">id</span><span class="p">,</span> <span class="na">result</span><span class="p">:</span> <span class="p">{}</span> <span class="p">};</span>
      <span class="nx">process</span><span class="p">.</span><span class="nx">stdout</span><span class="p">.</span><span class="nf">write</span><span class="p">(</span><span class="nx">JSON</span><span class="p">.</span><span class="nf">stringify</span><span class="p">(</span><span class="nx">resp</span><span class="p">)</span> <span class="o">+</span> <span class="dl">"</span><span class="se">\n</span><span class="dl">"</span><span class="p">);</span>
      <span class="k">return</span><span class="p">;</span>
    <span class="p">}</span>

    <span class="k">if </span><span class="p">(</span><span class="nx">method</span> <span class="o">===</span> <span class="dl">"</span><span class="s2">roots/list</span><span class="dl">"</span><span class="p">)</span> <span class="p">{</span>
      <span class="kd">const</span> <span class="nx">resp</span> <span class="o">=</span> <span class="p">{</span> <span class="na">jsonrpc</span><span class="p">:</span> <span class="dl">"</span><span class="s2">2.0</span><span class="dl">"</span><span class="p">,</span> <span class="na">id</span><span class="p">:</span> <span class="nx">id</span><span class="p">,</span> <span class="na">result</span><span class="p">:</span> <span class="p">{</span> <span class="na">roots</span><span class="p">:</span> <span class="p">[]</span> <span class="p">}</span> <span class="p">};</span>
      <span class="nx">process</span><span class="p">.</span><span class="nx">stdout</span><span class="p">.</span><span class="nf">write</span><span class="p">(</span><span class="nx">JSON</span><span class="p">.</span><span class="nf">stringify</span><span class="p">(</span><span class="nx">resp</span><span class="p">)</span> <span class="o">+</span> <span class="dl">"</span><span class="se">\n</span><span class="dl">"</span><span class="p">);</span>
      <span class="k">return</span><span class="p">;</span>
    <span class="p">}</span>

    <span class="c1">// 2. 如果是底层明确支持的方法，透传给底层 flutter_skill</span>
    <span class="k">if </span><span class="p">(</span><span class="nx">SUPPORTED_NATIVE_METHODS</span><span class="p">.</span><span class="nf">has</span><span class="p">(</span><span class="nx">method</span><span class="p">))</span> <span class="p">{</span>
      <span class="nx">child</span><span class="p">.</span><span class="nx">stdin</span><span class="p">.</span><span class="nf">write</span><span class="p">(</span><span class="nx">line</span> <span class="o">+</span> <span class="dl">"</span><span class="se">\n</span><span class="dl">"</span><span class="p">);</span>
      <span class="k">return</span><span class="p">;</span>
    <span class="p">}</span>

    <span class="c1">// 3. 对其他带有 id 的未知方法，主动返回标准 JSON-RPC 2.0 Method not found</span>
    <span class="k">if </span><span class="p">(</span><span class="nx">id</span> <span class="o">!==</span> <span class="kc">undefined</span> <span class="o">&amp;&amp;</span> <span class="nx">id</span> <span class="o">!==</span> <span class="kc">null</span><span class="p">)</span> <span class="p">{</span>
      <span class="kd">const</span> <span class="nx">resp</span> <span class="o">=</span> <span class="p">{</span> <span class="na">jsonrpc</span><span class="p">:</span> <span class="dl">"</span><span class="s2">2.0</span><span class="dl">"</span><span class="p">,</span> <span class="na">id</span><span class="p">:</span> <span class="nx">id</span><span class="p">,</span> <span class="na">error</span><span class="p">:</span> <span class="p">{</span> <span class="na">code</span><span class="p">:</span> <span class="o">-</span><span class="mi">32601</span><span class="p">,</span> <span class="na">message</span><span class="p">:</span> <span class="s2">`Method not found: </span><span class="p">${</span><span class="nx">method</span><span class="p">}</span><span class="s2">`</span> <span class="p">}</span> <span class="p">};</span>
      <span class="nx">process</span><span class="p">.</span><span class="nx">stdout</span><span class="p">.</span><span class="nf">write</span><span class="p">(</span><span class="nx">JSON</span><span class="p">.</span><span class="nf">stringify</span><span class="p">(</span><span class="nx">resp</span><span class="p">)</span> <span class="o">+</span> <span class="dl">"</span><span class="se">\n</span><span class="dl">"</span><span class="p">);</span>
      <span class="k">return</span><span class="p">;</span>
    <span class="p">}</span>

    <span class="c1">// 无 id 的通知类消息，安全透传</span>
    <span class="nx">child</span><span class="p">.</span><span class="nx">stdin</span><span class="p">.</span><span class="nf">write</span><span class="p">(</span><span class="nx">line</span> <span class="o">+</span> <span class="dl">"</span><span class="se">\n</span><span class="dl">"</span><span class="p">);</span>
  <span class="p">}</span> <span class="k">catch </span><span class="p">(</span><span class="nx">e</span><span class="p">)</span> <span class="p">{</span>
    <span class="nx">child</span><span class="p">.</span><span class="nx">stdin</span><span class="p">.</span><span class="nf">write</span><span class="p">(</span><span class="nx">line</span> <span class="o">+</span> <span class="dl">"</span><span class="se">\n</span><span class="dl">"</span><span class="p">);</span>
  <span class="p">}</span>
<span class="p">});</span>

<span class="nx">rlStdin</span><span class="p">.</span><span class="nf">on</span><span class="p">(</span><span class="dl">"</span><span class="s2">close</span><span class="dl">"</span><span class="p">,</span> <span class="p">()</span> <span class="o">=&gt;</span> <span class="p">{</span>
  <span class="nf">cleanup</span><span class="p">();</span>
  <span class="nx">process</span><span class="p">.</span><span class="nf">exit</span><span class="p">(</span><span class="mi">0</span><span class="p">);</span>
<span class="p">});</span>

<span class="c1">// 处理底层 flutter_skill 发出的响应</span>
<span class="kd">const</span> <span class="nx">rlStdout</span> <span class="o">=</span> <span class="nx">readline</span><span class="p">.</span><span class="nf">createInterface</span><span class="p">({</span> <span class="na">input</span><span class="p">:</span> <span class="nx">child</span><span class="p">.</span><span class="nx">stdout</span><span class="p">,</span> <span class="na">terminal</span><span class="p">:</span> <span class="kc">false</span> <span class="p">});</span>

<span class="nx">rlStdout</span><span class="p">.</span><span class="nf">on</span><span class="p">(</span><span class="dl">"</span><span class="s2">line</span><span class="dl">"</span><span class="p">,</span> <span class="p">(</span><span class="nx">line</span><span class="p">)</span> <span class="o">=&gt;</span> <span class="p">{</span>
  <span class="kd">const</span> <span class="nx">trimmed</span> <span class="o">=</span> <span class="nx">line</span><span class="p">.</span><span class="nf">trim</span><span class="p">();</span>
  <span class="k">if </span><span class="p">(</span><span class="o">!</span><span class="nx">trimmed</span><span class="p">)</span> <span class="k">return</span><span class="p">;</span>
  <span class="k">try</span> <span class="p">{</span>
    <span class="kd">const</span> <span class="nx">msg</span> <span class="o">=</span> <span class="nx">JSON</span><span class="p">.</span><span class="nf">parse</span><span class="p">(</span><span class="nx">trimmed</span><span class="p">);</span>
    <span class="c1">// 移除 initialize 中的 resources 声明，避免 IDE 去请求 resources/list</span>
    <span class="k">if </span><span class="p">(</span><span class="nx">msg</span><span class="p">.</span><span class="nx">result</span> <span class="o">&amp;&amp;</span> <span class="nx">msg</span><span class="p">.</span><span class="nx">result</span><span class="p">.</span><span class="nx">capabilities</span> <span class="o">&amp;&amp;</span> <span class="nx">msg</span><span class="p">.</span><span class="nx">result</span><span class="p">.</span><span class="nx">capabilities</span><span class="p">.</span><span class="nx">resources</span><span class="p">)</span> <span class="p">{</span>
      <span class="k">delete</span> <span class="nx">msg</span><span class="p">.</span><span class="nx">result</span><span class="p">.</span><span class="nx">capabilities</span><span class="p">.</span><span class="nx">resources</span><span class="p">;</span>
      <span class="nx">process</span><span class="p">.</span><span class="nx">stdout</span><span class="p">.</span><span class="nf">write</span><span class="p">(</span><span class="nx">JSON</span><span class="p">.</span><span class="nf">stringify</span><span class="p">(</span><span class="nx">msg</span><span class="p">)</span> <span class="o">+</span> <span class="dl">"</span><span class="se">\n</span><span class="dl">"</span><span class="p">);</span>
      <span class="k">return</span><span class="p">;</span>
    <span class="p">}</span>
    <span class="nx">process</span><span class="p">.</span><span class="nx">stdout</span><span class="p">.</span><span class="nf">write</span><span class="p">(</span><span class="nx">line</span> <span class="o">+</span> <span class="dl">"</span><span class="se">\n</span><span class="dl">"</span><span class="p">);</span>
  <span class="p">}</span> <span class="k">catch </span><span class="p">(</span><span class="nx">e</span><span class="p">)</span> <span class="p">{</span>
    <span class="nx">process</span><span class="p">.</span><span class="nx">stdout</span><span class="p">.</span><span class="nf">write</span><span class="p">(</span><span class="nx">line</span> <span class="o">+</span> <span class="dl">"</span><span class="se">\n</span><span class="dl">"</span><span class="p">);</span>
  <span class="p">}</span>
<span class="p">});</span>

</code></pre></div></div>

<hr />

<h3 id="3-mcp-最终配置文件规范">3. MCP 最终配置文件规范</h3>

<p>配置文件路径：<code class="language-plaintext highlighter-rouge">~/.gemini/config/mcp_config.json</code> 与 <code class="language-plaintext highlighter-rouge">~/.gemini/antigravity/mcp_config.json</code></p>

<div class="language-json highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="p">{</span><span class="w">
  </span><span class="nl">"mcpServers"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
    </span><span class="nl">"flutter-skill"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
      </span><span class="nl">"command"</span><span class="p">:</span><span class="w"> </span><span class="s2">"/opt/homebrew/bin/node"</span><span class="p">,</span><span class="w">
      </span><span class="nl">"args"</span><span class="p">:</span><span class="w"> </span><span class="p">[</span><span class="w">
        </span><span class="s2">"/Users/mingo/.gemini/config/scripts/flutter_skill_wrapper.js"</span><span class="w">
      </span><span class="p">],</span><span class="w">
      </span><span class="nl">"env"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
        </span><span class="nl">"PATH"</span><span class="p">:</span><span class="w"> </span><span class="s2">"/Users/mingo/fvm/versions/3.38.10/bin/cache/dart-sdk/bin:/Users/mingo/fvm/versions/3.38.10/bin:/Users/mingo/Library/Android/sdk/platform-tools:/opt/homebrew/bin:/usr/local/bin:/usr/bin:/bin:/usr/sbin:/sbin"</span><span class="w">
      </span><span class="p">}</span><span class="w">
    </span><span class="p">}</span><span class="w">
  </span><span class="p">}</span><span class="w">
</span><span class="p">}</span><span class="w">
</span></code></pre></div></div>

<hr />

<h2 id="四-压测与修复验证">四、 压测与修复验证</h2>

<p>使用高并发模拟脚本，针对 3 个客户端实例在同一毫秒并发发起 <code class="language-plaintext highlighter-rouge">initialize</code> 与 <code class="language-plaintext highlighter-rouge">tools/list</code> 握手压测：</p>

<div class="language-python highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="c1"># 并发压测返回结果：
</span><span class="n">Concurrent</span> <span class="n">results</span><span class="p">:</span> <span class="p">[(</span><span class="mi">1</span><span class="p">,</span> <span class="mi">13</span><span class="p">),</span> <span class="p">(</span><span class="mi">1</span><span class="p">,</span> <span class="mi">13</span><span class="p">),</span> <span class="p">(</span><span class="mi">1</span><span class="p">,</span> <span class="mi">13</span><span class="p">)]</span>
</code></pre></div></div>

<ul>
  <li><strong>握手时延</strong>：毫秒级完成初始化握手，无任何卡死与断流；</li>
  <li><strong>能力覆盖</strong>：每个实例均稳定加载全部 <strong>13 个核心 MCP 工具</strong>；</li>
  <li><strong>生命周期</strong>：客户端退出后，临时沙箱与 Dart 虚拟机进程 100% 自动回收，零孤儿进程残留；</li>
  <li><strong>自愈验证</strong>：Antigravity IDE 重新启动后，无需手动点击 Refresh 即可自动加载就绪。</li>
</ul>]]></content><author><name>袁凤鸣</name></author><category term="flutter" /><category term="flutter" /><category term="mcp" /><category term="ai" /><summary type="html"><![CDATA[面向 AI 辅助研发与端到端自动化测试的 flutter_skill MCP 插件在接入 Antigravity IDE 过程中，关于虚假协议声明、进程并发锁与 EOF 崩溃的踩坑复盘与深度治理。]]></summary></entry><entry><title type="html">flutter 集成 Android 和 iOS 极光推送 JPush</title><link href="https://www.yfmingo.cn/2025/05/28/flutter-jpush/" rel="alternate" type="text/html" title="flutter 集成 Android 和 iOS 极光推送 JPush" /><published>2025-05-28T00:00:00+00:00</published><updated>2025-05-28T00:00:00+00:00</updated><id>https://www.yfmingo.cn/2025/05/28/flutter-jpush</id><content type="html" xml:base="https://www.yfmingo.cn/2025/05/28/flutter-jpush/"><![CDATA[<ul id="markdown-toc">
  <li><a href="#0x000-背景" id="markdown-toc-0x000-背景">0x000 背景</a></li>
  <li><a href="#0x001-接入前期准备" id="markdown-toc-0x001-接入前期准备">0x001 接入前期准备。</a></li>
  <li><a href="#0x002-接入代码" id="markdown-toc-0x002-接入代码">0x002 接入代码</a>    <ul>
      <li><a href="#安卓代码" id="markdown-toc-安卓代码">安卓代码</a></li>
      <li><a href="#app下的buildgradle中dependencies" id="markdown-toc-app下的buildgradle中dependencies"><code class="language-plaintext highlighter-rouge">App</code>下的<code class="language-plaintext highlighter-rouge">build.gradle</code>中<code class="language-plaintext highlighter-rouge">dependencies</code></a></li>
      <li><a href="#android下buildgradle的dependencies" id="markdown-toc-android下buildgradle的dependencies"><code class="language-plaintext highlighter-rouge">android</code>下<code class="language-plaintext highlighter-rouge">build.gradle</code>的<code class="language-plaintext highlighter-rouge">dependencies</code></a></li>
    </ul>
  </li>
  <li><a href="#flutter-端的推送代码" id="markdown-toc-flutter-端的推送代码">flutter 端的推送代码</a></li>
  <li><a href="#0x003-试运行了" id="markdown-toc-0x003-试运行了">0x003 试运行了</a></li>
  <li><a href="#0x004-整个过程遇到的坑专辑" id="markdown-toc-0x004-整个过程遇到的坑专辑">0x004 整个过程遇到的坑专辑</a>    <ul>
      <li><a href="#坑1极光的初始化需要在android端完成在dart端完成初始化会在提审的时候被各家安卓拒审" id="markdown-toc-坑1极光的初始化需要在android端完成在dart端完成初始化会在提审的时候被各家安卓拒审">坑1：极光的初始化需要在Android端完成。在Dart端完成初始化会在提审的时候被各家安卓拒审</a></li>
      <li><a href="#坑2前面提到的获得了registration_id-仅是集成了极光的fluttersdk没有集成厂商推送通道" id="markdown-toc-坑2前面提到的获得了registration_id-仅是集成了极光的fluttersdk没有集成厂商推送通道">坑2：前面提到的获得了registration_id 仅是集成了极光的flutterSDK，没有集成厂商推送通道。</a></li>
      <li><a href="#坑3没有开通极光会员调试排查的机会都没有" id="markdown-toc-坑3没有开通极光会员调试排查的机会都没有">坑3：没有开通极光会员。调试排查的机会都没有。</a></li>
      <li><a href="#坑4oppo错误码67分类错误包含强提醒所有异常" id="markdown-toc-坑4oppo错误码67分类错误包含强提醒所有异常">坑4：OPPO错误码:67–分类错误(包含强提醒所有异常)。</a></li>
      <li><a href="#坑5无厂商token就是没有集成成功仅集成了极光端没有集成厂商通道不能离线推送消息" id="markdown-toc-坑5无厂商token就是没有集成成功仅集成了极光端没有集成厂商通道不能离线推送消息">坑5：无厂商token:就是没有集成成功。仅集成了极光端，没有集成厂商通道，不能离线推送消息。</a></li>
      <li><a href="#坑6集成华为的时候报错907135000" id="markdown-toc-坑6集成华为的时候报错907135000">坑6：集成华为的时候报错：907135000</a></li>
      <li><a href="#坑7然后又-get-huawei-token-error6003-certificate-fingerprint-error" id="markdown-toc-坑7然后又-get-huawei-token-error6003-certificate-fingerprint-error">坑7：然后又 get huawei token error:6003: certificate fingerprint error</a></li>
      <li><a href="#坑8--mac-无法查看-查看签名的sha256" id="markdown-toc-坑8--mac-无法查看-查看签名的sha256">坑8:  mac 无法查看 查看签名的SHA256</a></li>
      <li><a href="#坑9--并不是所有荣耀手机都走荣耀推送" id="markdown-toc-坑9--并不是所有荣耀手机都走荣耀推送">坑9:  并不是所有荣耀手机都走荣耀推送。</a></li>
      <li><a href="#坑10---离线推送消息到了通知栏点击通知栏拉不起来app" id="markdown-toc-坑10---离线推送消息到了通知栏点击通知栏拉不起来app">坑10:   离线推送，消息到了通知栏，点击通知栏拉不起来APP。</a></li>
      <li><a href="#坑11--推送消息处理安卓和ios的不一样" id="markdown-toc-坑11--推送消息处理安卓和ios的不一样">坑11:  推送消息处理。安卓和iOS的不一样</a></li>
      <li><a href="#坑12--app-的极光sdk有生产环境和测试环境后台接口也有生产环境和测试环境" id="markdown-toc-坑12--app-的极光sdk有生产环境和测试环境后台接口也有生产环境和测试环境">坑12:  APP 的极光SDK有生产环境和测试环境，后台接口也有生产环境和测试环境</a></li>
      <li><a href="#坑13--一定需要后台出一个测试推送的接口不然不好及时触发推送调试" id="markdown-toc-坑13--一定需要后台出一个测试推送的接口不然不好及时触发推送调试">坑13:  一定需要后台出一个测试推送的接口。不然不好及时触发推送调试。</a></li>
      <li><a href="#坑14--厂商消息分类完成后才可以针对目前配置好的厂商做下推送测试" id="markdown-toc-坑14--厂商消息分类完成后才可以针对目前配置好的厂商做下推送测试">坑14:  厂商消息分类完成后，才可以针对目前配置好的厂商做下推送测试</a></li>
      <li><a href="#坑15--需要和后台约定每次app登录后需要把得到的极光registration_id存到用户表" id="markdown-toc-坑15--需要和后台约定每次app登录后需要把得到的极光registration_id存到用户表">坑15:  需要和后台约定，每次APP登录后，需要把得到的极光<code class="language-plaintext highlighter-rouge">registration_id</code>存到用户表。</a></li>
      <li><a href="#坑16--buildgradle-中的各厂商sdk的版本号码需要和jpush_flutter-对应一致" id="markdown-toc-坑16--buildgradle-中的各厂商sdk的版本号码需要和jpush_flutter-对应一致">坑16:  build.gradle 中的各厂商SDK的版本号码需要和jpush_flutter 对应一致。</a></li>
      <li><a href="#坑17--小米-错误码27001channel相关信息不匹配" id="markdown-toc-坑17--小米-错误码27001channel相关信息不匹配">坑17:  小米 错误码:27001–channel相关信息不匹配</a></li>
      <li><a href="#坑18--小米需要在-androidmanifest-的-application标签下添加配置" id="markdown-toc-坑18--小米需要在-androidmanifest-的-application标签下添加配置">坑18:  小米需要在 AndroidManifest 的 <code class="language-plaintext highlighter-rouge">application</code>标签下添加配置</a></li>
      <li><a href="#坑19--荣耀需要在-androidmanifest-的-application标签下添加配置" id="markdown-toc-坑19--荣耀需要在-androidmanifest-的-application标签下添加配置">坑19:  荣耀需要在 AndroidManifest 的 <code class="language-plaintext highlighter-rouge">application</code>标签下添加配置</a></li>
      <li><a href="#坑20--华为收到离线推送点击拉起app报错" id="markdown-toc-坑20--华为收到离线推送点击拉起app报错">坑20:  华为收到离线推送，点击拉起APP报错</a></li>
      <li><a href="#坑21-桌面logo角标设置" id="markdown-toc-坑21-桌面logo角标设置">坑21: 桌面logo角标设置</a></li>
      <li><a href="#坑22--小米角标-无效需要人工开启才生效" id="markdown-toc-坑22--小米角标-无效需要人工开启才生效">坑22:  小米角标 无效。需要人工开启才生效。</a></li>
    </ul>
  </li>
</ul>
<hr />
<h2 id="0x000-背景">0x000 背景</h2>
<p>最近<code class="language-plaintext highlighter-rouge">flutter</code>项目需要接入极光推送。接入过程中是艰难险阻一大堆。极光官网的文档都是<code class="language-plaintext highlighter-rouge">Android</code> 和 <code class="language-plaintext highlighter-rouge">iOS</code> 原生接入的文档。对于<code class="language-plaintext highlighter-rouge">flutter</code>的朋友接入太过艰难。官网勉强出了<a href="https://pub.dev/packages/jpush_flutter">jpush_flutter: ^3.2.7</a>。但是文档也是草草敷衍。里面的<code class="language-plaintext highlighter-rouge">issues</code>一大堆，官方不管。<br />
<img src="https://yfmingo.oss-cn-beijing.aliyuncs.com/images/202505281030385.png" alt="官方issues" /> <br />
遂经历艰难险阻后，故写这篇文章，以方便后续自己和其他的网友避坑。</p>

<h2 id="0x001-接入前期准备">0x001 接入前期准备。</h2>
<p><strong>有些接入基础前期准备，就不过多细嗦了。一笔带过。</strong></p>
<ul>
  <li>极光平台 创建安卓和<code class="language-plaintext highlighter-rouge">iOS</code>应用 得到<code class="language-plaintext highlighter-rouge">AppKey</code>和 <code class="language-plaintext highlighter-rouge">Master Secret</code></li>
  <li>申请各家安卓厂商的推送 <code class="language-plaintext highlighter-rouge">key</code>。每家的<code class="language-plaintext highlighter-rouge">key</code>不同，
    <ul>
      <li>
        <p>可参考极光文档申请：<a href="https://docs.jiguang.cn/jpush/client/Android/android_3rd_param">https://docs.jiguang.cn/jpush/client/Android/android_3rd_param</a><br />
  申请后填入极光后台下图：<br />
  <img src="https://yfmingo.oss-cn-beijing.aliyuncs.com/images/202505281037867.png" alt="" /></p>
      </li>
      <li>
        <p><strong>【注意坑】大多需要APP已经上线他们家的应用商店才能申请推送key</strong><br />
部分厂商要求必须上架应用市场才可以正常使用推送服务，详情参考下表：</p>

        <table>
 <thead>
 <tr>
 <th style="text-align:left">厂商通道</th>
 <th style="text-align:left">是否需要上架</th>
 <th style="text-align:left">说明</th>
 </tr>
 </thead>
 <tbody><tr>
 <td style="text-align:left">小米</td>
 <td style="text-align:left"><strong>是</strong></td>
 <td style="text-align:left">需要注册企业开发者账号，详见 <a href="/jpush/client/Android/android_3rd_param#%E5%B0%8F%E7%B1%B3%E5%8F%82%E6%95%B0%E8%8E%B7%E5%8F%96">小米参数获取</a>。</td>
 </tr>
 <tr>
 <td style="text-align:left">华为</td>
 <td style="text-align:left">否</td>
 <td style="text-align:left">个人开发者账号即可，详见 <a href="/jpush/client/Android/android_3rd_param#%E5%8D%8E%E4%B8%BA%E5%8F%82%E6%95%B0%E8%8E%B7%E5%8F%96">华为参数获取</a>。</td>
 </tr>
 <tr>
 <td style="text-align:left">魅族</td>
 <td style="text-align:left">否</td>
 <td style="text-align:left">个人开发者账号即可，详见 <a href="/jpush/client/Android/android_3rd_param#%E9%AD%85%E6%97%8F%E5%8F%82%E6%95%B0%E8%8E%B7%E5%8F%96">魅族参数获取</a>。</td>
 </tr>
 <tr>
 <td style="text-align:left">vivo</td>
 <td style="text-align:left"><strong>是</strong></td>
 <td style="text-align:left">需要注册企业开发者账号，详见 <a href="/jpush/client/Android/android_3rd_param#vivo-%E5%8F%82%E6%95%B0%E8%8E%B7%E5%8F%96">vivo 参数获取</a>。</td>
 </tr>
 <tr>
 <td style="text-align:left">OPPO</td>
 <td style="text-align:left"><strong>是</strong></td>
 <td style="text-align:left">需要注册企业开发者账号，详见 <a href="/jpush/client/Android/android_3rd_param#oppo-%E5%8F%82%E6%95%B0%E8%8E%B7%E5%8F%96">OPPO 参数获取</a>。</td>
 </tr>
 <tr>
 <td style="text-align:left">FCM</td>
 <td style="text-align:left">否</td>
 <td style="text-align:left">个人开发者账号即可，详见 <a href="/jpush/client/Android/android_3rd_param#fcm-%E5%8F%82%E6%95%B0%E8%8E%B7%E5%8F%96">FCM 参数获取</a>。</td>
 </tr>
 <tr>
 <td style="text-align:left">荣耀</td>
 <td style="text-align:left">否</td>
 <td style="text-align:left">需要注册企业开发者账号，详见 <a href="/jpush/client/Android/android_3rd_param#%E8%8D%A3%E8%80%80%E5%8F%82%E6%95%B0%E8%8E%B7%E5%8F%96">荣耀参数获取</a>。</td>
 </tr>
 </tbody></table>
      </li>
    </ul>
  </li>
  <li>在<a href="https://docs.jiguang.cn/jpush/client/Android/android_3rd_guide#vivo-%25E9%2580%259A%25E9%2581%2593%25E9%259B%2586%25E6%2588%2590%25E6%258C%2587%25E5%258D%2597">极光厂商接入文档</a>下载极光原生SDk备用，当前是5.7.0版本<br />
 <img src="https://yfmingo.oss-cn-beijing.aliyuncs.com/images/202505281419604.png" alt="" /></li>
</ul>

<h2 id="0x002-接入代码">0x002 接入代码</h2>
<h3 id="安卓代码">安卓代码</h3>
<ul>
  <li>在<code class="language-plaintext highlighter-rouge">flutter</code> 项目先集成 <a href="https://pub.dev/packages/jpush_flutter">jpush_flutter: ^3.2.7</a>。执行 <code class="language-plaintext highlighter-rouge">flutter pub get</code></li>
  <li>在<code class="language-plaintext highlighter-rouge">App</code>下的<code class="language-plaintext highlighter-rouge">build.gradle</code>中添加上面获取的各个厂商<code class="language-plaintext highlighter-rouge">key</code>
    <ul>
      <li>红框的不需要我忘记删除了，绿框的就刚刚下载备用的原生SDK的example中demo中的<code class="language-plaintext highlighter-rouge">libs</code>下的<br />
  <img src="https://yfmingo.oss-cn-beijing.aliyuncs.com/images/202505281616506.png" alt="" /></li>
    </ul>
  </li>
  <li>还有<code class="language-plaintext highlighter-rouge"> id "com.huawei.agconnect"</code>。
    <ul>
      <li>一些老的资料可能会是<code class="language-plaintext highlighter-rouge">apply plugin: 'com.huawei.agconnect' </code>这个在高版本<code class="language-plaintext highlighter-rouge">gradle</code>过时了会报错。<br />
  <img src="https://yfmingo.oss-cn-beijing.aliyuncs.com/images/202505281428323.png" alt="" /></li>
    </ul>
  </li>
</ul>

<h3 id="app下的buildgradle中dependencies"><code class="language-plaintext highlighter-rouge">App</code>下的<code class="language-plaintext highlighter-rouge">build.gradle</code>中<code class="language-plaintext highlighter-rouge">dependencies</code></h3>
<div class="language-gradle highlighter-rouge"><div class="highlight"><pre class="highlight"><code> <span class="k">dependencies</span> <span class="o">{</span>
    <span class="n">implementation</span> <span class="nf">fileTree</span><span class="o">(</span><span class="nl">include:</span> <span class="o">[</span><span class="s1">'*.jar'</span><span class="o">,</span><span class="s2">"*.aar"</span><span class="o">],</span> <span class="nl">dir:</span> <span class="s1">'libs'</span><span class="o">)</span>
<span class="c1">//    implementation(name: 'HiPushSdk-v8.0.12.307', ext: 'aar')</span>
    <span class="c1">// only for demo</span>
    <span class="n">implementation</span> <span class="s1">'androidx.appcompat:appcompat:1.2.0'</span>
    <span class="n">implementation</span> <span class="s1">'androidx.constraintlayout:constraintlayout:2.0.1'</span>
    <span class="n">implementation</span> <span class="s1">'com.google.android.material:material:1.2.1'</span>
    <span class="n">implementation</span> <span class="s1">'org.conscrypt:conscrypt-android:2.2.1'</span>
    <span class="n">implementation</span> <span class="s1">'androidx.multidex:multidex:2.0.1'</span>
    <span class="n">implementation</span> <span class="s1">'com.hjq:toast:8.8'</span>
    <span class="n">implementation</span> <span class="s1">'com.github.CymChad:BaseRecyclerViewAdapterHelper:3.0.4'</span>
    <span class="n">implementation</span> <span class="s1">'com.tencent:mmkv-static:1.2.4'</span>
    
    <span class="n">coreLibraryDesugaring</span> <span class="s1">'com.android.tools:desugar_jdk_libs:2.1.4'</span>
    <span class="n">implementation</span> <span class="s1">'androidx.localbroadcastmanager:localbroadcastmanager:1.1.0'</span>
    <span class="n">implementation</span> <span class="s1">'cn.jiguang.sdk:jpush:5.7.0'</span>
    <span class="n">implementation</span> <span class="s1">'cn.jiguang.sdk:jcore:4.9.1'</span>
    
    <span class="n">implementation</span> <span class="s1">'com.huawei.hms:push:6.12.0.300'</span>  <span class="c1">// 华为 HMS Push SDK</span>
    <span class="n">implementation</span> <span class="s1">'cn.jiguang.sdk.plugin:huawei:5.7.0'</span>  <span class="c1">// 极光华为通道插件</span>
    <span class="n">implementation</span> <span class="s1">'com.huawei.agconnect:agconnect-core:1.8.0.300'</span> <span class="c1">// 核心库</span>
    
    
    <span class="n">implementation</span> <span class="s1">'cn.jiguang.sdk.plugin:xiaomi:5.7.0'</span>
    <span class="n">implementation</span> <span class="s1">'cn.jiguang.sdk.plugin:oppo:5.7.0'</span>
    <span class="n">implementation</span> <span class="s1">'cn.jiguang.sdk.plugin:vivo:5.7.0'</span>
    <span class="n">implementation</span> <span class="s1">'cn.jiguang.sdk.plugin:honor:5.7.0'</span>
    <span class="c1">//厂商版本和 JPush SDK 版本保持一致</span>
<span class="c1">//    implementation 'cn.jiguang.sdk.plugin:huawei:5.7.0'</span>
    
    <span class="n">implementation</span> <span class="s1">'com.google.code.gson:gson:2.6.2'</span>
    <span class="n">implementation</span> <span class="s1">'commons-codec:commons-codec:1.6'</span>
    <span class="n">implementation</span> <span class="s1">'androidx.annotation:annotation:1.1.0'</span>
<span class="o">}</span>
</code></pre></div></div>

<h3 id="android下buildgradle的dependencies"><code class="language-plaintext highlighter-rouge">android</code>下<code class="language-plaintext highlighter-rouge">build.gradle</code>的<code class="language-plaintext highlighter-rouge">dependencies</code></h3>

<div class="language-plaintext highlighter-rouge"><div class="highlight"><pre class="highlight"><code> buildscript {
    ext.kotlin_version = '1.9.24'
    repositories {
        google()
        mavenCentral()
        maven {url 'https://developer.huawei.com/repo/'}
        maven {url 'https://developer.hihonor.com/repo'}
        maven { url 'https://maven.aliyun.com/repository/google' }
        maven { url 'https://maven.aliyun.com/repository/jcenter' }
        maven { url 'https://maven.aliyun.com/repository/public' }
    }
    
    dependencies {
        classpath 'com.android.tools.build:gradle:8.8.0'
        classpath 'com.huawei.agconnect:agcp:1.9.1.301' // 确保版本与 HMS SDK 兼容
    
//        classpath 'com.google.gms:google-services:4.3.14'
//        classpath 'com.huawei.agconnect:agcp:1.6.0.300'
//        classpath 'com.hihonor.mcs:asplugin:2.0.1.300'
    }
}  
allprojects {
    repositories {
//        google()
//        mavenCentral()
//        maven {url 'https://developer.huawei.com/repo/'}
//        maven {url 'https://developer.hihonor.com/repo'}
        mavenCentral()
//        maven { url "https://mirrors.tencent.com/nexus/repository/maven-public/" }
        // 配置HMS Core SDK的Maven仓地址。
        maven {url 'https://developer.huawei.com/repo/'}
        maven {url 'https://developer.hihonor.com/repo'}
        maven { url 'https://maven.aliyun.com/repository/google' }
        maven { url 'https://maven.aliyun.com/repository/jcenter' }
        maven { url 'https://maven.aliyun.com/repository/public' }
        maven { url "https://maven.jiguang.cn/repository/public" }
    }
}
// This is updated Code .
 rootProject.buildDir = "../build"
    
subprojects {
    afterEvaluate {
        if (it.hasProperty('android')) {
            it.android.compileSdkVersion = 35
            it.android.defaultConfig.targetSdkVersion = 35
            it.android.compileOptions.sourceCompatibility = JavaVersion.VERSION_21
            it.android.compileOptions.targetCompatibility = JavaVersion.VERSION_21
            tasks.withType(org.jetbrains.kotlin.gradle.tasks.KotlinCompile).configureEach {
                kotlinOptions.jvmTarget = JavaVersion.VERSION_21
            }
            if (it.android.namespace == null) {
                def manifest = new XmlSlurper().parse(file(it.android.sourceSets.main.manifest.srcFile))
                def packageName = manifest.@package.text()
                android.namespace = packageName
                println("Updating namespace ${packageName}")
            }
        }
    }
    project.buildDir = "${rootProject.buildDir}/${project.name}"
}
    
tasks.register("clean", Delete) {
    delete rootProject.buildDir
}    
</code></pre></div></div>

<ul>
  <li>还有华为和荣耀的<code class="language-plaintext highlighter-rouge">services.json</code>离线文件，都放在 <code class="language-plaintext highlighter-rouge">res</code>同级目录</li>
  <li>
    <p>混淆<code class="language-plaintext highlighter-rouge">proguard-rules.pro</code>按照<a href="https://docs.jiguang.cn/jpush/client/Android/android_3rd_guide">极光厂商配置代码混淆的文档</a>进行配置。</p>

    <p><img src="https://yfmingo.oss-cn-beijing.aliyuncs.com/images/202505281436491.png" alt="" /></p>
  </li>
</ul>

<h2 id="flutter-端的推送代码">flutter 端的推送代码</h2>

<ul>
  <li>以下<code class="language-plaintext highlighter-rouge">AppKey.appKeyJPush</code>就是极光申请的key。</li>
  <li>有个文件<code class="language-plaintext highlighter-rouge">app_export.dart</code>，<code class="language-plaintext highlighter-rouge">im_talk.dart</code>，<code class="language-plaintext highlighter-rouge">im_chat_page.dart</code>，<code class="language-plaintext highlighter-rouge">im_socket.dart</code>，<code class="language-plaintext highlighter-rouge">kit_view.dart</code>,<code class="language-plaintext highlighter-rouge">ImSocket</code>都是我的业务文件。你复制过去报错删除即可。</li>
</ul>

<div class="language-dart highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="c1">// 接入文档 https://github.com/jpush/jpush-flutter-plugin</span>
<span class="c1">// https://github.com/jpush/jpush-flutter-plugin/blob/master/documents/APIs.md</span>
<span class="c1">// 各厂商集成参考 https://docs.jiguang.cn/jpush/client/Android/android_3rd_guide</span>
<span class="c1">// import 'package:jpush_flutter/jpush_flutter.dart';</span>
    
<span class="kn">import</span> <span class="s">'dart:developer'</span><span class="o">;</span>
<span class="kn">import</span> <span class="s">'package:app/core/app_export.dart'</span><span class="o">;</span>
<span class="kn">import</span> <span class="s">'package:app/models/im/im_talk.dart'</span><span class="o">;</span>
<span class="kn">import</span> <span class="s">'package:app/pages/im/im_chat_page.dart'</span><span class="o">;</span>
<span class="kn">import</span> <span class="s">'package:app/pages/im/im_socket.dart'</span><span class="o">;</span>
<span class="kn">import</span> <span class="s">'package:app/widgets/kit_view.dart'</span><span class="o">;</span>
<span class="kn">import</span> <span class="s">'package:jpush_flutter/android_ios/jpush_flutter_a_i.dart'</span><span class="o">;</span>
<span class="kn">import</span> <span class="s">'package:jpush_flutter/jpush_interface.dart'</span><span class="o">;</span>
<span class="kn">import</span> <span class="s">'../core/app_key.dart'</span><span class="o">;</span>
    
<span class="kd">class</span> <span class="nc">AppPush</span> <span class="p">{</span>
  <span class="kd">static</span> <span class="n">AppPush</span><span class="o">?</span> <span class="n">_instance</span><span class="p">;</span>
  <span class="n">AppPush</span><span class="o">.</span><span class="na">_internal</span><span class="p">()</span> <span class="p">{</span>
    <span class="n">_instance</span> <span class="o">=</span> <span class="k">this</span><span class="p">;</span>
    <span class="n">jpush</span> <span class="o">=</span>  <span class="n">JPush_A_I</span><span class="p">();</span>
  <span class="p">}</span>
  <span class="kd">factory</span> <span class="n">AppPush</span><span class="p">()</span> <span class="o">=</span><span class="p">&gt;</span> <span class="n">_instance</span> <span class="o">??</span> <span class="n">AppPush</span><span class="o">.</span><span class="na">_internal</span><span class="p">();</span>   <span class="c1">///判空符??</span>
    
  <span class="kd">late</span> <span class="n">JPush_A_I</span> <span class="n">jpush</span><span class="p">;</span>
    
  <span class="n">Future</span><span class="p">&lt;</span><span class="kt">void</span><span class="p">&gt;</span> <span class="n">init</span><span class="p">()</span> <span class="kd">async</span> <span class="p">{</span>
    <span class="n">logs</span><span class="p">(</span><span class="s">'---dao.token--</span><span class="si">${dao.token}</span><span class="s">'</span><span class="p">);</span>
    <span class="c1">// if (dao.token.isEmpty) return;</span>
    <span class="c1">// 之前提审因为极光被拒，就操作提审日之后延迟5天才初始化极光。现在不需要了</span>
    <span class="c1">// var t1 = DateTime.tryParse(Env.time);</span>
    <span class="c1">// logs('---t1--$t1');</span>
    <span class="c1">// var t2 = DateTime.now();</span>
    <span class="c1">// if(t1 != null) {</span>
    <span class="c1">//   if(t2.difference(t1).inDays &lt;= 5) {</span>
    <span class="c1">//     return;</span>
    <span class="c1">//   }</span>
    <span class="c1">// }</span>
    
    <span class="n">jpush</span><span class="o">.</span><span class="na">addEventHandler</span><span class="p">(</span>
      <span class="c1">// 接收通知回调方法。</span>
      <span class="nl">onReceiveNotification:</span> <span class="p">(</span><span class="kt">Map</span><span class="p">&lt;</span><span class="kt">String</span><span class="p">,</span> <span class="kd">dynamic</span><span class="p">&gt;</span> <span class="n">message</span><span class="p">)</span> <span class="kd">async</span> <span class="p">{</span>
        <span class="c1">// logs("----jpush-onReceiveNotification: $message");</span>
        <span class="n">logs</span><span class="p">(</span><span class="s">'--jsonDecode--:</span><span class="si">${jsonEncode(message)}</span><span class="s">'</span><span class="p">);</span>
      <span class="p">},</span>
    
      <span class="c1">// onConnected: (Map&lt;String, dynamic&gt; message) async {</span>
      <span class="c1">//   logs("----jpush-onConnected: $message");</span>
      <span class="c1">// },</span>
      <span class="c1">// onReceiveNotificationAuthorization: (Map&lt;String, dynamic&gt; message) async {</span>
      <span class="c1">//   logs("----jpush-onReceiveNotificationAuthorization: $message");</span>
      <span class="c1">// },</span>
      <span class="c1">// onInAppMessageShow: (Map&lt;String, dynamic&gt; message) async {</span>
      <span class="c1">//   logs("----jpush-onInAppMessageShow: $message");</span>
      <span class="c1">// },</span>
      <span class="c1">// onNotifyMessageUnShow: (Map&lt;String, dynamic&gt; message) async {</span>
      <span class="c1">//   logs("----jpush-onNotifyMessageUnShow: $message");</span>
      <span class="c1">// },</span>
      <span class="c1">// 点击通知回调方法。</span>
      <span class="nl">onOpenNotification:</span> <span class="p">(</span><span class="kt">Map</span><span class="p">&lt;</span><span class="kt">String</span><span class="p">,</span> <span class="kd">dynamic</span><span class="p">&gt;</span> <span class="n">message</span><span class="p">)</span> <span class="kd">async</span> <span class="p">{</span>
        <span class="c1">//     {alert: 推送内容2, extras: {cn.jpush.android.ALERT_TYPE: 7, cn.jpush.android.NOTIFICATION_ID: 518325105, cn.jpush.android.MSG_ID: 18100827735900274, cn.jpush.android.ALERT: 推送内容2, cn.jpush.android.EXTRA: {"route_path":"\/problems"}}, title: 推送标题2}</span>
        <span class="n">logs</span><span class="p">(</span><span class="s">'----jpush-onOpenNotification-:</span><span class="si">$message</span><span class="s">'</span><span class="p">);</span>
        <span class="n">jpush</span><span class="o">.</span><span class="na">setBadge</span><span class="p">(</span><span class="mi">0</span><span class="p">);</span>
        <span class="n">Future</span><span class="o">.</span><span class="na">delayed</span><span class="p">(</span><span class="n">Duration</span><span class="p">(</span><span class="nl">milliseconds:</span> <span class="mi">1000</span><span class="p">),(){</span>
          <span class="n">_do_message</span><span class="p">(</span><span class="n">message</span><span class="p">);</span>
        <span class="p">});</span>
      <span class="p">},</span>
      <span class="c1">// 接收自定义消息回调方法。</span>
      <span class="nl">onReceiveMessage:</span> <span class="p">(</span><span class="kt">Map</span><span class="p">&lt;</span><span class="kt">String</span><span class="p">,</span> <span class="kd">dynamic</span><span class="p">&gt;</span> <span class="n">message</span><span class="p">)</span> <span class="kd">async</span> <span class="p">{</span>
        <span class="n">logs</span><span class="p">(</span><span class="s">"----jpush-onReceiveMessage: </span><span class="si">$message</span><span class="s">"</span><span class="p">);</span>
      <span class="p">},</span>
    <span class="p">);</span>
    <span class="c1">// jpush.setup(appKey: AppKey.appKeyJPush, channel: Env.channel, production: Env.indexUrl == 0, debug: isDebug,);</span>
    <span class="n">jpush</span><span class="o">.</span><span class="na">setup</span><span class="p">(</span><span class="nl">appKey:</span> <span class="n">AppKey</span><span class="o">.</span><span class="na">appKeyJPush</span><span class="p">,</span> <span class="nl">channel:</span> <span class="s">''</span><span class="p">,</span> <span class="nl">production:</span> <span class="kc">true</span><span class="p">,</span> <span class="nl">debug:</span> <span class="kc">true</span><span class="p">,);</span>
    <span class="n">jpush</span><span class="o">.</span><span class="na">applyPushAuthority</span><span class="p">(</span><span class="kd">const</span> <span class="n">NotificationSettingsIOS</span><span class="p">(</span><span class="nl">sound:</span> <span class="kc">true</span><span class="p">,</span> <span class="nl">alert:</span> <span class="kc">true</span><span class="p">,</span> <span class="nl">badge:</span> <span class="kc">true</span><span class="p">));</span>
    <span class="n">jpush</span><span class="o">.</span><span class="na">setAuth</span><span class="p">(</span><span class="nl">enable:</span> <span class="kc">true</span><span class="p">);</span>
    <span class="k">if</span><span class="p">(</span><span class="n">user</span><span class="o">.</span><span class="na">info</span><span class="o">.</span><span class="na">mobile</span><span class="o">.</span><span class="na">isNotEmpty</span><span class="p">)</span> <span class="n">jpush</span><span class="o">.</span><span class="na">setAlias</span><span class="p">(</span><span class="n">user</span><span class="o">.</span><span class="na">info</span><span class="o">.</span><span class="na">mobile</span><span class="p">);</span>
    <span class="n">jpush</span><span class="o">.</span><span class="na">getRegistrationID</span><span class="p">()</span><span class="o">.</span><span class="na">then</span><span class="p">((</span><span class="n">rid</span><span class="p">)</span> <span class="p">{</span>
      <span class="n">AppRun</span><span class="p">()</span><span class="o">.</span><span class="na">registration_id</span> <span class="o">=</span> <span class="n">rid</span><span class="p">;</span>
      <span class="n">log</span><span class="p">(</span><span class="s">'---registration_id--</span><span class="si">$rid</span><span class="s">'</span><span class="p">);</span>
    <span class="p">});</span>
    <span class="n">jpush</span><span class="o">.</span><span class="na">isNotificationEnabled</span><span class="p">()</span><span class="o">.</span><span class="na">then</span><span class="p">((</span><span class="kt">bool</span> <span class="n">value</span><span class="p">)</span> <span class="p">{</span>
      <span class="n">print</span><span class="p">(</span><span class="s">"通知授权是否打开: </span><span class="si">$value</span><span class="s">"</span><span class="p">);</span>
      <span class="k">if</span> <span class="p">(</span><span class="o">!</span><span class="n">value</span><span class="p">)</span> <span class="p">{</span>
        <span class="n">Get</span><span class="o">.</span><span class="na">snackbar</span><span class="p">(</span>
          <span class="s">"提示"</span><span class="p">,</span>
          <span class="s">"没有通知权限,点击跳转打开通知设置界面"</span><span class="p">,</span>
          <span class="nl">duration:</span> <span class="kd">const</span> <span class="n">Duration</span><span class="p">(</span><span class="nl">seconds:</span> <span class="mi">6</span><span class="p">),</span>
          <span class="nl">onTap:</span> <span class="p">(</span><span class="n">_</span><span class="p">)</span> <span class="p">{</span>
            <span class="n">jpush</span><span class="o">.</span><span class="na">openSettingsForNotification</span><span class="p">();</span>
          <span class="p">},</span>
        <span class="p">);</span>
      <span class="p">}</span>
    <span class="p">})</span><span class="o">.</span><span class="na">catchError</span><span class="p">((</span><span class="n">onError</span><span class="p">)</span> <span class="p">{</span>
      <span class="n">print</span><span class="p">(</span><span class="s">"通知授权是否打开: </span><span class="si">${
          onError.toString()}</span><span class="s">"</span><span class="p">);</span>
    <span class="p">});</span>
    <span class="n">jpush</span><span class="o">.</span><span class="na">enableAutoWakeup</span><span class="p">(</span><span class="nl">enable:</span> <span class="kc">true</span><span class="p">);</span>
    <span class="k">if</span><span class="p">(</span><span class="n">isAndroid</span><span class="p">)</span> <span class="n">jpush</span><span class="o">.</span><span class="na">setWakeEnable</span><span class="p">(</span><span class="nl">enable:</span> <span class="kc">false</span><span class="p">);</span>
  <span class="p">}</span>
    
  <span class="n">Future</span><span class="p">&lt;</span><span class="kt">void</span><span class="p">&gt;</span> <span class="n">_do_message</span><span class="p">(</span><span class="kt">Map</span><span class="p">&lt;</span><span class="kt">String</span><span class="p">,</span> <span class="kd">dynamic</span><span class="p">&gt;</span> <span class="n">message</span><span class="p">)</span> <span class="kd">async</span> <span class="p">{</span>
    <span class="c1">// 业务字段都在 extras下的cn.jpush.android.EXTRA 中。</span>
    <span class="kd">var</span>  <span class="n">msg</span> <span class="p">;</span>
    <span class="k">if</span> <span class="p">(</span><span class="n">isAndroid</span><span class="p">)</span> <span class="n">msg</span> <span class="o">=</span> <span class="n">message</span><span class="p">[</span><span class="s">'extras'</span><span class="p">][</span><span class="s">'cn.jpush.android.EXTRA'</span><span class="p">];</span>
    <span class="k">if</span> <span class="p">(</span><span class="n">isIOS</span><span class="p">)</span>  <span class="n">msg</span> <span class="o">=</span> <span class="n">message</span><span class="p">[</span><span class="s">'extras'</span><span class="p">];</span>
    <span class="n">logs</span><span class="p">(</span><span class="s">'--map-msg-:</span><span class="si">${jsonEncode(msg)}</span><span class="s">'</span><span class="p">);</span>
    
    <span class="n">ImTalkItems</span> <span class="n">mo</span> <span class="o">=</span> <span class="n">ImTalkItems</span><span class="o">.</span><span class="na">fromJson</span><span class="p">(</span><span class="kt">Map</span><span class="p">&lt;</span><span class="kt">String</span><span class="p">,</span> <span class="kd">dynamic</span><span class="p">&gt;</span><span class="o">.</span><span class="na">from</span><span class="p">(</span><span class="n">msg</span><span class="p">));</span>
  <span class="p">}</span>
<span class="p">}</span>

</code></pre></div></div>

<ul>
  <li>
    <p>一些文档</p>

    <p><a href="https://github.com/jpush/jpush-flutter-plugin">https://github.com/jpush/jpush-flutter-plugin</a><br />
  <a href="https://github.com/jpush/jpush-flutter-plugin/blob/master/documents/APIs.md">https://github.com/jpush/jpush-flutter-plugin/blob/master/documents/APIs.md</a></p>

    <p><a href="https://docs.jiguang.cn/jpush/client/Android/android_3rd_guide">各厂商集成参考 </a></p>
  </li>
</ul>

<h2 id="0x003-试运行了">0x003 试运行了</h2>

<p>经过上面步骤。可以试运行了。运行后发现在<code class="language-plaintext highlighter-rouge">jpush.getRegistrationID()</code>得到了<code class="language-plaintext highlighter-rouge">registration_id</code>。</p>

<p>没座。<img src="https://yfmingo.oss-cn-beijing.aliyuncs.com/images/202505281506170.png" alt="" /><img src="https://yfmingo.oss-cn-beijing.aliyuncs.com/images/202505281507139.png" alt="" /><br />
 得到的<code class="language-plaintext highlighter-rouge">registration_id</code>就是当前设备的唯一标识。欣喜若狂。去极光后台控制台操作推送。<br />
<img src="https://yfmingo.oss-cn-beijing.aliyuncs.com/images/202505281503144.png" alt="" /><br />
呀呀呀，APP成功收到了消息。激动万分。</p>

<p>然而。<img src="https://yfmingo.oss-cn-beijing.aliyuncs.com/images/202505281510065.png" alt="" /><br />
少年还是太年轻了。缺少社会的鞭打，极光怎么会让你这么容易就搞成呢。发个问题都不叼的人。。<br />
<img src="https://yfmingo.oss-cn-beijing.aliyuncs.com/images/202505281508493.png" alt="" /></p>

<p>这只是第一步。下面开始介绍各种坑了。</p>

<h2 id="0x004-整个过程遇到的坑专辑">0x004 整个过程遇到的坑专辑</h2>

<h3 id="坑1极光的初始化需要在android端完成在dart端完成初始化会在提审的时候被各家安卓拒审">坑1：极光的初始化需要在Android端完成。在Dart端完成初始化会在提审的时候被各家安卓拒审</h3>
<p>原因如下：<a href="https://github.com/jpush/jpush-flutter-plugin/issues/494%0A">https://github.com/jpush/jpush-flutter-plugin/issues/494</a></p>

<p><img src="https://yfmingo.oss-cn-beijing.aliyuncs.com/images/202505281515226.png" alt="" /></p>

<p>我的解决是：在安卓<code class="language-plaintext highlighter-rouge">MainActivity</code>中</p>

<div class="language-plaintext highlighter-rouge"><div class="highlight"><pre class="highlight"><code>``` Kotlin
package com.xxx.app
import android.annotation.TargetApi
import android.app.ActivityManager
import android.graphics.BitmapFactory
import android.graphics.Color
import android.os.Build
import android.os.Bundle
import android.widget.Toast
import cn.jiguang.api.utils.JCollectionAuth
import cn.jpush.android.api.JPushInterface
import app包名.nsp.R
import io.flutter.embedding.android.FlutterActivity
import io.flutter.embedding.engine.FlutterEngine
import io.flutter.plugin.common.MethodChannel
import java.util.Timer
import kotlin.concurrent.schedule
    
class MainActivity: FlutterActivity() {
    private val CHANNEL = "flutter.app.method.plugin"
    
//    lateinit var resultCallback: MethodChannel.Result;
    
    override fun onStart() {
        super.onStart()
    
//        https://github.com/jpush/jpush-flutter-plugin/issues/383
        JCollectionAuth.setAuth(context, false);
    
    }
    
    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
    
        Timer("ChangingTaskDescriptionColor", false).schedule(1000) {
            val taskDescription: ActivityManager.TaskDescription =
                if (Build.VERSION.SDK_INT &gt;= Build.VERSION_CODES.P) {
                    //android 9.0
                    setTaskDescriptionP()
                } else {
                    setTaskDescriptionBeforeP()
                }
            setTaskDescription(taskDescription)
        }
    
    }
    
    override fun configureFlutterEngine(flutterEngine: FlutterEngine) {
        super.configureFlutterEngine(flutterEngine)
        MethodChannel(flutterEngine.dartExecutor.binaryMessenger, CHANNEL).setMethodCallHandler { call, result -&gt;
//            resultCallback = result;
//            resultCallback.success("Android 调用成功")  ;
            if (call.method == "AppMethod") {
//                showToast("Flutter 调用了通道: ${call.arguments as String}")
                System.out.println("channel=1==" + call.arguments.toString())

                JPushInterface.init(this)
                JPushInterface.setDebugMode(false)
                JCollectionAuth.setAuth(context, true)
                result.success("Android ${call.arguments}")
            } else {
                result.notImplemented()
            }
        }
    }
    
    private fun showToast(message: String) {
        Toast.makeText(this, message, Toast.LENGTH_SHORT).show()
    }
    
    // 和推送无关，适配华为提审被拒：APP后台看不见图标和APP名称
    private fun setTaskDescriptionBeforeP(): ActivityManager.TaskDescription {
        val bitmapIcon = BitmapFactory.decodeResource(resources, R.mipmap.ic_launcher)
        return ActivityManager.TaskDescription("APP名称", bitmapIcon, Color.RED)
    }
    
    // 和推送无关，适配华为提审被拒：APP后台看不见图标和APP名称
    @TargetApi(Build.VERSION_CODES.P)
    private fun setTaskDescriptionP(): ActivityManager.TaskDescription {
        return if (Build.VERSION.SDK_INT &gt;= Build.VERSION_CODES.TIRAMISU) {
            ActivityManager.TaskDescription.Builder().setLabel("APP名称")
                .setIcon(R.mipmap.ic_launcher)
                .setPrimaryColor(Color.RED).build()
        } else ActivityManager.TaskDescription("APP名称", R.mipmap.ic_launcher, Color.RED)
    
    }
}
```
</code></pre></div></div>

<p>在<code class="language-plaintext highlighter-rouge">onStart</code>中先<code class="language-plaintext highlighter-rouge">JCollectionAuth.setAuth(context, false);</code>。初始化但不验证。还要写flutter和原生交互方法（不会自己去学）。然后等用户在<code class="language-plaintext highlighter-rouge">APP</code>在<code class="language-plaintext highlighter-rouge">flutter</code> 端用户点击同意隐私协议后，进行和原生安卓交互，回调到原生安卓，重新初始化极光，如上重新初始化核心代码就这三行。在上面整个文件中也有。</p>

<div class="language-plaintext highlighter-rouge"><div class="highlight"><pre class="highlight"><code>JPushInterface.init(this)
JPushInterface.setDebugMode(false)
JCollectionAuth.setAuth(context, true)
</code></pre></div></div>

<p><strong>如果学不会flutter原生交互就看我封装的app_native.dart</strong></p>
<div class="language-dart highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="kn">import</span> <span class="s">'package:app/core/app_export.dart'</span><span class="o">;</span>
<span class="kn">import</span> <span class="s">'package:app/https/env.dart'</span><span class="o">;</span>

<span class="kd">class</span> <span class="nc">AppNative</span><span class="p">{</span>
  <span class="kd">static</span> <span class="kd">const</span> <span class="n">methodChannel</span> <span class="o">=</span> <span class="s">"flutter.app.method.plugin"</span><span class="p">;</span>
  <span class="kd">static</span> <span class="kd">const</span> <span class="n">methodApp</span> <span class="o">=</span> <span class="s">"AppMethod"</span><span class="p">;</span>
  <span class="kd">static</span> <span class="kd">const</span> <span class="n">methodChannelToNative</span> <span class="o">=</span> <span class="n">MethodChannel</span><span class="p">(</span><span class="n">AppNative</span><span class="o">.</span><span class="na">methodChannel</span><span class="p">);</span> <span class="c1">//和App原生对应</span>
  <span class="kd">static</span> <span class="kd">const</span> <span class="n">return_channel</span> <span class="o">=</span> <span class="s">"RETURN_CHANNEL"</span><span class="p">;</span> <span class="c1">//和安卓原生对应</span>

  <span class="c1">// 实现监听 安卓原生那边 传过来的值</span>
  <span class="kd">static</span> <span class="n">Future</span><span class="p">&lt;</span><span class="kd">dynamic</span><span class="p">&gt;</span> <span class="n">platformCallHandler</span><span class="p">(</span><span class="n">MethodCall</span> <span class="n">call</span><span class="p">)</span> <span class="kd">async</span> <span class="p">{</span>

    <span class="k">switch</span> <span class="p">(</span><span class="n">call</span><span class="o">.</span><span class="na">method</span><span class="p">)</span> <span class="p">{</span>
      <span class="k">case</span> <span class="n">AppNative</span><span class="o">.</span><span class="na">return_channel</span><span class="o">:</span>
        <span class="kd">var</span> <span class="n">realest</span> <span class="o">=</span> <span class="n">call</span><span class="o">.</span><span class="na">arguments</span><span class="p">;</span><span class="c1">//获取安卓穿过来的值</span>
        <span class="k">break</span><span class="p">;</span>
    <span class="p">}</span>
  <span class="p">}</span>

  <span class="c1">// 异步方法</span>
  <span class="kd">static</span> <span class="n">Future</span><span class="p">&lt;</span><span class="kt">Null</span><span class="p">&gt;</span> <span class="n">sendToNative</span><span class="p">()</span> <span class="kd">async</span><span class="p">{</span>
      <span class="c1">// Map&lt;String,dynamic&gt; map = {"isAgreePrivacy":dao.check,"channel":Env.channel};</span>
    <span class="c1">// 跳转并传递数据</span>
    <span class="kd">var</span> <span class="n">result</span> <span class="o">=</span> <span class="k">await</span> <span class="n">methodChannelToNative</span><span class="o">.</span><span class="na">invokeMethod</span><span class="p">(</span><span class="n">methodApp</span><span class="p">,</span><span class="n">Env</span><span class="o">.</span><span class="na">channel</span><span class="p">);</span>
    <span class="c1">// 打印原生返回的参数</span>
    <span class="n">logs</span><span class="p">(</span><span class="s">'---result--</span><span class="si">$result</span><span class="s">'</span><span class="p">);</span>
    <span class="k">return</span> <span class="kc">null</span><span class="p">;</span>
  <span class="p">}</span>
<span class="p">}</span>
</code></pre></div></div>

<p><code class="language-plaintext highlighter-rouge">sendToNative</code> 在用户点击同意隐私协议后调用。</p>

<h3 id="坑2前面提到的获得了registration_id-仅是集成了极光的fluttersdk没有集成厂商推送通道">坑2：前面提到的获得了registration_id 仅是集成了极光的flutterSDK，没有集成厂商推送通道。</h3>

<ul>
  <li>这个会导致：只有在APP打开的时候才能收到推送。下次冷启动后上次没收到的消息就会过来（默认一天离线等待时间），这是极光通道保存的离线消息过来了。因为没有集成厂商通道，在APP离线的时候不能及时收到推送消息。</li>
</ul>

<h3 id="坑3没有开通极光会员调试排查的机会都没有">坑3：没有开通极光会员。调试排查的机会都没有。</h3>
<p>红框这些都是需要会员才能操作的。记得之前集成原生iOS的时候都是免费使用的。现在飘了不付费都不好调试。<br />
 <img src="https://yfmingo.oss-cn-beijing.aliyuncs.com/images/202505281541679.png" alt="" /><br />
 可以联系极光销售人员，给7天的试用会员接入调试。（建议合理时期申请，在前期各个厂商的key申请好了。而且<a href="https://docs.jiguang.cn/jpush/client/Android/android_channel_id">厂商消息分类</a>完成后，可以申请试用会员针对目前配置好的厂商做下推送测试）</p>

<h3 id="坑4oppo错误码67分类错误包含强提醒所有异常">坑4：OPPO错误码:67–分类错误(包含强提醒所有异常)。</h3>

<p><img src="https://yfmingo.oss-cn-beijing.aliyuncs.com/images/202505281551728.png" alt="" /></p>

<p>解决：可以参考文档看看<br />
<a href="https://go48pg.yuque.com/go48pg/pa41sm/fytwgsthan0o4d0x">https://go48pg.yuque.com/go48pg/pa41sm/fytwgsthan0o4d0x</a><br />
注意：旧通道配置并不表示已经申请消息分类成功，同时还需要发邮件给oppo官方，等待邮件审核通过后并且配置旧通道才表示申请消息分类成功，可以正常使用不受限的服务类消息，服务端需要配置的字段是<code class="language-plaintext highlighter-rouge">channel_id</code>（如果使用的是旧版消息分类，<code class="language-plaintext highlighter-rouge">category</code> 和<code class="language-plaintext highlighter-rouge">notify_level</code> 一定不要配置！！！！），仔细看上面文档解决。</p>

<p>最终审核通过了。我的是IM及时通讯。需要后台推送接口配置如下。最终才能收到离线推送消息。</p>

<div class="language-plaintext highlighter-rouge"><div class="highlight"><pre class="highlight"><code>"oppo": {
    "channel_id": "push_oplus_category_service",
    "category": "IM",
    "notify_level": 2
},
</code></pre></div></div>

<h3 id="坑5无厂商token就是没有集成成功仅集成了极光端没有集成厂商通道不能离线推送消息">坑5：无厂商token:就是没有集成成功。仅集成了极光端，没有集成厂商通道，不能离线推送消息。</h3>

<p><img src="https://yfmingo.oss-cn-beijing.aliyuncs.com/images/202505281554917.png" alt="" /></p>

<ul>
  <li>如图右下角红框也验证了。无厂商<code class="language-plaintext highlighter-rouge">token</code>，下次<code class="language-plaintext highlighter-rouge">APP</code>启动时候得到的消息其实还是极光推送过来的，不是厂商的推送的。</li>
  <li>
    <p>无厂商<code class="language-plaintext highlighter-rouge">token</code>:就是没有集成成功。需要在<a href="https://docs.jiguang.cn/jpush/client/Android/android_3rd_guide">厂商通道集成指南</a>的每个厂商的集成结果判断一直才是集成了厂商通道。</p>
  </li>
  <li>
    <p>如下才是集成厂商通道的标志性打印信息</p>

    <div class="language-plaintext highlighter-rouge"><div class="highlight"><pre class="highlight"><code> 红米测试手机registration_id--100d855908726892cf6
 00:23:31.674 [XMPlatformsReceiver] [key-step]xiao mi push register success
 00:23:31.674 [okhttp] e:java.lang.ClassNotFoundException: com.mediatek.cta.CtaUtils
 00:23:31.675 [ThirdPushManager] uploadRegID regid:8eRWchmNchDDAy2XCKUNVlrhDFB74yPUdOUrc+F7HU6pwJoZa0KV6ghLcAq/ZHbJ
    
  荣耀20pro YAL AL10..是华为推送registration_id--1a0018970b9fbbb998e
 get huawei token:IQAAAACy1K-FAADtvROjjqcxf1fTCqvHiBvTCnraNSt7zzJrPgXJTG5iErmX68Os7u7WvYsiLd7D9XptTUqJCm2pP87x0sw7dj9i2sqQ1O_qUCVi_g
    
 荣耀平板-registration_id--13065ffa4f2bec9adf1
 get honor token success:BAEAAAAAB.jpj3KupmXF2GpUHjdbRQ9x9M7hrEhX2jxzYR2qiGcOk0Q5oIppeEADelcV8e8IzYPd8Yt7qTdsrvosXRQ9grX_4L8-fMqaKnzXVuBjnDBohBZIs7XAtMCk
 uploadRegID regid:BAEAAAAAB.jpj3KupmXF2GpUHjdbRQ9x9M7hrEhX2jxzYR2qiGcOk0Q5oIppeEADelcV8e8IzYPd8Yt7qTdsrvosXRQ9grX_4L8-fMqaKnzXVuBjnDBohBZIs7XAtMCk
    
 iPhone12-registration_id--171976fa8bb960b843e
 ab6f8b13b0b81d8aea79957d61ff36c54280e9a47e970491a795fde0b14b539f
</code></pre></div>    </div>
  </li>
</ul>

<h3 id="坑6集成华为的时候报错907135000">坑6：集成华为的时候报错：907135000</h3>

<div class="language-plaintext highlighter-rouge"><div class="highlight"><pre class="highlight"><code> doExecute, uri:push.gettoken, errorCode:907135000, transactionId:000000000ttoken20250527162637237540687
</code></pre></div></div>

<p><strong>日志报错907135000，参考这个文档排查解决</strong><br />
<a href="https://go48pg.yuque.com/go48pg/pa41sm/cge57f">https://go48pg.yuque.com/go48pg/pa41sm/cge57f</a></p>

<h3 id="坑7然后又-get-huawei-token-error6003-certificate-fingerprint-error">坑7：然后又 get huawei token error:6003: certificate fingerprint error</h3>
<p><strong>《错误码：6003》</strong><br />
 https://go48pg.yuque.com/go48pg/pa41sm/xi17ah?singleDoc#</p>

<h3 id="坑8--mac-无法查看-查看签名的sha256">坑8:  mac 无法查看 查看签名的SHA256</h3>
<p>你在坑7 这一步时候可能不是和文档那样顺利。</p>

<p><img src="https://yfmingo.oss-cn-beijing.aliyuncs.com/images/202505281601517.png" alt="" /><br />
  比如我是这样的：<br />
  <img src="https://yfmingo.oss-cn-beijing.aliyuncs.com/images/202505281602187.png" alt="" /><br />
  看到这样，顿时劳资猫当丁就不想说话了。<br />
  <img src="https://yfmingo.oss-cn-beijing.aliyuncs.com/images/202505281604471.png" alt="" /></p>

<p>接着查资料知道是非<code class="language-plaintext highlighter-rouge">JDK8</code>，高版本的就会这样。于是曲线救国。找到网友封装的<code class="language-plaintext highlighter-rouge">SignaturesUtils.java</code></p>

<div class="language-java highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="kn">package</span> <span class="nn">app</span><span class="n">包名</span><span class="o">;</span>

<span class="kn">import</span> <span class="nn">android.content.Context</span><span class="o">;</span>
<span class="kn">import</span> <span class="nn">android.content.pm.PackageInfo</span><span class="o">;</span>
<span class="kn">import</span> <span class="nn">android.content.pm.PackageManager</span><span class="o">;</span>
<span class="kn">import</span> <span class="nn">android.util.Log</span><span class="o">;</span>

<span class="kn">import</span> <span class="nn">java.security.MessageDigest</span><span class="o">;</span>
<span class="kn">import</span> <span class="nn">java.security.NoSuchAlgorithmException</span><span class="o">;</span>

<span class="kd">public</span> <span class="kd">class</span> <span class="nc">SignaturesUtils</span> <span class="o">{</span>
    <span class="kd">private</span> <span class="kd">static</span> <span class="kd">final</span> <span class="nc">String</span> <span class="no">TAG</span> <span class="o">=</span> <span class="nc">SignaturesUtils</span><span class="o">.</span><span class="na">class</span><span class="o">.</span><span class="na">getSimpleName</span><span class="o">();</span>

    <span class="kd">private</span> <span class="kd">static</span> <span class="kt">byte</span><span class="o">[]</span> <span class="nf">getSignBytes</span><span class="o">(</span><span class="nc">Context</span> <span class="n">context</span><span class="o">)</span> <span class="o">{</span>
        <span class="k">try</span> <span class="o">{</span>
            <span class="nc">PackageManager</span> <span class="n">pm</span> <span class="o">=</span> <span class="n">context</span><span class="o">.</span><span class="na">getPackageManager</span><span class="o">();</span>
            <span class="nc">PackageInfo</span> <span class="n">packageInfo</span> <span class="o">=</span> <span class="n">pm</span><span class="o">.</span><span class="na">getPackageInfo</span><span class="o">(</span><span class="n">context</span><span class="o">.</span><span class="na">getPackageName</span><span class="o">(),</span> <span class="nc">PackageManager</span><span class="o">.</span><span class="na">GET_SIGNATURES</span><span class="o">);</span>
            <span class="k">return</span> <span class="n">packageInfo</span><span class="o">.</span><span class="na">signatures</span><span class="o">[</span><span class="mi">0</span><span class="o">].</span><span class="na">toByteArray</span><span class="o">();</span>
        <span class="o">}</span> <span class="k">catch</span> <span class="o">(</span><span class="nc">PackageManager</span><span class="o">.</span><span class="na">NameNotFoundException</span> <span class="n">e</span><span class="o">)</span> <span class="o">{</span>
            <span class="n">e</span><span class="o">.</span><span class="na">printStackTrace</span><span class="o">();</span>
        <span class="o">}</span>
        <span class="k">return</span> <span class="kc">null</span><span class="o">;</span>
    <span class="o">}</span>

    <span class="kd">private</span> <span class="kd">static</span> <span class="nc">String</span> <span class="nf">bytesToHex</span><span class="o">(</span><span class="kt">byte</span><span class="o">[]</span> <span class="n">bytes</span><span class="o">)</span> <span class="o">{</span>
        <span class="nc">StringBuilder</span> <span class="n">builder</span> <span class="o">=</span> <span class="k">new</span> <span class="nc">StringBuilder</span><span class="o">();</span>
        <span class="k">for</span> <span class="o">(</span><span class="kt">byte</span> <span class="n">b</span> <span class="o">:</span> <span class="n">bytes</span><span class="o">)</span> <span class="o">{</span>
            <span class="n">builder</span><span class="o">.</span><span class="na">append</span><span class="o">(</span><span class="nc">String</span><span class="o">.</span><span class="na">format</span><span class="o">(</span><span class="s">"%02x"</span><span class="o">,</span> <span class="n">b</span><span class="o">));</span>
        <span class="o">}</span>
        <span class="k">return</span> <span class="n">builder</span><span class="o">.</span><span class="na">toString</span><span class="o">();</span>
    <span class="o">}</span>

    <span class="kd">public</span> <span class="kd">static</span> <span class="nc">String</span> <span class="nf">getMD5</span><span class="o">(</span><span class="nc">Context</span> <span class="n">context</span><span class="o">)</span> <span class="o">{</span>
        <span class="k">try</span> <span class="o">{</span>
            <span class="kt">byte</span><span class="o">[]</span> <span class="n">sig</span> <span class="o">=</span> <span class="n">getSignBytes</span><span class="o">(</span><span class="n">context</span><span class="o">);</span>
            <span class="c1">// MD5</span>
            <span class="nc">MessageDigest</span> <span class="n">md</span> <span class="o">=</span> <span class="nc">MessageDigest</span><span class="o">.</span><span class="na">getInstance</span><span class="o">(</span><span class="s">"MD5"</span><span class="o">);</span>
            <span class="nc">String</span> <span class="n">md5</span> <span class="o">=</span> <span class="n">bytesToHex</span><span class="o">(</span><span class="n">md</span><span class="o">.</span><span class="na">digest</span><span class="o">(</span><span class="n">sig</span><span class="o">));</span>
            <span class="nc">Log</span><span class="o">.</span><span class="na">i</span><span class="o">(</span><span class="no">TAG</span><span class="o">,</span> <span class="s">"getMD5="</span> <span class="o">+</span> <span class="n">md5</span><span class="o">);</span>
            <span class="k">return</span> <span class="n">md5</span><span class="o">;</span>
        <span class="o">}</span> <span class="k">catch</span> <span class="o">(</span><span class="nc">NoSuchAlgorithmException</span> <span class="n">e</span><span class="o">)</span> <span class="o">{</span>
            <span class="n">e</span><span class="o">.</span><span class="na">printStackTrace</span><span class="o">();</span>
        <span class="o">}</span>
        <span class="k">return</span> <span class="kc">null</span><span class="o">;</span>
    <span class="o">}</span>

    <span class="kd">public</span> <span class="kd">static</span> <span class="nc">String</span> <span class="nf">getSHA1</span><span class="o">(</span><span class="nc">Context</span> <span class="n">context</span><span class="o">)</span> <span class="o">{</span>
        <span class="kt">byte</span><span class="o">[]</span> <span class="n">sig</span> <span class="o">=</span> <span class="n">getSignBytes</span><span class="o">(</span><span class="n">context</span><span class="o">);</span>
        <span class="k">try</span> <span class="o">{</span>
            <span class="nc">MessageDigest</span> <span class="n">md</span> <span class="o">=</span> <span class="nc">MessageDigest</span><span class="o">.</span><span class="na">getInstance</span><span class="o">(</span><span class="s">"SHA-1"</span><span class="o">);</span>
            <span class="nc">String</span> <span class="n">sha1</span> <span class="o">=</span> <span class="n">bytesToHex</span><span class="o">(</span><span class="n">md</span><span class="o">.</span><span class="na">digest</span><span class="o">(</span><span class="n">sig</span><span class="o">));</span>
            <span class="nc">Log</span><span class="o">.</span><span class="na">i</span><span class="o">(</span><span class="no">TAG</span><span class="o">,</span> <span class="s">"getSHA1="</span> <span class="o">+</span> <span class="n">sha1</span><span class="o">);</span>
            <span class="k">return</span> <span class="n">sha1</span><span class="o">;</span>
        <span class="o">}</span> <span class="k">catch</span> <span class="o">(</span><span class="nc">NoSuchAlgorithmException</span> <span class="n">e</span><span class="o">)</span> <span class="o">{</span>
            <span class="n">e</span><span class="o">.</span><span class="na">printStackTrace</span><span class="o">();</span>
        <span class="o">}</span>
        <span class="k">return</span> <span class="kc">null</span><span class="o">;</span>
    <span class="o">}</span>

    <span class="kd">public</span> <span class="kd">static</span> <span class="nc">String</span> <span class="nf">getSHA256</span><span class="o">(</span><span class="nc">Context</span> <span class="n">context</span><span class="o">)</span> <span class="o">{</span>
        <span class="kt">byte</span><span class="o">[]</span> <span class="n">sig</span> <span class="o">=</span> <span class="n">getSignBytes</span><span class="o">(</span><span class="n">context</span><span class="o">);</span>
        <span class="k">try</span> <span class="o">{</span>
            <span class="c1">// SHA-256</span>
            <span class="nc">MessageDigest</span> <span class="n">md</span> <span class="o">=</span> <span class="nc">MessageDigest</span><span class="o">.</span><span class="na">getInstance</span><span class="o">(</span><span class="s">"SHA-256"</span><span class="o">);</span>
            <span class="nc">String</span> <span class="n">sha256</span> <span class="o">=</span> <span class="n">bytesToHex</span><span class="o">(</span><span class="n">md</span><span class="o">.</span><span class="na">digest</span><span class="o">(</span><span class="n">sig</span><span class="o">));</span>
            <span class="nc">Log</span><span class="o">.</span><span class="na">i</span><span class="o">(</span><span class="no">TAG</span><span class="o">,</span> <span class="s">"getSHA256="</span> <span class="o">+</span> <span class="n">sha256</span><span class="o">);</span>
            <span class="k">return</span> <span class="n">sha256</span><span class="o">;</span>
        <span class="o">}</span> <span class="k">catch</span> <span class="o">(</span><span class="nc">NoSuchAlgorithmException</span> <span class="n">e</span><span class="o">)</span> <span class="o">{</span>
            <span class="n">e</span><span class="o">.</span><span class="na">printStackTrace</span><span class="o">();</span>
        <span class="o">}</span>
        <span class="k">return</span> <span class="kc">null</span><span class="o">;</span>
    <span class="o">}</span>

<span class="o">}</span>
</code></pre></div></div>

<p>利用如上<code class="language-plaintext highlighter-rouge">getSHA256</code>获取，自己分割冒号，填入华为后台。（其实荣耀后台也要填 这个 SHA256）。最好测试的也填进去。</p>

<p>获取测试环境的<code class="language-plaintext highlighter-rouge">SHA256</code>代码如下，Mac终端测试的咋又是可以获取到。</p>

<div class="language-plaintext highlighter-rouge"><div class="highlight"><pre class="highlight"><code>keytool -list -v -keystore ~/.android/debug.keystore -alias androiddebugkey -storepass android -keypass android
</code></pre></div></div>

<p><strong>特别注意：</strong><br />
<strong>指纹配置成功后大约10分钟左右生效，请您耐心等待。</strong>。这里坑了我配置了无效了质疑自己半天。</p>

<h3 id="坑9--并不是所有荣耀手机都走荣耀推送">坑9:  并不是所有荣耀手机都走荣耀推送。</h3>

<p>这个是荣耀官网所述支持的设备：<a href="https://developer.honor.com/cn/docs/11002/guides/introduction">https://developer.honor.com/cn/docs/11002/guides/introduction</a><br />
  <img src="https://yfmingo.oss-cn-beijing.aliyuncs.com/images/202505281612175.png" alt="" /></p>

<p>我的荣耀20pro，走的是华为推送。</p>

<h3 id="坑10---离线推送消息到了通知栏点击通知栏拉不起来app">坑10:   离线推送，消息到了通知栏，点击通知栏拉不起来APP。</h3>

<div class="language-plaintext highlighter-rouge"><div class="highlight"><pre class="highlight"><code>当安卓端app程序处于后台时，通知收到了，点击通知无法成功把app拉回前台。
杀死APP离线通知可以收到了，点击通知无法成功把app拉起冷启动
</code></pre></div></div>

<p>参考原生配置文档：<br />
<a href="https://docs.jiguang.cn/jpush/practice/intent">https://docs.jiguang.cn/jpush/practice/intent</a><br />
联系后台推送接口配置</p>

<div class="language-plaintext highlighter-rouge"><div class="highlight"><pre class="highlight"><code>"intent": {
    "url": "intent:#Intent;action=android.intent.action.MAIN;end"
},
</code></pre></div></div>

<p><img src="https://yfmingo.oss-cn-beijing.aliyuncs.com/images/202505281632423.png" alt="" /></p>

<h3 id="坑11--推送消息处理安卓和ios的不一样">坑11:  推送消息处理。安卓和iOS的不一样</h3>

<div class="language-dart highlighter-rouge"><div class="highlight"><pre class="highlight"><code>  <span class="c1">// 点击通知回调方法。</span>
<span class="nl">onOpenNotification:</span> <span class="p">(</span><span class="kt">Map</span><span class="p">&lt;</span><span class="kt">String</span><span class="p">,</span> <span class="kd">dynamic</span><span class="p">&gt;</span> <span class="n">message</span><span class="p">)</span> <span class="kd">async</span> <span class="p">{</span>
    <span class="c1">//     {alert: 推送内容2, extras: {cn.jpush.android.ALERT_TYPE: 7, cn.jpush.android.NOTIFICATION_ID: 518325105, cn.jpush.android.MSG_ID: 18100827735900274, cn.jpush.android.ALERT: 推送内容2, cn.jpush.android.EXTRA: {"route_path":"\/problems"}}, title: 推送标题2}</span>
    <span class="n">logs</span><span class="p">(</span><span class="s">'----jpush-onOpenNotification-:</span><span class="si">$message</span><span class="s">'</span><span class="p">);</span>
    <span class="n">jpush</span><span class="o">.</span><span class="na">setBadge</span><span class="p">(</span><span class="mi">0</span><span class="p">);</span>
      <span class="c1">// 业务字段都在 extras下的cn.jpush.android.EXTRA 中。</span>
    <span class="kd">var</span>  <span class="n">msg</span> <span class="p">;</span>
    <span class="k">if</span> <span class="p">(</span><span class="n">isAndroid</span><span class="p">)</span> <span class="n">msg</span> <span class="o">=</span> <span class="n">message</span><span class="p">[</span><span class="s">'extras'</span><span class="p">][</span><span class="s">'cn.jpush.android.EXTRA'</span><span class="p">];</span>
    <span class="k">if</span> <span class="p">(</span><span class="n">isIOS</span><span class="p">)</span>  <span class="n">msg</span> <span class="o">=</span> <span class="n">message</span><span class="p">[</span><span class="s">'extras'</span><span class="p">];</span> 
 <span class="p">},</span>
      
</code></pre></div></div>

<h3 id="坑12--app-的极光sdk有生产环境和测试环境后台接口也有生产环境和测试环境">坑12:  APP 的极光SDK有生产环境和测试环境，后台接口也有生产环境和测试环境</h3>

<p><img src="https://yfmingo.oss-cn-beijing.aliyuncs.com/images/202505281637464.png" alt="" /></p>
<ul>
  <li>两端的环境要一样。之前后台接口都是一直是生产环境调试的。</li>
  <li><code class="language-plaintext highlighter-rouge">iOS</code>是<code class="language-plaintext highlighter-rouge">AppStore</code>的才是生产环境，非<code class="language-plaintext highlighter-rouge">AppStore</code>的就是测试环境。之前跑真机调试（测试环境）接口一直是生产环境，导致推送消息不成功。<br />
 <img src="https://yfmingo.oss-cn-beijing.aliyuncs.com/images/202505291507807.png" alt="" /></li>
</ul>

<h3 id="坑13--一定需要后台出一个测试推送的接口不然不好及时触发推送调试">坑13:  一定需要后台出一个测试推送的接口。不然不好及时触发推送调试。</h3>
<ul>
  <li>推送的测试接口需要返回<code class="language-plaintext highlighter-rouge">msg_id</code>。<code class="language-plaintext highlighter-rouge">msg_id</code>和<code class="language-plaintext highlighter-rouge">registration_id</code>可以在开会员后在极光后台排查问题。</li>
</ul>

<h3 id="坑14--厂商消息分类完成后才可以针对目前配置好的厂商做下推送测试">坑14:  厂商消息分类完成后，才可以针对目前配置好的厂商做下推送测试</h3>

<p>去各家厂商后台申请厂商消息分类：得到如下</p>

<div class="language-plaintext highlighter-rouge"><div class="highlight"><pre class="highlight"><code>``` JSON
{
    "options": {
        "classification": 1,
        "third_party_channel": {
            "xiaomi": {
                "channel_id": "xxx"
            },
            "huawei": {
                "importance": "NORMAL",
                "category": "IM"
            },
            "oppo": {
                "channel_id": "IM",
                "category": "IM",
                "notify_level": 16
            },
            "vivo": {
                "distribution": "secondary_push",
                "category": "IM"
            },
            "honor": {
                "importance": "NORMAL"
            }
        }
    }
}
```
</code></pre></div></div>

<p>如下是后台按照我申请配置的厂商消息分类：</p>

<div class="language-plaintext highlighter-rouge"><div class="highlight"><pre class="highlight"><code>class := 1
 options := &amp;push.Options{
  Classification: &amp;class,
  ThirdPartyChannel: &amp;push.ThirdPartyChannel{
   Xiaomi: &amp;push.ThirdPartyChannelOptions{
    ChannelID: "xxx",
   },
   Huawei: &amp;push.ThirdPartyChannelOptions{
    Importance: "NORMAL",
    Category:   "IM",
   },
   OPPO: &amp;push.ThirdPartyChannelOptions{
    ChannelID:   "IM",
    Category:    "IM",
    NotifyLevel: 16,
   },
   Vivo: &amp;push.ThirdPartyChannelOptions{
    Distribution: "secondary_push",
    Category:     "IM",
   },
   Honor: &amp;push.ThirdPartyChannelOptions{
    Importance: "NORMAL",
   },
  },
 }
</code></pre></div></div>

<p>厂商消息分类使用指南    <br />
 <a href="https://docs.jiguang.cn/jpush/client/Android/android_channel_id">https://docs.jiguang.cn/jpush/client/Android/android_channel_id</a></p>

<h3 id="坑15--需要和后台约定每次app登录后需要把得到的极光registration_id存到用户表">坑15:  需要和后台约定，每次APP登录后，需要把得到的极光<code class="language-plaintext highlighter-rouge">registration_id</code>存到用户表。</h3>

<ul>
  <li><code class="language-plaintext highlighter-rouge">registration_id</code>处理逻辑。：
    <ul>
      <li>每次登录，在登录接口一起上报<code class="language-plaintext highlighter-rouge">registration_id</code>给后台，后台拿到覆盖更新当前用户的<code class="language-plaintext highlighter-rouge">registration_id</code>字段。用于当前用户触发业务消息需要推送时候找到设备id。</li>
    </ul>
  </li>
</ul>

<h3 id="坑16--buildgradle-中的各厂商sdk的版本号码需要和jpush_flutter-对应一致">坑16:  build.gradle 中的各厂商SDK的版本号码需要和jpush_flutter 对应一致。</h3>
<p>比如查jpush_flutter 3.2.7源码知道对应的是</p>

<div class="language-plaintext highlighter-rouge"><div class="highlight"><pre class="highlight"><code>implementation ('cn.jiguang.sdk:jpush:5.7.0'){
    exclude group: 'cn.jiguang.sdk', module: 'jcore'//会自动把jcore剔除
}
implementation 'cn.jiguang.sdk:jcore:4.9.1'
</code></pre></div></div>

<p>那<code class="language-plaintext highlighter-rouge">build.gradle</code> 中都是<code class="language-plaintext highlighter-rouge">5.7.0</code>版本</p>

<div class="language-plaintext highlighter-rouge"><div class="highlight"><pre class="highlight"><code>implementation 'com.huawei.hms:push:6.12.0.300'  // 华为 HMS Push SDK
implementation 'cn.jiguang.sdk.plugin:huawei:5.7.0'  // 极光华为通道插件
implementation 'com.huawei.agconnect:agconnect-core:1.8.0.300' // 核心库


implementation 'cn.jiguang.sdk.plugin:xiaomi:5.7.0'
implementation 'cn.jiguang.sdk.plugin:oppo:5.7.0'
implementation 'cn.jiguang.sdk.plugin:vivo:5.7.0'
implementation 'cn.jiguang.sdk.plugin:honor:5.7.0'
</code></pre></div></div>

<p>并不是原生SDK文档中对应的版本<br />
<img src="https://yfmingo.oss-cn-beijing.aliyuncs.com/images/202505281747025.png" alt="" /></p>

<h3 id="坑17--小米-错误码27001channel相关信息不匹配">坑17:  小米 错误码:27001–channel相关信息不匹配</h3>

<p>小米 27001#invalid channel info!<br />
<img src="https://yfmingo.oss-cn-beijing.aliyuncs.com/images/202505281757995.png" alt="" /></p>

<p>服务端推送时AndroidNotificationXiaomiChannel参数是否正确配置， 小米开放平台消息渠道是否成功申请。<a href="https://dev.mi.com/console/doc/detail?pId=2422#_2">https://dev.mi.com/console/doc/detail?pId=2422#_2</a></p>

<p>申请后 回到 <code class="language-plaintext highlighter-rouge">坑14 </code> 让后台接口配置</p>

<div class="language-plaintext highlighter-rouge"><div class="highlight"><pre class="highlight"><code>"xiaomi": {
    "channel_id": "xxx"
},
</code></pre></div></div>

<p><img src="https://yfmingo.oss-cn-beijing.aliyuncs.com/images/202505281758879.png" alt="" /></p>

<h3 id="坑18--小米需要在-androidmanifest-的-application标签下添加配置">坑18:  小米需要在 AndroidManifest 的 <code class="language-plaintext highlighter-rouge">application</code>标签下添加配置</h3>

<div class="language-plaintext highlighter-rouge"><div class="highlight"><pre class="highlight"><code>&lt;!--        xiaomi start--&gt;
&lt;receiver
    android:name="cn.jpush.android.service.PushReceiver"
    android:exported="true"
    tools:node="replace"
    android:enabled="false"&gt;
    &lt;intent-filter android:priority="1000"&gt;
        &lt;action android:name="cn.jpush.android.intent.NOTIFICATION_RECEIVED_PROXY" /&gt;
        &lt;!--Required  显示通知栏 --&gt;
        &lt;category android:name="${applicationId}" /&gt;
    &lt;/intent-filter&gt;
&lt;/receiver&gt;
&lt;!--        xiaomi end--&gt;
</code></pre></div></div>

<h3 id="坑19--荣耀需要在-androidmanifest-的-application标签下添加配置">坑19:  荣耀需要在 AndroidManifest 的 <code class="language-plaintext highlighter-rouge">application</code>标签下添加配置</h3>

<div class="language-plaintext highlighter-rouge"><div class="highlight"><pre class="highlight"><code>//Honor所需要的权限
  &lt;queries&gt;
     &lt;intent&gt;
         &lt;action android:name="com.hihonor.push.action.BIND_PUSH_SERVICE" /&gt;
     &lt;/intent&gt;
 &lt;/queries&gt;
 &lt;application&gt;
     &lt;service
         android:name="cn.jpush.android.service.JHonorService"
         android:exported="false"&gt;
         &lt;intent-filter&gt;
             &lt;action android:name="com.hihonor.push.action.MESSAGING_EVENT" /&gt;
         &lt;/intent-filter&gt;
     &lt;/service&gt;
 
     &lt;meta-data
         android:name="com.hihonor.push.app_id"
         android:value="您的应用对应的Honor的APP ID" /&gt;
 &lt;/application&gt;
</code></pre></div></div>

<h3 id="坑20--华为收到离线推送点击拉起app报错">坑20:  华为收到离线推送，点击拉起APP报错</h3>

<blockquote>
  <div class="language-plaintext highlighter-rouge"><div class="highlight"><pre class="highlight"><code> A GlobalKey was used multiple times inside one widget's child list. The offending GlobalKey was： ［Label edGlobalKey&lt;NavigatorState&gt;#55a59］ The parent of the widgets with that key was：

_FocusInheritedScope The first Child to get instantlated with that key became：

Navigator-［LabeledGlobalKey&lt;Navig atorState&gt;#55a59］
The second child that was to be instantiated with that key was： FocusInheritedScope A GlobalKey can only be specified on one widget at a time in the widget tree.
See also: https://docs.flutter.dev/ testing/errors
</code></pre></div>  </div>
</blockquote>

<p><img src="https://yfmingo.oss-cn-beijing.aliyuncs.com/images/202505291152990.png" alt="" /></p>

<p>看到这真的把劳资搞麻木了。</p>

<p>遂根据报错信息。找到资料如下：<br />
<a href="https://stackoverflow.com/questions/78526585/a-globalkey-was-used-multiple-times-in-my-flutter-project">https://stackoverflow.com/questions/78526585/a-globalkey-was-used-multiple-times-in-my-flutter-project</a></p>

<p>按照资料提示设置</p>

<div class="language-plaintext highlighter-rouge"><div class="highlight"><pre class="highlight"><code>unknownRoute: GetPage(
  name: "/splash",
  page: () =&gt; SplashView(),
  binding: SplashBinding(),
),
</code></pre></div></div>

<p>然鹅，对我没有卵用，还是报错。最终思考应该是启动初始化 Getx的时候报错。<br />
故尝试屏蔽</p>

<div class="language-plaintext highlighter-rouge"><div class="highlight"><pre class="highlight"><code>// getPages: AppPages.pages,    
</code></pre></div></div>

<p>解决了问题。</p>

<h3 id="坑21-桌面logo角标设置">坑21: 桌面logo角标设置</h3>

<p><a href="https://docs.jiguang.cn/jpush/practice/set_badge">看文档解决：https://docs.jiguang.cn/jpush/practice/set_badge</a></p>

<p><img src="https://yfmingo.oss-cn-beijing.aliyuncs.com/images/202505291438798.png" alt="" /></p>

<p>需要Android原生配置一波，按照文档配置即可。<br />
需要后台接口配置：</p>

<div class="language-plaintext highlighter-rouge"><div class="highlight"><pre class="highlight"><code>//服务端发送 json 消息串
{
    "notification": {
        "android": {
            "alert": "hello, JPush!",
            "badge_add_num": 1, //角标增加值，取值范围1-99
            "badge_set_num": 1, //角标固定值，取值范围0-99
            "badge_class": "com.test.badge.MainActivity", //默认为 APP 的主 Activity
        }
    }
}
</code></pre></div></div>

<p>关键是</p>

<div class="language-plaintext highlighter-rouge"><div class="highlight"><pre class="highlight"><code>"badge_class": "app包名.MainActivity", //默认为 APP 的主 Activity
</code></pre></div></div>

<h3 id="坑22--小米角标-无效需要人工开启才生效">坑22:  小米角标 无效。需要人工开启才生效。</h3>

<blockquote>
  <p>小米角标<br />
小米 MIUI 6 及以上设备支持数字角标，小米系统自动处理数字角标展示功能，默认收到通知+1处理，打开 App 清零。</p>
</blockquote>

<p><img src="https://yfmingo.oss-cn-beijing.aliyuncs.com/images/202505291518689.png" alt="" /></p>

<p><strong>总结，遇坑填坑，多看文档，有的文档良心介绍了注意事项可以闭坑。遇到报错，根据报错信息多思考。</strong></p>]]></content><author><name>袁凤鸣</name></author><category term="flutter" /><category term="dio" /><category term="JPush" /><summary type="html"><![CDATA[0x000 背景 0x000 背景 最近flutter项目需要接入极光推送。接入过程中是艰难险阻一大堆。极光官网的文档都是Android 和 iOS 原生接入的文档。对于flutter的朋友接入太过艰难。官网勉强出了jpush_flutter: ^3.2.7。但是文档也是草草敷衍。里面的issues一大堆，官方不管。 遂经历艰难险阻后，故写这篇文章，以方便后续自己和其他的网友避坑。]]></summary></entry><entry><title type="html">flutter dio response cut the data</title><link href="https://www.yfmingo.cn/2025/02/05/dio-response-cut/" rel="alternate" type="text/html" title="flutter dio response cut the data" /><published>2025-02-05T00:00:00+00:00</published><updated>2025-02-05T00:00:00+00:00</updated><id>https://www.yfmingo.cn/2025/02/05/dio-response-cut</id><content type="html" xml:base="https://www.yfmingo.cn/2025/02/05/dio-response-cut/"><![CDATA[<ul id="markdown-toc">
  <li><a href="#0x001-现象" id="markdown-toc-0x001-现象">0x001 现象</a></li>
  <li><a href="#0x002-原因" id="markdown-toc-0x002-原因">0x002 原因</a></li>
  <li><a href="#0x003-解决" id="markdown-toc-0x003-解决">0x003 解决</a></li>
</ul>
<hr />

<h2 id="0x001-现象">0x001 现象</h2>
<p>某个接口报错，但是又有数据返回。报错如下：</p>

<div class="language-plaintext highlighter-rouge"><div class="highlight"><pre class="highlight"><code>Connection closed while receiving data
</code></pre></div></div>

<p>认真排查后发现如下问题。虽然有数据返回，但是数据被截断了。<br />
<img src="https://yfmingo.oss-cn-beijing.aliyuncs.com/images/202502051048077.png" alt="" /></p>

<h2 id="0x002-原因">0x002 原因</h2>
<p><strong>flutter dio 返回超大文本数据时候被截断了，导致数据缺失。</strong> 后台服务是PHP的，经过和后台开发沟通，说是 http 响应结果输出大小有限制太小了。</p>

<h2 id="0x003-解决">0x003 解决</h2>
<ul>
  <li>后续经过如下修改后台 Nginx配置实现正常。</li>
</ul>

<p><img src="https://yfmingo.oss-cn-beijing.aliyuncs.com/images/202502051053850.png" alt="" /></p>

<p><img src="https://yfmingo.oss-cn-beijing.aliyuncs.com/images/202502051059248.png" alt="" /></p>]]></content><author><name>袁凤鸣</name></author><category term="flutter" /><category term="dio" /><summary type="html"><![CDATA[0x001 现象 0x002 原因 0x003 解决 0x001 现象 某个接口报错，但是又有数据返回。报错如下： Connection closed while receiving data 认真排查后发现如下问题。虽然有数据返回，但是数据被截断了。 0x002 原因 flutter dio 返回超大文本数据时候被截断了，导致数据缺失。 后台服务是PHP的，经过和后台开发沟通，说是 http 响应结果输出大小有限制太小了。 0x003 解决 后续经过如下修改后台 Nginx配置实现正常。]]></summary></entry><entry><title type="html">Mac电脑 GitHub 配置SSH Key</title><link href="https://www.yfmingo.cn/2024/01/16/mac-github-ssh/" rel="alternate" type="text/html" title="Mac电脑 GitHub 配置SSH Key" /><published>2024-01-16T00:00:00+00:00</published><updated>2024-01-16T00:00:00+00:00</updated><id>https://www.yfmingo.cn/2024/01/16/mac-github-ssh</id><content type="html" xml:base="https://www.yfmingo.cn/2024/01/16/mac-github-ssh/"><![CDATA[<ul id="markdown-toc">
  <li><a href="#2024-01-20-000122-补充更新" id="markdown-toc-2024-01-20-000122-补充更新">2024-01-20 00:01:22 补充更新</a></li>
  <li><a href="#原因" id="markdown-toc-原因">原因</a></li>
  <li><a href="#检查" id="markdown-toc-检查">检查</a></li>
  <li><a href="#检查是否存在ssh-key" id="markdown-toc-检查是否存在ssh-key">检查是否存在SSH Key</a></li>
  <li><a href="#获取ssh-key" id="markdown-toc-获取ssh-key">获取SSH Key</a></li>
  <li><a href="#github添加ssh-key" id="markdown-toc-github添加ssh-key">GitHub添加SSH Key</a></li>
  <li><a href="#验证和修改" id="markdown-toc-验证和修改">验证和修改</a></li>
  <li><a href="#完整操作记录" id="markdown-toc-完整操作记录">完整操作记录</a></li>
</ul>
<hr />

<h2 id="2024-01-20-000122-补充更新">2024-01-20 00:01:22 补充更新</h2>
<p>最近Mac的SourceTree提交SSH仓库经常出现：</p>

<div class="language-plaintext highlighter-rouge"><div class="highlight"><pre class="highlight"><code>ssh:connect to host github.com port 22: Connection timed out
</code></pre></div></div>

<p>查阅相关资料后明白22端口无法使用了。因此想到修改端口试试。一般默认端口都是443</p>

<ul>
  <li>cd 进入<code class="language-plaintext highlighter-rouge">~/.ssh</code>下</li>
  <li>使用<code class="language-plaintext highlighter-rouge">vim config</code>打开 编辑 config文件</li>
  <li>
    <p>输入<code class="language-plaintext highlighter-rouge">I</code>后可以编写。粘贴如下：</p>

    <div class="language-plaintext highlighter-rouge"><div class="highlight"><pre class="highlight"><code>  Host github.com
  User git
  Hostname ssh.github.com
  PreferredAuthentications publickey
  IdentityFile ~/.ssh/id_rsa
  Port 443
</code></pre></div>    </div>
  </li>
  <li>
    <p>然后<code class="language-plaintext highlighter-rouge">WQ</code>保存退出，并使用如下检查是否成功</p>

    <div class="language-plaintext highlighter-rouge"><div class="highlight"><pre class="highlight"><code>  ssh -T git@github.com
</code></pre></div>    </div>
  </li>
  <li>按照提示操作，成功后如图。然后可以去提交了<br />
<img src="https://yfmingo.oss-cn-beijing.aliyuncs.com/images/202401200008609.png" alt="" /></li>
</ul>

<h2 id="原因">原因</h2>
<p>之前一直使用https的仓库链接进行提交<code class="language-plaintext highlighter-rouge">Github</code>仓库。但是最近一直动不动403无响应。经常链接不上。现在采用<code class="language-plaintext highlighter-rouge">SSH</code>链接仓库。记录下方便查询。</p>

<h2 id="检查">检查</h2>

<p><strong>先看当前Git环境有没有配置提交账号的user name和email</strong></p>
<ul>
  <li>使用<code class="language-plaintext highlighter-rouge">git config --list </code>查看。如下是已经配置好了。
    <div class="language-plaintext highlighter-rouge"><div class="highlight"><pre class="highlight"><code>  mingo@macdeMacBook-Pro-2 ~ % git config --list
  credential.helper=osxkeychain
  init.defaultbranch=main
  user.name=yfm
  user.email=928289877@qq.com
  core.excludesfile=/Users/mingo/.gitignore_global
  difftool.sourcetree.cmd=opendiff "$LOCAL" "$REMOTE"
  difftool.sourcetree.path=
  mergetool.sourcetree.cmd=/Applications/Sourcetree.app/Contents/Resources/opendiff-w.sh "$LOCAL" "$REMOTE" -ancestor "$BASE" -merge "$MERGED"
  mergetool.sourcetree.trustexitcode=true
  commit.template=/Users/mingo/.stCommitMsg
</code></pre></div>    </div>
  </li>
</ul>

<h2 id="检查是否存在ssh-key">检查是否存在SSH Key</h2>
<p><code class="language-plaintext highlighter-rouge">cd ~/.ssh</code>进行切换到<code class="language-plaintext highlighter-rouge">.ssh</code>文件夹进行<code class="language-plaintext highlighter-rouge"> ls</code>查看文件。</p>
<ul>
  <li>看是否存在 <code class="language-plaintext highlighter-rouge">id_rsa</code> 和 <code class="language-plaintext highlighter-rouge">id_rsa.pub</code>文件，如果存在，说明已经有<code class="language-plaintext highlighter-rouge">SSH Key</code></li>
  <li>我的就是这样，还没有
    <div class="language-plaintext highlighter-rouge"><div class="highlight"><pre class="highlight"><code>  mingo@macdeMacBook-Pro-2 .ssh % ls
  known_hosts
</code></pre></div>    </div>
  </li>
</ul>

<p><strong>如果没有SSH Key，则需要先生成一下</strong></p>
<ul>
  <li>我这里使用的是<code class="language-plaintext highlighter-rouge">Github</code>账号邮箱。
    <div class="language-plaintext highlighter-rouge"><div class="highlight"><pre class="highlight"><code>  ssh-keygen -t rsa -C "yfmingo@163.com"
</code></pre></div>    </div>
    <p><img src="https://yfmingo.oss-cn-beijing.aliyuncs.com/images/202307162241589.png" alt="" /></p>
  </li>
</ul>

<h2 id="获取ssh-key">获取SSH Key</h2>
<ul>
  <li><code class="language-plaintext highlighter-rouge">cat id_rsa.pub</code>命令出现秘钥。</li>
  <li>终端控制台会出现<code class="language-plaintext highlighter-rouge"> ssh-rsa</code>的一大堆字符串。<br />
  <img src="https://yfmingo.oss-cn-beijing.aliyuncs.com/images/202307162247936.png" alt="" /></li>
</ul>

<h2 id="github添加ssh-key">GitHub添加SSH Key</h2>

<ul>
  <li><code class="language-plaintext highlighter-rouge">GitHub</code>点击用户头像，选择<code class="language-plaintext highlighter-rouge">setting</code></li>
  <li>点击 <code class="language-plaintext highlighter-rouge">New SSH Key</code> 新建一个，取个名字。填入刚才得到<code class="language-plaintext highlighter-rouge"> ssh-rsa</code>的一大堆字符串<br />
  <img src="https://yfmingo.oss-cn-beijing.aliyuncs.com/images/202307162249765.png" alt="" /></li>
</ul>

<h2 id="验证和修改">验证和修改</h2>

<p>测试是否成功配置<code class="language-plaintext highlighter-rouge">SSH Key</code></p>
<div class="language-plaintext highlighter-rouge"><div class="highlight"><pre class="highlight"><code>ssh -T git@github.com
//运行结果出现类似如下
Hi yfming93! You've successfully authenticated, but GitHub does not provide shell access.
</code></pre></div></div>

<h2 id="完整操作记录">完整操作记录</h2>

<p><img src="https://yfmingo.oss-cn-beijing.aliyuncs.com/images/202307162254706.png" alt="" /></p>

<p>之前已经是<code class="language-plaintext highlighter-rouge">https</code>的链接，现在想要用<code class="language-plaintext highlighter-rouge">SSH</code>提交怎么办？<br />
直接修改项目目录下 <code class="language-plaintext highlighter-rouge">.git</code>文件夹下的<code class="language-plaintext highlighter-rouge">config</code>文件，将地址修改一下就好了。</p>
<ul>
  <li><code class="language-plaintext highlighter-rouge">.git</code>默认是隐藏的。
    <div class="language-plaintext highlighter-rouge"><div class="highlight"><pre class="highlight"><code>  Finder 始终显示隐藏文件或文件夹。
  defaults write com.apple.finder AppleShowAllFiles -boolean true ; killall Finder
  defaults write com.apple.finder AppleShowAllFiles -boolean false ; killall Finder
</code></pre></div>    </div>
  </li>
</ul>

<p><code class="language-plaintext highlighter-rouge">git</code>地址获取可以看如下图切换。</p>

<p><img src="https://yfmingo.oss-cn-beijing.aliyuncs.com/images/202307162256554.png" alt="" /></p>]]></content><author><name>袁凤鸣</name></author><category term="ssh" /><category term="ssh" /><summary type="html"><![CDATA[2024-01-20 00:01:22 补充更新 原因 2024-01-20 00:01:22 补充更新 最近Mac的SourceTree提交SSH仓库经常出现： ssh:connect to host github.com port 22: Connection timed out 查阅相关资料后明白22端口无法使用了。因此想到修改端口试试。一般默认端口都是443 cd 进入~/.ssh下 使用vim config打开 编辑 config文件 输入I后可以编写。粘贴如下： Host github.com User git Hostname ssh.github.com PreferredAuthentications publickey IdentityFile ~/.ssh/id_rsa Port 443 然后WQ保存退出，并使用如下检查是否成功 ssh -T git@github.com 按照提示操作，成功后如图。然后可以去提交了 原因 之前一直使用https的仓库链接进行提交Github仓库。但是最近一直动不动403无响应。经常链接不上。现在采用SSH链接仓库。记录下方便查询。]]></summary></entry><entry><title type="html">远程异地adb调试并配置Android为kiosk霸屏</title><link href="https://www.yfmingo.cn/2023/05/25/remote-adb-apk/" rel="alternate" type="text/html" title="远程异地adb调试并配置Android为kiosk霸屏" /><published>2023-05-25T00:00:00+00:00</published><updated>2023-05-25T00:00:00+00:00</updated><id>https://www.yfmingo.cn/2023/05/25/remote-adb-apk</id><content type="html" xml:base="https://www.yfmingo.cn/2023/05/25/remote-adb-apk/"><![CDATA[<ul id="markdown-toc">
  <li><a href="#远程异地adb调试并配置android为kiosk霸屏" id="markdown-toc-远程异地adb调试并配置android为kiosk霸屏">远程异地adb调试并配置Android为kiosk霸屏</a>    <ul>
      <li><a href="#0x0b-更新-2023年07月16日231358" id="markdown-toc-0x0b-更新-2023年07月16日231358">0x0B 更新 2023年07月16日23:13:58</a></li>
      <li><a href="#0x00-背景" id="markdown-toc-0x00-背景">0x00 背景</a></li>
      <li><a href="#0x01-远程搭建区域网组网" id="markdown-toc-0x01-远程搭建区域网组网">0x01 远程搭建区域网组网</a></li>
      <li><a href="#0x02-安卓端配置" id="markdown-toc-0x02-安卓端配置">0x02 安卓端配置</a></li>
      <li><a href="#0x03-终端配置" id="markdown-toc-0x03-终端配置">0x03 终端配置</a></li>
    </ul>
  </li>
</ul>
<hr />

<h1 id="远程异地adb调试并配置android为kiosk霸屏">远程异地adb调试并配置Android为kiosk霸屏</h1>

<h3 id="0x0b-更新-2023年07月16日231358">0x0B 更新 2023年07月16日23:13:58</h3>
<ul>
  <li>后发现 <code class="language-plaintext highlighter-rouge">LADB</code>可以在安卓设备中进行本地调试<code class="language-plaintext highlighter-rouge">adb</code>，自己<code class="language-plaintext highlighter-rouge">adb</code>自己。也是需要<code class="language-plaintext highlighter-rouge">WiFi</code>模块的。</li>
  <li>我用的版本 <code class="language-plaintext highlighter-rouge">LADB_v2.2.1_Mod_Armeabi_v7a_Dlpure.com</code>，可去<code class="language-plaintext highlighter-rouge">Github</code>搜索下载。</li>
</ul>

<p><strong>还有<code class="language-plaintext highlighter-rouge">termux</code>也是可以完成本地环境adb。</strong></p>
<ul>
  <li><code class="language-plaintext highlighter-rouge">termux-app_v0.118.0+github-debug_universal.apk</code></li>
  <li><code class="language-plaintext highlighter-rouge">termux</code>其实就是安卓设备的本地终端，需要找个教程利用这个终端按照安卓设备本地的<code class="language-plaintext highlighter-rouge">adb</code>环境。再通过如下操作链接:
    <ul>
      <li>安卓设备开启<code class="language-plaintext highlighter-rouge">USB调试</code></li>
      <li><code class="language-plaintext highlighter-rouge">adb tcpip 5555</code></li>
      <li><code class="language-plaintext highlighter-rouge">adb connect 192.168.0.168:5555</code>
        <ul>
          <li><code class="language-plaintext highlighter-rouge">192.168.0.168</code>是本地设备内网<code class="language-plaintext highlighter-rouge">IP</code></li>
          <li>这时候安卓新设备那边会提示授权弹窗，点击同意授权。</li>
          <li><code class="language-plaintext highlighter-rouge">adb devices</code> 连接好后可查看设备状态。是<code class="language-plaintext highlighter-rouge">device</code> 状态就可以操作其他的一些列<code class="language-plaintext highlighter-rouge">adb</code>流程命令。</li>
        </ul>
      </li>
    </ul>
  </li>
  <li><strong>说明：</strong>   可以研究下<code class="language-plaintext highlighter-rouge">scrcpy</code>这个进行远程显示安卓设备到本地的电脑。
    <ul>
      <li>其实也可以进行废旧手机利用。如果手机屏幕碎屏了，黑屏无法使用屏幕了。 也是可以使用<code class="language-plaintext highlighter-rouge">scrcpy</code>实时展示手机画面的。</li>
    </ul>
  </li>
</ul>

<p><strong>常用命名:</strong></p>
<div class="language-plaintext highlighter-rouge"><div class="highlight"><pre class="highlight"><code>复制安装包到设备
adb shell cp /storage/emulated/0/app.apk /data/local/tmp/

安装 
adb shell pm install -r -t -d -g /data/local/tmp/app.apk

设置管理者 
adb shell dpm set-device-owner com.shidai.app.runway/com.kalemba128.flutter_kiosk_android.FlutterKioskAndroidPlugin

移除管理者 
adb shell dpm remove-active-admin com.shidai.app.runway/com.kalemba128.flutter_kiosk_android.FlutterKioskAndroidPlugin

卸载
adb shell pm uninstall com.shidai.app.runway

启动
adb shell am start -n com.shidai.app.runway/.MainActivity


</code></pre></div></div>

<hr />
<hr />

<h3 id="0x00-背景">0x00 背景</h3>
<ul>
  <li>公司有多个公园大屏的项目在其他外省城市，各大屏均采用<code class="language-plaintext highlighter-rouge">Android</code>系统。</li>
  <li>这种室外大屏就必须达到霸屏的效果。整个设备开机启动只能霸屏显示我们的App。用户无法退出当前App，也不能进行其他操作。</li>
  <li>同时还要满足，开机自启动App。断电重启设备后自启动App。凌晨定时重新启动App。远程控制启动App。</li>
  <li>设备要常亮屏</li>
  <li>霸屏效果，采用<code class="language-plaintext highlighter-rouge">Android</code>的kiosk。达到这效果踩了不少坑，后期开一篇文章讲解如何完美<code class="language-plaintext highlighter-rouge">kiosk</code>霸屏。</li>
</ul>

<h3 id="0x01-远程搭建区域网组网">0x01 远程搭建区域网组网</h3>

<ul>
  <li><a href="https://www.bilibili.com/video/BV1hK4y1L7ND/?spm_id_from=333.788.recommend_more_video.-1&amp;vd_source=105da3da61ce39bd0f662b7be9e104d8">参照B站的视频了解下zerotier，先进行异地组一个大局域网</a></li>
</ul>

<p><img src="https://yfmingo.oss-cn-beijing.aliyuncs.com/images/202305240916365.png" alt="" /></p>

<p>下载 <code class="language-plaintext highlighter-rouge">Mac</code> 和 <code class="language-plaintext highlighter-rouge">Android</code> 端各自安装好后。都进入同一个局域网。操作期间，都必须保持各自端的 <code class="language-plaintext highlighter-rouge">zerotier</code> 客户端保持打开，并是连接状态是OK的</p>

<p>如下图就是  安卓端进如内网后配置好获取到的 内网 IP 地址 <code class="language-plaintext highlighter-rouge">192.168.192.59</code>，<code class="language-plaintext highlighter-rouge">Mac</code>端的内网地址是<code class="language-plaintext highlighter-rouge">192.168.192.128</code><br />
<img src="https://yfmingo.oss-cn-beijing.aliyuncs.com/images/dap.png" alt="" /></p>

<ul>
  <li>可以测试下，ping 安卓的内网IP。可以成功就进行后面流程。</li>
</ul>

<h3 id="0x02-安卓端配置">0x02 安卓端配置</h3>

<p><strong>前置条件：</strong></p>
<ul class="task-list">
  <li class="task-list-item"><input type="checkbox" class="task-list-item-checkbox" disabled="disabled" checked="checked" />需要安卓设备能进行 <code class="language-plaintext highlighter-rouge">WiFi</code> 联网。（没<code class="language-plaintext highlighter-rouge">WiFi</code>模组，就无法开启远程无线调试）</li>
  <li class="task-list-item"><input type="checkbox" class="task-list-item-checkbox" disabled="disabled" checked="checked" />需要安卓设备现场有人，开一个<code class="language-plaintext highlighter-rouge">WiFi</code>热点出来提供给安卓设备使用</li>
  <li class="task-list-item"><input type="checkbox" class="task-list-item-checkbox" disabled="disabled" checked="checked" />安卓端的 <code class="language-plaintext highlighter-rouge">zerotier</code> 加入局域网，保持App保活。</li>
  <li class="task-list-item"><input type="checkbox" class="task-list-item-checkbox" disabled="disabled" checked="checked" />安卓进入开发者调试模式。开启<code class="language-plaintext highlighter-rouge">USB</code>调试，开启<code class="language-plaintext highlighter-rouge">USB调试（安全设置）</code>等等。</li>
</ul>

<p><strong>安卓端开发者模式中无线网络调试：</strong><br />
<img src="https://yfmingo.oss-cn-beijing.aliyuncs.com/images/202305240950411.png" alt="" /></p>

<h3 id="0x03-终端配置">0x03 终端配置</h3>

<p><img src="https://yfmingo.oss-cn-beijing.aliyuncs.com/images/202305240945130.png" alt="" /></p>

<p><strong>连接说明：</strong></p>
<ul>
  <li>没有配对的设备先要进行两端配对 <code class="language-plaintext highlighter-rouge">adb pair 192.168.192.59:33251</code>
    <ul>
      <li>IP 是内网 IP，不是安卓设备显示的IP。但是端口是安卓设备进行6位数对码出现的端口。</li>
      <li>如下是配对成后：<img src="https://yfmingo.oss-cn-beijing.aliyuncs.com/images/202305241010441.png" alt="" /></li>
    </ul>
  </li>
  <li>配对好后，进行 <code class="language-plaintext highlighter-rouge">adb connect 192.168.192.59:46281</code>
    <ul>
      <li>此时 IP 是还是内网IP，但是端口是安卓设备无线调试页面中，<code class="language-plaintext highlighter-rouge">IP地址和端口</code>那一栏目显示出现的端口。</li>
    </ul>
  </li>
  <li>连接成功后。本地的电脑<code class="language-plaintext highlighter-rouge">Android Studio</code>就可以显示连接的安卓设备了。</li>
  <li>
    <p>设置设备管理者：</p>

    <div class="language-plaintext highlighter-rouge"><div class="highlight"><pre class="highlight"><code>  adb shell dpm set-device-owner com.shidai.app.runway/com.kalemba128.flutter_kiosk_android.FlutterKioskAndroidPlugin
</code></pre></div>    </div>
  </li>
  <li>霸屏配置：<code class="language-plaintext highlighter-rouge">Block apps</code>，<code class="language-plaintext highlighter-rouge">Start Kiosk</code>，<code class="language-plaintext highlighter-rouge">Allow installing applications</code>
    <ul>
      <li>后面单独开文，如果详细霸屏。</li>
    </ul>
  </li>
</ul>

<p><strong><u>实测发现安卓热点和iPhone热点连接方式不一样</u>:</strong></p>
<ul>
  <li>如下是安卓开的热点：
    <ul>
      <li>安卓手机开的热点，在对码配对这里显示的是<code class="language-plaintext highlighter-rouge">192.168</code>的IP地址，苹果是<code class="language-plaintext highlighter-rouge">172.20</code>地址。<img src="https://yfmingo.oss-cn-beijing.aliyuncs.com/images/202305241025329.png" alt="" /></li>
      <li>
        <p>此时配对连接用 <code class="language-plaintext highlighter-rouge">zerotier</code>分发的内网<code class="language-plaintext highlighter-rouge">IP</code>-<code class="language-plaintext highlighter-rouge">192.168.192.59</code>无法连接，提示如下</p>

        <div class="language-plaintext highlighter-rouge"><div class="highlight"><pre class="highlight"><code>  mingo@192 ~ % adb pair 192.168.192.59:36705   
  Enter pairing code: 943400
  Failed: Unable to start pairing client.
  mingo@192 ~ % adb pair 192.168.192.59:36705
  Enter pairing code: 943400
  Failed: Unable to start pairing client.
  mingo@192 ~ % adb pair 192.168.10.107:36705
  Enter pairing code: 943400
  Successfully paired to 192.168.10.107:36705 [guid=adb-eeedefbd7c2441d0-bRW0iu]
  mingo@192 ~ % adb connect 192.168.10.107:45617                   
  connected to 192.168.10.107:45617
</code></pre></div>        </div>
        <p>后尝试使用当前手机显示的 <code class="language-plaintext highlighter-rouge">192.168.10.107</code>进行配对和连接都成功了。</p>
      </li>
    </ul>
  </li>
</ul>

<p><strong>其他注意：</strong></p>
<ul>
  <li><code class="language-plaintext highlighter-rouge">adb push /Users/mingo/Desktop/app-release.apk /data/local/tmp/</code>这里先把 apk 推送到 安卓设备指定文件夹。</li>
  <li>后采用<code class="language-plaintext highlighter-rouge">adb shell pm install -r -t /data/local/tmp/app-release.apk</code>进行<code class="language-plaintext highlighter-rouge">adb</code>安装<code class="language-plaintext highlighter-rouge">apk</code>。
    <ul>
      <li>这里是无法直接手动点击安装的，因为打包的<code class="language-plaintext highlighter-rouge">apk</code>中有	<code class="language-plaintext highlighter-rouge">android:testOnly="true"</code>标签。</li>
      <li>设置<em><code class="language-plaintext highlighter-rouge">testOnly</code></em>这个标签的目的是后期可以进行 <code class="language-plaintext highlighter-rouge">adb shell dpm remove-active-admin</code> 命令移除设备管理者，退出霸屏模式方便维护调试，否则只能刷机才能退出霸屏。不要搞得达到霸屏效果，结果自己都不能维护了。。</li>
    </ul>
  </li>
  <li>需要自己开发隐藏的调试工具，在<code class="language-plaintext highlighter-rouge">App</code>中某个隐藏的入口，触发调试工具进行开启和关闭<code class="language-plaintext highlighter-rouge">kiosk</code>霸屏，</li>
</ul>

<hr />
<p><strong>详细操作记录：</strong></p>

<div class="language-plaintext highlighter-rouge"><div class="highlight"><pre class="highlight"><code>mingo@macdembp-2 ~ % adb pair 192.168.192.59:33251
Enter pairing code: 469301
Successfully paired to 192.168.192.59:33251 [guid=adb-eeedefbd7c2441d0-bRW0iu]
mingo@macdembp-2 ~ % adb connect 192.168.192.59:33251
failed to connect to '192.168.192.59:33251': Connection refused
mingo@macdembp-2 ~ % adb connect 192.168.192.59:46281
connected to 192.168.192.59:46281
mingo@macdembp-2 ~ % adb shell 
rk3568_mids:/ $ su 
su: setgid failed: Operation not permitted
1|rk3568_mids:/ $ sudo su
/system/bin/sh: sudo: inaccessible or not found
127|rk3568_mids:/ $ adb root        
/system/bin/sh: adb: inaccessible or not found
127|rk3568_mids:/ $ adb install -r /Users/mingo/Desktop/app-release.apk 
/system/bin/sh: adb: inaccessible or not found
127|rk3568_mids:/ $ % mingo@macdembp-2 ~ % adb push /Users/mingo/Desktop/app-release.apk /data/local/tmp/
/Users/mingo/Desktop/app-release.apk: 1 file pushed, 0 skipped. 0.6 MB/s (56891298 bytes in 85.867s)
mingo@macdembp-2 ~ % adb shell pm install /data/local/tmp/app-release.apk
Failure [INSTALL_FAILED_TEST_ONLY: installPackageLI]
mingo@macdembp-2 ~ % adb shell -r -t /data/local/tmp/app-release.apk     
adb shell: illegal option -- r
mingo@macdembp-2 ~ % adb shell --r -t /data/local/tmp/app-release.apk
adb shell: illegal option -- -
mingo@macdembp-2 ~ % adb shell pm install -r -t /data/local/tmp/app-release.apk
Success
mingo@macdembp-2 ~ % adb shell dpm set-device-owner com.shidai.app.runway/com.kalemba128.flutter_kiosk_android.FlutterKioskAndroidPlugin
Success: Device owner set to package ComponentInfo{com.shidai.app.runway/com.kalemba128.flutter_kiosk_android.FlutterKioskAndroidPlugin}
Active admin set to component {com.shidai.app.runway/com.kalemba128.flutter_kiosk_android.FlutterKioskAndroidPlugin}
mingo@macdembp-2 ~ % 
</code></pre></div></div>]]></content><author><name>袁凤鸣</name></author><category term="apk" /><category term="apk" /><summary type="html"><![CDATA[远程异地adb调试并配置Android为kiosk霸屏 0x0B 更新 2023年07月16日23:13:58 0x00 背景 远程异地adb调试并配置Android为kiosk霸屏 0x0B 更新 2023年07月16日23:13:58 后发现 LADB可以在安卓设备中进行本地调试adb，自己adb自己。也是需要WiFi模块的。 我用的版本 LADB_v2.2.1_Mod_Armeabi_v7a_Dlpure.com，可去Github搜索下载。 还有termux也是可以完成本地环境adb。 termux-app_v0.118.0+github-debug_universal.apk termux其实就是安卓设备的本地终端，需要找个教程利用这个终端按照安卓设备本地的adb环境。再通过如下操作链接: 安卓设备开启USB调试 adb tcpip 5555 adb connect 192.168.0.168:5555 192.168.0.168是本地设备内网IP 这时候安卓新设备那边会提示授权弹窗，点击同意授权。 adb devices 连接好后可查看设备状态。是device 状态就可以操作其他的一些列adb流程命令。 说明： 可以研究下scrcpy这个进行远程显示安卓设备到本地的电脑。 其实也可以进行废旧手机利用。如果手机屏幕碎屏了，黑屏无法使用屏幕了。 也是可以使用scrcpy实时展示手机画面的。 常用命名: 复制安装包到设备 adb shell cp /storage/emulated/0/app.apk /data/local/tmp/ 安装 adb shell pm install -r -t -d -g /data/local/tmp/app.apk 设置管理者 adb shell dpm set-device-owner com.shidai.app.runway/com.kalemba128.flutter_kiosk_android.FlutterKioskAndroidPlugin 移除管理者 adb shell dpm remove-active-admin com.shidai.app.runway/com.kalemba128.flutter_kiosk_android.FlutterKioskAndroidPlugin 卸载 adb shell pm uninstall com.shidai.app.runway 启动 adb shell am start -n com.shidai.app.runway/.MainActivity 0x00 背景 公司有多个公园大屏的项目在其他外省城市，各大屏均采用Android系统。 这种室外大屏就必须达到霸屏的效果。整个设备开机启动只能霸屏显示我们的App。用户无法退出当前App，也不能进行其他操作。 同时还要满足，开机自启动App。断电重启设备后自启动App。凌晨定时重新启动App。远程控制启动App。 设备要常亮屏 霸屏效果，采用Android的kiosk。达到这效果踩了不少坑，后期开一篇文章讲解如何完美kiosk霸屏。]]></summary></entry><entry><title type="html">flutter 版本的安卓项目友盟移动统计官方 umeng_common_sdk 的坑</title><link href="https://www.yfmingo.cn/2021/06/03/flutter-umeng-common/" rel="alternate" type="text/html" title="flutter 版本的安卓项目友盟移动统计官方 umeng_common_sdk 的坑" /><published>2021-06-03T00:00:00+00:00</published><updated>2021-06-03T00:00:00+00:00</updated><id>https://www.yfmingo.cn/2021/06/03/flutter-umeng-common</id><content type="html" xml:base="https://www.yfmingo.cn/2021/06/03/flutter-umeng-common/"><![CDATA[<ul id="markdown-toc">
  <li><a href="#0x001-坑01" id="markdown-toc-0x001-坑01">0x001 坑01</a></li>
  <li><a href="#0x002-坑02" id="markdown-toc-0x002-坑02">0x002 坑02</a></li>
  <li><a href="#0x003-坑03" id="markdown-toc-0x003-坑03">0x003 坑03</a></li>
  <li><a href="#0x004-坑04" id="markdown-toc-0x004-坑04">0x004 坑04</a></li>
  <li><a href="#0x005-坑05" id="markdown-toc-0x005-坑05">0x005 坑05</a></li>
  <li><a href="#0x006-坑06" id="markdown-toc-0x006-坑06">0x006 坑06</a></li>
  <li><a href="#0x007-坑07" id="markdown-toc-0x007-坑07">0x007 坑07</a></li>
  <li><a href="#0x008-坑08" id="markdown-toc-0x008-坑08">0x008 坑08</a></li>
</ul>
<hr />

<h2 id="0x001-坑01">0x001 坑01</h2>

<p>生产环境的 页面统计数据只能显示昨天的，或者以前的某一周。不能显示自然日。<br />
<img src="https://i.loli.net/2021/06/03/saTvyiKqXRkr2QA.png" alt="" /></p>

<h2 id="0x002-坑02">0x002 坑02</h2>
<p>必须要把版本管理都加上采集中。不加测试和生产都统计不到。<br />
<img src="https://i.loli.net/2021/06/03/osb9c4hlNqJLYCH.png" alt="" /></p>

<h2 id="0x003-坑03">0x003 坑03</h2>
<p>官方获取安卓的测试机id不好用。</p>

<ul>
  <li>在安卓项目工程文件夹的 <code class="language-plaintext highlighter-rouge">MainActivity.java</code> 中的<code class="language-plaintext highlighter-rouge">onCreate</code>执行以下方法<code class="language-plaintext highlighter-rouge">getTestDeviceInfo(getApplicationContext());</code>获取的id是空的。
    <ul>
      <li><strong>解决：</strong> 延时几秒执行就获取到。</li>
    </ul>
  </li>
</ul>

<div class="language-plaintext highlighter-rouge"><div class="highlight"><pre class="highlight"><code>public static String[] getTestDeviceInfo(Context context){
    String[] deviceInfo = new String[2];
    try {
        if(context != null){
            deviceInfo[0] = DeviceConfig.getDeviceIdForGeneral(context);
            deviceInfo[1] = DeviceConfig.getMac(context);
            android.util.Log.i("UMLog--deviceInfo0", deviceInfo[0]);
            android.util.Log.i("UMLog--deviceInfo1", deviceInfo[1]);

        }
    } catch (Exception e){
    }
    return deviceInfo;
}
</code></pre></div></div>

<h2 id="0x004-坑04">0x004 坑04</h2>
<p>添加的测试手机，如果长时间收录不到信息。最后一次测试时间迟迟不更新。可能是设备信息变了。需要删除重新添加。</p>

<ul>
  <li><strong>解决:</strong>删除测试设备 卸载重装应用.重新添加测试设备 然后触发页面 完全退出应用  不在后台运行。 间隔40秒 重新启动应用。看下数据是否上传。</li>
</ul>

<p><img src="https://i.loli.net/2021/06/03/4lAqURJhaOHpkLb.png" alt="" /></p>

<h2 id="0x005-坑05">0x005 坑05</h2>
<p>错误日志，暂无数据，是不体现在集成测试模式下的。官方把这个放在这里又看不数据确实很鸡肋。</p>
<ul>
  <li><strong>解决：</strong>需要单独集成U-APM</li>
</ul>

<p><img src="https://i.loli.net/2021/06/03/SGNnyAuhmVEYWac.jpg" alt="" /></p>

<h2 id="0x006-坑06">0x006 坑06</h2>
<p><code class="language-plaintext highlighter-rouge">onPageStart</code> 和  <code class="language-plaintext highlighter-rouge">onPageEnd</code> 没成对使用的话友盟日志会报错。</p>

<p><strong>解决：</strong>一定要想办法成对调用。就是先<code class="language-plaintext highlighter-rouge">onPageStart</code>了一定要先<code class="language-plaintext highlighter-rouge">onPageEnd</code>后再次去<code class="language-plaintext highlighter-rouge">onPageStart</code>。</p>

<div class="language-plaintext highlighter-rouge"><div class="highlight"><pre class="highlight"><code>E/UMLog (30670): │ 对于页面XXX，请确保先依序成对调用onPageStart，onPageEnd接口，再调用onPageStart接口对其它页面进行统计。 
E/UMLog (30670): ├───────────────────解决方案────── 
E/UMLog (30670): │ 对于任意一个页面，必须依序成对调用onPageStart以及onPageEnd，不能有遗漏。详见链接 https://developer.umeng.com/docs/66632/detail/66975?um_channel=sdk 
I/UMLog (30670): onPageStart:xxx
</code></pre></div></div>

<p><strong>解决示例代码：</strong></p>

<div class="language-plaintext highlighter-rouge"><div class="highlight"><pre class="highlight"><code>static void onPageStart (String pageName)async {
    String  page = FmAnalysis.pageName(pageName);
    if ( page != umStartPage &amp;&amp;(page.length &gt; 0)){
      if (umStartPage != ''){
        await UmengCommonSdk.onPageEnd(umStartPage);
      }
      umStartPage = page;
      await UmengCommonSdk.onPageStart(page);
    }
  }
  static void onPageEnd (String pageName) async {

    String  page = FmAnalysis.pageName(pageName);
    if ( (page == umStartPage )&amp;&amp;(umStartPage != '')){
        await UmengCommonSdk.onPageEnd(umStartPage);
        umStartPage = '';
    }
  }

  static String pageName (String pageName){
    String name = pageName??'';
    if (name == '/') name = '';
    if (name == '/FmTabPage') name = '';
    if (name.contains('/Fm')){
      name = name.replaceFirst('/Fm', '');
    }
    return name;
  }
</code></pre></div></div>

<p>然后 新建 <code class="language-plaintext highlighter-rouge">AppAnalysis</code>文件。在<code class="language-plaintext highlighter-rouge">MaterialApp</code>中的<code class="language-plaintext highlighter-rouge">navigatorObservers: [AppAnalysis()],</code>引用。我使用的是配合<code class="language-plaintext highlighter-rouge">GetMaterialApp</code>使用的。整个项目使用了<code class="language-plaintext highlighter-rouge">Get</code>管理路由。</p>

<div class="language-plaintext highlighter-rouge"><div class="highlight"><pre class="highlight"><code>class AppAnalysis extends NavigatorObserver {
  @override
  void didPush(Route&lt;dynamic&gt; route, Route&lt;dynamic&gt; previousRoute) {
    // print('---didPush.Get.previousRoute:${Get.previousRoute}');
    // print('---didPush.Get.currentRoute:${Get.currentRoute}');
    FmAnalysis.onPageStart(Get.currentRoute);
  }

  @override
  void didPop(Route&lt;dynamic&gt; route, Route&lt;dynamic&gt; previousRoute) {
    // print('---didPop.Get.previousRoute:${Get.previousRoute}');
    // print('---didPop.Get.currentRoute:${Get.currentRoute}');
    FmAnalysis.onPageEnd(Get.currentRoute);
  }

  @override
  void didReplace({Route&lt;dynamic&gt; newRoute, Route&lt;dynamic&gt; oldRoute}) {
    // print('---didReplace.Get.previousRoute:${Get.previousRoute}');
    // print('---didReplace.Get.currentRoute:${Get.currentRoute}');
    // FmAnalysis.onPageEnd(Get.previousRoute);
    // FmAnalysis.onPageStart(Get.currentRoute);

  }
}
</code></pre></div></div>

<h2 id="0x007-坑07">0x007 坑07</h2>
<p>集成友盟需要问题联系不到官方人员。<br />
<strong>解决：</strong></p>
<ul>
  <li>1、提客服工单，效率极慢。</li>
  <li>2、拨打官方400客服电话咨询</li>
  <li>3、我推荐的，在线客服，连续发两次“人工”。就好转接的在线的人工客服。回复讨论问题比较及时。我之前都不知道这个方案。还是打400电话咨询官方告诉我的。</li>
</ul>

<h2 id="0x008-坑08">0x008 坑08</h2>
<p>如果把测试手机转变为正式用户测试正式环境数据是否统计。<br />
<strong>解决：</strong>直接在测试设备中删除测试手机。正常使用APP。第二天才能看到数据被统计。</p>]]></content><author><name>袁凤鸣</name></author><category term="Android" /><category term="flutter" /><category term="Android" /><category term="flutter" /><summary type="html"><![CDATA[flutter 版本的安卓项目友盟移动统计官方 umeng_common_sdk 的坑]]></summary></entry><entry><title type="html">安卓手机或者苹果手机硬件设备信息</title><link href="https://www.yfmingo.cn/2021/03/23/device-info/" rel="alternate" type="text/html" title="安卓手机或者苹果手机硬件设备信息" /><published>2021-03-23T00:00:00+00:00</published><updated>2021-03-23T00:00:00+00:00</updated><id>https://www.yfmingo.cn/2021/03/23/device-info</id><content type="html" xml:base="https://www.yfmingo.cn/2021/03/23/device-info/"><![CDATA[<hr />

<div class="language-dart highlighter-rouge"><div class="highlight"><pre class="highlight"><code>
 <span class="kd">static</span> <span class="kt">void</span> <span class="nf">getDeviceInfo</span><span class="p">()</span> <span class="kd">async</span><span class="p">{</span>
    <span class="n">DeviceInfoPlugin</span> <span class="n">deviceInfo</span> <span class="o">=</span> <span class="k">new</span> <span class="n">DeviceInfoPlugin</span><span class="p">();</span>
    <span class="k">if</span><span class="p">(</span><span class="n">Platform</span><span class="o">.</span><span class="na">isIOS</span><span class="p">){</span>
      <span class="n">IosDeviceInfo</span> <span class="n">iosInfo</span> <span class="o">=</span> <span class="k">await</span> <span class="n">deviceInfo</span><span class="o">.</span><span class="na">iosInfo</span><span class="p">;</span>
      <span class="k">await</span> <span class="n">_readIosDeviceInfo</span><span class="p">(</span><span class="n">iosInfo</span><span class="p">);</span>

    <span class="p">}</span><span class="k">else</span> <span class="k">if</span><span class="p">(</span><span class="n">Platform</span><span class="o">.</span><span class="na">isAndroid</span><span class="p">){</span>
      <span class="n">AndroidDeviceInfo</span> <span class="n">androidInfo</span> <span class="o">=</span> <span class="k">await</span> <span class="n">deviceInfo</span><span class="o">.</span><span class="na">androidInfo</span><span class="p">;</span>
      <span class="k">await</span> <span class="n">_readAndroidBuildData</span><span class="p">(</span><span class="n">androidInfo</span><span class="p">);</span>
    <span class="p">}</span>
  <span class="p">}</span>

 <span class="kd">static</span> <span class="kt">Map</span><span class="p">&lt;</span><span class="kt">String</span><span class="p">,</span> <span class="kd">dynamic</span><span class="p">&gt;</span> <span class="n">_readAndroidBuildData</span><span class="p">(</span><span class="n">AndroidDeviceInfo</span> <span class="n">build</span><span class="p">)</span> <span class="p">{</span>
    <span class="kt">Map</span><span class="p">&lt;</span><span class="kt">String</span><span class="p">,</span> <span class="kd">dynamic</span><span class="p">&gt;</span> <span class="n">map</span><span class="o">=</span>  <span class="p">&lt;</span><span class="kt">String</span><span class="p">,</span> <span class="kd">dynamic</span><span class="p">&gt;{</span>
      <span class="s">'version.securityPatch'</span><span class="o">:</span> <span class="n">build</span><span class="o">.</span><span class="na">version</span><span class="o">.</span><span class="na">securityPatch</span><span class="p">,</span><span class="c1">//用户可见的安全补丁程序级别。仅在Android 6.0或更高版本上可用。</span>
      <span class="s">'version.sdkInt'</span><span class="o">:</span> <span class="n">build</span><span class="o">.</span><span class="na">version</span><span class="o">.</span><span class="na">sdkInt</span><span class="p">,</span><span class="c1">// API 级别是对 Android 平台版本提供的框架 API 修订版进行唯一标识的整数值。// https://developer.android.com/guide/topics/manifest/uses-sdk-element</span>
      <span class="s">'version.release'</span><span class="o">:</span> <span class="n">build</span><span class="o">.</span><span class="na">version</span><span class="o">.</span><span class="na">release</span><span class="p">,</span><span class="c1">// 用户可见的版本字符串。示例：Android10</span>
      <span class="s">'version.previewSdkInt'</span><span class="o">:</span> <span class="n">build</span><span class="o">.</span><span class="na">version</span><span class="o">.</span><span class="na">previewSdkInt</span><span class="p">,</span><span class="c1">// 开发人员预览版的预发行版SDK。</span>
      <span class="s">'version.incremental'</span><span class="o">:</span> <span class="n">build</span><span class="o">.</span><span class="na">version</span><span class="o">.</span><span class="na">incremental</span><span class="p">,</span><span class="c1">// 源码控制版本号 示例： C00B171</span>
      <span class="s">'version.codename'</span><span class="o">:</span> <span class="n">build</span><span class="o">.</span><span class="na">version</span><span class="o">.</span><span class="na">codename</span><span class="p">,</span><span class="c1">// 当前开发代号，或者字符串“REL”（如果是正式的发布版本） 示例： REL</span>
      <span class="s">'version.baseOS'</span><span class="o">:</span> <span class="n">build</span><span class="o">.</span><span class="na">version</span><span class="o">.</span><span class="na">baseOS</span><span class="p">,</span><span class="c1">// 基带版本 The base OS build the product is based on. 示例：空值</span>
      <span class="s">'board'</span><span class="o">:</span> <span class="n">build</span><span class="o">.</span><span class="na">board</span><span class="p">,</span><span class="c1">// 主板 示例：FRD-AL00</span>
      <span class="s">'bootloader'</span><span class="o">:</span> <span class="n">build</span><span class="o">.</span><span class="na">bootloader</span><span class="p">,</span><span class="c1">// 系统启动程序版本号 示例：unknown</span>
      <span class="s">'brand'</span><span class="o">:</span> <span class="n">build</span><span class="o">.</span><span class="na">brand</span><span class="p">,</span><span class="c1">// 系统定制商 示例：honor</span>
      <span class="s">'device'</span><span class="o">:</span> <span class="n">build</span><span class="o">.</span><span class="na">device</span><span class="p">,</span><span class="c1">// 设备参数 示例：HWFRD</span>
      <span class="s">'display'</span><span class="o">:</span> <span class="n">build</span><span class="o">.</span><span class="na">display</span><span class="p">,</span><span class="c1">// 用于向用户显示的构建ID字符串。示例：FRD-AL00C00B171</span>
      <span class="s">'fingerprint'</span><span class="o">:</span> <span class="n">build</span><span class="o">.</span><span class="na">fingerprint</span><span class="p">,</span><span class="c1">// 设备指纹（同样的新设备该值应该是一样的） 示例：honor/FRD-AL00/HWFRD:6.0/HUAWEIFRD-AL00/C00B171:user/release-keys</span>
      <span class="s">'hardware'</span><span class="o">:</span> <span class="n">build</span><span class="o">.</span><span class="na">hardware</span><span class="p">,</span><span class="c1">// 硬件的名称（从内核命令行或/ proc）。 示例：hi3650</span>
      <span class="s">'host'</span><span class="o">:</span> <span class="n">build</span><span class="o">.</span><span class="na">host</span><span class="p">,</span><span class="c1">// Hostname 示例：huawei-RH2288H-V2-12L</span>
      <span class="s">'id'</span><span class="o">:</span> <span class="n">build</span><span class="o">.</span><span class="na">id</span><span class="p">,</span><span class="c1">// 修订版本列表 示例：HUAWEIFRD-AL00</span>
      <span class="s">'manufacturer'</span><span class="o">:</span> <span class="n">build</span><span class="o">.</span><span class="na">manufacturer</span><span class="p">,</span><span class="c1">// 产品/硬件的制造商 示例：HUAWEI</span>
      <span class="s">'model'</span><span class="o">:</span> <span class="n">build</span><span class="o">.</span><span class="na">model</span><span class="p">,</span><span class="c1">// 最终用户可见名称。示例：FRD-AL00</span>
      <span class="s">'product'</span><span class="o">:</span> <span class="n">build</span><span class="o">.</span><span class="na">product</span><span class="p">,</span><span class="c1">// 整体产品的名称。 示例：FRD-AL00</span>
      <span class="s">'supported32BitAbis'</span><span class="o">:</span> <span class="n">build</span><span class="o">.</span><span class="na">supported32BitAbis</span><span class="p">,</span><span class="c1">// 支持32位ABIs的列表（数值）示例：[armeabi-v7a,armeabi]</span>
      <span class="s">'supported64BitAbis'</span><span class="o">:</span> <span class="n">build</span><span class="o">.</span><span class="na">supported64BitAbis</span><span class="p">,</span><span class="c1">// 支持64位ABIs的列表（数值）示例：[arm64-v8a]</span>
      <span class="s">'supportedAbis'</span><span class="o">:</span> <span class="n">build</span><span class="o">.</span><span class="na">supportedAbis</span><span class="p">,</span><span class="c1">// 支持ABIs的列表（数值）示例：[arm64-v8a,armeabi-v7a,armeabi]</span>
      <span class="s">'tags'</span><span class="o">:</span> <span class="n">build</span><span class="o">.</span><span class="na">tags</span><span class="p">,</span><span class="c1">// 描述Build的标签（Comma-separated tags describing the build, like "unsigned,debug".） 示例：release-keys</span>
      <span class="s">'type'</span><span class="o">:</span> <span class="n">build</span><span class="o">.</span><span class="na">type</span><span class="p">,</span><span class="c1">// 描述Build的类型（The type of build, like "user" or "eng".） 示例：user</span>
      <span class="s">'isPhysicalDevice'</span><span class="o">:</span> <span class="n">build</span><span class="o">.</span><span class="na">isPhysicalDevice</span><span class="p">,</span><span class="c1">// 是否是真实物理设备（真机或模拟器）</span>
      <span class="s">'androidId'</span><span class="o">:</span> <span class="n">build</span><span class="o">.</span><span class="na">androidId</span><span class="p">,</span> <span class="c1">//设备唯一标识</span>
      <span class="c1">// 'systemFeatures': build.systemFeatures,</span>
    <span class="p">};</span>
    <span class="kt">String</span> <span class="n">str</span> <span class="o">=</span>  <span class="n">ConvertUtils</span><span class="o">.</span><span class="na">convert</span><span class="p">(</span><span class="n">map</span><span class="p">,</span> <span class="mi">0</span><span class="p">);</span> <span class="c1">// map to json</span>
    <span class="n">developer</span><span class="o">.</span><span class="na">log</span><span class="p">(</span><span class="n">str</span><span class="p">);</span>
    <span class="k">return</span> <span class="n">map</span><span class="p">;</span>

  <span class="p">}</span>

  <span class="kd">static</span> <span class="kt">Map</span><span class="p">&lt;</span><span class="kt">String</span><span class="p">,</span> <span class="kd">dynamic</span><span class="p">&gt;</span> <span class="n">_readIosDeviceInfo</span><span class="p">(</span><span class="n">IosDeviceInfo</span> <span class="n">data</span><span class="p">)</span> <span class="p">{</span>

    <span class="kt">Map</span><span class="p">&lt;</span><span class="kt">String</span><span class="p">,</span> <span class="kd">dynamic</span><span class="p">&gt;</span> <span class="n">map</span><span class="o">=</span>  <span class="p">&lt;</span><span class="kt">String</span><span class="p">,</span> <span class="kd">dynamic</span><span class="p">&gt;{</span>
      <span class="s">'name'</span><span class="o">:</span> <span class="n">data</span><span class="o">.</span><span class="na">name</span><span class="p">,</span><span class="c1">// 手机名称（通用关于本机里显示的名称）示例：iPhone12</span>
      <span class="s">'systemName'</span><span class="o">:</span> <span class="n">data</span><span class="o">.</span><span class="na">systemName</span><span class="p">,</span><span class="c1">// 系统名称 示例： iOS</span>
      <span class="s">'systemVersion'</span><span class="o">:</span> <span class="n">data</span><span class="o">.</span><span class="na">systemVersion</span><span class="p">,</span><span class="c1">// 系统版本号 示例： iOS 14.3</span>
      <span class="s">'model'</span><span class="o">:</span> <span class="n">data</span><span class="o">.</span><span class="na">model</span><span class="p">,</span><span class="c1">// 设备型号的名称 示例：iPhone</span>
      <span class="s">'localizedModel'</span><span class="o">:</span> <span class="n">data</span><span class="o">.</span><span class="na">localizedModel</span><span class="p">,</span><span class="c1">// 设备型号的本地化名称 示例：iPhone</span>
      <span class="s">'identifierForVendor'</span><span class="o">:</span> <span class="n">data</span><span class="o">.</span><span class="na">identifierForVendor</span><span class="p">,</span> <span class="c1">//设备唯一标识 示例：DB2E04F5-27D0-4101-8D53-F73CB0505DAD</span>
      <span class="s">'isPhysicalDevice'</span><span class="o">:</span> <span class="n">data</span><span class="o">.</span><span class="na">isPhysicalDevice</span><span class="p">,</span><span class="c1">// 是否是物理设备（真机或模拟器）示例：true</span>
      <span class="s">'utsname.sysname:'</span><span class="o">:</span> <span class="n">data</span><span class="o">.</span><span class="na">utsname</span><span class="o">.</span><span class="na">sysname</span><span class="p">,</span><span class="c1">// 操作系统名称。示例：Darwin</span>
      <span class="s">'utsname.nodename:'</span><span class="o">:</span> <span class="n">data</span><span class="o">.</span><span class="na">utsname</span><span class="o">.</span><span class="na">nodename</span><span class="p">,</span><span class="c1">// 网络上的节点名称。示例：iPhone12t</span>
      <span class="s">'utsname.release:'</span><span class="o">:</span> <span class="n">data</span><span class="o">.</span><span class="na">utsname</span><span class="o">.</span><span class="na">release</span><span class="p">,</span><span class="c1">// 当前发布级别  示例：20.2.0</span>
      <span class="s">'utsname.version:'</span><span class="o">:</span> <span class="n">data</span><span class="o">.</span><span class="na">utsname</span><span class="o">.</span><span class="na">version</span><span class="p">,</span><span class="c1">// 当前发布版本  示例：Darwin Kernel Version 20.2.0: Fri Nov 13 01:00:14 PST 2020; root:xnu-7195.62.1~4/RELEASE_ARM64_T8101</span>
      <span class="s">'utsname.machine:'</span><span class="o">:</span> <span class="n">data</span><span class="o">.</span><span class="na">utsname</span><span class="o">.</span><span class="na">machine</span><span class="p">,</span><span class="c1">// 当前硬件体系类型  示例： 'iPhone7,1' 这个就是 iPhone 6 Plus；'iPhone13,2'这个就是iPhone12</span>
    <span class="p">};</span>
    <span class="kt">String</span> <span class="n">str</span> <span class="o">=</span>  <span class="n">ConvertUtils</span><span class="o">.</span><span class="na">convert</span><span class="p">(</span><span class="n">map</span><span class="p">,</span> <span class="mi">0</span><span class="p">);</span> <span class="c1">// map to json</span>
    <span class="n">developer</span><span class="o">.</span><span class="na">log</span><span class="p">(</span><span class="n">str</span><span class="p">);</span>
    <span class="k">return</span> <span class="n">map</span><span class="p">;</span>
  <span class="p">}</span>
</code></pre></div></div>]]></content><author><name>袁凤鸣</name></author><category term="Android" /><category term="iOS" /><category term="Android" /><category term="iOS" /><summary type="html"><![CDATA[flutter]]></summary></entry><entry><title type="html">flutter 发布自己的 package 到 pub.dev</title><link href="https://www.yfmingo.cn/2020/11/27/flutter-package-release/" rel="alternate" type="text/html" title="flutter 发布自己的 package 到 pub.dev" /><published>2020-11-27T00:00:00+00:00</published><updated>2020-11-27T00:00:00+00:00</updated><id>https://www.yfmingo.cn/2020/11/27/flutter-package-release</id><content type="html" xml:base="https://www.yfmingo.cn/2020/11/27/flutter-package-release/"><![CDATA[<ul id="markdown-toc">
  <li><a href="#一package-介绍" id="markdown-toc-一package-介绍">一、Package 介绍</a></li>
  <li><a href="#二创建package工程" id="markdown-toc-二创建package工程">二、创建Package工程</a>    <ul>
      <li><a href="#0x01-发布需要屏蔽-bash_profile-中" id="markdown-toc-0x01-发布需要屏蔽-bash_profile-中">0x01 发布需要屏蔽 .bash_profile 中：</a></li>
      <li><a href="#0x02终端挂代理这样容易上传" id="markdown-toc-0x02终端挂代理这样容易上传">0x02、终端挂代理（这样容易上传）</a></li>
      <li><a href="#0x03使用-flutter-packages-pub-publish-dry-run-验证是否有-error-" id="markdown-toc-0x03使用-flutter-packages-pub-publish-dry-run-验证是否有-error-">0x03、使用 flutter packages pub publish –dry-run 验证是否有 error 。</a></li>
      <li><a href="#0x04发布" id="markdown-toc-0x04发布">0x04、发布</a></li>
      <li><a href="#0x05-终端操作记录" id="markdown-toc-0x05-终端操作记录">0x05 终端操作记录</a></li>
      <li><a href="#0x06-第二次发更新包终端操作记录" id="markdown-toc-0x06-第二次发更新包终端操作记录">0x06 第二次发更新包终端操作记录</a></li>
      <li><a href="#0x07-最终效果" id="markdown-toc-0x07-最终效果">0x07 最终效果</a></li>
    </ul>
  </li>
</ul>
<hr />

<h2 id="一package-介绍">一、Package 介绍</h2>
<p><strong><code class="language-plaintext highlighter-rouge">flutter</code> 有四种工程模式：<code class="language-plaintext highlighter-rouge">Flutter Application</code>、<code class="language-plaintext highlighter-rouge">Flutter Module</code>、<code class="language-plaintext highlighter-rouge">Flutter Plugin</code> 和 <code class="language-plaintext highlighter-rouge">Flutter Package</code></strong>。</p>

<p><strong>他们的区别如下：</strong></p>

<ul>
  <li><strong>Flutter Application</strong> ：表示一个 Flutter 项目，主体是 Flutter，当然它也可以接入 Android Module 或者 iOS Framework，其内部包含 Android 和 iOS 项目。</li>
  <li><strong>Flutter Module</strong> ：用于原生项目中插入 Flutter 模块，原生为主体，与 Flutter 进行混合开发。</li>
  <li><strong>Flutter Plugin</strong> ：表示 Flutter 插件，包含 Android 和 iOS 项目，如果你要开发一个 Plugin 且此 Plugin 涉及到原生支持，比如蓝牙功能、网络功能等，这些功能纯 Flutter 是无法实现的。这时候就要新建 Flutter Plugin工程。</li>
  <li><strong>Flutter Package</strong>：和 Flutter Plugin 基本一样，唯一的区别是Flutter Package表示纯 Flutter 模块，不需要原生开发，没有Android 和 iOS 项目，比如开发一个纯 UI 的插件。</li>
</ul>

<p>发布自己的 package 到 pub.dev</p>

<hr />

<h2 id="二创建package工程">二、创建Package工程</h2>

<h3 id="0x01-发布需要屏蔽-bash_profile-中">0x01 发布需要屏蔽 .bash_profile 中：</h3>
<div class="language-plaintext highlighter-rouge"><div class="highlight"><pre class="highlight"><code>export PUB_HOSTED_URL=https://pub.flutter-io.cn
export FLUTTER_STORAGE_BASE_URL=https://storage.flutter-io.cn
</code></pre></div></div>

<h3 id="0x02终端挂代理这样容易上传">0x02、终端挂代理（这样容易上传）</h3>
<ul>
  <li>思路步骤：挂代理VPN。然后设置终端代理。</li>
  <li>翻墙成功后 测试 <code class="language-plaintext highlighter-rouge">curl www.google.com</code> 出现一大堆字符串就是翻墙成功。也可以利用 <code class="language-plaintext highlighter-rouge">curl ip.cc</code> 查看当前<code class="language-plaintext highlighter-rouge">ip</code>是否在国外。</li>
</ul>

<h3 id="0x03使用-flutter-packages-pub-publish-dry-run-验证是否有-error-">0x03、使用 flutter packages pub publish –dry-run 验证是否有 error 。</h3>

<ul>
  <li>出现 <strong>Your pubspec.yaml includes an “author” section which is no longer used and may be removed.</strong>
    <ul>
      <li>解决 ：在 <code class="language-plaintext highlighter-rouge">yaml</code> 中 删除 <code class="language-plaintext highlighter-rouge">author</code><br />
 直到出现 <code class="language-plaintext highlighter-rouge">Package has 0 warnings.</code> 表示验证成功</li>
    </ul>
  </li>
  <li>出现 <strong>./CHANGELOG.md doesn’t mention current version (1.0.0).</strong>
    <ul>
      <li>解决：去修改 CHANGELOG 文件 记录当前版本的修改情况。</li>
    </ul>
  </li>
  <li>出现 <strong>LICENSE file LICENSE contains generic TODO.</strong>
    <ul>
      <li>去添加 LICENSE 证书 。</li>
    </ul>
  </li>
</ul>

<h3 id="0x04发布">0x04、发布</h3>

<p>发布地址：</p>

<div class="language-plaintext highlighter-rouge"><div class="highlight"><pre class="highlight"><code>flutter packages pub publish --server=https://pub.dartlang.org
</code></pre></div></div>

<p><strong>然后根据提示去 浏览器验证账号地址，浏览器要翻墙。</strong></p>

<ul>
  <li>
    <p>浏览器验证账号地址： https://accounts.google.com/o/oauth2/auth 开头的一大段。</p>
  </li>
  <li>
    <p>出现 <code class="language-plaintext highlighter-rouge">Successfully uploaded package.</code> 表示上传成功。</p>
  </li>
</ul>

<h3 id="0x05-终端操作记录">0x05 终端操作记录</h3>

<div class="language-plaintext highlighter-rouge"><div class="highlight"><pre class="highlight"><code>imac@ksddeiMac → ~/Desktop/AAAFleeming/MingoKit/FlutterAppDebug/app_debug → main ✚ ● ? →
↵ 65 → flutter packages pub publish --dry-run
Publishing app_debug 1.0.0 to https://pub.flutter-io.cn:
|-- .gitignore
|-- .metadata
|-- CHANGELOG.md
|-- LICENSE
|-- README.md
|-- lib
|   |-- app_debug.dart
|   |-- app_float_box.dart
|   |-- app_info_show_page.dart
|   '-- app_network_show_page.dart
|-- pubspec.yaml
'-- test
'-- app_debug_test.dart

Package has 0 warnings.

imac@ksddeiMac → ~/Desktop/AAAFleeming/MingoKit/FlutterAppDebug/app_debug → main ✚ ● ? →
✔ → flutter packages pub publish
Publishing app_debug 1.0.0 to https://pub.flutter-io.cn:
|-- .gitignore
|-- .metadata
|-- CHANGELOG.md
|-- LICENSE
|-- README.md
|-- lib
|   |-- app_debug.dart
|   |-- app_float_box.dart
|   |-- app_info_show_page.dart
|   '-- app_network_show_page.dart
|-- pubspec.yaml
'-- test
'-- app_debug_test.dart

Publishing is forever; packages cannot be unpublished.
Policy details are available at https://pub.dev/policy

Do you want to publish app_debug 1.0.0 (y/N)? y
Pub needs your authorization to upload packages on your behalf.
In a web browser, go to https://accounts.google.com/o/oauth2/auth?access_type=offline&amp;approval_prompt=force&amp;response_type=code&amp;client_id=818368855108-8grd2eg9tj9f38os6f1urbcvsq399u8n.apps.googleusercontent.com&amp;redirect_uri=http%3A%2F%2Flocalhost%3A59176&amp;code_challenge=-hbfWqpz0_ieEG-RXp331HCw5h1sffHRGp1L-W0kxBg&amp;code_challenge_method=S256&amp;scope=openid+https%3A%2F%2Fwww.googleapis.com%2Fauth%2Fuserinfo.email
Then click "Allow access".

Waiting for your authorization...
Authorization received, processing...
^C%

imac@ksddeiMac → ~/Desktop/AAAFleeming/MingoKit/FlutterAppDebug/app_debug → main ✚ ● ? →
↵ SIGINT(2) → ip
IP    : 219.140.141.18
地址    : 中国  湖北  武汉
运营商    : 电信

数据二    : 湖北省武汉市 | 汉口众友网吧

数据三    :

URL    : http://www.cip.cc/219.140.141.18

imac@ksddeiMac → ~/Desktop/AAAFleeming/MingoKit/FlutterAppDebug/app_debug → main ✚ ● ? →
✔ → proxy
imac@ksddeiMac → ~/Desktop/AAAFleeming/MingoKit/FlutterAppDebug/app_debug → main ✚ ● ? →
✔ → ip
IP    : 111.250.98.16
地址    : 中国  台湾  台北市
运营商    : cht.com.tw

数据二    : 台湾省台北市 | 中华电信

数据三    : 中国台湾 | 中华电信

URL    : http://www.cip.cc/111.250.98.16


imac@ksddeiMac → ~/Desktop/AAAFleeming/MingoKit/FlutterAppDebug/app_debug → main ✚ ● ? →
↵ 1 → flutter packages pub publish --server=https://pub.dartlang.org
Publishing app_debug 1.0.0 to https://pub.dartlang.org:
|-- .gitignore
|-- .metadata
|-- CHANGELOG.md
|-- LICENSE
|-- README.md
|-- lib
|   |-- app_debug.dart
|   |-- app_float_box.dart
|   |-- app_info_show_page.dart
|   '-- app_network_show_page.dart
|-- pubspec.yaml
'-- test
'-- app_debug_test.dart

Publishing is forever; packages cannot be unpublished.
Policy details are available at https://pub.dev/policy

Do you want to publish app_debug 1.0.0 (y/N)? y
Uploading...
LICENSE file `LICENSE` contains generic TODO.
pub finished with exit code 1

imac@ksddeiMac → ~/Desktop/AAAFleeming/MingoKit/FlutterAppDebug/app_debug → main ✚ ● ? →
↵ 1 → flutter packages pub publish --server=https://pub.dartlang.org
Publishing app_debug 1.0.0 to https://pub.dartlang.org:
|-- .gitignore
|-- .metadata
|-- CHANGELOG.md
|-- LICENSE
|-- README.md
|-- lib
|   |-- app_debug.dart
|   |-- app_float_box.dart
|   |-- app_info_show_page.dart
|   '-- app_network_show_page.dart
|-- pubspec.yaml
'-- test
'-- app_debug_test.dart

Publishing is forever; packages cannot be unpublished.
Policy details are available at https://pub.dev/policy

Do you want to publish app_debug 1.0.0 (y/N)? y
Uploading...
Successfully uploaded package.

imac@ksddeiMac → ~/Desktop/AAAFleeming/MingoKit/FlutterAppDebug/app_debug → main ✚ ● ? →
</code></pre></div></div>

<h3 id="0x06-第二次发更新包终端操作记录">0x06 第二次发更新包终端操作记录</h3>

<div class="language-plaintext highlighter-rouge"><div class="highlight"><pre class="highlight"><code>
imac@ksddeiMac → ~/Desktop/AAAFleeming/MingoKit/FlutterAppDebug/app_debug → main ✚ ● ? →
✔ → ip
IP    : 111.250.98.16
地址    : 中国  台湾  台北市
运营商    : cht.com.tw

数据二    : 台湾省台北市 | 中华电信

数据三    :

URL    : http://www.cip.cc/111.250.98.16

imac@ksddeiMac → ~/Desktop/AAAFleeming/MingoKit/FlutterAppDebug/app_debug → main ✚ ● ? →
✔ → flutter packages pub publish --server=https://pub.dartlang.org
zsh: correct 'packages' to '.packages' [nyae]? n
Publishing app_debug 1.0.1 to https://pub.dartlang.org:
|-- .flutter-plugins
|-- .gitignore
|-- .idea
|   |-- codeStyles
|   |   '-- Project.xml
|   |-- libraries
|   |   |-- Dart_Packages.xml
|   |   |-- Dart_SDK.xml
|   |   '-- Flutter_Plugins.xml
|   |-- modules.xml
|   |-- vcs.xml
|   '-- workspace.xml
|-- .metadata
|-- CHANGELOG.md
|-- LICENSE
|-- README.md
|-- app_debug.iml
|-- example
|   '-- example.md
|-- lib
|   |-- app_debug.dart
|   |-- app_float_box.dart
|   |-- app_info_show_page.dart
|   '-- app_network_show_page.dart
|-- pubspec.yaml
'-- test
'-- app_debug_test.dart

Publishing is forever; packages cannot be unpublished.
Policy details are available at https://pub.dev/policy

Do you want to publish app_debug 1.0.1 (y/N)? y
Uploading...
Successfully uploaded package.

</code></pre></div></div>

<h3 id="0x07-最终效果">0x07 最终效果</h3>
<p><strong>pub.dev 成品链接</strong> <a href="https://pub.dev/packages/app_debug">https://pub.dev/packages/app_debug</a><br />
<img src="https://yfmingo.oss-cn-beijing.aliyuncs.com/images/20201130113844.png" alt="" /><br />
<img src="https://yfmingo.oss-cn-beijing.aliyuncs.com/images/20201130111201.jpg" alt="" /></p>]]></content><author><name>袁凤鸣</name></author><category term="flutter" /><category term="flutter" /><summary type="html"><![CDATA[flutter 发布自己的 package 到 pub.dev]]></summary></entry><entry><title type="html">mac 使用技巧,持续更新ing</title><link href="https://www.yfmingo.cn/2020/09/08/mac-useful/" rel="alternate" type="text/html" title="mac 使用技巧,持续更新ing" /><published>2020-09-08T00:00:00+00:00</published><updated>2020-09-08T00:00:00+00:00</updated><id>https://www.yfmingo.cn/2020/09/08/mac-useful</id><content type="html" xml:base="https://www.yfmingo.cn/2020/09/08/mac-useful/"><![CDATA[<ul id="markdown-toc">
  <li><a href="#mac-使用技巧" id="markdown-toc-mac-使用技巧">mac 使用技巧</a>    <ul>
      <li><a href="#0x01-mac-给-iphone-充电不是上电" id="markdown-toc-0x01-mac-给-iphone-充电不是上电">0x01 mac 给 iPhone 充电不是上电</a></li>
      <li><a href="#0x02-忘记mac电脑密码时重置管理员密码" id="markdown-toc-0x02-忘记mac电脑密码时重置管理员密码">0x02 忘记Mac电脑密码时重置管理员密码</a></li>
    </ul>
  </li>
</ul>
<hr />

<h2 id="mac-使用技巧">mac 使用技巧</h2>

<h3 id="0x01-mac-给-iphone-充电不是上电">0x01 mac 给 iPhone 充电不是上电</h3>
<p><strong>Q：</strong>数据线连接 mac 给 iPhone 充电不是上电。电池图标一直断断续续闪烁。<br />
<strong>A：</strong>解决方法：打开终端Terminal，输入</p>
<ul>
  <li><strong>sudo killall -STOP -c usbd</strong> 命令回车，即可把进程关闭。插上<code class="language-plaintext highlighter-rouge">iPhone</code>，正常连接，问题解决。</li>
</ul>

<hr />
<h3 id="0x02-忘记mac电脑密码时重置管理员密码">0x02 忘记Mac电脑密码时重置管理员密码</h3>

<p><strong>Q：</strong> 如果您无法在重新启动 Mac 后使用新密码登录，可尝试重新设置密码 ，请完成以下额外步骤：</p>

<p><strong>A：</strong>解决步骤：</p>

<ol>
  <li>再次重新启动 Mac，然后立即按住 <code class="language-plaintext highlighter-rouge">Command-R</code> 或其他 <code class="language-plaintext highlighter-rouge">macOS</code> 恢复组合键之一，直到您看到 <code class="language-plaintext highlighter-rouge">Apple</code> 标志或旋转的地球。</li>
  <li>当您看到“<code class="language-plaintext highlighter-rouge">macOS</code> 实用工具”窗口时，请从菜单栏中选取“实用工具”&gt;“终端”。</li>
  <li>在“终端”窗口中，键入 <code class="language-plaintext highlighter-rouge">resetpassword</code>，然后按下 Return 键以打开上图所示的“重设密码”助理。</li>
  <li>选择“我的密码在登录时无法正常工作”，然后点按“下一步”，并按照屏幕上适用于您用户帐户的说明操作。</li>
</ol>

<hr />]]></content><author><name>袁凤鸣</name></author><category term="mac" /><category term="mac" /><summary type="html"><![CDATA[mac使用技巧]]></summary></entry></feed>