<?xml version="1.0" encoding="UTF-8"?><rss xmlns:dc="http://purl.org/dc/elements/1.1/" xmlns:content="http://purl.org/rss/1.0/modules/content/" xmlns:atom="http://www.w3.org/2005/Atom" version="2.0" xmlns:cc="http://cyber.law.harvard.edu/rss/creativeCommonsRssModule.html">
    <channel>
        <title><![CDATA[Stories by Paul Wu on Medium]]></title>
        <description><![CDATA[Stories by Paul Wu on Medium]]></description>
        <link>https://medium.com/@easylive1989?source=rss-e16ddedcd5d2------2</link>
        <image>
            <url>https://cdn-images-1.medium.com/fit/c/150/150/1*V8n4QhLtgr5F0XWf4XrzSg.png</url>
            <title>Stories by Paul Wu on Medium</title>
            <link>https://medium.com/@easylive1989?source=rss-e16ddedcd5d2------2</link>
        </image>
        <generator>Medium</generator>
        <lastBuildDate>Sat, 21 Nov 2026 13:59:09 GMT</lastBuildDate>
        <atom:link href="https://medium.com/@easylive1989/feed" rel="self" type="application/rss+xml"/>
        <webMaster><![CDATA[yourfriends@medium.com]]></webMaster>
        <atom:link href="http://medium.superfeedr.com/" rel="hub"/>
        <item>
            <title><![CDATA[開發筆記 — 把複雜的動畫任務變拆小]]></title>
            <link>https://medium.com/%E4%BF%9D%E7%BE%85%E7%9A%84-flutter-%E9%96%8B%E7%99%BC%E6%8A%80%E5%B7%A7/%E9%96%8B%E7%99%BC%E7%AD%86%E8%A8%98-%E6%8A%8A%E8%A4%87%E9%9B%9C%E7%9A%84%E5%8B%95%E7%95%AB%E4%BB%BB%E5%8B%99%E8%AE%8A%E6%8B%86%E5%B0%8F-8293b98990dd?source=rss-e16ddedcd5d2------2</link>
            <guid isPermaLink="false">https://medium.com/p/8293b98990dd</guid>
            <category><![CDATA[flutter]]></category>
            <category><![CDATA[animation]]></category>
            <category><![CDATA[devtips]]></category>
            <dc:creator><![CDATA[Paul Wu]]></dc:creator>
            <pubDate>Fri, 19 Jun 2026 14:40:44 GMT</pubDate>
            <atom:updated>2026-06-19T14:46:06.909Z</atom:updated>
            <content:encoded><![CDATA[<h3>開發筆記 — 把複雜的動畫任務變拆小</h3><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/0*2vtm4NGRknXsJLDY" /><figcaption>Photo by <a href="https://unsplash.com/@kanhaiyasharma?utm_source=medium&amp;utm_medium=referral">Kanhaiya Sharma</a> on <a href="https://unsplash.com/?utm_source=medium&amp;utm_medium=referral">Unsplash</a></figcaption></figure><p>在軟體開發中有個 Baby Step 原則，這個原則是希望將任務拆小，每完成一個小任務就確認方向或做法是否正確可行，避免整個做完才發現方向錯了，又或者發現做法不可行。</p><p>我覺得這是非常實用的原則，可以把又複雜又大的事情變簡單。但有時候實踐起來挺困難的，會覺得不知道如何拆分，彼此之間好像都有關聯，沒辦法獨立拆開來完成。</p><p>做動畫就是其中之一。</p><p>前陣子接到一個任務，這個任務目標是實作新手教學，在新手教學中有一步教學是要用動畫來引導使用者滑動螢幕。</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/160/1*zq8zuPA7QEodakEq7zOgLQ.gif" /></figure><p>剛開始看到就覺得稍微有點複雜，要畫多層圈，每個圈都要套上動畫，還有一個滑動軌跡的動畫。</p><p>剛開始覺得花一些時間想一下，要整個設計想好才能開始動工。</p><p>那時就在想，製作動畫的工作能不能拆小？能不能不要一口氣做這麼大的設計呢？</p><p>忽然靈光一閃，覺得好像有機會： 一開始就簡單地做一個圓圈網上的動畫。</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/160/1*cPluZbX9vobwvelTUGBDRg.gif" /></figure><p>接著既然動畫都有了，就只是在原本的圓圈上多加幾個圈，好像也很簡單。</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/160/1*YliLn7L5qeNQVA_eOTq2Iw.gif" /></figure><p>最後就是，既然圓圈的動畫都有了，那就能來獨立考慮軌跡的動畫怎麼做了，相對來說也比較簡單。</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/160/1*A717vYo2MFEgkpS68_FnTA.gif" /></figure><p>將動畫的每個部分都拆成獨立的元件來製作，能減輕一些製作動畫上的負擔。</p><p>後記：這是去年的心得 🤣 ，在整理資料時發現好像也可以寫成部落格，所以現在才發上來。不過說實在的，現在這種需求比較明確的任務，大家應該都直接叫 AI 做了，可能比較少需要透過拆小的方式來減輕實作上的困難。</p><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=8293b98990dd" width="1" height="1" alt=""><hr><p><a href="https://medium.com/%E4%BF%9D%E7%BE%85%E7%9A%84-flutter-%E9%96%8B%E7%99%BC%E6%8A%80%E5%B7%A7/%E9%96%8B%E7%99%BC%E7%AD%86%E8%A8%98-%E6%8A%8A%E8%A4%87%E9%9B%9C%E7%9A%84%E5%8B%95%E7%95%AB%E4%BB%BB%E5%8B%99%E8%AE%8A%E6%8B%86%E5%B0%8F-8293b98990dd">開發筆記 — 把複雜的動畫任務變拆小</a> was originally published in <a href="https://medium.com/%E4%BF%9D%E7%BE%85%E7%9A%84-flutter-%E9%96%8B%E7%99%BC%E6%8A%80%E5%B7%A7">保羅的 Flutter 開發技巧</a> on Medium, where people are continuing the conversation by highlighting and responding to this story.</p>]]></content:encoded>
        </item>
        <item>
            <title><![CDATA[請 AI 來找碴！我的 Heptabase 筆記活化實驗]]></title>
            <link>https://medium.com/%E4%BF%9D%E7%BE%85%E7%9A%84-flutter-%E9%96%8B%E7%99%BC%E6%8A%80%E5%B7%A7/%E8%AB%8B-ai-%E4%BE%86%E6%89%BE%E7%A2%B4-%E6%88%91%E7%9A%84-heptabase-%E7%AD%86%E8%A8%98%E6%B4%BB%E5%8C%96%E5%AF%A6%E9%A9%97-30bd0061ea23?source=rss-e16ddedcd5d2------2</link>
            <guid isPermaLink="false">https://medium.com/p/30bd0061ea23</guid>
            <category><![CDATA[ai-agent]]></category>
            <category><![CDATA[heptabase]]></category>
            <dc:creator><![CDATA[Paul Wu]]></dc:creator>
            <pubDate>Sun, 15 Mar 2026 14:26:18 GMT</pubDate>
            <atom:updated>2026-06-19T09:28:19.940Z</atom:updated>
            <content:encoded><![CDATA[<figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/0*sBodRttJ-WeMCT2r" /><figcaption>Photo by <a href="https://unsplash.com/@earbiscuits?utm_source=medium&amp;utm_medium=referral">Juan Rumimpunu</a> on <a href="https://unsplash.com/?utm_source=medium&amp;utm_medium=referral">Unsplash</a></figcaption></figure><p>工程師或多或少都會做一些筆記，紀錄一些工作心得，技術實踐細節 ……等內容，但最大的痛點往往是：<strong>寫了不等於記住，更難確保關鍵時刻能派上用場。</strong></p><p>自己在 Heptabase 上記了一大堆內容，但只有偶爾才會回來看這些內容。而且如果單純的重新閱讀，大多時候也不會從這些筆記中找出更新的體悟，效益也不高。</p><p>只有真的在工作碰到有關的問題，自己有突然想到跟筆記的某一段有關係，才會有機會再回頭重新思考。</p><p>有時候就會想，是不是能找個人來看看我的筆記，一直問我一些怪問題，讓我可以從不同的角度思考，那該有多好？</p><p>現在有個完美的陪練員可以幫我，那就是 <strong>AI</strong>。</p><h3>用 Heptabase MCP 打造「刁民」助教</h3><p>Heptabase 官方提供了 <a href="https://support.heptabase.com/en/articles/12679581-how-to-use-heptabase-mcp">MCP</a> 有一陣子了，但是直到最近，我有一些多餘的 AI 扣打可以用，才在想什麼地方可以消耗。</p><p>於是就想到這個之前想做，但沒辦法做的 Idea：讓 AI 從 Heptabase 找一個白板，從這個白板中的筆記發想內容，當一個刁民來反覆地問我問題，促進我的思考。</p><p>所以我就做了一段 Prompt 如下：</p><pre>&quot;主題&quot; 白板中有很多子白板，從這群子白板中隨便挑一個白板</pre><pre>你是一個刁鑽的學生，你是試圖理解這個白板中的資料<br>你要隨機從這個白板中的資料，問我一個問題，當我回答問題時，你要嘗試用理論或數據反駁我</pre><pre>最多反駁五次，然後總結本次的討論內容，與提出可改進的理解。</pre><figure><img alt="" src="https://cdn-images-1.medium.com/max/692/1*KbLiAKsjwAowfKJngtK9ig.png" /></figure><p><strong>主題</strong>白板中有許多不同領域的筆記，讓 AI 隨機從這些挑一個領域來，讀取裡面的筆記內容來發想問題。</p><p>選擇一個主題之後，運用五個 Why 的概念，讓 AI 在我每次回答問題之後繼續追問，持續當個刁民反駁我五次。</p><h3>使用 Antigravity 來驅動</h3><p>由於 Antigravity 最近比較少使用，加上他 AI 額度好像一直被調降，所以最近比較少用到，但又覺得沒用有點浪費。</p><p>所以這次就決定使用 Antigravity 來串 Heptabase MCP，設定可以參考如下：</p><pre>{<br>  &quot;mcpServers&quot;: {<br>    &quot;heptabase-mcp&quot;: {<br>      &quot;command&quot;: &quot;npx&quot;,<br>      &quot;args&quot;: [<br>        &quot;-y&quot;,<br>        &quot;mcp-remote@latest&quot;,<br>        &quot;&lt;https://api.heptabase.com/mcp&gt;&quot;,<br>        &quot;--transport&quot;,<br>        &quot;http-only&quot;<br>      ]<br>    }<br>  }<br>}</pre><p>當跟 AI 討論問題之後，我會請 AI 總結這次討論寫成一則紀錄Antigravity 可以直接透過 MCP 把這個紀錄寫回 Heptabase，但是我沒有這麼做。</p><p>主要是因為我想保持我的 Heptabase 都是我自己理解過的寫出來的內容，所以我會先把討論結果存放在本地的資料夾中。</p><p>之後我自己再把一些消化過的內容寫回 Heptabase 中。</p><h3>實驗結果</h3><p>大概進行了一週，除了討論了繼承 vs 組合、策略模式 vs 責任鏈模式、DIP、Domain Event 的發布與儲存、代碼共有。</p><p>我個人覺得效果很不錯，往往都能從這些來回問答中挖到更深的理解，而且不會花太多時間，很適合當一天一題的挑戰。</p><h3>未來擴展方向</h3><p>最後預計把 Notebooklm 與 Notion 也串進 Antigravity 中，讓 Antigravity 可以用來當作某種 AI 輔助的學習工具。</p><p>整合 Notebooklm 的文獻和 Notion 中的各種資源，看看是不是能延伸出更不同的應用。</p><p>如果有興趣朋友可以看看下面的實際討論過程。</p><p>至於內容是否正確，觀眾可以謹慎評估，畢竟我的理解不一定對 😅ㄨ最後，如果想看個實際討論過程可以到<a href="https://paul-learning.dev/4b3ce25e/3238303f-78f7-80ff-be85-d8438e337a89/#%E5%AF%A6%E9%9A%9B%E9%81%8E%E7%A8%8B%E4%BB%A3%E7%A2%BC%E5%85%B1%E6%9C%89%E7%9A%84%E8%A8%8E%E8%AB%96">這邊</a>。</p><p>至於內容是否正確，觀眾可以謹慎評估，畢竟我的理解不一定對 😅</p><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=30bd0061ea23" width="1" height="1" alt=""><hr><p><a href="https://medium.com/%E4%BF%9D%E7%BE%85%E7%9A%84-flutter-%E9%96%8B%E7%99%BC%E6%8A%80%E5%B7%A7/%E8%AB%8B-ai-%E4%BE%86%E6%89%BE%E7%A2%B4-%E6%88%91%E7%9A%84-heptabase-%E7%AD%86%E8%A8%98%E6%B4%BB%E5%8C%96%E5%AF%A6%E9%A9%97-30bd0061ea23">請 AI 來找碴！我的 Heptabase 筆記活化實驗</a> was originally published in <a href="https://medium.com/%E4%BF%9D%E7%BE%85%E7%9A%84-flutter-%E9%96%8B%E7%99%BC%E6%8A%80%E5%B7%A7">保羅的 Flutter 開發技巧</a> on Medium, where people are continuing the conversation by highlighting and responding to this story.</p>]]></content:encoded>
        </item>
        <item>
            <title><![CDATA[這個 Flutter 小技巧，讓你看懂 Widget Test 到底哪裡壞了]]></title>
            <link>https://medium.com/%E4%BF%9D%E7%BE%85%E7%9A%84-flutter-%E9%96%8B%E7%99%BC%E6%8A%80%E5%B7%A7/%E9%80%99%E5%80%8B-flutter-%E5%B0%8F%E6%8A%80%E5%B7%A7-%E8%AE%93%E4%BD%A0%E7%9C%8B%E6%87%82-widget-test-%E5%88%B0%E5%BA%95%E5%93%AA%E8%A3%A1%E5%A3%9E%E4%BA%86-7860f4db1d6e?source=rss-e16ddedcd5d2------2</link>
            <guid isPermaLink="false">https://medium.com/p/7860f4db1d6e</guid>
            <category><![CDATA[widget-testing]]></category>
            <category><![CDATA[flutter]]></category>
            <category><![CDATA[devtips]]></category>
            <dc:creator><![CDATA[Paul Wu]]></dc:creator>
            <pubDate>Sun, 05 Oct 2025 10:37:14 GMT</pubDate>
            <atom:updated>2025-10-05T12:27:05.590Z</atom:updated>
            <content:encoded><![CDATA[<figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/0*jwyFn18wxYEHx9Dh" /><figcaption>Photo by <a href="https://unsplash.com/@miabaker?utm_source=medium&amp;utm_medium=referral">Mia Baker</a> on <a href="https://unsplash.com/?utm_source=medium&amp;utm_medium=referral">Unsplash</a></figcaption></figure><p>在 Flutter 開發中，我們除了寫程式之外，也會需要寫一些測試來確保功能沒有問題。Flutter SDK 內建提供了 Unit Test、Widget Test 與 Integration Test 三種測試工具供開發人員使用。這三種工具分別有些不同特性，Unit Test 無論是執行速度或是錯誤訊息清晰度，都要比 Integration Test 要來得好很多。</p><p>在 Flutter 開發中，除了撰寫功能程式碼之外，撰寫測試也是確保應用穩定性的重要一環。Flutter SDK 內建提供了三種測試工具：<strong>Unit Test</strong>、<strong>Widget Test</strong> 與 <strong>Integration Test</strong>。這三者的主要差異在於測試的層級與執行效能，其中 <strong>Unit Test</strong> 速度最快、錯誤訊息最清晰；而 <strong>Integration Test</strong></p><p>涵蓋範圍最廣，但速度最慢、維護成本也最高。</p><figure><img alt="https://docs.flutter.dev/testing/overview" src="https://cdn-images-1.medium.com/proxy/0*uzRuynsrzvAsJEd4" /><figcaption><a href="https://docs.flutter.dev/testing/overview">https://docs.flutter.dev/testing/overview</a></figcaption></figure><p>相較之下，<strong>Widget Test</strong> 的執行速度僅略慢於 Unit Test，但其錯誤訊息往往不夠直覺。例如，下列訊息僅指出某個 Widget 找不到，卻無法明確告訴我們原因：</p><pre>Expected: no matching candidates<br>  Actual: _TextWidgetFinder:&lt;Found 1 widget with text &quot;1&quot;: [<br>            Text(&quot;1&quot;, debugLabel: (englishLike headlineMedium 2021).merge((blackMountainView<br>headlineMedium).apply), inherit: false, color: Color(alpha: 1.0000, red: 0.1137, green: 0.1059,<br>blue: 0.1255, colorSpace: ColorSpace.sRGB), family: Roboto, size: 28.0, weight: 400, letterSpacing:<br>0.0, baseline: alphabetic, height: 1.3x, leadingDistribution: even, decoration: Color(alpha: 1.0000,<br>red: 0.1137, green: 0.1059, blue: 0.1255, colorSpace: ColorSpace.sRGB) TextDecoration.none,<br>dependencies: [DefaultSelectionStyle, DefaultTextStyle, MediaQuery]),</pre><p>造成測試失敗的原因可能很多：邏輯錯誤、畫面未刷新、Widget 被遮擋 ……單靠這樣的訊息，很難快速定位問題，也因此 Widget Test 維護成本較高。</p><h4>使用 debugDumpApp 顯示 Widget Tree</h4><p>若上網搜尋「如何除錯 Widget Test」，很容易找到 Flutter 提供的 debugDumpApp API。這個工具可以輸出整個 Widget Tree，理論上可協助我們檢查畫面結構是否正確（<a href="https://dartpad.dev/?id=97d3dae3a802cc1d3076998ca6c43772">完整範例在這裡</a>）。</p><pre>AutomatedTestWidgetsFlutterBinding - DEBUG MODE<br>[root]<br>└View(state: _ViewState#f6410)<br> └RawView<br>  └_RawViewInternal-[_DeprecatedRawViewKey TestFlutterView#36943](renderObject: _ReusableRenderView#62b88)<br>   └_ViewScope<br>    └_PipelineOwnerScope<br>     └_MediaQueryFromView(state: _MediaQueryFromViewState#8f554)<br>      └MediaQuery(MediaQueryData(size: Size(800.0, 600.0), devicePixelRatio: 3.0, textScaler: no scaling, platformBrightness: Brightness.light, padding: EdgeInsets.zero, viewPadding: EdgeInsets.zero, viewInsets: EdgeInsets.zero, systemGestureInsets: EdgeInsets.zero, alwaysUse24HourFormat: false, accessibleNavigation: false, highContrast: false, onOffSwitchLabels: false, disableAnimations: false, invertColors: false, boldText: false, navigationMode: traditional, gestureSettings: DeviceGestureSettings(touchSlop: null), displayFeatures: [], supportsShowingSystemContextMenu: false))<br>       └FocusTraversalGroup(policy: ReadingOrderTraversalPolicy#9bb45, state: _FocusTraversalGroupState#c8c8d)<br>        └Focus(debugLabel: &quot;FocusTraversalGroup&quot;, focusNode: _FocusTraversalGroupNode#1ee5d(FocusTraversalGroup [IN FOCUS PATH]), state: _FocusState#deea3)<br>         └_FocusInheritedScope<br>          └_FocusScopeWithExternalFocusNode(debugLabel: &quot;View Scope&quot;, focusNode: FocusScopeNode#98f92(View Scope [IN FOCUS PATH]), dependencies: [_FocusInheritedScope], state: _FocusScopeState#7ba60)<br>           └_FocusInheritedScope<br>            └MyApp</pre><p>但實際使用後會發現，這份輸出往往冗長又難以閱讀。即使是一個簡單的 Counter App，Widget Tree 也可能超過兩百行，每行還充滿細節資訊。因此，透過 debugDumpApp 來排查畫面問題在實務上並不方便。</p><p>那麼，我們該怎麼辦？在介紹解法之前，先來認識另一種測試方式 — — <strong>Golden Test</strong>。</p><h4>什麼是 Golden Test</h4><p>除了常見的 Unit Test、Widget Test 與 Integration Test 之外，Flutter 還有第四種測試：<strong>Golden Test</strong>。它不是用程式邏輯比對結果，而是透過<strong>畫面比對</strong>的方式確認 UI 是否異動。</p><p>Golden Test 的原理很簡單：</p><ol><li>先將正確的畫面狀態儲存為基準圖（snapshot）。</li><li>下次執行測試時，再將目前畫面與基準圖比較。</li><li>若畫面有任何變化，就會自動產生差異圖檔，讓開發者快速檢查變動位置。</li></ol><p>使用方式也很直觀：</p><pre>expect(find.byType(MaterialApp), matchesGoldenFile(&quot;snapshot.png&quot;));</pre><p>若結果不同，Flutter 會在 snapshot.png 旁邊自動產生比較結果，使用者就能確認變動是否預期：</p><pre>test<br>├── failures<br>│   ├── snapshot_isolatedDiff.png<br>│   ├── snapshot_maskedDiff.png<br>│   ├── snapshot_masterImage.png<br>│   ├── snapshot_testImage.png<br>├── snapshot.png<br>└── widget_test.dart</pre><p>如果確認畫面變動是預期內的修改，只需執行以下指令即可更新基準圖：</p><pre>flutter test --update-goldens</pre><p>聰明的你可能已經想到：我們能否利用 Golden Test 的特性，讓 Widget Test 也能快速檢查畫面呢？</p><h4>使用 matchesGoldenFile 直接顯示畫面</h4><p>在 Widget Test 中，我們雖然不是真的在做 Golden Test，但其實還是可以使用 matchesGoldenFile 來將當前的畫面結果印出來。印出來之後，我們就能更快的檢查畫面是不是符合預期，而不用看 debugDumpApp 的那一長串資料了。</p><p>雖然在 Widget Test 中我們並非真正執行 Golden Test，但仍可透過 matchesGoldenFile 來<strong>輸出當前畫面結果</strong>。</p><p>這樣一來，我們就能以圖像的方式檢查畫面是否如預期，而不必苦讀 debugDumpApp 的長篇輸出。</p><figure><img alt="" src="https://cdn-images-1.medium.com/proxy/1*pjLyVZrHaHgHVqVM91XJIw.png" /></figure><p>儘管測試環境中使用的字型可能與真實 App 不同（例如無法顯示文字或 Icon），但大部分畫面元素仍足以協助我們判斷 UI 是否正常。</p><p>下次當 Widget Test 報錯卻不知從何下手時，試著加入 matchesGoldenFile，你可能能立刻看出問題所在。</p><p><strong>注意事項</strong>：matchesGoldenFile 在 Widget Test 只是一種用來 Debug 的手段，不適合一直放在測試中，務必在問題解決之後移除。</p><h4>小結</h4><p>Widget Test 是在速度與真實性之間取得平衡的測試方式，能快速驗證 App 的行為並提升測試覆蓋率。然而，它的除錯難度也較高。</p><p>在進行逐步除錯（debug）之前，不妨先透過 matchesGoldenFile 生成畫面快照，快速比對結果。這個簡單的技巧，常能讓你瞬間發現問題根源。</p><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=7860f4db1d6e" width="1" height="1" alt=""><hr><p><a href="https://medium.com/%E4%BF%9D%E7%BE%85%E7%9A%84-flutter-%E9%96%8B%E7%99%BC%E6%8A%80%E5%B7%A7/%E9%80%99%E5%80%8B-flutter-%E5%B0%8F%E6%8A%80%E5%B7%A7-%E8%AE%93%E4%BD%A0%E7%9C%8B%E6%87%82-widget-test-%E5%88%B0%E5%BA%95%E5%93%AA%E8%A3%A1%E5%A3%9E%E4%BA%86-7860f4db1d6e">這個 Flutter 小技巧，讓你看懂 Widget Test 到底哪裡壞了</a> was originally published in <a href="https://medium.com/%E4%BF%9D%E7%BE%85%E7%9A%84-flutter-%E9%96%8B%E7%99%BC%E6%8A%80%E5%B7%A7">保羅的 Flutter 開發技巧</a> on Medium, where people are continuing the conversation by highlighting and responding to this story.</p>]]></content:encoded>
        </item>
        <item>
            <title><![CDATA[Widget Test 的 tap 原來這樣運作？一探 Flutter 測試點擊的祕密]]></title>
            <link>https://medium.com/%E4%BF%9D%E7%BE%85%E7%9A%84-flutter-%E9%96%8B%E7%99%BC%E6%8A%80%E5%B7%A7/widget-test-%E7%9A%84-tap-%E5%8E%9F%E4%BE%86%E9%80%99%E6%A8%A3%E9%81%8B%E4%BD%9C-%E4%B8%80%E6%8E%A2-flutter-%E6%B8%AC%E8%A9%A6%E9%BB%9E%E6%93%8A%E7%9A%84%E7%A5%95%E5%AF%86-a288f0194e4f?source=rss-e16ddedcd5d2------2</link>
            <guid isPermaLink="false">https://medium.com/p/a288f0194e4f</guid>
            <category><![CDATA[widget-testing]]></category>
            <category><![CDATA[flutter]]></category>
            <category><![CDATA[flutter-framework]]></category>
            <dc:creator><![CDATA[Paul Wu]]></dc:creator>
            <pubDate>Sat, 23 Aug 2025 08:26:51 GMT</pubDate>
            <atom:updated>2025-08-23T08:26:51.226Z</atom:updated>
            <content:encoded><![CDATA[<figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*4PEoDupZG4O9dHjv0PvF0g.png" /></figure><p>前陣子有同事問我：「WidgetTester 中的 tap 方法，到底是點擊卡片的哪個位置？它是真的模擬使用者的點擊行為，還是單純呼叫底層某個 callback 來觸發事件？」當下我其實不太確定，只好回家趕快研究一下。</p><p>雖然這些細節在大部分情境下不影響我們的日常測試，但世事難料，總有可能哪天派得上用場。所以趁有空時，就來探索一下這個小細節吧。</p><p>今天分享的內容會包含不少原始碼，如果你對底層實作細節沒有興趣，可以考慮先跳過。</p><h3>WidgetTester 的 tap 方法</h3><p>首先來看 tap 的實作，這應該能回答第一個問題：<strong>tap 方法到底是點擊 Widget 的哪個位置？</strong></p><p>從程式碼中可以看到，它實際上呼叫了 tapAt，並傳入 getCenter(...)。光從名稱就能推測出來：tap 點擊的是 <strong>Widget 的中心點</strong>。</p><pre>Future&lt;void&gt; tap(<br>  finders.FinderBase&lt;Element&gt; finder, {<br>  int? pointer,<br>  int buttons = kPrimaryButton,<br>  bool warnIfMissed = true,<br>  PointerDeviceKind kind = PointerDeviceKind.touch,<br>}) {<br>  return tapAt(<br>    getCenter(finder, warnIfMissed: warnIfMissed, callee: &#39;tap&#39;),<br>    pointer: pointer,<br>    buttons: buttons,<br>    kind: kind,<br>  );<br>}</pre><p>接下來的問題就是：它是怎麼找到「中心點」的？</p><h3>找尋 Widget 中心點</h3><p>往下追 getCenter 的實作，可以看到它呼叫了 _getElementPoint，這個方法的功能就是：<strong>計算 Widget 某個位置的 Global 座標</strong>。</p><pre>Offset getCenter(<br>  finders.FinderBase&lt;Element&gt; finder, {<br>  bool warnIfMissed = false,<br>  String callee = &#39;getCenter&#39;,<br>}) {<br>  return _getElementPoint(<br>    finder,<br>    (Size size) =&gt; size.center(Offset.zero),<br>    warnIfMissed: warnIfMissed,<br>    callee: callee,<br>  );<br>}<br><br>Offset _getElementPoint(<br>  finders.FinderBase&lt;Element&gt; finder,<br>  Offset Function(Size size) sizeToPoint, {<br>  required bool warnIfMissed,<br>  required String callee,<br>}) {<br>  TestAsyncUtils.guardSync();<br>  final Iterable&lt;Element&gt; elements = finder.evaluate();<br>  <br>  // 省略檢查細節<br>  final Element element = elements.single;<br>  final RenderObject? renderObject = element.renderObject;<br>  <br>  // 省略檢查細節<br>  final RenderBox box = element.renderObject! as RenderBox;<br>  final Offset location = box.localToGlobal(sizeToPoint(box.size));<br>  <br>  // 省略 warnIfMissed 細節<br>  return location;<br>}</pre><p>總結來說：getCenter 並不複雜，它只是透過 finder 找出 Element，再用 RenderBox 算出 Widget 中心點的 Global 座標。</p><p>除了 getCenter，還有像 getTopLeft、getBottomLeft 等方法，可以讓我們在測試中指定不同的點擊位置。</p><h3>tapAt 的點擊流程</h3><p>找到座標之後，tap 會透過 tapAt 來模擬點擊。</p><p>來看一下主要流程：</p><ol><li>tapAt 先呼叫 startGesture，建立一個 TestGesture，並執行 result.down(downLocation) 來模擬 <strong>手指按下</strong>。</li><li>接著呼叫 gesture.up() 來模擬 <strong>手指放開</strong>。</li></ol><pre>Future&lt;void&gt; tapAt(<br>  Offset location, {<br>  int? pointer,<br>  int buttons = kPrimaryButton,<br>  PointerDeviceKind kind = PointerDeviceKind.touch,<br>}) {<br>  return TestAsyncUtils.guard&lt;void&gt;(() async {<br>    final TestGesture gesture = await startGesture(<br>      location,<br>      pointer: pointer,<br>      buttons: buttons,<br>      kind: kind,<br>    );<br>    await gesture.up();<br>  });<br>}<br><br>Future&lt;TestGesture&gt; startGesture(<br>  Offset downLocation, {<br>  int? pointer,<br>  PointerDeviceKind kind = PointerDeviceKind.touch,<br>  int buttons = kPrimaryButton,<br>}) async {<br>  final TestGesture result = _createGesture(pointer: pointer, kind: kind, buttons: buttons);<br>  if (kind == PointerDeviceKind.trackpad) {<br>    // 處理觸控板的點擊行為<br>  } else {<br>    await result.down(downLocation);<br>  }<br>  return result;<br>}</pre><p>如果你曾經用 Listener 監聽過觸控事件，對這流程應該不陌生：</p><ul><li>按下時 → PointerDownEvent</li><li>放開時 → PointerUpEvent</li></ul><p>想實際觀察的人，可以參考<a href="https://dartpad.dev/?id=5b0ff587c3653927bdc93e39fddac731">這個範例</a>。</p><h3>TestGesture 如何發送事件</h3><p>那這些事件是怎麼真正「傳到 Flutter Framework」的呢？</p><p>答案就在 TestGesture 的 down 與 up 方法中。</p><pre>Future&lt;void&gt; down(Offset downLocation, {Duration timeStamp = Duration.zero}) async {<br>  <br>  // 省略檢查細節<br>  <br>  return TestAsyncUtils.guard&lt;void&gt;(() async {<br>    return _dispatcher(_pointer.down(downLocation, timeStamp: timeStamp));<br>  });<br>}</pre><p>這裡 _dispatcher 會發送一個 PointerDownEvent。在 TestGesture 的建構過程中，可以看到它實際上被綁定成 sendEventToBinding，最後透過 WidgetsBinding 把事件送進 Framework。</p><pre>TestGesture _createGesture({<br>  int? pointer,<br>  required PointerDeviceKind kind,<br>  required int buttons,<br>}) {<br>  return TestGesture(<br>    dispatcher: sendEventToBinding,<br>    kind: kind,<br>    pointer: pointer ?? _getNextPointer(),<br>    buttons: buttons,<br>  );<br>}<br><br>Future&lt;void&gt; sendEventToBinding(PointerEvent event) {<br>  return TestAsyncUtils.guard&lt;void&gt;(() async {<br>    binding.handlePointerEvent(event);<br>  });<br>}</pre><p>熟悉 Flutter 的人應該對 WidgetsBinding 不陌生。我們常用的 WidgetsBinding.instance.addPostFrameCallback(...) 就是它的功能之一。</p><p>在點擊事件的情境下，Engine 收到事件後，會透過 WidgetsBinding（更精確地說是 GestureBinding）把事件傳進 Framework，經過像 <strong>GestureArena</strong> 這樣的機制過濾與解析，最後才交給我們常用的 GestureDetector。</p><h3>整理一下</h3><p>整個 tap 的執行流程，可以簡單整理如下：</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*vXIsdiqG-HXvqXRThla8Xw.jpeg" /></figure><ol><li>呼叫 WidgetTester.tap</li><li>透過 finder 找到 Element，計算中心點的 Global 座標</li><li>呼叫 tapAt，傳入座標</li><li>建立 TestGesture 負責處理點擊</li><li>呼叫 down → 發送 PointerDownEvent</li><li>呼叫 up → 發送 PointerUpEvent</li></ol><h3>小結</h3><p>透過研究 WidgetTester.tap 的實作，我們不僅加深了對 Widget Test 使用方式的理解，也更清楚它是如何與 Flutter Framework 互動。雖然這些細節未必直接影響日常開發，但它可以視為一種「閱讀程式碼的訓練」。在 AI 不斷進步的時代，我們反而更需要具備閱讀、理解 <strong>別人程式碼</strong> 的能力。</p><p>每次遇到不熟悉的地方，都是充實知識庫的契機。在追原始碼的過程中，不只能更透徹地理解框架運作，也能從中學到設計思維與程式風格。</p><p>希望這篇文章能帶給你一些啟發。如果有任何問題，歡迎留言與我討論，感謝你讀到這裡！</p><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=a288f0194e4f" width="1" height="1" alt=""><hr><p><a href="https://medium.com/%E4%BF%9D%E7%BE%85%E7%9A%84-flutter-%E9%96%8B%E7%99%BC%E6%8A%80%E5%B7%A7/widget-test-%E7%9A%84-tap-%E5%8E%9F%E4%BE%86%E9%80%99%E6%A8%A3%E9%81%8B%E4%BD%9C-%E4%B8%80%E6%8E%A2-flutter-%E6%B8%AC%E8%A9%A6%E9%BB%9E%E6%93%8A%E7%9A%84%E7%A5%95%E5%AF%86-a288f0194e4f">Widget Test 的 tap 原來這樣運作？一探 Flutter 測試點擊的祕密</a> was originally published in <a href="https://medium.com/%E4%BF%9D%E7%BE%85%E7%9A%84-flutter-%E9%96%8B%E7%99%BC%E6%8A%80%E5%B7%A7">保羅的 Flutter 開發技巧</a> on Medium, where people are continuing the conversation by highlighting and responding to this story.</p>]]></content:encoded>
        </item>
        <item>
            <title><![CDATA[Vibe Coding 回顧]]></title>
            <link>https://medium.com/%E4%BF%9D%E7%BE%85%E7%9A%84-flutter-%E9%96%8B%E7%99%BC%E6%8A%80%E5%B7%A7/vibe-coding-%E5%9B%9E%E9%A1%A7-1a6480589360?source=rss-e16ddedcd5d2------2</link>
            <guid isPermaLink="false">https://medium.com/p/1a6480589360</guid>
            <category><![CDATA[vibe-coding]]></category>
            <category><![CDATA[other]]></category>
            <category><![CDATA[cursor]]></category>
            <dc:creator><![CDATA[Paul Wu]]></dc:creator>
            <pubDate>Thu, 07 Aug 2025 12:38:03 GMT</pubDate>
            <atom:updated>2025-08-07T12:38:03.796Z</atom:updated>
            <content:encoded><![CDATA[<figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*huPFeN-ncbb79Ro8y3Af4g.png" /></figure><p>今年 AI 能力大躍進，不斷地在社群或網路看到別人說大部分的 Code 都是由 AI 產生，讓我不禁開始懷疑自己的開發方式。去年我還只是拿著 Github Copilot 當作更智能自動補完工具，完全沒有感覺這東西是能有大改變，覺得 AI 終究只是從上下文來預測結果，終究是有其極限。</p><p>在三月的時候，剛好在 Flutter Taipei Meetup 聽了有兩個關於 AI 的主題，這才發現或許 AI 已經進步到超乎我想像的地步了，是時候改變思維，擁抱變化了。至今大約 Vibe Coding 了半年多，剛好最近想法上有轉變（最後會提到），所以先來回顧一下這半年的 AI 使用心得了。</p><p>三月那會兒，最流行的 AI 工具大概也就是 Cursor 或 Winsurf，有鑒於之前買了一年的 Github Copilot 的教訓，這次就來一個月、一個月的買 Cursor。那買了 Cursor 要用在什麼地方呢？首先在除了在工作中的產品嘗試之外，當時有個朋友找我弄個小小的自動化工具，想想這也是個挺好的機會，就來用 Vibe Coding 的方式來建立這個小工具吧。</p><h3>開始 Vibe Coding</h3><p>在開始這個 Side Project 時，我刻意選擇了自己幾乎不太懂的語言加框架，用 Electron + React + Playwright 來做一個自動化的爬蟲工具，希望自己能在開發的過程中學會這些技能（雖然事後看起來效果並不算太好）。</p><p>一開始就像坊間常見的 Vibe Coding 分享一樣，直接開始跟 AI 對話，說明我想要什麼功能，要用什麼技術，從最基礎的畫面，一點一點的增加新功能。由於我對 Electron 也不熟，加上人的惰性，所以大多時候，只要功能正常，且我看的懂它在寫什麼，生成的 Code 我大多都直接接受，不太會進一步修改。</p><h4>失去動手改的能力</h4><p>但是這樣有個缺點，那就是我只看得懂，要自己動手改就比較難。變成任何小改動，我都是請AI 來做，而不是自己做。熟悉使用 AI 工具的人也都知道，AI 一跑起來快一點也要三四十秒、一分鐘的，甚至還有更久的。但是如果知道怎麼改而且熟悉工具的話，自己改可能也不到 AI 一半時間。</p><p>我在自己的工作中也會使用 AI，常常會在內心評估每個改動到底是自己改比較快，還是 AI 改比較快。但是在不熟悉的技術中，這個評估幾乎變得沒有意義，因為幾乎都是 AI 改比較快。越常讓 AI 來改，就越加不可能出現自己改比較快的情況。</p><p>或許看起來有一些負面影響，但我想這應該就是趨勢，單一任務或許 AI 做起來比較慢，但是 AI 可以同步執行多個任務，理論上來說應該會增加生產力（前提是任務沒有相依）。</p><p>&gt; AI 削弱了開發人員自己實作的能力，但是也開啟工作同步執行的能力。就像手工製作與工廠生產，單一機器的效率中難以跟真人匹敵，但是大量機器 24 小時同時運轉就不是人類可以比較的。</p><h4>只有一個 AI 不夠</h4><p>在開發的過程中，碰到一個問題：打包 macOS 應用程式失敗。在本地端打包都沒什麼問題，但是上 CI 打包建置卻一直出錯。由於 Cursor 並無法直接讀到 Github Action 的結果，所以只好手動貼錯誤給 Cursor（或許現在有 MCP 能做到了？），請 Cursor 修復 Github Workflow 腳本。</p><p>但即便如此，Cursor 還是一直鬼打牆，無法真正的解決問題。最後只好把 Github Workflow 腳本、Github Action 錯誤，再加上我想做的事情的 Context 通通整理貼到 Claude 與 Gemini 去問，而且兩者的回答還都不同，只好自己交叉比對結果與實驗，最後才讓打包工作能在 CI 上完成。</p><p>&gt; 讓 AI 自動改 Code 非常方便，但也意味著她也只選擇一種方向來處理，方向是對是錯，是好還是壞，還是得要依靠人的判斷。</p><h3>免不了，也快不了的學習</h3><p>本想靠著 AI 實際做個東西，藉此在開發的過程中快速學一門新技術，但事後看起來還是有一定的極限，沒有想像中的這麼美好。</p><h4>Electron 線程的坑</h4><p>最初是這個工具只有使用 Electron，而沒有 React，程式也是在 Electron 中啟動 Playwright 腳本。後來加入 React 之後，想把啟動 Playwright 腳本的工作也搬到 React 中，卻怎麼一直都無法正常運作。幾過一番折騰才了解 Playwright 只能由 Node.js 啟動，所以只能放在 Electron 中，讓 React 跟 Electron 溝通呼叫腳本，無法放在 React 中。</p><p>這件工作也是來來回回請 AI 改了好幾次，每一次改就壞，過程中也出現奇奇怪怪的改法，看著都不太對勁。最後也是直接問了 AI 是否這個任務其實是有問題的，AI 才說了上面提到的問題（但也很有可能這結論也是錯的XD）。</p><p>&gt; AI 會盡全力滿足你的要求，即便這的要求不合理。如果沒有了人的判斷，可以想像如果開發時間一長，技術債會快速累積。</p><h4>測試的難處</h4><p>同樣的問題也發生在測試，自己對測試的概念還算熟悉，本來想模仿工作中測試方式，用比較大粒度的方式來測試這個工具。與常見小粒度的測試方式不同，可能訓練資料比較缺乏，所以無論我怎麼跟 AI 溝通，都得不到理想的結果。</p><p>原因可能是自己對技術的理解不夠，無法有效用該技術常見的用語與 AI 溝通，導致 AI 無法完成我想要的結果。另外一種可能是，這根本就是做不到的，但對這個語言與框架理解有限的我，也無法知道這件事。</p><p>&gt; 即便使用了 AI ，我們還是得學習相關技術，否則既限制了上限，也會浪費許多時間。</p><h3>下一步</h3><p>最後，我已經對這個 Side Project 失去了興趣，暫時不會在這個 Side Project 上繼續 Vibe Coding。同時最近也從 Cursor 跳槽到 Claude Code，所以就趁這些轉變，回顧一下這半年的過程，總結一下 Vibe Coding 不熟悉技術的體驗。</p><p>但這終究不是現實的常態，現在對於大部分開發人員來說，工作中使用的還是自己比較熟悉的技術，只是需要摸索與 AI 如何共生。自己也打算開始另外一個 Side Project，這次會使用自己熟悉的技能模仿實際工作中的流程來 Vibe Coding，看看能否帶來開發上的改變。</p><h3>小結</h3><p>透過這次 Vibe Coding 的過程，感受到動口不動手的快感，但也更清楚感受到 AI 的限制。無論如何，AI 已經開始改變了開發人員的工作方式，既要放下成見，接受 AI 的結果，也要持續學習，不斷反思與改善這個過程。</p><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=1a6480589360" width="1" height="1" alt=""><hr><p><a href="https://medium.com/%E4%BF%9D%E7%BE%85%E7%9A%84-flutter-%E9%96%8B%E7%99%BC%E6%8A%80%E5%B7%A7/vibe-coding-%E5%9B%9E%E9%A1%A7-1a6480589360">Vibe Coding 回顧</a> was originally published in <a href="https://medium.com/%E4%BF%9D%E7%BE%85%E7%9A%84-flutter-%E9%96%8B%E7%99%BC%E6%8A%80%E5%B7%A7">保羅的 Flutter 開發技巧</a> on Medium, where people are continuing the conversation by highlighting and responding to this story.</p>]]></content:encoded>
        </item>
        <item>
            <title><![CDATA[避免隱晦的程式邏輯 — 避免把細節當狀態]]></title>
            <link>https://medium.com/%E4%BF%9D%E7%BE%85%E7%9A%84-flutter-%E9%96%8B%E7%99%BC%E6%8A%80%E5%B7%A7/%E9%81%BF%E5%85%8D%E9%9A%B1%E6%99%A6%E7%9A%84%E7%A8%8B%E5%BC%8F%E9%82%8F%E8%BC%AF-%E9%81%BF%E5%85%8D%E6%8A%8A%E7%B4%B0%E7%AF%80%E7%95%B6%E7%8B%80%E6%85%8B-be6848cbb2cc?source=rss-e16ddedcd5d2------2</link>
            <guid isPermaLink="false">https://medium.com/p/be6848cbb2cc</guid>
            <category><![CDATA[devtips]]></category>
            <category><![CDATA[clean-code]]></category>
            <category><![CDATA[flutter]]></category>
            <dc:creator><![CDATA[Paul Wu]]></dc:creator>
            <pubDate>Mon, 07 Jul 2025 14:40:30 GMT</pubDate>
            <atom:updated>2025-07-07T14:43:25.904Z</atom:updated>
            <content:encoded><![CDATA[<h3><strong>避免隱晦的程式邏輯 — 避免把細節當狀態</strong></h3><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/0*f9D0LNNchN4Ama9e" /><figcaption>Photo by <a href="https://unsplash.com/@pastorrema?utm_source=medium&amp;utm_medium=referral">RT Duncan</a> on <a href="https://unsplash.com/?utm_source=medium&amp;utm_medium=referral">Unsplash</a></figcaption></figure><p>最近改開發的時候，碰到一段很難懂的 Code，讓自己看了非常久，明明程式邏輯沒多複雜，但是整體讓我覺得很不舒服，總覺得有太多東西混雜在裡面。</p><p>這段程式主要的功能是做電話號碼 OTP 驗證，功能沒有太複雜，也就是拿著使用者輸入的 OTP 驗證碼去打一隻 API 做驗證。</p><p>這段 Code 來回看了幾天，請 AI 重構了無數回，也 Rollback 無數次。</p><p>最後終於想通了到底問題在哪邊，到底是什麼讓整段程式難以理解。</p><h3>舉個例子</h3><p>先來看看下面這段簡化過的程式碼例子：</p><pre>class OtpPage extends StatefulWidget {<br>  @override<br>  _OtpPageState createState() =&gt; _OtpPageState();<br>}<br><br>class _OtpPageState extends State&lt;OtpPage&gt; {<br>  String? errorMessage;<br>  String otpCode = &quot;&quot;;<br>  <br>  Future&lt;void&gt; _verifyOtp(String otp) async {<br>    try {<br>      await otpService.verify(otp);<br>    } catch (e) {<br>   setState(() {<br>        if (e.code == &#39;INVALID_OTP&#39;) {<br>          errorMessage = &quot;OTP 驗證碼錯誤，請重新輸入&quot;;<br>     } else if (e.code == &#39;EXPIRED_OTP&#39;) {<br>          errorMessage = &quot;OTP 驗證碼已過期&quot;;<br>        }<br>      });<br>    }<br>  }<br>  <br>  @override<br>  Widget build(BuildContext context) {<br>    return Column(<br>      children: [<br>        TextField(<br>          onChanged: (value) =&gt; otpCode = value,<br>          decoration: InputDecoration(<br>            hintText: &quot;請輸入 OTP 驗證碼&quot;,<br>          ),<br>        ),<br>        ElevatedButton(<br>          onPressed: () =&gt; _verifyOtp(otpCode),<br>          child: Text(&quot;驗證&quot;),<br>        ),<br>        if (errorMessage != null)<br>          Text(<br>            errorMessage!,<br>            style: TextStyle(color: Colors.red),<br>          ),<br>      ],<br>    );<br>  }<br>}</pre><p>這段程式挺單純的，使用者輸入 OTP 驗證碼，按下驗證按鈕後就打 API 去驗證。</p><p>在驗證的時候，程式會用 try/catch 來攔截 API 回的 400/500 錯誤，並且將指定錯誤訊息存到狀態中，以供畫面顯示。</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*fyDSitZuHj-Ecj5Vkruo2Q.jpeg" /></figure><p>這功能做起來也沒什麼問題，也挺好理解的，錯誤訊息就是要顯示給使用者看的，放在 _OtpPageState 中也是合情合理。</p><p>但是如果故事只到此處，那也沒什麼好說的，難就難在需求總是會改，我們總是要回來重新閱讀這段程式碼。</p><h3>需求異動</h3><p>有天客人抱怨錯誤訊息不夠清楚，害他沒看到驗證碼錯誤的訊息，覺得怎麼系統一直沒反應，然後就很不高興的刪除 App 了。</p><p>既然客戶抱怨了，那我們只好想想辦法來解決客戶的問題。</p><p>經過 PO 與設計師討論，最終決定強化錯誤提示，讓客人可以更清楚了解現在是發什麼狀況。</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*hzAhZQTCplMGcEenz7jZrQ.jpeg" /></figure><p>這邊有個小細節，就是只有在 OTP 驗證碼錯誤的情況下才需要顯示紅框，其餘像是過期就不顯示紅框。</p><p>當開發人員看到設計之後，肯定覺得這題我會，不過就是一個 if 能解決的事，IDE 一開，手指一動，測試一跑，輕輕鬆鬆就完成了。</p><pre>class _OtpPageState extends State&lt;OtpPage&gt; {<br>  String? errorMessage;<br>  String otpCode = &quot;&quot;;<br>  String phoneNumber = &quot;0912345678&quot;;<br>  <br>  Future&lt;void&gt; _verifyOtp(String otp) async {<br>    try {<br>      await otpService.verify(otp);<br>    } catch (e) {<br>      setState(() {<br>        if (e.code == &#39;INVALID_OTP&#39;) {<br>          errorMessage = &quot;OTP 驗證碼錯誤，請重新輸入&quot;;<br>        } else if (e.code == &#39;EXPIRED_OTP&#39;) {<br>          errorMessage = &quot;OTP 驗證碼已過期&quot;;<br>        }<br>      });<br>    }<br>  }<br>  <br>  @override<br>  Widget build(BuildContext context) {<br>    return Column(<br>      children: [<br>        TextField(<br>          onChanged: (value) =&gt; otpCode = value,<br>          decoration: InputDecoration(<br>            hintText: &quot;請輸入 OTP 驗證碼&quot;,<br>          ),<br>          border: OutlineInputBorder( <br>            borderSide: BorderSide(。<br>              color: errorMessage == &quot;OTP 驗證碼錯誤，請重新輸入&quot; ? <br>                  Colors.red : <br>                  Colors.black,<br>            ), <br>          ),<br>        ),<br>        ElevatedButton(<br>          onPressed: () =&gt; _verifyOtp(otpCode),<br>          child: Text(&quot;驗證&quot;),<br>        ),<br>        if (errorMessage != null)<br>          Text(<br>            errorMessage!,<br>            style: TextStyle(color: Colors.red),<br>          ),<br>        if (errorMessage == &quot;OTP 驗證碼錯誤，請重新輸入&quot;)<br>          Row(<br>            children: [<br>              Icon(Icons.phone, color: Colors.orange),<br>              Text(&quot;請檢查您的電話號碼：&quot;),<br>              Text(<br>                phoneNumber,<br>                style: TextStyle(<br>                  fontWeight: FontWeight.bold,<br>                  color: Colors.orange,<br>                ),<br>              ),<br>            ],<br>          ),<br>      ],<br>    );<br>  }<br>}</pre><p>結果 Review 的時候一看，就出現了 errorMessage == “OTP 驗證碼錯誤，請重新輸入” 的 if 判斷。</p><p>看到這裡，你肯定會想，功能完成是完成了，但是總感覺哪裡怪怪的。</p><p>這裡就得回到我們的主題，<strong>把細節當狀態了</strong>。</p><p>由於前面錯誤訊息與錯誤狀態是一對一，所以把訊息當狀態好像也沒什麼毛病。</p><p>但當今天錯誤狀態與錯誤畫面細節不是一對一的時候，問題就出現了。</p><p>直接把畫面細節當狀態來存的時候，當未來需要根據狀態來判斷時，就會變得很麻煩。</p><p>尤其是當一個錯誤可能又會出現多個提示的時候，錯綜復雜的關係，讓閱讀的人根本不可能從當前的提示組合中理解當前是處於什麼錯誤狀態。</p><p>所以我們應該儲存的是<strong>錯誤狀態</strong>，而不是<strong>畫面細節</strong>。</p><h3>更好的做法</h3><p>了解問題之後，其實解法也就顯而易見，我們在 _OtpPageState 中應該存的是錯誤狀態，而不是錯誤訊息。</p><pre>enum OtpError {<br>  invalidOtp,<br>  expiredOtp,<br>}<br><br>class _OtpPageState extends State&lt;OtpPage&gt; {<br>  OtpError? otpError;<br>  String otpCode = &quot;&quot;;<br>  String phoneNumber = &quot;0912345678&quot;;<br>  <br>  Future&lt;void&gt; _verifyOtp(String otp) async {<br>    try {<br>      await otpService.verify(otp);<br>    } catch (e) {<br>      setState(() {<br>        if (e.code == &#39;INVALID_OTP&#39;) {<br>          otpError = OtpError.invalidOtp;<br>        } else if (e.code == &#39;EXPIRED_OTP&#39;) {<br>          otpError = OtpError.expiredOtp;<br>        }<br>      });<br>    }<br>  }<br>  <br>  String? get errorMessage {<br>    switch (otpError) {<br>      case OtpError.invalidOtp:<br>        return &quot;OTP 驗證碼錯誤，請重新輸入&quot;;<br>      case OtpError.expiredOtp:<br>        return &quot;OTP 驗證碼已過期&quot;;<br>      default:<br>        return null;<br>    }<br>  }<br>  <br>  @override<br>  Widget build(BuildContext context) {<br>    return Column(<br>      children: [<br>        TextField(<br>          onChanged: (value) =&gt; otpCode = value,<br>          decoration: InputDecoration(<br>            hintText: &quot;請輸入 OTP 驗證碼&quot;,<br>            border: OutlineInputBorder( <br>              borderSide: BorderSide(。<br>                color: otpError == OtpError.invalidOtp ? <br>                  Colors.red : <br>                  Colors.black,<br>              ), <br>            ),<br>          ),<br>        ),<br>        ElevatedButton(<br>          onPressed: () =&gt; _verifyOtp(otpCode),<br>          child: Text(&quot;驗證&quot;),<br>        ),<br>        if (errorMessage != null)<br>          Text(<br>            errorMessage!,<br>            style: TextStyle(color: Colors.red),<br>          ),<br>      ],<br>    );<br>  }<br>}</pre><p>使用 enum 來儲存錯誤狀態之後，我們要拿這個錯誤狀態來衍生更多不同的顯示，就更容易的。</p><p>當然錯誤不一定得用 enum 來表示，這部分就得視需求來決定。</p><p>但重點是儲存錯誤狀態，能讓看的人更容易理解程式碼的邏輯。</p><h3>結語</h3><p>避免把細節當狀態，是寫出易讀、易維護程式碼的重要概念。</p><p>當你發現自己在用字串比對、或是用畫面顯示的內容做邏輯判斷時，就要停下來想想：我儲存的是系統狀態，還是畫面細節？</p><p>存正確的狀態不只能讓讀的人更容易理解，也增加未來修改彈性。</p><p>記住：<strong>狀態管理的核心，是管理系統的真實狀況，而不是管理畫面的呈現細節。</strong></p><p>在 Flutter 開發中，合理運用 enum、class 和狀態管理工具，可以讓你的程式碼更清晰、更容易測試和維護。</p><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=be6848cbb2cc" width="1" height="1" alt=""><hr><p><a href="https://medium.com/%E4%BF%9D%E7%BE%85%E7%9A%84-flutter-%E9%96%8B%E7%99%BC%E6%8A%80%E5%B7%A7/%E9%81%BF%E5%85%8D%E9%9A%B1%E6%99%A6%E7%9A%84%E7%A8%8B%E5%BC%8F%E9%82%8F%E8%BC%AF-%E9%81%BF%E5%85%8D%E6%8A%8A%E7%B4%B0%E7%AF%80%E7%95%B6%E7%8B%80%E6%85%8B-be6848cbb2cc">避免隱晦的程式邏輯 — 避免把細節當狀態</a> was originally published in <a href="https://medium.com/%E4%BF%9D%E7%BE%85%E7%9A%84-flutter-%E9%96%8B%E7%99%BC%E6%8A%80%E5%B7%A7">保羅的 Flutter 開發技巧</a> on Medium, where people are continuing the conversation by highlighting and responding to this story.</p>]]></content:encoded>
        </item>
        <item>
            <title><![CDATA[避免隱晦的程式邏輯 — Index 篇]]></title>
            <link>https://medium.com/%E4%BF%9D%E7%BE%85%E7%9A%84-flutter-%E9%96%8B%E7%99%BC%E6%8A%80%E5%B7%A7/%E9%81%BF%E5%85%8D%E9%9A%B1%E6%99%A6%E7%9A%84%E7%A8%8B%E5%BC%8F%E9%82%8F%E8%BC%AF-index-cbec1d6308e7?source=rss-e16ddedcd5d2------2</link>
            <guid isPermaLink="false">https://medium.com/p/cbec1d6308e7</guid>
            <category><![CDATA[dart]]></category>
            <category><![CDATA[devtips]]></category>
            <category><![CDATA[clean-code]]></category>
            <category><![CDATA[flutter]]></category>
            <dc:creator><![CDATA[Paul Wu]]></dc:creator>
            <pubDate>Sun, 09 Mar 2025 07:25:30 GMT</pubDate>
            <atom:updated>2025-03-10T15:49:07.043Z</atom:updated>
            <content:encoded><![CDATA[<h3>避免隱晦的程式邏輯 — Index 篇</h3><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/0*2vubVRnce7yavzTL" /><figcaption>Photo by <a href="https://unsplash.com/@sarahdorweiler?utm_source=medium&amp;utm_medium=referral">Sarah Dorweiler</a> on <a href="https://unsplash.com/?utm_source=medium&amp;utm_medium=referral">Unsplash</a></figcaption></figure><p>在開發過程中，我們會使用各種資料結構來表示不同類型的資料，例如 List、Set、Map 等。List 作為一種有序的元素集合，允許重複元素，並提供基於索引（Index）的存取方式，適用於需要保持元素順序的場景。在程式中，我們經常需要與 List 互動，例如取出所有資料來顯示，或對 List 進行篩選 (where) 與轉換 (map) 等操作。</p><p>大多數情況下，對 List 的操作並不複雜，程式碼的可讀性也不會受到影響。然而，某些特定的寫法可能會降低可讀性，尤其是當我們使用索引來存取 List 時，可能會帶來潛在的問題。今天我們就來看看這些情況。</p><h3>使用 Index 表示資料</h3><p>在較舊的開發方式中，為了避免 API 直接暴露資料的屬性，可能會讓 API 回傳一個 JSON 陣列，其中每個位置代表某個特定的資料屬性。例如：</p><pre>[123, &quot;Jonh&quot;, 27, &quot;john@gamil.com&quot;, &quot;male&quot;]</pre><p>當客戶端接收到這樣的回應時，必須透過 Index 來解析資料：</p><pre>Future&lt;User&gt; getUser() async {<br>  final data = await api.get(&quot;/user&quot;).data;<br>  return User.from(<br>    id: data[0],<br>    name: data[1],<br>    age: data[2],<br>    email: data[3],<br>    gender: data[4],<br>  );<br>}</pre><p>類似地，當某個方法需要回傳多個值時，我們可能會選擇用 List 來存放結果，讓呼叫端透過 Index 來取出對應的值：</p><pre>Widget build(BuildContext context) {<br>  final results = summarizeFee(orders);<br>  return Column(<br>    children: [<br>      Text(&quot;Price ${result[0].toString()}&quot;),<br>      Text(&quot;Fee ${result[1].toString()}&quot;),<br>    ],<br>  );<br>}<br><br>List&lt;int&gt; summarizeFee(List&lt;Order&gt; orders) {<br>  var price = 0;<br>  var fee = 0;<br><br>  for (var order in orders) {<br>    price += order.price;<br>    fee += order.fee;<br>  }<br><br>  return [price, fee];<br>}</pre><p>在這些例子中，當我們閱讀 data[0] 或 results[0] 時，完全無法從字面上理解它們的意義，必須對照命名參數或其他使用處，才能弄清楚這些 Index 所代表的資訊。</p><p>那要如何解決呢？</p><p>以第一個例子來說，即便使用 List 避免了直接暴露屬性名稱，但這種方法終究是「防君子不防小人」，沒有太大的實際意義，就盡量避免使用。而對於回傳多個值的情境，我們可以改用更具可讀性的方式，例如使用具名類別或 <a href="https://dart.dev/language/records">Record</a> 來改善可讀性：</p><pre>({int price, int fee}) summarizeFee(List&lt;Order&gt; orders) {<br>  var price = 0;<br>  var fee = 0;<br>  for (var order in orders) {<br>    price += order.price;<br>    fee += order.fee;<br>  }<br>  return (price: price, fee: fee);<br>}</pre><p>接著我們來看看另一個 Index 造成的問題。</p><h3>Index 判斷</h3><p>在以下程式碼中，我們根據 index 是否為 0 來決定是否要顯示標題：</p><pre>Widget build(BuildContext context) {<br>  return Column(<br>    children: users.mapIndexed((index, user) {<br>      return Column(<br>        children: [<br>          if (index == 0)<br>            Text(&quot;User List Title&quot;),<br>          Text(user.name),<br>        ]<br>      );<br>    }).toList(),<br>  );<br>}</pre><p>乍看之下，這段程式碼可能不容易理解為何會有這個判斷條件。但細看後會發現，這是為了讓標題只顯示一次。</p><p>與其依賴 Index 來決定顯示標題的時機，我們可以直接將標題作為 Column 的第一個子元素，如下所示：</p><pre>Widget build(BuildContext context) {<br>  return Column(<br>    children: [<br>      Text(&quot;User List Title&quot;),<br>      ...users.map((user) {<br>        return Text(user.name);<br>      }),<br>    ],<br>  );<br>}</pre><p>這樣的寫法不僅更直覺，也更清楚地表達了「標題應該只顯示一次，並位於使用者名稱清單的最上方」。</p><p>然而，這仍然不完全等價於原始程式碼。原始版本的邏輯還包括「當 users 為空時，不應顯示標題」。因此，我們可以進一步調整程式碼，使其更明確地表達這一邏輯：</p><pre>Widget build(BuildContext context) {<br>  if (users.isEmpty) {<br>    return SizedBox.shrink();<br>  }<br><br>  return Column(<br>    children: [<br>      Text(&quot;User List Title&quot;),<br>      ...users.map((user) {<br>        return Text(user.name);<br>      }),<br>    ],<br>  );<br>}</pre><p>如此一來，讀者能夠一眼看出程式的意圖：標題僅在 users 非空時顯示，並且只會出現一次。</p><h3>小結</h3><p>使用 Index 並非絕對不妥，而是應視情境而定。我們應該考慮索引是否真正表達了程式的意圖，還是讓讀者需要額外推理才能理解它的用途。透過適當的資料結構與語法特性，我們可以讓程式碼更易讀、更容易維護。</p><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=cbec1d6308e7" width="1" height="1" alt=""><hr><p><a href="https://medium.com/%E4%BF%9D%E7%BE%85%E7%9A%84-flutter-%E9%96%8B%E7%99%BC%E6%8A%80%E5%B7%A7/%E9%81%BF%E5%85%8D%E9%9A%B1%E6%99%A6%E7%9A%84%E7%A8%8B%E5%BC%8F%E9%82%8F%E8%BC%AF-index-cbec1d6308e7">避免隱晦的程式邏輯 — Index 篇</a> was originally published in <a href="https://medium.com/%E4%BF%9D%E7%BE%85%E7%9A%84-flutter-%E9%96%8B%E7%99%BC%E6%8A%80%E5%B7%A7">保羅的 Flutter 開發技巧</a> on Medium, where people are continuing the conversation by highlighting and responding to this story.</p>]]></content:encoded>
        </item>
        <item>
            <title><![CDATA[避免隱晦的程式邏輯]]></title>
            <link>https://medium.com/%E4%BF%9D%E7%BE%85%E7%9A%84-flutter-%E9%96%8B%E7%99%BC%E6%8A%80%E5%B7%A7/%E9%81%BF%E5%85%8D%E9%9A%B1%E6%99%A6%E7%9A%84%E7%A8%8B%E5%BC%8F%E9%82%8F%E8%BC%AF-8f267a7267e4?source=rss-e16ddedcd5d2------2</link>
            <guid isPermaLink="false">https://medium.com/p/8f267a7267e4</guid>
            <category><![CDATA[flutter]]></category>
            <category><![CDATA[devtips]]></category>
            <category><![CDATA[clean-code]]></category>
            <category><![CDATA[dart]]></category>
            <dc:creator><![CDATA[Paul Wu]]></dc:creator>
            <pubDate>Sat, 25 Jan 2025 05:54:57 GMT</pubDate>
            <atom:updated>2025-01-31T14:35:17.119Z</atom:updated>
            <content:encoded><![CDATA[<figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/0*zBjK854GP_RwPvor" /><figcaption>Photo by <a href="https://unsplash.com/@wel_shy?utm_source=medium&amp;utm_medium=referral">Daniel Welsh</a> on <a href="https://unsplash.com/?utm_source=medium&amp;utm_medium=referral">Unsplash</a></figcaption></figure><p>在開發中，我們為了完成某項功能的細部行為，可能會有很多種做法，如何評估哪種作法更好呢？其中一項準則就是清楚呈現邏輯。當程式碼能夠清楚呈現邏輯時，往後其他人在閱讀程式碼時，就能更快的了解其意圖。</p><p>就同如《先整理一下？》所提到的：「作者只有一個，但讀者通常會有很多個」，如果把邏輯用隱晦的方式完成，我們很難保證每個人對都能理解這段邏輯的意圖，而呈現意圖也是 Kent Beck 簡單設計中的一項原則。</p><h3>舉個例子</h3><p>假設畫面有兩個彈跳視窗 A 與 B，這兩個彈跳視窗有些規則，規則如下：</p><ul><li>系統會先顯示彈跳視窗 A，接著才顯示彈跳視窗 B。</li><li>如果使用者已經看過了彈跳視窗 A，則 A <strong>此後都不再顯示</strong>。</li><li>如果使用者<strong>今天</strong>看過了彈跳視窗 B，則 B <strong>今天不再顯示</strong>。</li></ul><p>根據這三個規則，我們可以很容易地寫出類似下方這樣的程式碼：</p><p>( 這裡讓我們先暫時忽略持久化的部分，畢竟這不是重點 )</p><pre>Future&lt;void&gt; showPopups() async {<br>    if (!hasPopupAShow) {<br>        await showPopupA();<br>        hasPopupAShow = true;<br>    }<br><br>    if (popupBShowDate != today()) {<br>        await showPopupB();<br>        popupBShowDate = today();<br>    }<br>}d</pre><p>這段程式碼也完整地呈現了上述的三的規則。</p><h3>事情發生了改變</h3><p>若是今天需求發生了變化，在這兩個彈窗之間，又新增了一條規則</p><ul><li>如果使用者今天看過了 A，今天之內就不要再看到 B 了。</li></ul><p>那我們應該如何調整呢？觀眾們也可以先想想看，若是自己來處理的話，會怎麼做。</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/600/1*fkscdoklHPvubX3w3ZWvjQ.png" /></figure><h3>一種作法</h3><p>一種作法是，我們可以在看完 A 的時候，順手把 B 的 popupBShowDate 也順手設了，這樣一來，當檢查到 B 的時候，自然也就會不打開 B。這個作法相當簡單，不要改動太多程式碼，只要僅僅多加一行程式碼就能完成，省時又省力。</p><pre>Future&lt;void&gt; showPopups() async {<br>    if (!hasPopupAShow) {<br>        await showPopupA();<br>        hasPopupAShow = true;<br>        popupBShowDate = today(); // 設定今天看過 B<br>    }<br><br>    if (popupBShowDate != today()) {<br>        await showPopupB();<br>        popupBShowDate = today();<br>    }<br>}</pre><p>這種作法乍聽起來也很自然：看了 A 之後，就當作 B 也看過了，但若是仔細想想，真的是這樣嗎？</p><p>但若是對於作者以外的人來說，如果對這個功能不是很了解，在爬 Code 看到這段的時候，就可能很難聯想為什麼 A 看完之後，要同時把 B 的時間也設定了，也就更難推論出當初的作法：看過 A 之後，今天之內就不要再看到 B 了 的行為。</p><h3>另一種作法</h3><p>讓我們來看看另外一種作法：把 A 的彈窗顯示紀錄從 bool 改成 DateTime，當看過 A 之後，紀錄 A 看過的時間。</p><p>接著我們就在能檢查 B 彈窗的時候，確認只有在今天都還沒看過 A 與 B 兩個彈窗時，才顯示 B。</p><pre>Future&lt;void&gt; showPopups() async {<br>    if (popupAShowDate == null) {<br>        await showPopupA();<br>        popupAShowDate = today();<br>    }<br><br>    if (popupBShowDate != today() &amp;&amp; popupAShowDate != today()) {<br>        await showPopupB();<br>        popupBShowDate = today();<br>    }<br>}</pre><p>相比於第一個作法，我們可以更清楚在邏輯中展示 A 與 B 之間的關係，向讀者說明若是今天看過 A，就不要再顯示 B 了。</p><p>雖然第二種寫法看起來比較囉唆，需要的改動也比較多，但是他能更準確地從 if 條件中看出 B 的顯示邏輯。</p><p>看完兩種作法之後，不知道你喜歡哪種呢？或者你有更好的作法，歡迎留言交流分享。</p><h3>小結</h3><p>無論第一種作法或第二種，我們都能完成功能。在完成功能之後，我們還得花時間看看我們的程式碼，確認程式碼是否符合各種設計原則，透過不斷重構，讓程式碼不斷演化的過程中，能維持品質，支持後續的改動。</p><p>年節已到，祝大家新年快樂。</p><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=8f267a7267e4" width="1" height="1" alt=""><hr><p><a href="https://medium.com/%E4%BF%9D%E7%BE%85%E7%9A%84-flutter-%E9%96%8B%E7%99%BC%E6%8A%80%E5%B7%A7/%E9%81%BF%E5%85%8D%E9%9A%B1%E6%99%A6%E7%9A%84%E7%A8%8B%E5%BC%8F%E9%82%8F%E8%BC%AF-8f267a7267e4">避免隱晦的程式邏輯</a> was originally published in <a href="https://medium.com/%E4%BF%9D%E7%BE%85%E7%9A%84-flutter-%E9%96%8B%E7%99%BC%E6%8A%80%E5%B7%A7">保羅的 Flutter 開發技巧</a> on Medium, where people are continuing the conversation by highlighting and responding to this story.</p>]]></content:encoded>
        </item>
        <item>
            <title><![CDATA[新書介紹：不可不知的 Flutter App 自動化測試實戰攻略]]></title>
            <link>https://medium.com/%E4%BF%9D%E7%BE%85%E7%9A%84-flutter-%E9%96%8B%E7%99%BC%E6%8A%80%E5%B7%A7/%E4%B8%8D%E5%8F%AF%E4%B8%8D%E7%9F%A5%E7%9A%84-flutter-app-%E8%87%AA%E5%8B%95%E5%8C%96%E6%B8%AC%E8%A9%A6%E5%AF%A6%E6%88%B0%E6%94%BB%E7%95%A5-8f6678665a9c?source=rss-e16ddedcd5d2------2</link>
            <guid isPermaLink="false">https://medium.com/p/8f6678665a9c</guid>
            <category><![CDATA[testing]]></category>
            <category><![CDATA[flutter]]></category>
            <category><![CDATA[devtips]]></category>
            <dc:creator><![CDATA[Paul Wu]]></dc:creator>
            <pubDate>Sun, 29 Dec 2024 14:07:40 GMT</pubDate>
            <atom:updated>2024-12-29T14:16:45.768Z</atom:updated>
            <content:encoded><![CDATA[<p><a href="https://ithelp.ithome.com.tw/users/20129825/ironman/4992">2022</a>、<a href="https://ithelp.ithome.com.tw/users/20129825/ironman/5974">2023</a> 連續參加了兩年鐵人賽，分別談論 Flutter 的設計與測試兩項議題，也連續兩年有幸獲得佳作，也就索性以 23 年的文章為主軸，將這些年來的開發經驗整理成冊：<a href="https://www.tenlong.com.tw/products/9786264140010?list_name=c-flutter">不可不知的 Flutter App 自動化測試實戰攻略：從設計到測試、維持產品品質的高效實踐</a>。</p><p>自從七年前接觸了敏捷開發，陸續上了許多課程與看了許多書，很多敏捷開發與 XP 相關實踐已是日常發開中一部分。其中測試就是十分重要的一環，例如軟體開發人員最耳熟能詳的 TDD (測試驅動開發) 便是其中的一部分。</p><p>雖然說寫測試並不困難，上網搜尋或問 ChatGPT 很快就能得到答案，但是通常這些答案都是比較片段，著重於如何寫，與如何融入日常開發仍有一段距離。所以本書特別著重介紹測試的部分，並實際測試一個完整小專案，讓讀者能夠以俯視角全面觀察測試如何應用在專案的每個部分。</p><h3>本書內容</h3><p>書中使用了一個已經完成的 Puzzle 專案，帶領讀者一步一步的來測試專案中的每的部分，從單元測試、Widget 測試到整合測試，從基礎到進階，帶領讀者深入探討自動化測試的奧秘。</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*DcIYTnLf8hNw93FrqsXMXA.jpeg" /></figure><p>除了介紹測試的寫法之外，也會帶入不同場景的測試該怎麼做，以及如何處理常見的測試難題。此外，書中還談論了如何重構測試，讓測試即便在數量變多，專案變大時，也能夠更輕鬆地維護這些測試。</p><p>對自動化測試有興趣的朋友，有歡迎參考看看。</p><p>雖然筆者在日常開發上會運用 TDD，但是 TDD 在本書中只有在末段的時候簡單帶過，沒有詳細討論，如果追著 TDD 而來的朋友可能失望。其主要是因為本書偏基礎向，但是使用 TDD 的前提是要熟練測試的各種基礎與進階技巧，如果連測試技巧都還沒熟練，TDD 起來也大概不順暢。不過要是對於如何在 Flutter 上 TDD 有興趣的朋友，非常歡迎聯絡我一起討論。</p><h3>後續</h3><p>在寫這本書的時候，筆者其實就有本著某些想法來安排，而當這些想法從別人的口中說出時，又是特別的感動。</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/926/1*Fq_9rZ4vZi7NK5TBm8Oh9w.png" /></figure><p>筆者也只是一個學習者，很多觀念都是從許多教練身上或大師的書中獲得，所以在寫的時候附上許多相關資源。不得不說，比起本書，這些相關資源更加來得重要，也超級無敵推薦讀者閱讀。本書只是將這些重要觀念用更具體的例子呈現，讓讀者更容易了解。（講更不好聽一些，筆者的書可以不看，大師的書可不能不讀，希望編輯不會打我XD）</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/644/1*6H1BonDjcjIFcZQqb-McTA.png" /></figure><p>筆者當初在寫的時候也確實希望 Flutter 只是一個範例，背後的軟體開發觀念才是真正重要的東西，希望這些觀念能帶領讀者走得更遠。帶著這些觀念，即便未來換了語言或工具，不再使用 Flutter 了，也能將這些觀念運用在開發工作中。</p><p>之後筆者也會在明年 (2025) 的台中社群有一場分享，主題是筆者在公司使用 Flutter 測試的心路歷程。最後，無論你是否有購買本書，有任何問題也歡迎隨時聯絡我，謝謝大家。</p><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=8f6678665a9c" width="1" height="1" alt=""><hr><p><a href="https://medium.com/%E4%BF%9D%E7%BE%85%E7%9A%84-flutter-%E9%96%8B%E7%99%BC%E6%8A%80%E5%B7%A7/%E4%B8%8D%E5%8F%AF%E4%B8%8D%E7%9F%A5%E7%9A%84-flutter-app-%E8%87%AA%E5%8B%95%E5%8C%96%E6%B8%AC%E8%A9%A6%E5%AF%A6%E6%88%B0%E6%94%BB%E7%95%A5-8f6678665a9c">新書介紹：不可不知的 Flutter App 自動化測試實戰攻略</a> was originally published in <a href="https://medium.com/%E4%BF%9D%E7%BE%85%E7%9A%84-flutter-%E9%96%8B%E7%99%BC%E6%8A%80%E5%B7%A7">保羅的 Flutter 開發技巧</a> on Medium, where people are continuing the conversation by highlighting and responding to this story.</p>]]></content:encoded>
        </item>
        <item>
            <title><![CDATA[Container — 一個你最熟悉又最陌生的 Widget]]></title>
            <link>https://medium.com/%E4%BF%9D%E7%BE%85%E7%9A%84-flutter-%E9%96%8B%E7%99%BC%E6%8A%80%E5%B7%A7/container-%E4%B8%80%E5%80%8B%E4%BD%A0%E6%9C%80%E7%86%9F%E6%82%89%E5%8F%88%E6%9C%80%E9%99%8C%E7%94%9F%E7%9A%84-widget-4d7a79ee79e6?source=rss-e16ddedcd5d2------2</link>
            <guid isPermaLink="false">https://medium.com/p/4d7a79ee79e6</guid>
            <category><![CDATA[flutter-widget]]></category>
            <category><![CDATA[flutter]]></category>
            <category><![CDATA[flutter-framework]]></category>
            <dc:creator><![CDATA[Paul Wu]]></dc:creator>
            <pubDate>Mon, 23 Dec 2024 17:00:17 GMT</pubDate>
            <atom:updated>2024-12-23T17:00:17.407Z</atom:updated>
            <content:encoded><![CDATA[<h3>Container — 一個你最熟悉又最陌生的 Widget</h3><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/0*nzN6Rlsp7PjHBQq7" /><figcaption>Photo by <a href="https://unsplash.com/@frankiefoto?utm_source=medium&amp;utm_medium=referral">frank mckenna</a> on <a href="https://unsplash.com/?utm_source=medium&amp;utm_medium=referral">Unsplash</a></figcaption></figure><p>每次在開發的時候，碰到不如預期的狀況時，都是一個非常好的機會，可以讓我們更深了解某些事。</p><p>最近在開發的時候又碰到一些意料之外的事，經過一些實驗，終於定位了問題點。</p><p>讓我們看看以下這段程式碼，在這段程式碼中，我們指定了 Container 的大小為 300 x 300，同時也指定 child 中的 Image 大小為 30 x 30。</p><pre>Container(<br>  width: 300,<br>  height: 300,<br>  color: Colors.pinkAccent,<br>  child: Image.asset(<br>    &quot;assets/images/blog.png&quot;,<br>    width: 30,<br>    height: 30,<br>  ),<br>)</pre><p>大家可以在腦海中想像一下，這段程式碼在畫面中會呈現成什麼樣子？是否會覺得下圖這樣呢？</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/299/1*RHcyFSqd4crUnPT8nPpejg.png" /></figure><p>但結果卻是 Container 把 Image 也拉大到 300 x 300 了。</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/299/1*IP0Km19aK0WRvkI9iWDEWQ.png" /></figure><p>觀眾們可能會想，都設定圖片大小了，怎麼還是會被放到最大呢？</p><p>顯然肯定有個人在搞鬼，今天就來看看這個搞鬼的人：<strong>Container</strong>。</p><h3>Container 的行為</h3><p>Container 作為開發 Flutter App 最常用的 Widget 之一，其實有著相當複雜的行為。如果我們看到<a href="https://api.flutter.dev/flutter/widgets/Container-class.html">官方文件</a>，會發現其中有一段文字在描述 Container 的行為。</p><p>Container 的佈局行為按以下順序進行：</p><ul><li>優先遵循 alignment。</li><li>根據 child 的大小來決定自身大小。</li><li>遵循 width、height 和 constraints</li><li>擴展以適配父級大小。</li><li>嘗試盡量小化自身大小。</li></ul><p>若是調整一下剛剛的例子，把 width 與 height 拿掉。</p><pre>Container(<br>  color: Colors.pinkAccent,<br>  child: Image.asset(<br>    &quot;assets/images/blog.png&quot;,<br>    width: 30,<br>    height: 30,<br>  ),<br>)</pre><p>此時就會發現，Container 就遵循了第二條規則：<strong>根據 child 大小來決定自身大小</strong>。</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/299/1*-FQqRooMJKIXnlFtc3cVPg.png" /></figure><p>設定了 width 與 height 後，到底實際發生了什麼事呢？讓我們深入 Container 的 build 方法一探究竟。</p><h3>Container 的 build 方法</h3><p>當我們設定了 width 或 height 而沒有給 constraints 時，實際上 Container 會幫我們生成一個 BoxConstraints.tightFor(width: width, height: height)。</p><pre>Container({<br>    // 省略...<br>  }) : // 省略 ...,<br>       constraints =<br>        (width != null || height != null)<br>          ? constraints?.tighten(width: width, height: height)<br>            ?? BoxConstraints.tightFor(width: width, height: height)<br>          : constraints;</pre><p>tighFor 方法會限制 Widget 的大小，指定 Widget 的寬高，那這個 BoxConstraints 會用在哪邊呢？</p><pre>const BoxConstraints.tightFor({<br>    double? width,<br>    double? height,<br>  }) : minWidth = width ?? 0.0,<br>       maxWidth = width ?? double.infinity,<br>       minHeight = height ?? 0.0,<br>       maxHeight = height ?? double.infinity;</pre><p>在 build 方法中，我們可以看到剛剛的 constraints 被放在 ConstrainedBox 中，用來限制 Container 的子 Widget。以上面的例子來說，被限制的 Widget 就是放入的 child 的 Image。</p><pre>@override<br>Widget build(BuildContext context) {<br>  // Container 的 build 方法<br>  // 省略 ...<br><br>  if (constraints != null) {<br>    current = ConstrainedBox(constraints: constraints!, child: current);<br>  }<br><br>  // 省略 ...<br><br>  return current!;<br>}</pre><p>所以也就使得了 Image 被拉到與 Container 一樣大小。</p><h3>使用 alignment</h3><p>熟悉 Flutter 的開發人員肯定對這狀況也不陌生，知道加上 alignment 參數就能解決問題。</p><pre>Container(<br>  width: 300,<br>  height: 300,<br>  color: Colors.pinkAccent,<br>  alignment: Alignment.center,<br>  child: Image.asset(<br>    &quot;assets/images/blog.png&quot;,<br>    width: 30,<br>    height: 30,<br>  ),<br>)</pre><p>那為什麼在 Container 中加上 alignment 時，圖片就能維持當初設定的大小呢？讓我們再次看回 Container 的 build 方法中。</p><pre>@override<br>Widget build(BuildContext context) {<br>  // Container 的 build 方法<br>  // 省略 ...<br><br>  if (child == null &amp;&amp; (constraints == null || !constraints!.isTight)) {<br>    // 省略 ...<br>  } else if (alignment != null) {<br>    current = Align(alignment: alignment!, child: current);<br>  }<br><br>  // 省略 ...<br><br>  if (constraints != null) {<br>    current = ConstrainedBox(constraints: constraints!, child: current);<br>  }<br><br>  // 省略 ...<br><br>  return current!;<br>}</pre><p>當 alignment 不為 null 時，就會在 child 外面包上一層 Align，接著才是在 Align 外面再包上 ConstrainedBox。這樣一來，就使得實際被拉大的是 Align，而非 Image。</p><p>如果有認真看 Container 原始碼的觀眾可能會問，即便我沒有設定 alignment，但我有設定 color，而 ConstrainedBox 的下一層 child 應該是 ColoredBox，所以要拉大也是拉大 ColoredBox，而不應該是 Image 吧？</p><pre>@override<br>Widget build(BuildContext context) {<br>  // Container 的 build 方法<br>  // 省略 ...<br><br>  if (child == null &amp;&amp; (constraints == null || !constraints!.isTight)) {<br>    // 省略 ...<br>  } else if (alignment != null) {<br>    current = Align(alignment: alignment!, child: current);<br>  }<br><br>  if (color != null) {<br>    current = ColoredBox(color: color!, child: current);<br>  }<br><br>  // 省略 ...<br><br>  if (constraints != null) {<br>    current = ConstrainedBox(constraints: constraints!, child: current);<br>  }<br><br>  // 省略 ...<br><br>  return current!;<br>}</pre><p>的確，ColoredBox 確實會被拉大，但是 ColoredBox 也直接把上頭來的 constraints 直接轉送給了他的 child。在這兩種狀況中，雖然 Image 上層還有其他 Widget，但是卻有不同的結果。</p><p>若繼續深入 Align 與 ColoredBox 的佈局方式，很快就有答案了。</p><p>一路追蹤 ColoredBox 的原始碼：ColoredBox -&gt; _RenderColoredBox -&gt; RenderProxyBoxWithHitTestBehavior -&gt; RenderProxyBox，最後可以發現 ColoredBox 繼承了 RenderProxyBox。在 RenderProxyBox 的佈局中，其實也就只是把自己收到的限制，直接原封不動的傳給子 Widget，所以即便中間多墊了一層 ColoredBox，也不能避免 Image 被拉大的效果。</p><pre>@override<br>void performLayout() {<br>  size = (child?..layout(constraints, parentUsesSize: true))?.size<br>      ?? computeSizeForNoChild(constraints);<br>  return;<br>}</pre><p>接著看到 Align，Align 繼承了 RenderPositionedBox。在 RenderPositionedBox 的佈局中，我們可以發現，它從上頭接收到了限制，接著轉頭就將限制放寬，讓子 Widget 可以挑選他希望的大小。所以在 Align 中，Image 可以維持當初設定的 30 x 30 的大小。</p><pre>@override<br>void performLayout() {<br>  final BoxConstraints constraints = this.constraints;<br><br>  // 省略 ...<br><br>  if (child != null) {<br>    child!.layout(constraints.loosen(), parentUsesSize: true);<br><br>    // 省略 ...<br><br>  } else {...}<br>}</pre><h3>實驗放入不同的 Widget</h3><p>最後讓我們做一些實驗，如果採用相同 Container 設定，但是在 child 中放入不同東西，看看會發生什麼事？</p><h4>放入指定大小的 Container</h4><p>與 Image 一樣，放入了指定大小的 Container，結果這個 Container 還是被拉大到 300 x 300。</p><pre>Container(<br>  width: 300,<br>  height: 300,<br>  color: Colors.pinkAccent,<br>  child: Container(<br>    width: 100,<br>    height: 100,<br>    color: Colors.blueAccent,<br>  ),<br>)</pre><figure><img alt="" src="https://cdn-images-1.medium.com/max/299/1*WKsYtv3eQ9sWpbHd4ApBkQ.png" /></figure><h4>放入 TextButton</h4><p>乍看之下，放入的 TextButton 好像沒被拉大，但實際上卻是有的，我們可以從 Hover 效果看出，按鈕還是被拉大了。</p><pre>Container(<br>  width: 300,<br>  height: 300,<br>  color: Colors.pinkAccent,<br>  child: TextButton(<br>    onPressed: () {},<br>    child: const Text(&#39;Click me&#39;),<br>  ),<br>)</pre><figure><img alt="" src="https://cdn-images-1.medium.com/max/299/1*CLjzsPCXUTeIaWmzRC-gSA.png" /></figure><h4>放入 Text</h4><p>當我們試到 Text 的時候，卻發現 Text 好像就沒被拉大的問題，這又是怎麼一回事呢？</p><pre>Container(<br>  width: 300,<br>  height: 300,<br>  color: Colors.pinkAccent,<br>  child: const Text(&quot;Hello World&quot;),<br>)</pre><figure><img alt="" src="https://cdn-images-1.medium.com/max/299/1*_lSOd3GNBLcgb2HQtZu0Bg.png" /></figure><p>關於這個問題，有機會再讓我們深入探討，好奇的觀眾也可以先自行研究看看。</p><h3>小結</h3><p>Container 做為我們最常使用的 Widget 之一，了解他如何運作對於開發必然有些幫助。雖然不是每天都會碰到 Widget 排版不如預期的問題，但是每次碰上就會相當困擾，需要花許多時間嘗試才能解決。</p><p>追蹤原始碼，了解 Widget 底層的運作邏輯，能夠提供我們更多解決問題的思路。當未來碰上問題時，就能用正確又快速的方式解決，而不是留下更多的 Workaround。</p><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=4d7a79ee79e6" width="1" height="1" alt=""><hr><p><a href="https://medium.com/%E4%BF%9D%E7%BE%85%E7%9A%84-flutter-%E9%96%8B%E7%99%BC%E6%8A%80%E5%B7%A7/container-%E4%B8%80%E5%80%8B%E4%BD%A0%E6%9C%80%E7%86%9F%E6%82%89%E5%8F%88%E6%9C%80%E9%99%8C%E7%94%9F%E7%9A%84-widget-4d7a79ee79e6">Container — 一個你最熟悉又最陌生的 Widget</a> was originally published in <a href="https://medium.com/%E4%BF%9D%E7%BE%85%E7%9A%84-flutter-%E9%96%8B%E7%99%BC%E6%8A%80%E5%B7%A7">保羅的 Flutter 開發技巧</a> on Medium, where people are continuing the conversation by highlighting and responding to this story.</p>]]></content:encoded>
        </item>
    </channel>
</rss>