<?xml version="1.0" encoding="UTF-8"?><rss version="2.0" xmlns:content="http://purl.org/rss/1.0/modules/content/"><channel><title>Kay&apos;s Blog</title><description>Kay&apos;s Small Blog Website</description><link>https://blog.kayxue.dev/</link><language>zh_TW</language><item><title>Upgrade Blog Framework to Astro 7.1</title><link>https://blog.kayxue.dev/posts/blogupgrade/</link><guid isPermaLink="true">https://blog.kayxue.dev/posts/blogupgrade/</guid><description>將此部落格使用的框架升級至 Astro 7.1</description><pubDate>Mon, 03 Aug 2026 00:00:00 GMT</pubDate><content:encoded>&lt;p&gt;因為學校軟體工程課程，也因為想不太到什麼東西要寫，所以許久沒有更新了。&lt;/p&gt;
&lt;p&gt;而轉眼間，不知道過了多久，而 Astro 目前也已經迎來了 7.1 版本。在這段期間 Astro 也迎來了非常多的升級，包括將編譯器遷移至 Rust、Markdown pipeline 遷移至 Rust 等，個人覺得算蠻好的大版本更新，個人目前感覺下來網頁載入速度似乎好像有變快？&lt;/p&gt;
&lt;p&gt;那這次就來分享一下升級的過程吧！雖然不知道有在用 fuwari 的各位會不會升上去，但在這邊還是給各位一些參考。&lt;/p&gt;
&lt;p&gt;:::warning
由於是跨大版本更新，若您的專案沒有做 version control，請先備份您的專案
:::&lt;/p&gt;
&lt;h2&gt;Running Upgrade Script&lt;/h2&gt;
&lt;p&gt;首先，我們先執行以下指令進行版本更新&lt;/p&gt;
&lt;pre&gt;&lt;code&gt;bunx @astrojs/upgrade
&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;&lt;img src=&quot;./UpgradeCommand.png&quot; alt=&quot;&quot; /&gt;&lt;/p&gt;
&lt;p&gt;:::note
Package manager 相關指令請依據您專案使用的 package manager 進行適當變化。
:::&lt;/p&gt;
&lt;p&gt;接下來會出現是否升級確認，選擇 &lt;code&gt;Yes&lt;/code&gt;
&lt;img src=&quot;./RunningUpgrade.png&quot; alt=&quot;&quot; /&gt;&lt;/p&gt;
&lt;p&gt;之後等待升級即可。當出現如下圖畫面時，即升級完成&lt;/p&gt;
&lt;p&gt;&lt;img src=&quot;./UpgradeCommandFinish.png&quot; alt=&quot;&quot; /&gt;&lt;/p&gt;
&lt;h2&gt;Fixing Error Using AI&lt;/h2&gt;
&lt;p&gt;只是更新 dependencies 後，因為新版本用了新的工具，所以直接執行專案的話會發生錯誤&lt;/p&gt;
&lt;p&gt;&lt;img src=&quot;./ProjectBuildFailed.png&quot; alt=&quot;&quot; /&gt;&lt;/p&gt;
&lt;p&gt;在此我下載了 Antigravity IDE，請 AI 幫我處理。&lt;/p&gt;
&lt;p&gt;安裝好 Antigravity IDE、在該編輯器開啟專案並確認 agent 已就緒後，即可將以下 prompt 餵給 agent 讓它開始處理&lt;/p&gt;
&lt;pre&gt;&lt;code&gt;Upgrade my Astro project to v7. Follow the migration guide at
https://docs.astro.build/en/guides/upgrade-to/v7/
&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;&lt;img src=&quot;./RunningCommand.png&quot; alt=&quot;&quot; /&gt;&lt;/p&gt;
&lt;p&gt;之後它會產生一份報告告訴你接下來的變更計劃，確定沒有什麼問題後，可以直接按下 &lt;code&gt;Proceed&lt;/code&gt; 繼續&lt;/p&gt;
&lt;p&gt;&lt;img src=&quot;./UpgradePlan.png&quot; alt=&quot;&quot; /&gt;&lt;/p&gt;
&lt;p&gt;接下來 agent 就會開始幫你修復相關錯誤，修復完之後專案即可正常執行。&lt;/p&gt;
&lt;p&gt;如果說部落格在 AI 幫你處理之後有出現一些問題，您可以將錯誤截圖給 AI 請它幫你處理，基本上多數都是可以修復的。舉例如下：&lt;/p&gt;
&lt;ol&gt;
&lt;li&gt;文章圖片消失
&lt;img src=&quot;./NoImage.png&quot; alt=&quot;No Image&quot; /&gt;&lt;/li&gt;
&lt;li&gt;TypeError&lt;/li&gt;
&lt;/ol&gt;
&lt;pre&gt;&lt;code&gt;TypeError: file is not a function. (In &apos;file()&apos;, &apos;file&apos; is undefined)
&lt;/code&gt;&lt;/pre&gt;
&lt;ol&gt;
&lt;li&gt;圖片路徑確定正確，但是找不到圖片。&lt;/li&gt;
&lt;/ol&gt;
&lt;pre&gt;&lt;code&gt;[ERROR] Image file not found: src/content/posts/WholeSystem.png
&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;又或者有一些可優化之處，可以請 AI 幫你處理，基本上他也是可以處理掉的。
&lt;img src=&quot;./Optimization.png&quot; alt=&quot;&quot; /&gt;
&lt;img src=&quot;./Optimization2.png&quot; alt=&quot;&quot; /&gt;&lt;/p&gt;
&lt;p&gt;但還是有一些問題是沒有辦法解決的，比如 link card 部分，疑似因為現在都有防爬，所以現在不少網站抓 metadata 都會出問題，這可能只能改成手動了。&lt;/p&gt;
&lt;p&gt;&lt;img src=&quot;./NoLinkCard.png&quot; alt=&quot;&quot; /&gt;&lt;/p&gt;
&lt;h2&gt;Wrapping Up&lt;/h2&gt;
&lt;p&gt;整個過程中雖然有發生一些波折，比如還是有一些錯誤，並且在修復過程中發生了 token 不足的狀況，需要換帳號登入才可以繼續用，但整個升級過程感覺算順利，一段時間過後，整個部落格就已經升級完成了。並且部署成品後目前似乎也暫時沒有問題。如果說本部落格目前功能上還是有什麼問題的話，歡迎各位進行回報。&lt;/p&gt;
</content:encoded></item><item><title>First Time Buying Keyboard on TaoBao</title><link>https://blog.kayxue.dev/posts/azothx/</link><guid isPermaLink="true">https://blog.kayxue.dev/posts/azothx/</guid><description>第一次從淘寶購物的體驗</description><pubDate>Tue, 14 Oct 2025 00:00:00 GMT</pubDate><content:encoded>&lt;h2&gt;前言&lt;/h2&gt;
&lt;p&gt;其實我不久之前就已經被 ROG Azoth 鍵盤的外觀吸引，加上我有某個網友某天在聊天中上傳了一張照片，沒想到他居然在用那款鍵盤。問了對方打感跟好用程度，並且看了幾個開箱影片後，就決定想買了。&lt;/p&gt;
&lt;h2&gt;選擇的經過&lt;/h2&gt;
&lt;p&gt;只是我上蝦皮查看了新版 Azoth X......約 NT 9000，這價錢看都嚇死了。&lt;/p&gt;
&lt;p&gt;&lt;img src=&quot;./priceshopee.png&quot; alt=&quot;&quot; /&gt;&lt;/p&gt;
&lt;p&gt;那時要買時我其實也有點糾結，畢竟以前有在京東買過東西，所以其實我大概知道我有機會在京東上找到相同商品，並且價格更低，反正沒有注音刻字對我來說不是問題，所以我賭了一把，結果這價格沒意外......沒差多少（大約 NT 8500 左右）&lt;/p&gt;
&lt;p&gt;&lt;img src=&quot;./pricejd.jpg&quot; alt=&quot;&quot; /&gt;&lt;/p&gt;
&lt;p&gt;最後只好轉向了淘寶，反正國泰剛好也有對在淘寶購物給比較高的回饋，這次就試試吧！希望不會有什麼問題。&lt;/p&gt;
&lt;p&gt;&lt;img src=&quot;./cathey.jpg&quot; alt=&quot;&quot; /&gt;&lt;/p&gt;
&lt;p&gt;之後在因緣際會下成功找到了一個七千三的，看到這價格真的感覺爽到一個可以，相較於蝦皮，這根本省下來整個超過 1500 了&lt;/p&gt;
&lt;p&gt;&lt;img src=&quot;./pricetb.jpg&quot; alt=&quot;&quot; /&gt;&lt;/p&gt;
&lt;p&gt;即使最後為了能狀況比較穩定選了空運，但是這價錢還是省了一筆。雖然感覺他支付手續費是有點貴，但是其實加上了尊榮服務費之後，還是能省下 1000 左右，感覺真的算蠻值的，雖然說需要等比平常在蝦皮買時，再長一些的到貨時間，但是能省下一筆可觀的費用，這我願意忍。&lt;/p&gt;
&lt;p&gt;&lt;img src=&quot;./pricefinal.jpg&quot; alt=&quot;&quot; /&gt;&lt;/p&gt;
&lt;h2&gt;到貨惹～～&lt;/h2&gt;
&lt;p&gt;最後運送的時間大概是七天，並且收到貨時也發現賣家包得很好，只是當時忘記拍了。
外盒上面可以明顯看到「夜魔 X」，其實它就是 Azoth X，只是在中國大陸的話他會寫中文罷了。
&lt;img src=&quot;./box.png&quot; alt=&quot;&quot; /&gt;&lt;/p&gt;
&lt;p&gt;這次買的是風暴軸，因為個人比較喜歡有打感，且有聲音。除了在打音遊方面會比較有感之外，平常對我來說也可以減少一些孤獨感。
&lt;img src=&quot;./switch.png&quot; alt=&quot;&quot; /&gt;&lt;/p&gt;
&lt;p&gt;而這就是鍵盤本體，目前使用下來基本上沒有什麼問題，不得不說第二版風暴軸真的打起來非常舒服。
&lt;img src=&quot;./keyboard.png&quot; alt=&quot;&quot; /&gt;&lt;/p&gt;
&lt;p&gt;右上角的螢幕雖然還是黑白的，不過有個螢幕可以顯示自己喜歡的東西也是蠻有趣。而且旁邊的 knob 也是非常方便，在調整音量模式下按下去可以直接靜音，在多媒體的狀況下按下去可以暫停、播放音樂，感覺這樣操作也是一種蠻新奇的體驗。
&lt;img src=&quot;./screen.png&quot; alt=&quot;&quot; /&gt;&lt;/p&gt;
&lt;h2&gt;總結&lt;/h2&gt;
&lt;p&gt;個人覺得這次算是一次蠻不錯的購物體驗。雖然說不是像京東的自營，由平台官方直接採購並進行銷售，關於保障部分確實沒有到那麼好，但是其實這次商品從某實體店下單買回來，基本上沒有遇到買到贗品之類的問題發生，寄送時間其實也還算可以接受。未來會不會再次嘗試淘寶的話就要看狀況了，畢竟能以合理的價格在當地買到還是最好，畢竟跨境購物確實需要不少時間。&lt;/p&gt;
</content:encoded></item><item><title>VSCode Extension Downloader－Download Extension from Marketplace</title><link>https://blog.kayxue.dev/posts/vscodeextensiondownloader/</link><guid isPermaLink="true">https://blog.kayxue.dev/posts/vscodeextensiondownloader/</guid><description>如何使用 VSCode Extension Downloader 下載 extension</description><pubDate>Mon, 04 Aug 2025 00:00:00 GMT</pubDate><content:encoded>&lt;p&gt;現在我猜不少人都因為 AI 而使用 Cursor 或者擁有 AI 功能的編輯器吧？而使用非微軟官方的 Visual Studio Code 版本，雖然可能可以用到非常猛的 AI 功能，又或者說可以避免被微軟官方收集使用資料，但所要付出的代價也是顯而易見－extension 來源並不是 Visual Studio Marketplace，所以就會造成在搜尋某些擴充時，直接在軟體中的擴充搜尋找會找不到的狀況。&lt;/p&gt;
&lt;p&gt;這個問題基本上在網頁版的 Visual Studio Marketplace 都可以得到解決，但在這幾個月本人在上面尋找擴充時發現下載按鈕不見了......&lt;/p&gt;
&lt;p&gt;&lt;img src=&quot;./noDownloadButton.png&quot; alt=&quot;Resource 區塊 m-auto&quot; /&gt;&lt;/p&gt;
&lt;p&gt;這可就頭大了，微軟這麼做的原因，是希望使用者回流嗎？又或者為了留住目前的使用者？但這些都不是重點，最重點的問題是......那這樣要怎麼辦呢？&lt;/p&gt;
&lt;p&gt;還好後來我在網路上有找到 StackOverflow 上有人有留下下載 extension 的連結格式，不然未來如果要直接從 Visual Studio Marketplace 下載 extension 可就費功夫惹～～而本人在此也已經做成了軟體，在此歡迎各位使用外，也歡迎各位進行貢獻讓軟體功能更加完整喔！&lt;/p&gt;
&lt;h2&gt;Screenshot&lt;/h2&gt;
&lt;p&gt;&lt;img src=&quot;./screenshot.png&quot; alt=&quot;軟體截圖 m-auto&quot; /&gt;&lt;/p&gt;
&lt;h2&gt;Usage&lt;/h2&gt;
&lt;ol&gt;
&lt;li&gt;在 Visual Studio Marketplace 上找到你想下載的 extension
&lt;img src=&quot;./findExtension.png&quot; alt=&quot;&quot; /&gt;&lt;/li&gt;
&lt;li&gt;記下 publisher、name 和 version
&lt;img src=&quot;./extensionName.png&quot; alt=&quot;擴充發佈者、名稱 m-auto&quot; /&gt;
&lt;img src=&quot;./version.png&quot; alt=&quot;版本 m-auto&quot; /&gt;&lt;/li&gt;
&lt;li&gt;打開軟體，選取儲存位置，並在對應欄位中填入對應資訊，完成後按下方按鈕。&lt;/li&gt;
&lt;/ol&gt;
&lt;p&gt;:::warning
您對於所選的儲存位置必須有讀寫權限！
:::&lt;/p&gt;
&lt;p&gt;&lt;img src=&quot;./downloadExtension.png&quot; alt=&quot;&quot; /&gt;&lt;/p&gt;
&lt;ol&gt;
&lt;li&gt;確定要下載的 extension 資訊無誤後，按下 &lt;code&gt;Download&lt;/code&gt; 開始下載&lt;/li&gt;
&lt;/ol&gt;
&lt;p&gt;&lt;img src=&quot;./download.png&quot; alt=&quot;&quot; /&gt;&lt;/p&gt;
&lt;ol&gt;
&lt;li&gt;下載完之後，可以點選 &lt;code&gt;Show&lt;/code&gt; 按鈕，在資料夾內顯示下載好的檔案&lt;/li&gt;
&lt;/ol&gt;
&lt;p&gt;&lt;img src=&quot;./showInFolder.png&quot; alt=&quot;&quot; /&gt;&lt;/p&gt;
&lt;ol&gt;
&lt;li&gt;此時即可將下載好的擴充安裝至 VSCode 系列編輯器&lt;/li&gt;
&lt;/ol&gt;
&lt;p&gt;&lt;img src=&quot;./displayExtension.png&quot; alt=&quot;&quot; /&gt;&lt;/p&gt;
&lt;h2&gt;Wrapping Up&lt;/h2&gt;
&lt;p&gt;這次算是 Flutter 課程上完的第一作，其實在上 Flutter 課程之前，我原本是想說使用 Tauri 開發的，但因為碰到 Tauri 的 download 模組出現問題，最後只好改用 Flutter 進行開發，原本以為會需要很久的時間才能做出來，沒想到 pub.dev 上模組蠻多的，想要做到什麼事情，基本上找一下模組通常都有，並且非常容易使用。在此非常感謝 pub.dev 上模組的多樣性，讓此軟體基礎功能可以快速完成。這軟體在製作完後，個人感覺自己下載擴充的速度更快了，不用在那邊自己還要找連結格式，自己將東西慢慢填進去，才可以下載，真的是方便了不少。&lt;/p&gt;
&lt;h2&gt;GitHub Repository&lt;/h2&gt;
&lt;p&gt;::github{repo=&quot;Kayxue/VSCodeExtensionDownloader&quot;}&lt;/p&gt;
</content:encoded></item><item><title>Flutter App &amp; IoT Final - Parking System</title><link>https://blog.kayxue.dev/posts/flutterappfinal/</link><guid isPermaLink="true">https://blog.kayxue.dev/posts/flutterappfinal/</guid><description>IoT 兼 Flutter 課程的期末專題</description><pubDate>Sat, 14 Jun 2025 00:00:00 GMT</pubDate><content:encoded>&lt;p&gt;這學期的 Flutter 和 IoT 課程終於結束了，真的是有點不容易。雖然說在做期末專題中途發生了一些曲折，包括在中途因為時間不足以處理完整個大架構的串接，還有因為在大學，考試時間不太固定，所以在時間安排上也經常要進行調整，但是最後還是在願意放下一些東西的狀況下，成功地完成了這次的專題，最後也感謝彼得對於期末專題的開放性是如此大，可以因要跟一些其他課程結合的因素而接受需求變動。
:::note
本文有些圖片內容為報告截圖，因那時不知道物聯網課程 Demo 此專題時誰要上去報告，所以內容雖然皆由本人直接撰寫，但我們這組有僑生成員，故全部皆使用英文撰寫。但是請各位讀者不用擔心，本人會在文中輔以繁體中文解釋相關內容。
:::&lt;/p&gt;
&lt;h2&gt;System Structure&lt;/h2&gt;
&lt;p&gt;&lt;img src=&quot;./InitialStructure.png&quot; alt=&quot;Initial structure of the system&quot; /&gt;&lt;/p&gt;
&lt;p&gt;原始系統如上圖所示，箭頭旁的文字是該互動所牽涉到的 protocol，因為這學期的物聯網課程是使用 Node-RED 與 oneM2M 為主，所以原本希望說可以保留類似的架構進行製作，並且已經想好大概要怎麼做了，但是因為微積分考試是跟我目前修的所有課程中，考試時間最不同的，所以微積分考試嚴重影響了我做專題的時間。&lt;/p&gt;
&lt;p&gt;而在成果發表前的週末，我請了組員幫我處理 Arduino 端的程式碼，並告訴了他如何處理跟 M2M 系統互動的部分，但是結果他直接請了 AI，並且不小心請 AI 把整個裝置 server 都寫出來。我當下也是有點傻了，雖然該組員說他可以請我給關鍵字，讓他請 AI 幫忙改成可以跟 M2M 系統相接，但是我當下完全想不到我要下什麼關鍵字（在 &lt;a href=&quot;/posts/iotproject1&quot;&gt;IoT Final Project 1 - The Beginning&lt;/a&gt; 中，我有提到 M2M 是我自己寫的），所以只好當機立斷，直接變更整個架構，故最終架構如下圖所示：&lt;/p&gt;
&lt;p&gt;&lt;img src=&quot;./FinalStructure.png&quot; alt=&quot;Final structure&quot; /&gt;&lt;/p&gt;
&lt;p&gt;雖然說真的是非常的簡單，但沒辦法嘛！那天距離成果發表就剩三天，進度目前就這樣，還能再搞出什麼瘋狂的東西？反正關於儲存等其他部分，或許未來在還可以在其他物聯網課程中，將這系統直接拿來用，並進行其他改善，或許也是個不錯的選擇。&lt;/p&gt;
&lt;h2&gt;Techniques We Use&lt;/h2&gt;
&lt;p&gt;這次最終有使用到的有以下技術。&lt;/p&gt;
&lt;p&gt;不過在此解釋一下，Docker 旁邊標的 &lt;code&gt;Deprecated&lt;/code&gt; 是代表我們原本有執行一些使用該技術的手續，但是最後在使用時遇到問題，並且不知道怎麼處理，所以只能先放棄使用，非指 Docker 本身是個已被棄用的東西。&lt;/p&gt;
&lt;p&gt;&lt;img src=&quot;./Technique.png&quot; alt=&quot;Techniques we use in the project&quot; /&gt;&lt;/p&gt;
&lt;p&gt;我們使用的技術大概簡述如下：&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;&lt;strong&gt;Arduino UNO:&lt;/strong&gt; 一個義大利公司產的微控制器開發板&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;JavaScript &amp;amp; Jonhhy-five:&lt;/strong&gt; JavaScript 是一個用於網頁的程式語言，但 Node.js 出現後，使其也可以用來開發後端。而 Johnny-five 是一個可以透過 JavaScript 來控制 Arduino 的一個 library。&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Flutter:&lt;/strong&gt; 一個由 Google 公司所開發的礦平台應用程式開發框架。&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Docker:&lt;/strong&gt; 一個可以幫助開發者將其應用程式打包成簡單的 image 並且可直接部署至其他裝置執行的好用工具。&lt;/li&gt;
&lt;/ul&gt;
&lt;h2&gt;Sensors We Use​&lt;/h2&gt;
&lt;p&gt;這次最終有使用到的有以下感應器。
&lt;img src=&quot;./Sensors.png&quot; alt=&quot;Sensors we use in the project&quot; /&gt;&lt;/p&gt;
&lt;p&gt;用途簡單說明如下：&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;&lt;strong&gt;IR 避障感應器:&lt;/strong&gt; 偵測車位狀態、是否有車子要進去或離開停車場&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;20 x 4 顯示器:&lt;/strong&gt; 顯示停車場內的車位狀態&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;SG90 迷你伺服馬達:&lt;/strong&gt; 控制柵欄升降&lt;/li&gt;
&lt;/ul&gt;
&lt;h2&gt;Circuit Diagrams&lt;/h2&gt;
&lt;p&gt;圖片的原圖來自此網站，只是因為我們本次專案不會採用變壓器供電，所以有將原圖進行修改。&lt;/p&gt;
&lt;p&gt;https://www.hackster.io/embeddedlab786/automatic-car-parking-system-95a9dc&lt;/p&gt;
&lt;p&gt;&lt;img src=&quot;./Circuit.png&quot; alt=&quot;The circuit&quot; /&gt;&lt;/p&gt;
&lt;h2&gt;System Exhibition&lt;/h2&gt;
&lt;p&gt;由於沒有足夠的玩具車，故在此有東西拿玩具代替&lt;/p&gt;
&lt;p&gt;&lt;img src=&quot;./System1.png&quot; alt=&quot;No car&quot; /&gt;&lt;/p&gt;
&lt;p&gt;&lt;img src=&quot;./System2.png&quot; alt=&quot;With few cars&quot; /&gt;&lt;/p&gt;
&lt;h2&gt;App Exhibition&lt;/h2&gt;
&lt;p&gt;:::note
因應 Flutter 課程作業需求，但本人平常沒用該 APP 預覽圖製作平台，所以沒有付費，故圖片有浮水印，請見諒。
:::
&lt;img src=&quot;./App.png&quot; alt=&quot;App screenshots&quot; /&gt;&lt;/p&gt;
&lt;h2&gt;App Code Explaination&lt;/h2&gt;
&lt;h3&gt;Folder Structure&lt;/h3&gt;
&lt;p&gt;這次因為 Flutter 應用程式跟其他課程結合，所以沒有很複雜，資料夾結構跟之前也是差不多的
&lt;img src=&quot;./folder.png&quot; alt=&quot;&quot; /&gt;&lt;/p&gt;
&lt;h3&gt;Code Explaination&lt;/h3&gt;
&lt;p&gt;首先是自訂型別的部分，在抓到資料後，會將資料中的 &lt;code&gt;data&lt;/code&gt; 部分取出並呼叫 factory function 轉換成 &lt;code&gt;SlotData&lt;/code&gt; 類別的物件實體。而在資料載入狀態的部分，則會以 &lt;code&gt;ParkingDataState&lt;/code&gt; 儲存，因其 enhanced enum 不像 Rust 的 enum 可以針對不同窮舉值儲存不同型別值。&lt;/p&gt;
&lt;pre&gt;&lt;code&gt;class SlotData {
  List&amp;lt;bool&amp;gt; slots;
  int totalSlots;
  int avaliableSlots;
  bool gateOpen;
  bool systemReady;

  SlotData({
    required this.slots,
    required this.totalSlots,
    required this.avaliableSlots,
    required this.gateOpen,
    required this.systemReady,
  });

  factory SlotData.fromJson(Map&amp;lt;String, dynamic&amp;gt; json) {
    return SlotData(
      slots: List&amp;lt;bool&amp;gt;.from(json[&apos;slots&apos;] ?? []),
      totalSlots: json[&apos;totalSlots&apos;] ?? 0,
      avaliableSlots: json[&apos;avaliableSlots&apos;] ?? 0,
      gateOpen: json[&apos;gateOpen&apos;] ?? false,
      systemReady: json[&apos;systemReady&apos;] ?? false,
    );
  }

  Map&amp;lt;String, dynamic&amp;gt; toJson() {
    return {
      &apos;slots&apos;: slots,
      &apos;totalSlots&apos;: totalSlots,
      &apos;avaliableSlots&apos;: avaliableSlots,
      &apos;gateOpen&apos;: gateOpen,
      &apos;systemReady&apos;: systemReady,
    };
  }
}

class ParkingDataState {
  final SlotData? data;
  final bool isLoading;
  final String? error;

  ParkingDataState({this.data, this.isLoading = false, this.error});

  factory ParkingDataState.loading() {
    return ParkingDataState(isLoading: true);
  }

  factory ParkingDataState.error(String error) {
    return ParkingDataState(error: error);
  }

  factory ParkingDataState.success(SlotData data) {
    return ParkingDataState(data: data);
  }
}
&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;接下來就是有切開的 Widget，由上而下。
首先是頂部部分的 banner，其可以顯示停車場資訊，點一下可以透過 &lt;code&gt;maps_launcher&lt;/code&gt; 在手機的地圖軟體中開啟停車場的位置。&lt;/p&gt;
&lt;pre&gt;&lt;code&gt;import &apos;package:flutter/material.dart&apos;;
import &apos;package:maps_launcher/maps_launcher.dart&apos;;

class TopBar extends StatelessWidget {
  const TopBar({super.key});

  @override
  Widget build(BuildContext context) {
    return Padding(
      padding: const EdgeInsets.only(top: 20.0, left: 8.0, right: 8.0),
      child: Card(
        color: Colors.blue,
        clipBehavior: Clip.hardEdge,
        child: InkWell(
          splashColor: Colors.grey.withAlpha(40),
          onTap: () {
            MapsLauncher.launchCoordinates(25.04782398,121.50525497, &quot;洛陽停車場&quot;);
          },
          child: Container(
            width: double.infinity,
            height: 100,
            padding: const EdgeInsets.symmetric(vertical: 4.0),
            child: const Row(
              mainAxisAlignment: MainAxisAlignment.spaceBetween,
              children: [
                Padding(
                  padding: EdgeInsets.only(left: 16.0),
                  child: Column(
                    mainAxisAlignment: MainAxisAlignment.center,
                    crossAxisAlignment: CrossAxisAlignment.start,
                    children: [
                      Text(
                        &quot;洛陽停車場&quot;,
                        style: TextStyle(
                          fontSize: 24,
                          color: Colors.white,
                          fontWeight: FontWeight.bold,
                        ),
                      ),
                      SizedBox(height: 4),
                      Text(
                        &quot;台北市萬華區環河南路一段1號&quot;,
                        style: TextStyle(
                          fontSize: 16,
                          fontWeight: FontWeight.w500,
                          color: Colors.white,
                        ),
                      ),
                    ],
                  ),
                ),
                Padding(
                  padding: EdgeInsets.only(right: 16.0),
                  child: CircleAvatar(
                    radius: 35,
                    backgroundImage: AssetImage(&apos;assets/Parking_icon.png&apos;),
                  ),
                ),
              ],
            ),
          ),
        ),
      ),
    );
  }
}
&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;接下來就是停車場剩餘位置計數器。基本上整個顯示邏輯是先執行抓取資料確認，如果抓到的資料有任何問題或者在抓取中有遇到任何問題的話，進行提早傳回對應情況需要顯示的 widget。如果確認資料都沒有問題後，就進行資料顯示。&lt;/p&gt;
&lt;pre&gt;&lt;code&gt;import &apos;package:animated_flip_counter/animated_flip_counter.dart&apos;;
import &apos;package:flutter/material.dart&apos;;

import &apos;../Types/slotdata.dart&apos;;

class SlotDataWidget extends StatelessWidget {
  final ParkingDataState state;

  const SlotDataWidget({super.key, required this.state});

  @override
  Widget build(BuildContext context) {
    if (state.isLoading) {
      return SizedBox(
        height: 200,
        child: Center(
          child: Column(
            mainAxisAlignment: MainAxisAlignment.center,
            children: [
              CircularProgressIndicator(
                strokeWidth: 3,
                valueColor: const AlwaysStoppedAnimation&amp;lt;Color&amp;gt;(Colors.blue),
                backgroundColor: Colors.grey[200],
              ),
              const SizedBox(height: 16),
              const Text(&quot;資料載入中...&quot;, style: TextStyle(fontSize: 16)),
            ],
          ),
        ),
      );
    }

    if (state.error != null) {
      return SizedBox(
        height: 200,
        child: Center(
          child: Column(
            mainAxisAlignment: MainAxisAlignment.center,
            children: [
              const Icon(Icons.error_outline, color: Colors.red, size: 48),
              const SizedBox(height: 16),
              Text(
                state.error!,
                style: const TextStyle(color: Colors.red, fontSize: 16),
                textAlign: TextAlign.center,
              ),
            ],
          ),
        ),
      );
    }

    final slotData = state.data;
    if (slotData == null) {
      return const SizedBox(
        height: 200,
        child: Center(
          child: Text(&quot;No data available&quot;, style: TextStyle(fontSize: 16)),
        ),
      );
    }

    return SizedBox(
      height: 200,
      child: GridView(
        gridDelegate: const SliverGridDelegateWithFixedCrossAxisCount(
          crossAxisCount: 2,
          childAspectRatio: 1.0,
        ),
        physics: const NeverScrollableScrollPhysics(),
        children: [
          Padding(
            padding: const EdgeInsets.all(8.0),
            child: Card(
              color: Colors.white,
              shape: RoundedRectangleBorder(
                borderRadius: BorderRadius.circular(10.0),
              ),
              child: Center(
                child: Column(
                  mainAxisAlignment: MainAxisAlignment.center,
                  children: [
                    const Text(
                      &quot;Total Spots&quot;,
                      style: TextStyle(fontWeight: FontWeight.bold),
                    ),
                    const SizedBox(height: 4.0),
                    AnimatedFlipCounter(
                      value: slotData.totalSlots,
                      textStyle: const TextStyle(
                        fontWeight: FontWeight.bold,
                        fontSize: 50,
                      ),
                    ),
                  ],
                ),
              ),
            ),
          ),
          Padding(
            padding: const EdgeInsets.all(8.0),
            child: Card(
              color: Colors.white,
              shape: RoundedRectangleBorder(
                borderRadius: BorderRadius.circular(10.0),
              ),
              child: Center(
                child: Column(
                  mainAxisAlignment: MainAxisAlignment.center,
                  children: [
                    const Text(
                      &quot;Remaining Spots&quot;,
                      style: TextStyle(fontWeight: FontWeight.bold),
                    ),
                    const SizedBox(height: 4.0),
                    AnimatedFlipCounter(
                      value: slotData.avaliableSlots,
                      textStyle: TextStyle(
                        fontWeight: FontWeight.bold,
                        fontSize: 50,
                        color:
                            slotData.avaliableSlots &amp;gt; 0
                                ? Colors.black
                                : Colors.red,
                      ),
                    ),
                  ],
                ),
              ),
            ),
          ),
        ],
      ),
    );
  }
}
&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;接下來就是提供一個進度條來顯示停車場已經被停的車位百分比。關於資料抓取狀態與資料檢查邏輯，基本上跟上一個是完全相同的。&lt;/p&gt;
&lt;pre&gt;&lt;code&gt;import &apos;package:flutter/material.dart&apos;;

import &apos;../Types/slotdata.dart&apos;;

class SlotProgress extends StatelessWidget {
  final ParkingDataState state;

  const SlotProgress({super.key, required this.state});

  @override
  Widget build(BuildContext context) {
    if (state.isLoading) {
      return const Padding(
        padding: EdgeInsets.all(8.0),
        child: Column(
          children: [
            Row(
              mainAxisAlignment: MainAxisAlignment.spaceBetween,
              children: [
                Text(
                  &quot;Parking Availability&quot;,
                  style: TextStyle(fontSize: 18, fontWeight: FontWeight.w500),
                ),
                Text(&quot;Loading...&quot;, style: TextStyle(fontSize: 18)),
              ],
            ),
            SizedBox(height: 16),
            LinearProgressIndicator(),
          ],
        ),
      );
    }

    if (state.error != null) {
      return Padding(
        padding: const EdgeInsets.all(8.0),
        child: Column(
          children: [
            const Row(
              mainAxisAlignment: MainAxisAlignment.spaceBetween,
              children: [
                Text(
                  &quot;Parking Availability&quot;,
                  style: TextStyle(fontSize: 18, fontWeight: FontWeight.w500),
                ),
                Text(
                  &quot;Error&quot;,
                  style: TextStyle(fontSize: 18, color: Colors.red),
                ),
              ],
            ),
            const SizedBox(height: 16),
            Text(
              state.error!,
              style: const TextStyle(color: Colors.red),
              textAlign: TextAlign.center,
            ),
          ],
        ),
      );
    }

    final slotData = state.data;
    if (slotData == null) {
      return const Padding(
        padding: EdgeInsets.all(8.0),
        child: Column(
          children: [
            Row(
              mainAxisAlignment: MainAxisAlignment.spaceBetween,
              children: [
                Text(
                  &quot;Parking Availability&quot;,
                  style: TextStyle(fontSize: 18, fontWeight: FontWeight.w500),
                ),
                Text(&quot;No data&quot;, style: TextStyle(fontSize: 18)),
              ],
            ),
          ],
        ),
      );
    }

    return Padding(
      padding: const EdgeInsets.all(8.0),
      child: Column(
        children: [
          Row(
            mainAxisAlignment: MainAxisAlignment.spaceBetween,
            children: [
              const Text(
                &quot;Parking Availability&quot;,
                style: TextStyle(fontSize: 18, fontWeight: FontWeight.w500),
              ),
              Text(
                &quot;${slotData.avaliableSlots}/${slotData.totalSlots} available&quot;,
                style: TextStyle(
                  color:
                      slotData.avaliableSlots &amp;gt; 0 ? Colors.black : Colors.red,
                  fontSize: 18,
                ),
              ),
            ],
          ),
          const SizedBox(height: 16),
          ClipRRect(
            borderRadius: BorderRadius.circular(10),
            child: LinearProgressIndicator(
              value: slotData.avaliableSlots / slotData.totalSlots,
              minHeight: 10,
              backgroundColor: Colors.grey[300],
              valueColor: AlwaysStoppedAnimation&amp;lt;Color&amp;gt;(
                slotData.avaliableSlots &amp;gt; 0 ? Colors.blue : Colors.red,
              ),
            ),
          ),
        ],
      ),
    );
  }
}
&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;最後就是每一個停車位的狀態，在此使用 GridView 進行每一個停車格的呈現。&lt;/p&gt;
&lt;pre&gt;&lt;code&gt;import &apos;package:flutter/material.dart&apos;;
import &apos;package:parking/Types/slotdata.dart&apos;;

class SlotStatus extends StatelessWidget {
  const SlotStatus({
    super.key,
    required ParkingDataState state,
  }) : _state = state;

  final ParkingDataState _state;

  @override
  Widget build(BuildContext context) {
    return SizedBox(
      height: 300,
      child: GridView.builder(
        gridDelegate:
            const SliverGridDelegateWithFixedCrossAxisCount(
              crossAxisCount: 3,
              childAspectRatio: 1.5,
            ),
        itemCount: _state.data!.slots.length,
        itemBuilder: (context, index) {
          final occupied = _state.data!.slots[index];
          return Card(
            color:
                occupied ? Colors.red[100] : Colors.green[100],
            child: Padding(
              padding: const EdgeInsets.all(4.0),
              child: Center(
                child: Column(
                  mainAxisAlignment: MainAxisAlignment.center,
                  mainAxisSize: MainAxisSize.min,
                  children: [
                    Expanded(
                      child: Text(
                        &apos;車位 #${index + 1}&apos;,
                        style: const TextStyle(fontSize: 11),
                      ),
                    ),
                    const SizedBox(height: 2),
                    Icon(
                      occupied
                          ? Icons.directions_car
                          : Icons.check_box_outline_blank,
                      color:
                          occupied ? Colors.red : Colors.green,
                      size: 18,
                    ),
                    const SizedBox(height: 2),
                    Expanded(
                      child: Text(
                        occupied ? &apos;有車&apos; : &apos;空位&apos;,
                        style: const TextStyle(fontSize: 11),
                      ),
                    ),
                  ],
                ),
              ),
            ),
          );
        },
      ),
    );
  }
}
&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;最後就是程式的基底。因為前面都跟以前相同，所以就先折了。然後下方 build 各位應該也可以看到整個 &lt;code&gt;build&lt;/code&gt; function 程式碼變超少，因為全部都搬到其他檔案去了，所也整個乾淨了許多。&lt;/p&gt;
&lt;pre&gt;&lt;code&gt;import &apos;package:flutter/material.dart&apos;;
import &apos;package:parking/Widgets/slotdata.dart&apos;;
import &apos;package:parking/Widgets/slotstatus.dart&apos;;
import &apos;package:parking/Widgets/topbar.dart&apos;;
import &apos;package:parking/Widgets/slotprogress.dart&apos;;
import &apos;package:parking/Types/slotdata.dart&apos;;
import &apos;package:http/http.dart&apos; as http;
import &apos;dart:convert&apos;;
import &apos;dart:async&apos;;
import &apos;dart:io&apos;;

void main() {
  runApp(const MyApp());
}

class MyApp extends StatelessWidget {
  const MyApp({super.key});

  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      debugShowCheckedModeBanner: false,
      title: &apos;Parking Area Info&apos;,
      theme: ThemeData(
        colorScheme: ColorScheme.fromSeed(seedColor: Colors.lightBlue),
      ),
      home: const MyHomePage(title: &apos;Parking Area Info&apos;),
    );
  }
}

class MyHomePage extends StatefulWidget {
  final String title;

  const MyHomePage({super.key, required this.title});

  @override
  State&amp;lt;MyHomePage&amp;gt; createState() =&amp;gt; _MyHomePageState();
}

class _MyHomePageState extends State&amp;lt;MyHomePage&amp;gt; {
  ParkingDataState _state = ParkingDataState.loading();
  final String _apiUrl = &apos;http://192.168.50.250:3000/api/status&apos;;
  final String _wsUrl = &apos;ws://192.168.50.250:3000/ws&apos;;
  WebSocket? _webSocket;
  StreamSubscription? _webSocketSubscription;

  Future&amp;lt;void&amp;gt; _loadData() async {
    setState(() {
      _state = ParkingDataState.loading();
    });

    try {
      // Add timeout to the request
      final response = await http
          .get(Uri.parse(_apiUrl))
          .timeout(
            const Duration(seconds: 5),
            onTimeout: () {
              throw TimeoutException(&apos;請求超時，請檢查網路連線&apos;);
            },
          );

      if (response.statusCode == 200) {
        final jsonData = json.decode(response.body);
        final data = SlotData.fromJson(jsonData);

        setState(() {
          _state = ParkingDataState.success(data);
        });
      } else {
        throw Exception(&apos;伺服器返回錯誤: ${response.statusCode}&apos;);
      }
    } on SocketException {
      setState(() {
        _state = ParkingDataState.error(&apos;無法連接到伺服器，請檢查網路連線&apos;);
      });
    } on TimeoutException catch (e) {
      setState(() {
        _state = ParkingDataState.error(e.message ?? &apos;請求超時&apos;);
      });
    } on FormatException {
      setState(() {
        _state = ParkingDataState.error(&apos;資料格式錯誤&apos;);
      });
    } catch (e) {
      setState(() {
        _state = ParkingDataState.error(&apos;發生錯誤: ${e.toString()}&apos;);
      });
    }

    if (mounted &amp;amp;&amp;amp; _state.error != null) {
      ScaffoldMessenger.of(context).showSnackBar(
        SnackBar(
          content: Text(_state.error!),
          backgroundColor: Colors.red,
          duration: const Duration(seconds: 3),
          action: SnackBarAction(
            label: &apos;重試&apos;,
            textColor: Colors.white,
            onPressed: _loadData,
          ),
        ),
      );
    }
  }

  @override
  void initState() {
    super.initState();
    _loadData();
    _connectWebSocket();
  }

  @override
  void dispose() {
    _webSocketSubscription?.cancel();
    _webSocket?.close();
    super.dispose();
  }

  void _connectWebSocket() async {
    try {
      print(&apos;Attempting to connect to WebSocket at $_wsUrl&apos;);
      final socket = await WebSocket.connect(_wsUrl);
      print(&apos;WebSocket connected successfully&apos;);
      _webSocket = socket;
      _webSocketSubscription = _webSocket?.listen(
        (data) {
          try {
            print(&apos;Received WebSocket data: $data&apos;);
            final Map&amp;lt;String, dynamic&amp;gt; jsonData = jsonDecode(data);
            if (jsonData[&apos;type&apos;] != &quot;parkingUpdate&quot;) {
              print(
                &apos;Received unexpected WebSocket data type: ${jsonData[&apos;type&apos;]}, ignoring&apos;,
              );
              return;
            }
            final updatedData = SlotData.fromJson(jsonData[&apos;data&apos;]);
            setState(() {
              _state = ParkingDataState.success(updatedData);
            });
          } catch (e) {
            print(&apos;Error parsing WebSocket data: $e&apos;);
            setState(() {
              _state = ParkingDataState.error(&apos;WebSocket數據格式錯誤&apos;);
            });
          }
        },
        onError: (error) {
          print(&apos;WebSocket error: $error&apos;);
          setState(() {
            _state = ParkingDataState.error(&apos;WebSocket連接錯誤&apos;);
          });
          _reconnectWebSocket();
        },
        onDone: () {
          print(&apos;WebSocket connection closed&apos;);
          setState(() {
            _state = ParkingDataState.error(&apos;WebSocket連接已關閉&apos;);
          });
          _reconnectWebSocket();
        },
      );
    } catch (e) {
      print(&apos;Error connecting to WebSocket: $e&apos;);
      setState(() {
        _state = ParkingDataState.error(&apos;無法連接到伺服器&apos;);
      });
      _reconnectWebSocket();
    }
  }

  void _reconnectWebSocket() {
    print(&apos;Attempting to reconnect WebSocket in 3 seconds...&apos;);
    Future.delayed(const Duration(seconds: 3), () {
      if (mounted) {
        _connectWebSocket();
      }
    });
  }

  @override
  Widget build(BuildContext context) {
    return Scaffold(
      body: SafeArea(
        child: RefreshIndicator(
          onRefresh: _loadData,
          child: SingleChildScrollView(
            physics: const AlwaysScrollableScrollPhysics(),
            child: Container(
              height:
                  MediaQuery.of(context).size.height -
                  MediaQuery.of(context).padding.top,
              padding: const EdgeInsets.only(left: 16.0, right: 16.0),
              child: Column(
                children: [
                  const TopBar(),
                  const SizedBox(height: 8),
                  SlotDataWidget(state: _state),
                  const SizedBox(height: 8),
                  SlotProgress(state: _state),
                  const SizedBox(height: 8),
                  if (_state.data != null)
                    SlotStatus(state: _state),
                ],
              ),
            ),
          ),
        ),
      ),
      floatingActionButton: FloatingActionButton(
        onPressed: _loadData,
        tooltip: &apos;Reload&apos;,
        child: const Icon(Icons.refresh),
      ),
    );
  }
}
&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;當然關於所有作業要求部分都在這裡，在這歡迎各位去看。而本人也已經盡量達到作業要求，且將因為此 APP 要跟其他課程結合，所以有些作業要求達不到的事告訴 Flutter 課程的彼得，而他也同意了，非常感謝。&lt;/p&gt;
&lt;p&gt;https://medium.com/%E5%BD%BC%E5%BE%97%E6%BD%98%E7%9A%84%E8%A9%A6%E7%85%89-%E5%8B%87%E8%80%85%E7%9A%84-100-%E9%81%93-swift-ios-app-%E8%AC%8E%E9%A1%8C/222-%E5%A4%A7%E5%AD%B8%E7%9A%84-flutter-app-%E5%85%A5%E9%96%80%E8%AA%B2%E7%A8%8B%E6%9C%9F%E6%9C%AB%E5%B0%88%E9%A1%8C-6e1c760eecf8&lt;/p&gt;
&lt;h2&gt;Final Exhibition&lt;/h2&gt;
&lt;p&gt;主要系統與 App 主功能展示
&amp;lt;div style=&quot;position:relative; width:100%; height:0px; padding-bottom:56.250%&quot;&amp;gt;&amp;lt;iframe allow=&quot;fullscreen&quot; allowfullscreen height=&quot;100%&quot; src=&quot;https://streamable.com/e/glfrzf?&quot; width=&quot;100%&quot; style=&quot;border:none; width:100%; height:100%; position:absolute; left:0px; top:0px; overflow:hidden;&quot;&amp;gt;&amp;lt;/iframe&amp;gt;&amp;lt;/div&amp;gt;&lt;/p&gt;
&lt;p&gt;App 其他部分展示
&amp;lt;div style=&quot;position:relative; width:100%; height:0px; padding-bottom:217.687%&quot;&amp;gt;&amp;lt;iframe allow=&quot;fullscreen&quot; allowfullscreen height=&quot;100%&quot; src=&quot;https://streamable.com/e/vioty7?&quot; width=&quot;100%&quot; style=&quot;border:none; width:100%; height:100%; position:absolute; left:0px; top:0px; overflow:hidden;&quot;&amp;gt;&amp;lt;/iframe&amp;gt;&amp;lt;/div&amp;gt;&lt;/p&gt;
&lt;h2&gt;Future Improvements&lt;/h2&gt;
&lt;h3&gt;App&lt;/h3&gt;
&lt;p&gt;&lt;img src=&quot;./AppImprove.png&quot; alt=&quot;&quot; /&gt;
簡單來說為以下幾點：&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;&lt;strong&gt;喜愛的停車位：&lt;/strong&gt; 將喜歡停的停車位進行標記，並將那些停車位釘選在停車位狀態列表的最前面&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;登入系統：&lt;/strong&gt; 使用者可以透過 OAuth 登入，將他們選擇的喜愛停車位紀錄上傳至雲端，並且在新裝置上登入相同的帳號，即可從雲端還原喜愛停車位紀錄&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;顯示快取資料：&lt;/strong&gt; 讓 App 在離線狀態下，如果一段時間前有抓過停車場狀態資料的話，則顯示該停車場一段時間之前的狀態資料&lt;/li&gt;
&lt;/ul&gt;
&lt;h3&gt;Core System&lt;/h3&gt;
&lt;p&gt;&lt;img src=&quot;./CoreImprove.png&quot; alt=&quot;&quot; /&gt;
簡單來說為以下幾點：&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;&lt;strong&gt;整合資料庫：&lt;/strong&gt; 目前只是將停車位資料儲存在記憶體中，但是希望未來可以整合資料庫，以避免停車場狀態紀錄遺失&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;支援多個停車場：&lt;/strong&gt; 使一個系統可以同時管理多個停車場，並且可以非常容易進行設定&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;簡易部署：&lt;/strong&gt; 找到將系統包成 Docker image 時，剛執行就跑出 board closed 訊息的根本原因，並且將系統重新打包成 Docker image，讓整個系統容易部署。&lt;/li&gt;
&lt;/ul&gt;
&lt;h2&gt;Summary&lt;/h2&gt;
&lt;p&gt;這學期的兩個課程個人真的覺得非常的充實，雖然說中途遇到了一些無可避免的問題，但是最後在同學的幫助與自己的努力下，將問題都處理掉了。雖然說架構部分，沒有如願以償的將自己寫的 M2M 系統用上，然後也沒成功用上 Docker，但是整個製作下來還是可以說非常的充實。再次感謝學校有開這兩門課程，讓我們的課程有更多的選擇。最後也感謝 IT 邦幫忙鐵人賽冠軍系列文章「IoT 沒那麼難！新手用 JavaScript 入門作自己的玩具！」，讓我在這次的專題中，有信心的在 Arduino 方面選擇使用 JavaScript 作為控制 Arduino 所使用的程式語言，避開繁瑣的 &lt;code&gt;.ino&lt;/code&gt; 檔案撰寫，使控制 Arduino 更加容易。&lt;/p&gt;
&lt;p&gt;https://ithelp.ithome.com.tw/users/20103130/ironman/2125?sc=hot&lt;/p&gt;
&lt;p&gt;而此系列文章也有書籍，如果想要看的話也可以考慮購買&lt;/p&gt;
&lt;p&gt;https://www.books.com.tw/products/0010875992?srsltid=AfmBOopjEck7FnykyHyCDaX6AVLdKhG1GPGdYN3i9gHBzdLJQzMpqHBS&lt;/p&gt;
&lt;h2&gt;GitHub Repository&lt;/h2&gt;
&lt;p&gt;::github{repo=&quot;Kayxue/IoTFinalApp&quot;}
::github{repo=&quot;Kayxue/IoTFinalArduino&quot;}
原本已經寫好的簡單 M2M 系統，但是因為製作專題時間不足而廢棄
::github{repo=&quot;Kayxue/M2MSystem&quot;}&lt;/p&gt;
</content:encoded></item><item><title>Static Web Server－跨平台、高效能的網頁伺服器</title><link>https://blog.kayxue.dev/posts/staticwebserver/</link><guid isPermaLink="true">https://blog.kayxue.dev/posts/staticwebserver/</guid><description>一個奠基於 Hyper 和 Tokio 的高效能網頁伺服器</description><pubDate>Mon, 09 Jun 2025 00:00:00 GMT</pubDate><content:encoded>&lt;p&gt;今天要來介紹的是一個 Web Server。因為幾個月前在架這個部落格的時候，雖然覺得 actix-web 配上 actix-files 是一個不錯的選擇，但是他終究是一個後端框架，比較適合的場合是你真的需要寫一個後端的時候，如果真的是要架設一個純檔案伺服器或者完全靜態的網頁伺服器，那或許真的沒有那個必要。&lt;/p&gt;
&lt;p&gt;所以當時我開始尋找有什麼 Rust 寫出來的網頁伺服器，沒想到就找到了這個，而這幾個月使用下來果真覺得蠻好用的，除了打包起來很小、使用起來非常容易，並且在執行時佔用資源極低、效能優異，還保留了非常多設定，可以將 server 依據自己的需求來調整。&lt;/p&gt;
&lt;p&gt;在此附上官網：https://static-web-server.net/&lt;/p&gt;
&lt;h2&gt;Features&lt;/h2&gt;
&lt;p&gt;在這裡只會列舉一些，更多特色請自行前往官網查看。&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;&lt;strong&gt;High performance&lt;/strong&gt;－使用 Rust 撰寫，提供了高效非同步 I/O 、優越效能與記憶體安全&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Lightweight &amp;amp; portable&lt;/strong&gt;－單個靜態執行檔僅 4MB，無需任何依賴，適合在任何 Linux 發行版和 Docker 容器中執行。&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;HTTP/2 &amp;amp; TLS&lt;/strong&gt;－含 HTTPS redirect 的現代協議開箱支援&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;CORS &amp;amp; preflight&lt;/strong&gt;－設定 origins、methods 與 headers，並包含完整 preflight 支援&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;SPA fallback&lt;/strong&gt;－對於 React、Vue、Svelte 等框架，可以在請求發生 404 時導向至 &lt;code&gt;index.html&lt;/code&gt;&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Rewrites &amp;amp; Redirects&lt;/strong&gt;－包含取代功能的 Glob patterns 用以生成乾淨的 URL&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Health &amp;amp; Metrics&lt;/strong&gt;－健康監控 endpoint 與內建 Prometheus 監控&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Markdown Content&lt;/strong&gt;－可依據 &lt;code&gt;Accept&lt;/code&gt; header 來選擇提供 Markdown 或 HTML 格式的內容&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Smart compression&lt;/strong&gt;－可選的 &lt;code&gt;gzip&lt;/code&gt;, &lt;code&gt;brotli&lt;/code&gt;, &lt;code&gt;zstd&lt;/code&gt; 支援&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Pre-compressed files&lt;/strong&gt;－直接從硬碟提供 &lt;code&gt;.gz&lt;/code&gt;、&lt;code&gt;.br&lt;/code&gt; 或 &lt;code&gt;.zstd&lt;/code&gt; 壓縮的檔案&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Maintenance Mode&lt;/strong&gt;－當網頁更新時顯示自訂頁面&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;First-class Docker support&lt;/strong&gt;－多種架構且多樣的 image 可供選擇&lt;/li&gt;
&lt;/ul&gt;
&lt;h2&gt;Benchmarks&lt;/h2&gt;
&lt;p&gt;圖片來自官網，雖然是兩年前的了，但還是可以看到，其效能跟 &lt;a href=&quot;https://nginx.org/&quot;&gt;nginx&lt;/a&gt; 可以說是不相上下。
&lt;img src=&quot;./benchmark.jpg&quot; alt=&quot;&quot; /&gt;&lt;/p&gt;
&lt;h2&gt;Installation and Usage&lt;/h2&gt;
&lt;h3&gt;Directly Install&lt;/h3&gt;
&lt;p&gt;您可以直接前往&lt;a href=&quot;https://static-web-server.net/v3/download-install.html&quot;&gt;官網&lt;/a&gt;下載壓縮檔&lt;br /&gt;
Linux 使用者可以透過 binary installer 直接安裝：&lt;/p&gt;
&lt;pre&gt;&lt;code&gt;curl --proto &apos;=https&apos; --tlsv1.2 -sSfL https://get.static-web-server.net | sh
&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;MacOS 使用者可以透過 Homebrew 安裝：&lt;/p&gt;
&lt;pre&gt;&lt;code&gt;# Build from source
brew install static-web-server

# Just the binary
brew install static-web-server-bin

# Or build from source
brew install static-web-server
&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;Windows 使用者可以透過 scoop 安裝：&lt;/p&gt;
&lt;pre&gt;&lt;code&gt;scoop install static-web-server
&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;安裝完成之後，輸入以下指令即可啟動：&lt;/p&gt;
&lt;pre&gt;&lt;code&gt;static-web-server
&lt;/code&gt;&lt;/pre&gt;
&lt;h3&gt;Docker Run&lt;/h3&gt;
&lt;p&gt;:::tip
你可以在輸入指令時直接以像 &lt;code&gt;-v $HOME/my-public-dir:/public&lt;/code&gt; 這樣的參數提來直接覆蓋預設的 root directory，也可以在此直接透過 cli 參數進行 Static Web Server 相關設定，設定部分稍後會再解釋。
:::
輸入以下指令即可：&lt;/p&gt;
&lt;pre&gt;&lt;code&gt;docker run --rm -it -p 80:8787 joseluisq/static-web-server:&amp;lt;tag&amp;gt; -g info
# Or
docker run --rm -it -p 80:8787 ghcr.io/static-web-server/static-web-server:&amp;lt;tag&amp;gt; -g info
&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;&lt;code&gt;&amp;lt;tag&amp;gt;&lt;/code&gt; 部分會依據你想使用的 image 而不同，對照如下：&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;Scratch: &lt;code&gt;latest&lt;/code&gt;、&lt;code&gt;&amp;lt;version&amp;gt;&lt;/code&gt;&lt;/li&gt;
&lt;li&gt;Alpine Linux：&lt;code&gt;&amp;lt;version&amp;gt;-alpine&lt;/code&gt;&lt;/li&gt;
&lt;li&gt;Debian：&lt;code&gt;&amp;lt;version&amp;gt;-debian&lt;/code&gt;&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;&lt;code&gt;&amp;lt;version&amp;gt;&lt;/code&gt; 不知道要填多少的話可以上 &lt;a href=&quot;https://hub.docker.com/r/joseluisq/static-web-server/tags&quot;&gt;Docker Hub&lt;/a&gt; 查，懶得查的話請直接填 &lt;code&gt;2&lt;/code&gt;&lt;/p&gt;
&lt;p&gt;:::note
如果不知道要選哪個的話，選擇 Debian 即可，效能會比另外兩個更好；如果優先需要 image 更小的話可以選擇 Alpine 或者 Scratch
:::&lt;/p&gt;
&lt;h3&gt;Dockerfile&lt;/h3&gt;
&lt;p&gt;請在你的靜態網站專案下建立 Dockerfile，內容如下，若靜態網站有需要透過建置進行生成（例如 Astro 框架），請在插入以下內容之前寫上建置專案相關指令，並在 &lt;code&gt;COPY&lt;/code&gt; 指令時記得從前一個 stage 複製靜態網站相關檔案，設定檔如果沒有可以不用複製。&lt;code&gt;&amp;lt;tag&amp;gt;&lt;/code&gt; 部分如上方清單所示&lt;/p&gt;
&lt;pre&gt;&lt;code&gt;FROM joseluisq/static-web-server:&amp;lt;tag&amp;gt;

COPY ./public ./public
COPY ./config.toml ./config.toml

EXPOSE 8787
&lt;/code&gt;&lt;/pre&gt;
&lt;h3&gt;Docker Compose&lt;/h3&gt;
&lt;p&gt;請在你的靜態網站專案下建立一個設定檔，&lt;code&gt;&amp;lt;tag&amp;gt;&lt;/code&gt; 的部分如前面列表所示（&lt;code&gt;environment&lt;/code&gt; 部分所做的設定等一下會再說明）&lt;/p&gt;
&lt;pre&gt;&lt;code&gt;version: &quot;3.3&quot;

services:
  website:
    image: joseluisq/static-web-server:&amp;lt;tag&amp;gt;
    container_name: &quot;website&quot;
    ports:
      - 80:8787
    restart: unless-stopped
    environment:
      # Note: those envs are customizable but also optional
      - SERVER_ROOT=/var/public
      - SERVER_CONFIG_FILE=/etc/config.toml
    volumes:
      - ./public:/var/public
      - ./config.toml:/etc/config.toml
&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;然後在專案資料夾下輸入以下指令即可啟動：&lt;/p&gt;
&lt;pre&gt;&lt;code&gt;docker-compose up -d
&lt;/code&gt;&lt;/pre&gt;
&lt;h2&gt;Configuration&lt;/h2&gt;
&lt;h3&gt;Environment Variables&lt;/h3&gt;
&lt;p&gt;更改 Static Web Server 相關設定最通用的一種方式就是修改環境變數，這方法不管是 Linux、MacOS 或者 Windows 都可以使用。&lt;/p&gt;
&lt;p&gt;裡面個人最常會設定的環境變數如下：&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;&lt;code&gt;SERVER_HOST&lt;/code&gt;、&lt;code&gt;SERVER_PORT&lt;/code&gt;：host 與端口，預設為 &lt;code&gt;[::]&lt;/code&gt; 與 &lt;code&gt;8787&lt;/code&gt;&lt;/li&gt;
&lt;li&gt;&lt;code&gt;SERVER_ROOT&lt;/code&gt;：靜態網站檔案的根目錄，絕對或相對路徑皆可&lt;/li&gt;
&lt;li&gt;&lt;code&gt;SERVER_DIRECTORY_LISTING&lt;/code&gt;：在請求結尾為 &lt;code&gt;/&lt;/code&gt; 時啟用 directory listing&lt;/li&gt;
&lt;li&gt;&lt;code&gt;SERVER_CORS_ALLOW_ORIGINS&lt;/code&gt;：CORS 的允許 origin 列表，預設為空，若要允許任何 host，請修改成 &lt;code&gt;*&lt;/code&gt;&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;其餘更多環境變數請參考&lt;a href=&quot;https://static-web-server.net/configuration/environment-variables/&quot;&gt;官網&lt;/a&gt;&lt;/p&gt;
&lt;h3&gt;Command-Line Arguments&lt;/h3&gt;
&lt;p&gt;輸入以下指令即可查看&lt;/p&gt;
&lt;pre&gt;&lt;code&gt;static-web-server -h
&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;內容如下，command-line arguments 基本上跟環境變數是等效的，如果指定 command-line arguments 在環境變數也有設定，會優先採用 command-line arguments。&lt;/p&gt;
&lt;pre&gt;&lt;code&gt;A cross-platform, high-performance and asynchronous web server for static files-serving.

Usage: static-web-server [OPTIONS] [COMMAND]

Commands:
  generate  Generate man pages and shell completions
  help      Print this message or the help of the given subcommand(s)

Options:
  -a, --host &amp;lt;HOST&amp;gt;
          Host address (E.g 127.0.0.1 or ::1) [env: SERVER_HOST=] [default: ::]
  -p, --port &amp;lt;PORT&amp;gt;
          Host port [env: SERVER_PORT=] [default: 8787]
  -f, --fd &amp;lt;FD&amp;gt;
          Instead of binding to a TCP port, accept incoming connections to an already-bound TCP socket listener on the specified file descriptor number (usually zero). Requires that the parent process (e.g. inetd, launchd, or systemd) binds an address and port on behalf of static-web-server, before arranging for the resulting file descriptor to be inherited by static-web-server. Cannot be used in conjunction with the port and host arguments. The included systemd unit file utilises this feature to increase security by allowing the static-web-server to be sandboxed more completely [env: SERVER_LISTEN_FD=]
      --unix-socket &amp;lt;UNIX_SOCKET&amp;gt;
          Bind the server to a Unix Domain Socket (UDS) at the given filesystem path instead of a TCP host/port. Useful for reverse-proxy setups (e.g. nginx) on the same host where TCP/IP overhead is undesirable and filesystem-based access control is preferred. Cannot be combined with `--host`, `--port`, `--fd`, or TLS-related options. The socket file is removed on a graceful shutdown [env: SERVER_UNIX_SOCKET=]
      --unix-socket-mode &amp;lt;UNIX_SOCKET_MODE&amp;gt;
          Filesystem permission bits applied to the Unix socket file after binding, expressed in octal (e.g. `660`, `0660`, or `0o660`). When omitted the socket is created with the process umask. Only meaningful together with `--unix-socket` [env: SERVER_UNIX_SOCKET_MODE=]
      --unix-socket-force [&amp;lt;UNIX_SOCKET_FORCE&amp;gt;]
          When `true`, remove an existing socket file at `--unix-socket` before binding. This is useful when the server was previously killed abruptly and left a stale socket behind. Defaults to `false` to avoid clobbering an unrelated file [env: SERVER_UNIX_SOCKET_FORCE=] [default: false] [possible values: true, false]
  -n, --threads-multiplier &amp;lt;THREADS_MULTIPLIER&amp;gt;
          Number of worker threads multiplier that&apos;ll be multiplied by the number of system CPUs using the formula: `worker threads = number of CPUs * n` where `n` is the value that changes here. When multiplier value is 0 or 1 then one thread per core is used. Number of worker threads result should be a number between 1 and 32,768 though it is advised to keep this value on the smaller side [env: SERVER_THREADS_MULTIPLIER=] [default: 1]
  -b, --max-blocking-threads &amp;lt;MAX_BLOCKING_THREADS&amp;gt;
          Maximum number of blocking threads [env: SERVER_MAX_BLOCKING_THREADS=] [default: 512]
  -d, --root &amp;lt;ROOT&amp;gt;
          Root directory path of static files [env: SERVER_ROOT=] [default: ./public]
      --page50x &amp;lt;PAGE50X&amp;gt;
          HTML file path for 50x errors. If the path is not specified or simply doesn&apos;t exist then the server will use a generic HTML error message. If a relative path is used then it will be resolved under the root directory [env: SERVER_ERROR_PAGE_50X=] [default: ./50x.html]
      --page404 &amp;lt;PAGE404&amp;gt;
          HTML file path for 404 errors. If the path is not specified or simply doesn&apos;t exist then the server will use a generic HTML error message. If a relative path is used then it will be resolved under the root directory [env: SERVER_ERROR_PAGE_404=] [default: ./404.html]
      --page-fallback &amp;lt;PAGE_FALLBACK&amp;gt;
          A HTML file path (not relative to the root) used for GET requests when the requested path doesn&apos;t exist. The fallback page is served with a 200 status code, useful when using client routers. If the path doesn&apos;t exist then the feature is not activated [env: SERVER_FALLBACK_PAGE=] [default: &quot;&quot;]
  -g, --log-level &amp;lt;LOG_LEVEL&amp;gt;
          Specify a logging level in lower case. Values: error, warn, info, debug or trace [env: SERVER_LOG_LEVEL=] [default: error]
      --log-format &amp;lt;LOG_FORMAT&amp;gt;
          Specify the logging output format. Values: json (structured single-line JSON for production) or pretty (human-readable text for development) [env: SERVER_LOG_FORMAT=] [default: json] [possible values: json, pretty]
      --log-with-ansi [&amp;lt;LOG_WITH_ANSI&amp;gt;]
          Enable or disable ANSI escape codes for colors and other text formatting of the log output. Only effective when `--log-format pretty` is used [env: SERVER_LOG_WITH_ANSI=] [default: false] [possible values: true, false]
      --log-file &amp;lt;LOG_FILE&amp;gt;
          Optional filesystem path to stream log records to in addition to stderr. When set, logs are written asynchronously through a background worker thread (non-blocking I/O), so the request path is never delayed by disk writes. Missing parent directories are created on startup. ANSI escape codes are always disabled for file output regardless of `--log-with-ansi`. The file uses the format selected by `--log-format` (JSON by default). The file is opened in append mode and is not rotated by SWS, use an external tool (e.g. `logrotate`) for rotation [env: SERVER_LOG_FILE=]
  -c, --cors-allow-origins &amp;lt;CORS_ALLOW_ORIGINS&amp;gt;
          Specify an optional CORS list of allowed origin hosts separated by commas. Host ports or protocols aren&apos;t being checked. Use an asterisk (*) to allow any host [env: SERVER_CORS_ALLOW_ORIGINS=] [default: &quot;&quot;]
  -j, --cors-allow-headers &amp;lt;CORS_ALLOW_HEADERS&amp;gt;
          Specify an optional CORS list of allowed headers separated by commas. Default &quot;origin, content-type&quot;. It requires `--cors-allow-origins` to be used along with [env: SERVER_CORS_ALLOW_HEADERS=] [default: &quot;origin, content-type, authorization&quot;]
      --cors-expose-headers &amp;lt;CORS_EXPOSE_HEADERS&amp;gt;
          Specify an optional CORS list of exposed headers separated by commas. Default &quot;origin, content-type&quot;. It requires `--cors-expose-origins` to be used along with [env: SERVER_CORS_EXPOSE_HEADERS=] [default: &quot;origin, content-type&quot;]
  -t, --tls [&amp;lt;TLS&amp;gt;]
          Enable TLS/HTTPS support. Requires --tls-cert and --tls-key [env: SERVER_TLS=] [default: false] [possible values: true, false]
      --tls-cert &amp;lt;TLS_CERT&amp;gt;
          Specify the file path to the TLS certificate [env: SERVER_TLS_CERT=]
      --tls-key &amp;lt;TLS_KEY&amp;gt;
          Specify the file path to the TLS private key [env: SERVER_TLS_KEY=]
      --http2 [&amp;lt;HTTP2&amp;gt;]
          Enable HTTP/2 protocol support. Requires TLS to be enabled (--tls) [env: SERVER_HTTP2=] [default: false] [possible values: true, false]
      --https-redirect [&amp;lt;HTTPS_REDIRECT&amp;gt;]
          Redirect all requests with scheme &quot;http&quot; to &quot;https&quot; for the current server instance. Requires TLS to be enabled (--tls) [env: SERVER_HTTPS_REDIRECT=] [default: false] [possible values: true, false]
      --https-redirect-host &amp;lt;HTTPS_REDIRECT_HOST&amp;gt;
          Canonical host name or IP of the HTTPS server. It depends on &quot;https_redirect&quot; to be enabled [env: SERVER_HTTPS_REDIRECT_HOST=] [default: localhost]
      --https-redirect-from-port &amp;lt;HTTPS_REDIRECT_FROM_PORT&amp;gt;
          HTTP host port where the redirect server will listen for requests to redirect them to HTTPS. It depends on &quot;https_redirect&quot; to be enabled [env: SERVER_HTTPS_REDIRECT_FROM_PORT=] [default: 80]
      --https-redirect-from-hosts &amp;lt;HTTPS_REDIRECT_FROM_HOSTS&amp;gt;
          List of host names or IPs allowed to redirect from. HTTP requests must contain the HTTP &apos;Host&apos; header and match against this list. It depends on &quot;https_redirect&quot; to be enabled [env: SERVER_HTTPS_REDIRECT_FROM_HOSTS=] [default: localhost]
      --index-files &amp;lt;INDEX_FILES&amp;gt;
          List of files that will be used as an index for requests ending with the slash character (‘/’). Files are checked in the specified order [env: SERVER_INDEX_FILES=] [default: index.html]
  -x, --compression [&amp;lt;COMPRESSION&amp;gt;]
          Gzip, Deflate, Brotli or Zstd compression on demand determined by the Accept-Encoding header and applied to text-based web file types only [env: SERVER_COMPRESSION=] [default: true] [possible values: true, false]
      --compression-level &amp;lt;COMPRESSION_LEVEL&amp;gt;
          Compression level to apply for Gzip, Deflate, Brotli or Zstd compression [env: SERVER_COMPRESSION_LEVEL=] [default: default] [possible values: fastest, best, default]
      --compression-static [&amp;lt;COMPRESSION_STATIC&amp;gt;]
          Look up the pre-compressed file variant (`.gz`, `.br` or `.zst`) on disk of a requested file and serves it directly if available. The compression type is determined by the `Accept-Encoding` header [env: SERVER_COMPRESSION_STATIC=] [default: true] [possible values: true, false]
  -z, --directory-listing [&amp;lt;DIRECTORY_LISTING&amp;gt;]
          Enable directory listing for all requests ending with the slash character (‘/’) [env: SERVER_DIRECTORY_LISTING=] [default: false] [possible values: true, false]
      --directory-listing-order &amp;lt;DIRECTORY_LISTING_ORDER&amp;gt;
          Specify a default code number to order directory listing entries per `Name`, `Last modified` or `Size` attributes (columns). Code numbers supported: 0 (Name asc), 1 (Name desc), 2 (Last modified asc), 3 (Last modified desc), 4 (Size asc), 5 (Size desc). Default 6 (unordered) [env: SERVER_DIRECTORY_LISTING_ORDER=] [default: 6]
      --directory-listing-format &amp;lt;DIRECTORY_LISTING_FORMAT&amp;gt;
          Specify a content format for directory listing entries. Formats supported: &quot;html&quot; or &quot;json&quot;. Default &quot;html&quot; [env: SERVER_DIRECTORY_LISTING_FORMAT=] [default: html] [possible values: html, json]
      --directory-listing-download=&amp;lt;DIRECTORY_LISTING_DOWNLOAD&amp;gt;
          Specify list of enabled format(s) for directory download. Format supported: `targz`. Default to empty list (disabled) [env: SERVER_DIRECTORY_LISTING_DOWNLOAD=] [possible values: targz]
      --security-headers [&amp;lt;SECURITY_HEADERS&amp;gt;]
          Enable security headers by default when TLS feature is activated. Headers included: &quot;Strict-Transport-Security: max-age=63072000; includeSubDomains; preload&quot; (2 years max-age), &quot;X-Frame-Options: DENY&quot; and &quot;Content-Security-Policy: frame-ancestors &apos;self&apos;&quot; [env: SERVER_SECURITY_HEADERS=] [default: true] [possible values: true, false]
  -e, --cache-control-headers [&amp;lt;CACHE_CONTROL_HEADERS&amp;gt;]
          Enable cache control headers for incoming requests based on a set of file types. The file type list can be found on `src/control_headers.rs` file [env: SERVER_CACHE_CONTROL_HEADERS=] [default: true] [possible values: true, false]
      --etag [&amp;lt;ETAG&amp;gt;]
          Enable weak `ETag` headers (`W/&quot;&amp;lt;mtime&amp;gt;-&amp;lt;size&amp;gt;&quot;`) and full conditional request handling (`If-None-Match`, `If-Match`, `If-Range`). Composes with `--cache-control-headers`; emits validators on every static-file response so clients can revalidate hot HTML even when long `max-age` is configured elsewhere [env: SERVER_ETAG=] [default: true] [possible values: true, false]
      --basic-auth &amp;lt;BASIC_AUTH&amp;gt;
          It provides The &quot;Basic&quot; HTTP Authentication scheme using credentials as &quot;user-id:password&quot; pairs. Password must be encoded using the &quot;BCrypt&quot; password-hashing function [env: SERVER_BASIC_AUTH=] [default: &quot;&quot;]
  -q, --grace-period &amp;lt;GRACE_PERIOD&amp;gt;
          Defines a grace period in seconds after a `SIGTERM` signal is caught which will delay the server before to shut it down gracefully. The maximum value is 255 seconds [env: SERVER_GRACE_PERIOD=] [default: 0]
  -w, --config-file &amp;lt;CONFIG_FILE&amp;gt;
          Server TOML configuration file path [env: SERVER_CONFIG_FILE=] [default: ./sws.toml]
      --log-remote-address [&amp;lt;LOG_REMOTE_ADDRESS&amp;gt;]
          Log incoming requests information along with its remote address if available using the `info` log level [env: SERVER_LOG_REMOTE_ADDRESS=] [default: false] [possible values: true, false]
      --log-x-real-ip [&amp;lt;LOG_X_REAL_IP&amp;gt;]
          Log the X-Real-IP header for remote IP information [env: SERVER_LOG_X_REAL_IP=] [default: false] [possible values: true, false]
      --log-forwarded-for [&amp;lt;LOG_FORWARDED_FOR&amp;gt;]
          Log the X-Forwarded-For header for remote IP information [env: SERVER_LOG_FORWARDED_FOR=] [default: false] [possible values: true, false]
      --trusted-proxies &amp;lt;TRUSTED_PROXIES&amp;gt;
          List of IPs to use X-Forwarded-For from. The default is to trust all [env: SERVER_TRUSTED_PROXIES=]
      --redirect-trailing-slash [&amp;lt;REDIRECT_TRAILING_SLASH&amp;gt;]
          Check for a trailing slash in the requested directory URI and redirect permanently (308) to the same path with a trailing slash suffix if it is missing [env: SERVER_REDIRECT_TRAILING_SLASH=] [default: true] [possible values: true, false]
      --include-hidden [&amp;lt;INCLUDE_HIDDEN&amp;gt;]
          Include hidden files/directories (dotfiles), allowing them to be served and listed in auto HTML index pages (directory listing). Disabled by default; hidden files return `404 Not Found` [env: SERVER_INCLUDE_HIDDEN=] [default: false] [possible values: true, false]
      --follow-symlinks [&amp;lt;FOLLOW_SYMLINKS&amp;gt;]
          Follow symbolic links when serving files or directories. Disabled by default; requests whose path contains any symlink component return `403 Forbidden` [env: SERVER_FOLLOW_SYMLINKS=] [default: false] [possible values: true, false]
      --use-relative-root [&amp;lt;USE_RELATIVE_ROOT&amp;gt;]
          Resolve the web root directory at request time rather than at startup, allowing symlinked root directories to be swapped at runtime [env: SERVER_USE_RELATIVE_ROOT=] [default: false] [possible values: true, false]
      --accept-markdown [&amp;lt;ACCEPT_MARKDOWN&amp;gt;]
          Enable markdown content negotiation. When a client sends Accept: text/markdown, serve .md or .html.md files if available [env: SERVER_ACCEPT_MARKDOWN=] [default: false] [possible values: true, false]
      --text-charset [&amp;lt;TEXT_CHARSET&amp;gt;]
          Set a default `charset=utf-8` parameter on limited set of `text` responses that don&apos;t already have one [env: SERVER_TEXT_CHARSET=] [default: true] [possible values: true, false]
      --health [&amp;lt;HEALTH&amp;gt;]
          Add a /health endpoint that doesn&apos;t generate any log entry and returns a 200 status code. This is especially useful with Kubernetes liveness and readiness probes [env: SERVER_HEALTH=] [default: false] [possible values: true, false]
      --metrics [&amp;lt;METRICS&amp;gt;]
          Enable the /metrics endpoint that exposes Prometheus metrics for HTTP requests, connections, and latency [env: SERVER_METRICS=] [default: false] [possible values: true, false]
      --maintenance-mode [&amp;lt;MAINTENANCE_MODE&amp;gt;]
          Enable the server&apos;s maintenance mode functionality [env: SERVER_MAINTENANCE_MODE=] [default: false] [possible values: true, false]
      --maintenance-mode-status &amp;lt;MAINTENANCE_MODE_STATUS&amp;gt;
          Provide a custom HTTP status code when entering into maintenance mode. Default 503 [env: SERVER_MAINTENANCE_MODE_STATUS=] [default: 503]
      --maintenance-mode-file &amp;lt;MAINTENANCE_MODE_FILE&amp;gt;
          Provide a custom maintenance mode HTML file. If not provided then a generic message will be displayed [env: SERVER_MAINTENANCE_MODE_FILE=] [default: &quot;&quot;]
  -V, --version
          Print version info and exit
  -h, --help
          Print help (see more with &apos;--help&apos;)
&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;而 Windows 的話會有以下指令和選項：&lt;/p&gt;
&lt;pre&gt;&lt;code&gt;-s, --windows-service &amp;lt;windows-service&amp;gt;
           Run the web server as a Windows Service [env: SERVER_WINDOWS_SERVICE=]  [default: false]

SUBCOMMANDS:
   help         Prints this message or the help of the given subcommand(s)
   install      Install a Windows Service for the web server
   uninstall    Uninstall the current Windows Service
&lt;/code&gt;&lt;/pre&gt;
&lt;h3&gt;TOML&lt;/h3&gt;
&lt;p&gt;讀取 TOML 設定預設是關閉的，若要開啟，可以透過 &lt;code&gt;-w, --config-file&lt;/code&gt; 參數或者透過設定 &lt;code&gt;SERVER_CONFIG_FILE&lt;/code&gt; 環境變數提供路徑。設定檔的優先度是高於前兩者的，若設定檔中某設定值在前兩者之一有提供，會優先採用設定檔的設定值。&lt;/p&gt;
&lt;p&gt;以下摘自官網，裡面有所有設定與其預設值：&lt;/p&gt;
&lt;pre&gt;&lt;code&gt;[general]

#### Address &amp;amp; Root dir
host = &quot;::&quot;
port = 8787
root = &quot;./public&quot;

#### Logging
log-level = &quot;error&quot;
log-format = &quot;json&quot;

#### Cache Control headers
cache-control-headers = true

#### Auto Compression
compression = true
compression-level = &quot;default&quot;

#### Error pages
# Note: If a relative path is used then it will be resolved under the root directory.
page404 = &quot;./404.html&quot;
page50x = &quot;./50x.html&quot;

#### HTTP/2 + TLS
http2 = false
http2-tls-cert = &quot;&quot;
http2-tls-key = &quot;&quot;
https-redirect = false
https-redirect-host = &quot;localhost&quot;
https-redirect-from-port = 80
https-redirect-from-hosts = &quot;localhost&quot;

#### CORS &amp;amp; Security headers
# security-headers = true
# cors-allow-origins = &quot;&quot;

#### Directory listing
directory-listing = false

#### Directory listing sorting code
directory-listing-order = 1

#### Directory listing content format
directory-listing-format = &quot;html&quot;

#### Directory listing download format
directory-listing-download = []

#### Basic Authentication
# basic-auth = &quot;&quot;

#### File descriptor binding
# fd = &quot;&quot;

#### Worker threads
threads-multiplier = 1

#### Grace period after a graceful shutdown
grace-period = 0

#### Page fallback for 404s
# page-fallback = &quot;&quot;

#### Log request Remote Address if available
log-remote-address = false

#### Log real IP from X-Forwarded-For header if available
log-forwarded-for = false

#### IPs to accept the X-Forwarded-For header from. Empty means all
trusted-proxies = []

#### Redirect to trailing slash in the requested directory uri
redirect-trailing-slash = true

#### Use relative root (skip root canonicalization at startup)
use-relative-root = false

#### Check for existing pre-compressed files
compression-static = true

#### Health-check endpoint (GET or HEAD `/health`)
health = false

#### Markdown content negotiation
accept-markdown = false

#### Default charset for text responses (enabled by default)
# text-charset = false

#### List of index files
# index-files = &quot;index.html, index.htm&quot;
#### Maintenance Mode

maintenance-mode = false
# maintenance-mode-status = 503
# maintenance-mode-file = &quot;./maintenance.html&quot;

### Windows Only

#### Run the web server as a Windows Service
# windows-service = false


[advanced]

#### HTTP Headers customization (examples only)

#### a. Oneline version
# [[advanced.headers]]
# source = &quot;**/*.{js,css}&quot;
# headers = { Access-Control-Allow-Origin = &quot;*&quot; }

#### b. Multiline version
# [[advanced.headers]]
# source = &quot;/index.html&quot;
# [advanced.headers.headers]
# Cache-Control = &quot;public, max-age=36000&quot;
# Content-Security-Policy = &quot;frame-ancestors &apos;self&apos;&quot;
# Strict-Transport-Security = &quot;max-age=63072000; includeSubDomains; preload&quot;

#### c. Multiline version with explicit key (dotted)
# [[advanced.headers]]
# source = &quot;**/*.{jpg,jpeg,png,ico,gif}&quot;
# headers.Strict-Transport-Security = &quot;max-age=63072000; includeSubDomains; preload&quot;


### URL Redirects (examples only)

# [[advanced.redirects]]
# source = &quot;**/*.{jpg,jpeg}&quot;
# destination = &quot;/images/generic1.png&quot;
# kind = 301

# [[advanced.redirects]]
# source = &quot;/index.html&quot;
# destination = &quot;https://static-web-server.net&quot;
# kind = 302

### URL Rewrites (examples only)

# [[advanced.rewrites]]
# source = &quot;**/*.{png,ico,gif}&quot;
# destination = &quot;/assets/favicon.ico&quot;
## Optional redirection
# redirect = 301

# [[advanced.rewrites]]
# source = &quot;**/*.{jpg,jpeg}&quot;
# destination = &quot;/images/sws.png&quot;

### Virtual Hosting

# [[advanced.virtual-hosts]]
## But if the &quot;Host&quot; header matches this...
# host = &quot;sales.example.com&quot;
## ...then files will be served from here instead
# root = &quot;/var/sales/html&quot;

# [[advanced.virtual-hosts]]
# host = &quot;blog.example.com&quot;
# root = &quot;/var/blog/html&quot;

# [advanced.memory-cache]
# capacity = 100
# ttl = 1800      # 30 minutes
# tti = 300       # 5 minutes
# max-file-size = 8192  # 8 MiB
&lt;/code&gt;&lt;/pre&gt;
&lt;h2&gt;Dockerfile Examples&lt;/h2&gt;
&lt;h3&gt;File Server&lt;/h3&gt;
&lt;p&gt;由於 Scratch image 是沒有辦法透過 &lt;code&gt;CMD&lt;/code&gt; 下終端機指令的，而它預設 &lt;code&gt;./public&lt;/code&gt; 資料夾下已經有 &lt;code&gt;index.html&lt;/code&gt; 檔案，所以為了方便起見，我們換資料夾存放檔案，並且透過 &lt;code&gt;SERVER_ROOT&lt;/code&gt; 變數將根目錄路徑切換過去，這樣即可保證顯示資料夾目錄。&lt;/p&gt;
&lt;pre&gt;&lt;code&gt;FROM joseluisq/static-web-server:2
WORKDIR /
COPY ./assets ./assets
ENV SERVER_PORT=3000
ENV SERVER_CORS_ALLOW_ORIGINS=&quot;*&quot;
ENV SERVER_DIRECTORY_LISTING=true
ENV SERVER_ROOT=&quot;./assets&quot;

EXPOSE 3000
&lt;/code&gt;&lt;/pre&gt;
&lt;h3&gt;Astro Static Website&lt;/h3&gt;
&lt;p&gt;這個其實就是我目前架本部落格在用的 Dockerfile 檔案。由於需要先生成靜態網頁，所以需要採用 multi-stage build 的方式，先安裝相關模組、生成靜態網頁，之後再透過 Static Web Server 的 image 建立新的 stage，並從前一個 stage 將生成的靜態網站檔案複製進預設的根目錄資料夾進行覆蓋。&lt;/p&gt;
&lt;pre&gt;&lt;code&gt;FROM oven/bun:alpine AS builder

WORKDIR /app
COPY . .

RUN bun install
RUN bun run build

FROM joseluisq/static-web-server:latest

WORKDIR /

COPY --from=builder /app/dist/ ./public/
&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;:::warning
如果您的專案被限制使用 &lt;code&gt;pnpm&lt;/code&gt;（例如 fuwari），詳細請參考 pnpm 官方文件的 &lt;a href=&quot;https://pnpm.io/docker&quot;&gt;Working with Docker&lt;/a&gt;
:::
:::note
如果你想要你的 fuwari 專案「脫 pnpm 入 bun」可參考&lt;a href=&quot;/posts/actixstaticsereveastro/&quot;&gt;此文章&lt;/a&gt;的「Preparation」一節
:::&lt;/p&gt;
</content:encoded></item><item><title>IoT Final Project 1 - The Beginning</title><link>https://blog.kayxue.dev/posts/iotproject1/</link><guid isPermaLink="true">https://blog.kayxue.dev/posts/iotproject1/</guid><description>物聯網課程期末專題的開始</description><pubDate>Wed, 30 Apr 2025 00:00:00 GMT</pubDate><content:encoded>&lt;p&gt;既然 Flutter 課程相關文章已經出現在我的部落格裡了，就順便把這次 IoT 期末專題也記錄一下吧！這次專題，或許又是突破了只用上課所學來完成專題的一次。&lt;/p&gt;
&lt;h2&gt;What I Have Learned &amp;amp; My Confusion&lt;/h2&gt;
&lt;p&gt;從開學到現在，大概目前已經上了六次課，一次大概三小時。大概包括了目前整個 IoT 相關趨勢、M2M 的架構，還有 OM2M 與 Node-Red 相關的東西、使用 App Inventor 2 來讀取手機 GPS 資訊、使用 Arduino 接收感測器資料並送到 OM2M 上。&lt;/p&gt;
&lt;p&gt;整體來說，關於實作部分，我是覺得關於觀念部分似乎沒有到很深入，並且也使我留下了不少疑問。比如在送給 OM2M 的資料中，為什麼會有這些東西？又或者說，由於在課程中，我們所燒錄進去的 Arduino 程式，因為我沒什麼碰過這個領域，所以我根本不知道那些程式碼在寫什麼，而且感覺關於 working with network 部分更是令人困惑，個人感覺擴展部分似乎不容易，這要怎麼辦呢？&lt;/p&gt;
&lt;h2&gt;No OM2M?&lt;/h2&gt;
&lt;p&gt;這個章節標題能下得出來的，或許很多人看到都覺得很奇怪吧？OM2M 是全世界 IoT 的標準，那麼流行，我居然不想用？&lt;/p&gt;
&lt;p&gt;其實我原本也是想要用的，但是看到這晶片，相信各位已經知道了
&lt;img src=&quot;./mymac.png&quot; alt=&quot;&quot; /&gt;&lt;/p&gt;
&lt;p&gt;即使電腦是 Apple Silicon 晶片，不是也還是可以用嗎？OM2M 不是開源專案，而且用 Java 寫的，能跨平台跑不是嗎？嗯對，Java 能跨平台跑是真的，我曾經嘗試在別的平台上跑 Java project，但這專案......它已經年久失修，目前已經無法建置了。
&lt;img src=&quot;./buildfailed.png&quot; alt=&quot;&quot; /&gt;&lt;/p&gt;
&lt;p&gt;而這次 IoT 期末專題是 3 人一組，因為我們這組除了我之外，也有一個也是同樣使用 Apple Silicon 晶片的 MacBook。在遇到這個問題後，我只好在報告製作主題前兩週，直接開了小組會議說能不能拋棄 OM2M，因為如果我們兩個都因晶片架構不同而無法使用 OM2M，則製作工作會變成全部壓在一個人身上，這樣非常的不公平，而 OM2M 核心也就 CRUD 系統罷了，真了不起我們可以自己簡單搞一個。最後他們全部都同意了，所以最後就決定寫了一個簡易的 CRUD 系統，雖然說可能跟 OM2M 還是有差異，但至少因為是我們自己寫的，我們知道如何使用它，所以在使用上面會相對比較容易，而且可以額外實作出一些 OM2M 沒有的功能，彌補 OM2M 的不足。&lt;/p&gt;
&lt;h2&gt;No Node-Red?&lt;/h2&gt;
&lt;p&gt;不使用 Node-Red，那麼扯的嗎？&lt;/p&gt;
&lt;p&gt;沒錯，因為個人是覺得直接透過撰寫型程式語言（例如 Rust、C++）去寫其實反而比較快，Node-Red 的話雖然說功能強大，只要拖個拼塊，就能做好一個 API 了，並且可以按個按鈕直接部署，但是缺點其實非常明顯。&lt;/p&gt;
&lt;p&gt;第一個就是可自訂度低，有些東西模組基本上都是固定了，想換都不太容易；第二個就是「拖拼塊」你要動的是滑鼠，將拼塊從左側列表中找到你想要的，拖出來，然後再連起來，個人是感覺非常耗時。你如果自己寫的話，程式語言還可以自己選，框架自己挑，架構自己決定，這樣不是很舒服嗎？&lt;/p&gt;
&lt;p&gt;https://nodered.org/&lt;/p&gt;
&lt;p&gt;&lt;img src=&quot;./nodered.jpg&quot; alt=&quot;&quot; /&gt;&lt;/p&gt;
&lt;h2&gt;No C Syntax-like Arduino Code?&lt;/h2&gt;
&lt;p&gt;相信各位都知道 Arduino 基本上都是用像 C++ 語言的語法在 Arduino IDE 中寫程式碼，然後燒錄到 Arduino 中執行吧？雖然一般用途 C++ 要寫可能問題不大，但是換到 Arduino 上，變成了 setup 與 loop 兩個 function，並且看了一下 Arduino 有給的模組，主要都是給硬體方面的，對於網路的部分其實比較難去做一個整合的動作。而在這一兩個月我也稍微看了 &lt;a href=&quot;https://www.books.com.tw/products/0010875992?srsltid=AfmBOorI9pLB9c0ELLlL2m7ehdEcppYfZTIHt1sPhcNpjGweKJfCDXnG&quot;&gt;IoT 沒那麼難！新手用 JavaScript 入門做自己的玩具！&lt;/a&gt;書的內容還有系列文章，了解了 &lt;a href=&quot;https://johnny-five.io/&quot;&gt;Johnny-five&lt;/a&gt; 這個模組，因為他提供了相關 API 讓使用者可以以 JavaScript/TypeScript 的程式碼風格與方式去操控 Arduino。而我也對 TypeScript 執行後端開發經驗是相對熟悉的，所以這次就決定採用 TypeScript 與 Johnny-five 去操作 Arduino。&lt;/p&gt;
&lt;p&gt;&lt;img src=&quot;./johnnyfive.png&quot; alt=&quot;&quot; /&gt;&lt;/p&gt;
&lt;p&gt;當然這次沒意外執行環境會是 Bun，其對於 Johnny-five 的相容性就不得而知了，因為似乎沒有人這樣子玩過。關於 Johnny-five 對於其他 runtime environment 的支援度，其實我也曾經想過這方面的問題，所以我有在 Deno 的官方伺服器上問過這個問題，但我只有得到一個答案......TIAS (Try it and see)，可見似乎沒有人這樣嘗試過&lt;/p&gt;
&lt;p&gt;&lt;img src=&quot;./askondenoserver.png&quot; alt=&quot;&quot; /&gt;&lt;/p&gt;
&lt;p&gt;那這次就來玩吧！人生中能有多少像這樣嘗試的歲月？而且基本上語法跟在 Node.js 上執行所寫的程式碼沒有什麼兩樣，切換環境那是一下子的事情。&lt;/p&gt;
&lt;h2&gt;No App Inventor?&lt;/h2&gt;
&lt;blockquote&gt;
&lt;p&gt;Yeah, because I hate drag-and-drop blocks.&lt;/p&gt;
&lt;/blockquote&gt;
&lt;p&gt;就如同前面文章所說，拖拼塊對我來說是一件非常煩的事情，而這學期我也剛好有修彼得潘的 Flutter 課程，感覺 Flutter 其實是蠻不錯的一個跨平台應用程式框架，雖然說是使用 Dart 程式語言，過去我沒有碰過，但是寫到了現在，我感覺使用 Flutter 寫應用程式就有點像你在寫 React，在 widget class 中 declare 你要用到的 state 和 function，然後下方在 build 方法中像 React 一樣構築一個 widget 並傳回。&lt;/p&gt;
&lt;p&gt;https://flutter.dev/&lt;/p&gt;
&lt;p&gt;&lt;img src=&quot;./flutter.png&quot; alt=&quot;&quot; /&gt;&lt;/p&gt;
&lt;h2&gt;Architecture&lt;/h2&gt;
&lt;p&gt;當然那時有跟他們討論過，這個是目前暫定的架構，關於某些部分（例如圖中中下的 Elysia）目前也都還是未決定的狀態。&lt;/p&gt;
&lt;p&gt;&lt;img src=&quot;./architecture.jpg&quot; alt=&quot;&quot; /&gt;&lt;/p&gt;
&lt;h2&gt;Wrapping Up&lt;/h2&gt;
&lt;p&gt;希望這次專題能有非常大的收穫。雖然說基本上很多都用我用過的開發，但是就我也差不多才第二次吧？把不是上課教的工具直接套在期末專題上來說，還是會需要花額外時間去摸索與撰寫程式碼，但我相信這過程會是非常有趣的，並且我也非常期待接下來專題做出來的成果會如何。&lt;/p&gt;
</content:encoded></item><item><title>Flutter App 4 - A Music Player</title><link>https://blog.kayxue.dev/posts/flutterapp4/</link><guid isPermaLink="true">https://blog.kayxue.dev/posts/flutterapp4/</guid><description>一個小小的音樂播放器 App</description><pubDate>Mon, 28 Apr 2025 00:00:00 GMT</pubDate><content:encoded>&lt;p&gt;這次的作業是寫一個音樂播放器，雖然說可能沒有做得太精緻，但是還是盡量把功能做好。儘管沒有提供網路上搜尋音樂然後就可以直接播放的功能，但基本上還是有因為要減少應用程式的體積，還有在通知欄控制音樂播放，所以有將音樂先下載，然後臨時在網路上架一個小伺服器，讓音樂可以播放的同時，讓應用程式體積可以更小。&lt;/p&gt;
&lt;p&gt;:::caution
雖然說下方文章內容會有該小伺服器連結，但該網站上的資源與歌曲皆為流行歌，故在此僅供寫作業用，請勿使用該網站資源進行營利等其他行為。
:::&lt;/p&gt;
&lt;h2&gt;Preview&lt;/h2&gt;
&lt;p&gt;這次圖只有一張，如下圖所示：
&lt;img src=&quot;./IMG_2556FE805DA9-1.jpeg&quot; alt=&quot;&quot; /&gt;
沒錯，乾淨又簡單&lt;/p&gt;
&lt;h2&gt;Code Explanation&lt;/h2&gt;
&lt;p&gt;因為這次時間比較緊，所以採用 AI 去做了介面。又因為 VSCodium 的 GitHub Copilot 程式碼編輯功能不知道跑去哪了，而 Zed 編輯器的 AI 程式碼編輯一次又只能請它改你選取的區域，所以這次檔案只有一個主檔案跟一個宣告資料類型的檔案。widget 我也懶得分檔案了，反正 widget 都一次性。&lt;/p&gt;
&lt;h3&gt;Data Model&lt;/h3&gt;
&lt;p&gt;用以記錄歌曲的相關資料&lt;/p&gt;
&lt;pre&gt;&lt;code&gt;class Song {
  final String title;
  final String artist;
  final String imageName;
  final String audioName;

  Song({
    required this.title,
    required this.artist,
    required this.imageName,
    required this.audioName,
  });
}
&lt;/code&gt;&lt;/pre&gt;
&lt;h3&gt;Entrance&lt;/h3&gt;
&lt;p&gt;這裡主要就是做一些初始設定，比如在 App 中調音量時不會顯示系統的音量調整，並且初始化背景播放、通知控制等相關的東西。&lt;/p&gt;
&lt;pre&gt;&lt;code&gt;import &apos;dart:async&apos;;
import &apos;dart:collection&apos;;
import &apos;dart:math&apos;;

import &apos;package:flutter/material.dart&apos;;
import &apos;package:just_audio/just_audio.dart&apos;;
import &apos;package:just_audio_background/just_audio_background.dart&apos;;
import &apos;package:musicplayer/song.dart&apos;;
import &apos;package:rxdart/rxdart.dart&apos;;
import &apos;package:volume_controller/volume_controller.dart&apos;;

Future&amp;lt;void&amp;gt; main() async {
  VolumeController.instance.showSystemUI = false;
  await JustAudioBackground.init();
  runApp(const MyApp());
}

class MyApp extends StatelessWidget {
  const MyApp({super.key});

  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      title: &apos;Music App&apos;,
      theme: ThemeData(
        colorScheme: ColorScheme.fromSeed(seedColor: Colors.blue),
        scaffoldBackgroundColor: Colors.black,
        textTheme: const TextTheme(
          bodyMedium: TextStyle(color: Colors.white),
          headlineMedium: TextStyle(color: Colors.white),
        ),
      ),
      debugShowCheckedModeBanner: false,
      home: const MyHomePage(title: &apos;Music App&apos;),
    );
  }
}

class MyHomePage extends StatefulWidget {
  const MyHomePage({super.key, required this.title});

  final String title;

  @override
  State&amp;lt;MyHomePage&amp;gt; createState() =&amp;gt; _MyHomePageState();
}

class _MyHomePageState extends State&amp;lt;MyHomePage&amp;gt; {
  final AudioPlayer _audioPlayer = AudioPlayer();
  late final VolumeController _volumeController;
  late final StreamSubscription&amp;lt;double&amp;gt; _subscription;
  final HashMap&amp;lt;LoopMode, int&amp;gt; loopModeToIndex = HashMap.of({
    LoopMode.off: 0,
    LoopMode.all: 1,
    LoopMode.one: 2,
  });
  final HashMap&amp;lt;int, LoopMode&amp;gt; indexToLoopMode = HashMap.of({
    0: LoopMode.off,
    1: LoopMode.all,
    2: LoopMode.one,
  });
  List&amp;lt;Color&amp;gt; colors = [Colors.grey.shade700, Colors.white, Colors.white];
  List&amp;lt;Icon&amp;gt; icons = [
    const Icon(Icons.repeat),
    const Icon(Icons.repeat),
    const Icon(Icons.repeat_one),
  ];
  List&amp;lt;Song&amp;gt; songs = [
    Song(
      title: &apos;Numb&apos;,
      artist: &apos;Will Pan&apos;,
      imageName: &apos;IMG_6398.jpg&apos;,
      audioName: &apos;Numb.mp3&apos;,
    ),
    Song(
      title: &apos;Colorful&apos;,
      artist: &apos;Hiiragi Magnetite&apos;,
      imageName: &apos;IMG_6399.jpg&apos;,
      audioName: &apos;カラフル.mp3&apos;,
    ),
    Song(
      title: &apos;もしも&apos;,
      artist: &apos;ナナツカゼ&apos;,
      imageName: &apos;IMG_6400.jpg&apos;,
      audioName: &apos;What If.mp3&apos;,
    ),
    Song(
      title: &apos;サンダーソニア&apos;,
      artist: &apos;小花依ある&apos;,
      imageName: &apos;IMG_6412.jpg&apos;,
      audioName: &apos;サンダーソニア.mp3&apos;,
    ),
    Song(
      title: &apos;I Am I Can&apos;,
      artist: &apos;Nine Chen&apos;,
      imageName: &apos;IMG_6413.jpg&apos;,
      audioName: &apos;I am I can.mp3&apos;,
    ),
  ];
  LoopMode prevLoopMode = LoopMode.off;
  double _volumeValue = 0;
  Duration _currentPosition = Duration.zero;
  bool changingPosition = false;

  _MyHomePageState() {
    _audioPlayer.setVolume(1.0);
    _audioPlayer.setLoopMode(LoopMode.off);
    _audioPlayer.setShuffleModeEnabled(false);
    _audioPlayer.setAudioSources(
      songs.map((song) {
        return AudioSource.uri(
          Uri.parse(
            &apos;https://homeworkfileserver.onrender.com/music/${song.audioName}&apos;,
          ),
          tag: MediaItem(
            id: song.audioName,
            title: song.title,
            artist: song.artist,
            artUri: Uri.parse(
              &apos;https://homeworkfileserver.onrender.com/image/${song.imageName}&apos;,
            ),
          ),
        );
      }).toList(),
      initialIndex: 0,
      initialPosition: Duration.zero,
      preload: true,
    );
    _audioPlayer.sequenceStateStream.listen((state) {
      if (state.currentIndex != null) {
        setState(() {});
      }
    });
    _audioPlayer.playerStateStream.listen((state) async {
      if (state.processingState == ProcessingState.completed) {
        if (!_audioPlayer.hasNext &amp;amp;&amp;amp;
            _audioPlayer.loopMode == LoopMode.off &amp;amp;&amp;amp;
            _audioPlayer.shuffleModeEnabled == false) {
          await _audioPlayer.seek(Duration.zero, index: 0);
          await _audioPlayer.stop();
        }
      }
      setState(() {});
    });
    _volumeController = VolumeController.instance;

    _subscription = _volumeController.addListener((volume) {
      setState(() =&amp;gt; _volumeValue = volume);
    }, fetchInitialVolume: true);
  }

  Stream&amp;lt;DurationState&amp;gt; get _durationStateStream =&amp;gt;
      Rx.combineLatest2&amp;lt;Duration, Duration?, DurationState&amp;gt;(
        _audioPlayer.positionStream,
        _audioPlayer.durationStream,
        (position, duration) =&amp;gt;
            DurationState(position: position, total: duration ?? Duration.zero),
      );

  @override
  void dispose() {
    _audioPlayer.dispose();
    super.dispose();
  }

  void _playPauseAudio() async {
    if (_audioPlayer.playing) {
      await _audioPlayer.pause();
    } else {
      await _audioPlayer.play();
    }
  }

  void _setVolume(double volume) async {
    await _volumeController.setVolume(volume);
    setState(() {});
  }

  @override
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        backgroundColor: Colors.black,
        title: Text(widget.title, style: const TextStyle(color: Colors.white)),
      ),
      body: Column(
        mainAxisAlignment: MainAxisAlignment.center,
        children: [
          const Padding(
            padding: EdgeInsets.all(16.0),
            child: Text(
              &apos;Now Playing&apos;,
              style: TextStyle(
                fontSize: 28,
                fontWeight: FontWeight.bold,
                color: Colors.white,
              ),
            ),
          ),
          Padding(
            padding: EdgeInsets.symmetric(horizontal: 16.0),
            child: Text(
              &apos;${songs[_audioPlayer.currentIndex ?? 0].artist} - ${songs[_audioPlayer.currentIndex ?? 0].title}&apos;,
              style: TextStyle(fontSize: 20, color: Colors.white70),
              textAlign: TextAlign.center,
            ),
          ),
          const SizedBox(height: 20),
          SizedBox(
            width: 300,
            height: 300,
            child: ClipRRect(
              borderRadius: BorderRadius.circular(16.0),
              child: Image.network(
                &quot;https://homeworkfileserver.onrender.com/image/${songs[_audioPlayer.currentIndex ?? 0].imageName}&quot;,
                fit: BoxFit.cover,
              ),
            ),
          ),
          const SizedBox(height: 30),
          StreamBuilder&amp;lt;DurationState&amp;gt;(
            stream: _durationStateStream,
            builder: (context, snapshot) {
              final durationState = snapshot.data;
              final position = durationState?.position ?? Duration.zero;
              final total = durationState?.total ?? Duration.zero;

              return Column(
                children: [
                  SizedBox(
                    width: 400,
                    child: Slider(
                      value:
                          changingPosition
                              ? _currentPosition.inSeconds.toDouble()
                              : min(
                                total.inSeconds.toDouble(),
                                position.inSeconds.toDouble(),
                              ),
                      max: total.inSeconds.toDouble(),
                      onChangeStart: (value) {
                        changingPosition = true;
                        _currentPosition = position;
                      },
                      onChanged: (value) {
                        _currentPosition = Duration(seconds: value.toInt());
                      },
                      onChangeEnd: (value) async {
                        await _audioPlayer.seek(
                          Duration(seconds: value.toInt()),
                        );
                        changingPosition = false;
                      },
                      activeColor: Colors.white,
                      inactiveColor: Colors.white54,
                    ),
                  ),
                  SizedBox(
                    width: 400,
                    child: Padding(
                      padding: const EdgeInsets.symmetric(horizontal: 16.0),
                      child: Row(
                        mainAxisAlignment: MainAxisAlignment.spaceBetween,
                        children: [
                          Text(
                            _formatDuration(
                              changingPosition ? _currentPosition : position,
                            ),
                            style: const TextStyle(color: Colors.white),
                          ),
                          Text(
                            _formatDuration(total),
                            style: const TextStyle(color: Colors.white),
                          ),
                        ],
                      ),
                    ),
                  ),
                ],
              );
            },
          ),
          const SizedBox(height: 30),
          Row(
            mainAxisAlignment: MainAxisAlignment.spaceEvenly,
            children: [
              IconButton(
                icon: const Icon(Icons.skip_previous, color: Colors.white),
                iconSize: 48,
                onPressed: () async {
                  if (_audioPlayer.hasPrevious) {
                    await _audioPlayer.seekToPrevious();
                  } else {
                    await _audioPlayer.seek(
                      Duration.zero,
                      index: songs.length - 1,
                    );
                  }
                },
              ),
              IconButton(
                icon: Icon(
                  _audioPlayer.playing
                      ? Icons.pause_circle_filled
                      : Icons.play_circle_filled,
                  color: Colors.white,
                ),
                iconSize: 64,
                onPressed: _playPauseAudio,
              ),
              IconButton(
                icon: const Icon(Icons.skip_next, color: Colors.white),
                iconSize: 48,
                onPressed: () async {
                  if (_audioPlayer.hasNext) {
                    await _audioPlayer.seekToNext();
                  } else {
                    await _audioPlayer.seek(Duration.zero, index: 0);
                  }
                },
              ),
            ],
          ),
          const SizedBox(height: 20),
          SizedBox(
            width: 400,
            child: Row(
              mainAxisAlignment: MainAxisAlignment.spaceAround,
              children: [
                const Icon(Icons.volume_up, color: Colors.white),
                SizedBox(
                  width: 350,
                  child: Slider(
                    value: _volumeValue,
                    min: 0.0,
                    max: 1.0,
                    onChanged: _setVolume,
                    activeColor: Colors.white,
                    inactiveColor: Colors.white54,
                  ),
                ),
              ],
            ),
          ),
          const SizedBox(height: 20),
          Padding(
            padding: EdgeInsets.only(bottom: 20),
            child: Row(
              mainAxisAlignment: MainAxisAlignment.spaceAround,
              children: [
                IconButton(
                  onPressed: () async {
                    await _audioPlayer.seek(
                      null,
                      index: Random().nextInt(songs.length),
                    );
                  },
                  icon: Icon(Icons.casino),
                  color: Colors.white,
                  iconSize: 30,
                ),
                IconButton(
                  onPressed: () async {
                    await _audioPlayer.setShuffleModeEnabled(
                      !_audioPlayer.shuffleModeEnabled,
                    );
                    if (_audioPlayer.shuffleModeEnabled) {
                      prevLoopMode = _audioPlayer.loopMode;
                      await _audioPlayer.setLoopMode(LoopMode.all);
                    } else {
                      await _audioPlayer.setLoopMode(prevLoopMode);
                    }
                    setState(() {});
                  },
                  icon: Icon(
                    _audioPlayer.shuffleModeEnabled
                        ? Icons.shuffle
                        : Icons.double_arrow,
                  ),
                  color: Colors.white,
                  iconSize: 30,
                ),
                IconButton(
                  onPressed:
                      _audioPlayer.shuffleModeEnabled
                          ? null
                          : (() async {
                            int loopMode =
                                loopModeToIndex[_audioPlayer.loopMode]!;
                            loopMode = (loopMode + 1) % 3;
                            await _audioPlayer.setLoopMode(
                              indexToLoopMode[loopMode]!,
                            );
                            setState(() {});
                          }),
                  icon: icons[loopModeToIndex[_audioPlayer.loopMode]!],
                  color: colors[loopModeToIndex[_audioPlayer.loopMode]!],
                  iconSize: 30,
                ),
              ],
            ),
          ),
        ],
      ),
    );
  }

  String _formatDuration(Duration duration) {
    final minutes = duration.inMinutes.remainder(60).toString().padLeft(2, &apos;0&apos;);
    final seconds = duration.inSeconds.remainder(60).toString().padLeft(2, &apos;0&apos;);
    return &apos;$minutes:$seconds&apos;;
  }
}

class DurationState {
  final Duration position;
  final Duration total;

  DurationState({required this.position, required this.total});
}
&lt;/code&gt;&lt;/pre&gt;
&lt;h3&gt;Base Widget and States&lt;/h3&gt;
&lt;p&gt;整個基底 widget、常值、狀態和一些運作中會需要的東西。例如用來播放音樂的 &lt;code&gt;_audioPlayer&lt;/code&gt;，還有跟系統音量控制有關的 &lt;code&gt;_volumeController&lt;/code&gt; 和 &lt;code&gt;_subscription&lt;/code&gt;。&lt;/p&gt;
&lt;pre&gt;&lt;code&gt;import &apos;dart:async&apos;;
import &apos;dart:collection&apos;;
import &apos;dart:math&apos;;

import &apos;package:flutter/material.dart&apos;;
import &apos;package:just_audio/just_audio.dart&apos;;
import &apos;package:just_audio_background/just_audio_background.dart&apos;;
import &apos;package:musicplayer/song.dart&apos;;
import &apos;package:rxdart/rxdart.dart&apos;;
import &apos;package:volume_controller/volume_controller.dart&apos;;

Future&amp;lt;void&amp;gt; main() async {
  VolumeController.instance.showSystemUI = false;
  await JustAudioBackground.init();
  runApp(const MyApp());
}

class MyApp extends StatelessWidget {
  const MyApp({super.key});

  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      title: &apos;Music App&apos;,
      theme: ThemeData(
        colorScheme: ColorScheme.fromSeed(seedColor: Colors.blue),
        scaffoldBackgroundColor: Colors.black,
        textTheme: const TextTheme(
          bodyMedium: TextStyle(color: Colors.white),
          headlineMedium: TextStyle(color: Colors.white),
        ),
      ),
      debugShowCheckedModeBanner: false,
      home: const MyHomePage(title: &apos;Music App&apos;),
    );
  }
}

class MyHomePage extends StatefulWidget {
  const MyHomePage({super.key, required this.title});

  final String title;

  @override
  State&amp;lt;MyHomePage&amp;gt; createState() =&amp;gt; _MyHomePageState();
}

class _MyHomePageState extends State&amp;lt;MyHomePage&amp;gt; {
  final AudioPlayer _audioPlayer = AudioPlayer();
  late final VolumeController _volumeController;
  late final StreamSubscription&amp;lt;double&amp;gt; _subscription;
  final HashMap&amp;lt;LoopMode, int&amp;gt; loopModeToIndex = HashMap.of({
    LoopMode.off: 0,
    LoopMode.all: 1,
    LoopMode.one: 2,
  });
  final HashMap&amp;lt;int, LoopMode&amp;gt; indexToLoopMode = HashMap.of({
    0: LoopMode.off,
    1: LoopMode.all,
    2: LoopMode.one,
  });
  List&amp;lt;Color&amp;gt; colors = [Colors.grey.shade700, Colors.white, Colors.white];
  List&amp;lt;Icon&amp;gt; icons = [
    const Icon(Icons.repeat),
    const Icon(Icons.repeat),
    const Icon(Icons.repeat_one),
  ];
  List&amp;lt;Song&amp;gt; songs = [
    Song(
      title: &apos;Numb&apos;,
      artist: &apos;Will Pan&apos;,
      imageName: &apos;IMG_6398.jpg&apos;,
      audioName: &apos;Numb.mp3&apos;,
    ),
    Song(
      title: &apos;Colorful&apos;,
      artist: &apos;Hiiragi Magnetite&apos;,
      imageName: &apos;IMG_6399.jpg&apos;,
      audioName: &apos;カラフル.mp3&apos;,
    ),
    Song(
      title: &apos;もしも&apos;,
      artist: &apos;ナナツカゼ&apos;,
      imageName: &apos;IMG_6400.jpg&apos;,
      audioName: &apos;What If.mp3&apos;,
    ),
    Song(
      title: &apos;サンダーソニア&apos;,
      artist: &apos;小花依ある&apos;,
      imageName: &apos;IMG_6412.jpg&apos;,
      audioName: &apos;サンダーソニア.mp3&apos;,
    ),
    Song(
      title: &apos;I Am I Can&apos;,
      artist: &apos;Nine Chen&apos;,
      imageName: &apos;IMG_6413.jpg&apos;,
      audioName: &apos;I am I can.mp3&apos;,
    ),
  ];
  LoopMode prevLoopMode = LoopMode.off;
  double _volumeValue = 0;
  Duration _currentPosition = Duration.zero;
  bool changingPosition = false;

  _MyHomePageState() {
    _audioPlayer.setVolume(1.0);
    _audioPlayer.setLoopMode(LoopMode.off);
    _audioPlayer.setShuffleModeEnabled(false);
    _audioPlayer.setAudioSources(
      songs.map((song) {
        return AudioSource.uri(
          Uri.parse(
            &apos;https://homeworkfileserver.onrender.com/music/${song.audioName}&apos;,
          ),
          tag: MediaItem(
            id: song.audioName,
            title: song.title,
            artist: song.artist,
            artUri: Uri.parse(
              &apos;https://homeworkfileserver.onrender.com/image/${song.imageName}&apos;,
            ),
          ),
        );
      }).toList(),
      initialIndex: 0,
      initialPosition: Duration.zero,
      preload: true,
    );
    _audioPlayer.sequenceStateStream.listen((state) {
      if (state.currentIndex != null) {
        setState(() {});
      }
    });
    _audioPlayer.playerStateStream.listen((state) async {
      if (state.processingState == ProcessingState.completed) {
        if (!_audioPlayer.hasNext &amp;amp;&amp;amp;
            _audioPlayer.loopMode == LoopMode.off &amp;amp;&amp;amp;
            _audioPlayer.shuffleModeEnabled == false) {
          await _audioPlayer.seek(Duration.zero, index: 0);
          await _audioPlayer.stop();
        }
      }
      setState(() {});
    });
    _volumeController = VolumeController.instance;

    _subscription = _volumeController.addListener((volume) {
      setState(() =&amp;gt; _volumeValue = volume);
    }, fetchInitialVolume: true);
  }

  Stream&amp;lt;DurationState&amp;gt; get _durationStateStream =&amp;gt;
      Rx.combineLatest2&amp;lt;Duration, Duration?, DurationState&amp;gt;(
        _audioPlayer.positionStream,
        _audioPlayer.durationStream,
        (position, duration) =&amp;gt;
            DurationState(position: position, total: duration ?? Duration.zero),
      );

  @override
  void dispose() {
    _audioPlayer.dispose();
    super.dispose();
  }

  void _playPauseAudio() async {
    if (_audioPlayer.playing) {
      await _audioPlayer.pause();
    } else {
      await _audioPlayer.play();
    }
  }

  void _setVolume(double volume) async {
    await _volumeController.setVolume(volume);
    setState(() {});
  }

  @override
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        backgroundColor: Colors.black,
        title: Text(widget.title, style: const TextStyle(color: Colors.white)),
      ),
      body: Column(
        mainAxisAlignment: MainAxisAlignment.center,
        children: [
          const Padding(
            padding: EdgeInsets.all(16.0),
            child: Text(
              &apos;Now Playing&apos;,
              style: TextStyle(
                fontSize: 28,
                fontWeight: FontWeight.bold,
                color: Colors.white,
              ),
            ),
          ),
          Padding(
            padding: EdgeInsets.symmetric(horizontal: 16.0),
            child: Text(
              &apos;${songs[_audioPlayer.currentIndex ?? 0].artist} - ${songs[_audioPlayer.currentIndex ?? 0].title}&apos;,
              style: TextStyle(fontSize: 20, color: Colors.white70),
              textAlign: TextAlign.center,
            ),
          ),
          const SizedBox(height: 20),
          SizedBox(
            width: 300,
            height: 300,
            child: ClipRRect(
              borderRadius: BorderRadius.circular(16.0),
              child: Image.network(
                &quot;https://homeworkfileserver.onrender.com/image/${songs[_audioPlayer.currentIndex ?? 0].imageName}&quot;,
                fit: BoxFit.cover,
              ),
            ),
          ),
          const SizedBox(height: 30),
          StreamBuilder&amp;lt;DurationState&amp;gt;(
            stream: _durationStateStream,
            builder: (context, snapshot) {
              final durationState = snapshot.data;
              final position = durationState?.position ?? Duration.zero;
              final total = durationState?.total ?? Duration.zero;

              return Column(
                children: [
                  SizedBox(
                    width: 400,
                    child: Slider(
                      value:
                          changingPosition
                              ? _currentPosition.inSeconds.toDouble()
                              : min(
                                total.inSeconds.toDouble(),
                                position.inSeconds.toDouble(),
                              ),
                      max: total.inSeconds.toDouble(),
                      onChangeStart: (value) {
                        changingPosition = true;
                        _currentPosition = position;
                      },
                      onChanged: (value) {
                        _currentPosition = Duration(seconds: value.toInt());
                      },
                      onChangeEnd: (value) async {
                        await _audioPlayer.seek(
                          Duration(seconds: value.toInt()),
                        );
                        changingPosition = false;
                      },
                      activeColor: Colors.white,
                      inactiveColor: Colors.white54,
                    ),
                  ),
                  SizedBox(
                    width: 400,
                    child: Padding(
                      padding: const EdgeInsets.symmetric(horizontal: 16.0),
                      child: Row(
                        mainAxisAlignment: MainAxisAlignment.spaceBetween,
                        children: [
                          Text(
                            _formatDuration(
                              changingPosition ? _currentPosition : position,
                            ),
                            style: const TextStyle(color: Colors.white),
                          ),
                          Text(
                            _formatDuration(total),
                            style: const TextStyle(color: Colors.white),
                          ),
                        ],
                      ),
                    ),
                  ),
                ],
              );
            },
          ),
          const SizedBox(height: 30),
          Row(
            mainAxisAlignment: MainAxisAlignment.spaceEvenly,
            children: [
              IconButton(
                icon: const Icon(Icons.skip_previous, color: Colors.white),
                iconSize: 48,
                onPressed: () async {
                  if (_audioPlayer.hasPrevious) {
                    await _audioPlayer.seekToPrevious();
                  } else {
                    await _audioPlayer.seek(
                      Duration.zero,
                      index: songs.length - 1,
                    );
                  }
                },
              ),
              IconButton(
                icon: Icon(
                  _audioPlayer.playing
                      ? Icons.pause_circle_filled
                      : Icons.play_circle_filled,
                  color: Colors.white,
                ),
                iconSize: 64,
                onPressed: _playPauseAudio,
              ),
              IconButton(
                icon: const Icon(Icons.skip_next, color: Colors.white),
                iconSize: 48,
                onPressed: () async {
                  if (_audioPlayer.hasNext) {
                    await _audioPlayer.seekToNext();
                  } else {
                    await _audioPlayer.seek(Duration.zero, index: 0);
                  }
                },
              ),
            ],
          ),
          const SizedBox(height: 20),
          SizedBox(
            width: 400,
            child: Row(
              mainAxisAlignment: MainAxisAlignment.spaceAround,
              children: [
                const Icon(Icons.volume_up, color: Colors.white),
                SizedBox(
                  width: 350,
                  child: Slider(
                    value: _volumeValue,
                    min: 0.0,
                    max: 1.0,
                    onChanged: _setVolume,
                    activeColor: Colors.white,
                    inactiveColor: Colors.white54,
                  ),
                ),
              ],
            ),
          ),
          const SizedBox(height: 20),
          Padding(
            padding: EdgeInsets.only(bottom: 20),
            child: Row(
              mainAxisAlignment: MainAxisAlignment.spaceAround,
              children: [
                IconButton(
                  onPressed: () async {
                    await _audioPlayer.seek(
                      null,
                      index: Random().nextInt(songs.length),
                    );
                  },
                  icon: Icon(Icons.casino),
                  color: Colors.white,
                  iconSize: 30,
                ),
                IconButton(
                  onPressed: () async {
                    await _audioPlayer.setShuffleModeEnabled(
                      !_audioPlayer.shuffleModeEnabled,
                    );
                    if (_audioPlayer.shuffleModeEnabled) {
                      prevLoopMode = _audioPlayer.loopMode;
                      await _audioPlayer.setLoopMode(LoopMode.all);
                    } else {
                      await _audioPlayer.setLoopMode(prevLoopMode);
                    }
                    setState(() {});
                  },
                  icon: Icon(
                    _audioPlayer.shuffleModeEnabled
                        ? Icons.shuffle
                        : Icons.double_arrow,
                  ),
                  color: Colors.white,
                  iconSize: 30,
                ),
                IconButton(
                  onPressed:
                      _audioPlayer.shuffleModeEnabled
                          ? null
                          : (() async {
                            int loopMode =
                                loopModeToIndex[_audioPlayer.loopMode]!;
                            loopMode = (loopMode + 1) % 3;
                            await _audioPlayer.setLoopMode(
                              indexToLoopMode[loopMode]!,
                            );
                            setState(() {});
                          }),
                  icon: icons[loopModeToIndex[_audioPlayer.loopMode]!],
                  color: colors[loopModeToIndex[_audioPlayer.loopMode]!],
                  iconSize: 30,
                ),
              ],
            ),
          ),
        ],
      ),
    );
  }

  String _formatDuration(Duration duration) {
    final minutes = duration.inMinutes.remainder(60).toString().padLeft(2, &apos;0&apos;);
    final seconds = duration.inSeconds.remainder(60).toString().padLeft(2, &apos;0&apos;);
    return &apos;$minutes:$seconds&apos;;
  }
}

class DurationState {
  final Duration position;
  final Duration total;

  DurationState({required this.position, required this.total});
}
&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;:::note[Explanation]&lt;/p&gt;
&lt;ol&gt;
&lt;li&gt;因為 Dart 中的窮舉不像 TypeScript 中擁有直接雙向映射，enchanced enum 個人感覺還是有點麻煩，所以直接使用雙 &lt;code&gt;HashMap&lt;/code&gt; 進行處理會比較快。&lt;/li&gt;
&lt;li&gt;用以切換循環模式按鈕樣式&lt;/li&gt;
&lt;li&gt;儲存目前是否在切換歌曲播放秒數和要切換到歌曲秒數
:::&lt;/li&gt;
&lt;/ol&gt;
&lt;h3&gt;Methods&lt;/h3&gt;
&lt;pre&gt;&lt;code&gt;import &apos;dart:async&apos;;
import &apos;dart:collection&apos;;
import &apos;dart:math&apos;;

import &apos;package:flutter/material.dart&apos;;
import &apos;package:just_audio/just_audio.dart&apos;;
import &apos;package:just_audio_background/just_audio_background.dart&apos;;
import &apos;package:musicplayer/song.dart&apos;;
import &apos;package:rxdart/rxdart.dart&apos;;
import &apos;package:volume_controller/volume_controller.dart&apos;;

Future&amp;lt;void&amp;gt; main() async {
  VolumeController.instance.showSystemUI = false;
  await JustAudioBackground.init();
  runApp(const MyApp());
}

class MyApp extends StatelessWidget {
  const MyApp({super.key});

  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      title: &apos;Music App&apos;,
      theme: ThemeData(
        colorScheme: ColorScheme.fromSeed(seedColor: Colors.blue),
        scaffoldBackgroundColor: Colors.black,
        textTheme: const TextTheme(
          bodyMedium: TextStyle(color: Colors.white),
          headlineMedium: TextStyle(color: Colors.white),
        ),
      ),
      debugShowCheckedModeBanner: false,
      home: const MyHomePage(title: &apos;Music App&apos;),
    );
  }
}

class MyHomePage extends StatefulWidget {
  const MyHomePage({super.key, required this.title});

  final String title;

  @override
  State&amp;lt;MyHomePage&amp;gt; createState() =&amp;gt; _MyHomePageState();
}

class _MyHomePageState extends State&amp;lt;MyHomePage&amp;gt; {
  final AudioPlayer _audioPlayer = AudioPlayer();
  late final VolumeController _volumeController;
  late final StreamSubscription&amp;lt;double&amp;gt; _subscription;
  final HashMap&amp;lt;LoopMode, int&amp;gt; loopModeToIndex = HashMap.of({
    LoopMode.off: 0,
    LoopMode.all: 1,
    LoopMode.one: 2,
  });
  final HashMap&amp;lt;int, LoopMode&amp;gt; indexToLoopMode = HashMap.of({
    0: LoopMode.off,
    1: LoopMode.all,
    2: LoopMode.one,
  });
  List&amp;lt;Color&amp;gt; colors = [Colors.grey.shade700, Colors.white, Colors.white];
  List&amp;lt;Icon&amp;gt; icons = [
    const Icon(Icons.repeat),
    const Icon(Icons.repeat),
    const Icon(Icons.repeat_one),
  ];
  List&amp;lt;Song&amp;gt; songs = [
    Song(
      title: &apos;Numb&apos;,
      artist: &apos;Will Pan&apos;,
      imageName: &apos;IMG_6398.jpg&apos;,
      audioName: &apos;Numb.mp3&apos;,
    ),
    Song(
      title: &apos;Colorful&apos;,
      artist: &apos;Hiiragi Magnetite&apos;,
      imageName: &apos;IMG_6399.jpg&apos;,
      audioName: &apos;カラフル.mp3&apos;,
    ),
    Song(
      title: &apos;もしも&apos;,
      artist: &apos;ナナツカゼ&apos;,
      imageName: &apos;IMG_6400.jpg&apos;,
      audioName: &apos;What If.mp3&apos;,
    ),
    Song(
      title: &apos;サンダーソニア&apos;,
      artist: &apos;小花依ある&apos;,
      imageName: &apos;IMG_6412.jpg&apos;,
      audioName: &apos;サンダーソニア.mp3&apos;,
    ),
    Song(
      title: &apos;I Am I Can&apos;,
      artist: &apos;Nine Chen&apos;,
      imageName: &apos;IMG_6413.jpg&apos;,
      audioName: &apos;I am I can.mp3&apos;,
    ),
  ];
  LoopMode prevLoopMode = LoopMode.off;
  double _volumeValue = 0;
  Duration _currentPosition = Duration.zero;
  bool changingPosition = false;

  _MyHomePageState() {
    _audioPlayer.setVolume(1.0);
    _audioPlayer.setLoopMode(LoopMode.off);
    _audioPlayer.setShuffleModeEnabled(false);
    _audioPlayer.setAudioSources(
      songs.map((song) {
        return AudioSource.uri(
          Uri.parse(
            &apos;https://homeworkfileserver.onrender.com/music/${song.audioName}&apos;,
          ),
          tag: MediaItem(
            id: song.audioName,
            title: song.title,
            artist: song.artist,
            artUri: Uri.parse(
              &apos;https://homeworkfileserver.onrender.com/image/${song.imageName}&apos;,
            ),
          ),
        );
      }).toList(),
      initialIndex: 0,
      initialPosition: Duration.zero,
      preload: true,
    );
    _audioPlayer.sequenceStateStream.listen((state) {
      if (state.currentIndex != null) {
        setState(() {});
      }
    });
    _audioPlayer.playerStateStream.listen((state) async {
      if (state.processingState == ProcessingState.completed) {
        if (!_audioPlayer.hasNext &amp;amp;&amp;amp;
            _audioPlayer.loopMode == LoopMode.off &amp;amp;&amp;amp;
            _audioPlayer.shuffleModeEnabled == false) {
          await _audioPlayer.seek(Duration.zero, index: 0);
          await _audioPlayer.stop();
        }
      }
      setState(() {});
    });
    _volumeController = VolumeController.instance;

    _subscription = _volumeController.addListener((volume) {
      setState(() =&amp;gt; _volumeValue = volume);
    }, fetchInitialVolume: true);
  }

  Stream&amp;lt;DurationState&amp;gt; get _durationStateStream =&amp;gt;
      Rx.combineLatest2&amp;lt;Duration, Duration?, DurationState&amp;gt;(
        _audioPlayer.positionStream,
        _audioPlayer.durationStream,
        (position, duration) =&amp;gt;
            DurationState(position: position, total: duration ?? Duration.zero),
      );

  @override
  void dispose() {
    _audioPlayer.dispose();
    super.dispose();
  }

  void _playPauseAudio() async {
    if (_audioPlayer.playing) {
      await _audioPlayer.pause();
    } else {
      await _audioPlayer.play();
    }
  }

  void _setVolume(double volume) async {
    await _volumeController.setVolume(volume);
    setState(() {});
  }

  @override
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        backgroundColor: Colors.black,
        title: Text(widget.title, style: const TextStyle(color: Colors.white)),
      ),
      body: Column(
        mainAxisAlignment: MainAxisAlignment.center,
        children: [
          const Padding(
            padding: EdgeInsets.all(16.0),
            child: Text(
              &apos;Now Playing&apos;,
              style: TextStyle(
                fontSize: 28,
                fontWeight: FontWeight.bold,
                color: Colors.white,
              ),
            ),
          ),
          Padding(
            padding: EdgeInsets.symmetric(horizontal: 16.0),
            child: Text(
              &apos;${songs[_audioPlayer.currentIndex ?? 0].artist} - ${songs[_audioPlayer.currentIndex ?? 0].title}&apos;,
              style: TextStyle(fontSize: 20, color: Colors.white70),
              textAlign: TextAlign.center,
            ),
          ),
          const SizedBox(height: 20),
          SizedBox(
            width: 300,
            height: 300,
            child: ClipRRect(
              borderRadius: BorderRadius.circular(16.0),
              child: Image.network(
                &quot;https://homeworkfileserver.onrender.com/image/${songs[_audioPlayer.currentIndex ?? 0].imageName}&quot;,
                fit: BoxFit.cover,
              ),
            ),
          ),
          const SizedBox(height: 30),
          StreamBuilder&amp;lt;DurationState&amp;gt;(
            stream: _durationStateStream,
            builder: (context, snapshot) {
              final durationState = snapshot.data;
              final position = durationState?.position ?? Duration.zero;
              final total = durationState?.total ?? Duration.zero;

              return Column(
                children: [
                  SizedBox(
                    width: 400,
                    child: Slider(
                      value:
                          changingPosition
                              ? _currentPosition.inSeconds.toDouble()
                              : min(
                                total.inSeconds.toDouble(),
                                position.inSeconds.toDouble(),
                              ),
                      max: total.inSeconds.toDouble(),
                      onChangeStart: (value) {
                        changingPosition = true;
                        _currentPosition = position;
                      },
                      onChanged: (value) {
                        _currentPosition = Duration(seconds: value.toInt());
                      },
                      onChangeEnd: (value) async {
                        await _audioPlayer.seek(
                          Duration(seconds: value.toInt()),
                        );
                        changingPosition = false;
                      },
                      activeColor: Colors.white,
                      inactiveColor: Colors.white54,
                    ),
                  ),
                  SizedBox(
                    width: 400,
                    child: Padding(
                      padding: const EdgeInsets.symmetric(horizontal: 16.0),
                      child: Row(
                        mainAxisAlignment: MainAxisAlignment.spaceBetween,
                        children: [
                          Text(
                            _formatDuration(
                              changingPosition ? _currentPosition : position,
                            ),
                            style: const TextStyle(color: Colors.white),
                          ),
                          Text(
                            _formatDuration(total),
                            style: const TextStyle(color: Colors.white),
                          ),
                        ],
                      ),
                    ),
                  ),
                ],
              );
            },
          ),
          const SizedBox(height: 30),
          Row(
            mainAxisAlignment: MainAxisAlignment.spaceEvenly,
            children: [
              IconButton(
                icon: const Icon(Icons.skip_previous, color: Colors.white),
                iconSize: 48,
                onPressed: () async {
                  if (_audioPlayer.hasPrevious) {
                    await _audioPlayer.seekToPrevious();
                  } else {
                    await _audioPlayer.seek(
                      Duration.zero,
                      index: songs.length - 1,
                    );
                  }
                },
              ),
              IconButton(
                icon: Icon(
                  _audioPlayer.playing
                      ? Icons.pause_circle_filled
                      : Icons.play_circle_filled,
                  color: Colors.white,
                ),
                iconSize: 64,
                onPressed: _playPauseAudio,
              ),
              IconButton(
                icon: const Icon(Icons.skip_next, color: Colors.white),
                iconSize: 48,
                onPressed: () async {
                  if (_audioPlayer.hasNext) {
                    await _audioPlayer.seekToNext();
                  } else {
                    await _audioPlayer.seek(Duration.zero, index: 0);
                  }
                },
              ),
            ],
          ),
          const SizedBox(height: 20),
          SizedBox(
            width: 400,
            child: Row(
              mainAxisAlignment: MainAxisAlignment.spaceAround,
              children: [
                const Icon(Icons.volume_up, color: Colors.white),
                SizedBox(
                  width: 350,
                  child: Slider(
                    value: _volumeValue,
                    min: 0.0,
                    max: 1.0,
                    onChanged: _setVolume,
                    activeColor: Colors.white,
                    inactiveColor: Colors.white54,
                  ),
                ),
              ],
            ),
          ),
          const SizedBox(height: 20),
          Padding(
            padding: EdgeInsets.only(bottom: 20),
            child: Row(
              mainAxisAlignment: MainAxisAlignment.spaceAround,
              children: [
                IconButton(
                  onPressed: () async {
                    await _audioPlayer.seek(
                      null,
                      index: Random().nextInt(songs.length),
                    );
                  },
                  icon: Icon(Icons.casino),
                  color: Colors.white,
                  iconSize: 30,
                ),
                IconButton(
                  onPressed: () async {
                    await _audioPlayer.setShuffleModeEnabled(
                      !_audioPlayer.shuffleModeEnabled,
                    );
                    if (_audioPlayer.shuffleModeEnabled) {
                      prevLoopMode = _audioPlayer.loopMode;
                      await _audioPlayer.setLoopMode(LoopMode.all);
                    } else {
                      await _audioPlayer.setLoopMode(prevLoopMode);
                    }
                    setState(() {});
                  },
                  icon: Icon(
                    _audioPlayer.shuffleModeEnabled
                        ? Icons.shuffle
                        : Icons.double_arrow,
                  ),
                  color: Colors.white,
                  iconSize: 30,
                ),
                IconButton(
                  onPressed:
                      _audioPlayer.shuffleModeEnabled
                          ? null
                          : (() async {
                            int loopMode =
                                loopModeToIndex[_audioPlayer.loopMode]!;
                            loopMode = (loopMode + 1) % 3;
                            await _audioPlayer.setLoopMode(
                              indexToLoopMode[loopMode]!,
                            );
                            setState(() {});
                          }),
                  icon: icons[loopModeToIndex[_audioPlayer.loopMode]!],
                  color: colors[loopModeToIndex[_audioPlayer.loopMode]!],
                  iconSize: 30,
                ),
              ],
            ),
          ),
        ],
      ),
    );
  }

  String _formatDuration(Duration duration) {
    final minutes = duration.inMinutes.remainder(60).toString().padLeft(2, &apos;0&apos;);
    final seconds = duration.inSeconds.remainder(60).toString().padLeft(2, &apos;0&apos;);
    return &apos;$minutes:$seconds&apos;;
  }
}

class DurationState {
  final Duration position;
  final Duration total;

  DurationState({required this.position, required this.total});
}
&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;:::note[Explanation]&lt;/p&gt;
&lt;ol&gt;
&lt;li&gt;初始化音樂播放器，並設定初始狀態與歌單。&lt;/li&gt;
&lt;li&gt;抓取系統的音量控制器，並監聽音量變化。&lt;/li&gt;
&lt;li&gt;將目前位置與總長度的 stream 合併成一個 stream，並且在兩個 stream 內皆有資料時才會進行輸出，此部分為 ReactiveX 相關語法，若此寫法會感覺抽象的話，請參考 &lt;a href=&quot;https://reactivex.io/&quot;&gt;ReactiveX 官網&lt;/a&gt; 或者閱讀&lt;a href=&quot;https://ithelp.ithome.com.tw/users/20020617/ironman/2959&quot;&gt;「打通 RxJS 任督二脈」系列文章&lt;/a&gt;了解相關概念。&lt;/li&gt;
&lt;li&gt;取得分跟秒，&lt;code&gt;padLeft&lt;/code&gt; 方法用於檢查字串長度是否為指定長度，若沒有達到，則會在左側填入第二個參數的值直至達到指定長度。
:::&lt;/li&gt;
&lt;/ol&gt;
&lt;h3&gt;Widget&lt;/h3&gt;
&lt;pre&gt;&lt;code&gt;import &apos;dart:async&apos;;
import &apos;dart:collection&apos;;
import &apos;dart:math&apos;;

import &apos;package:flutter/material.dart&apos;;
import &apos;package:just_audio/just_audio.dart&apos;;
import &apos;package:just_audio_background/just_audio_background.dart&apos;;
import &apos;package:musicplayer/song.dart&apos;;
import &apos;package:rxdart/rxdart.dart&apos;;
import &apos;package:volume_controller/volume_controller.dart&apos;;

Future&amp;lt;void&amp;gt; main() async {
  VolumeController.instance.showSystemUI = false;
  await JustAudioBackground.init();
  runApp(const MyApp());
}

class MyApp extends StatelessWidget {
  const MyApp({super.key});

  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      title: &apos;Music App&apos;,
      theme: ThemeData(
        colorScheme: ColorScheme.fromSeed(seedColor: Colors.blue),
        scaffoldBackgroundColor: Colors.black,
        textTheme: const TextTheme(
          bodyMedium: TextStyle(color: Colors.white),
          headlineMedium: TextStyle(color: Colors.white),
        ),
      ),
      debugShowCheckedModeBanner: false,
      home: const MyHomePage(title: &apos;Music App&apos;),
    );
  }
}

class MyHomePage extends StatefulWidget {
  const MyHomePage({super.key, required this.title});

  final String title;

  @override
  State&amp;lt;MyHomePage&amp;gt; createState() =&amp;gt; _MyHomePageState();
}

class _MyHomePageState extends State&amp;lt;MyHomePage&amp;gt; {
  final AudioPlayer _audioPlayer = AudioPlayer();
  late final VolumeController _volumeController;
  late final StreamSubscription&amp;lt;double&amp;gt; _subscription;
  final HashMap&amp;lt;LoopMode, int&amp;gt; loopModeToIndex = HashMap.of({
    LoopMode.off: 0,
    LoopMode.all: 1,
    LoopMode.one: 2,
  });
  final HashMap&amp;lt;int, LoopMode&amp;gt; indexToLoopMode = HashMap.of({
    0: LoopMode.off,
    1: LoopMode.all,
    2: LoopMode.one,
  });
  List&amp;lt;Color&amp;gt; colors = [Colors.grey.shade700, Colors.white, Colors.white];
  List&amp;lt;Icon&amp;gt; icons = [
    const Icon(Icons.repeat),
    const Icon(Icons.repeat),
    const Icon(Icons.repeat_one),
  ];
  List&amp;lt;Song&amp;gt; songs = [
    Song(
      title: &apos;Numb&apos;,
      artist: &apos;Will Pan&apos;,
      imageName: &apos;IMG_6398.jpg&apos;,
      audioName: &apos;Numb.mp3&apos;,
    ),
    Song(
      title: &apos;Colorful&apos;,
      artist: &apos;Hiiragi Magnetite&apos;,
      imageName: &apos;IMG_6399.jpg&apos;,
      audioName: &apos;カラフル.mp3&apos;,
    ),
    Song(
      title: &apos;もしも&apos;,
      artist: &apos;ナナツカゼ&apos;,
      imageName: &apos;IMG_6400.jpg&apos;,
      audioName: &apos;What If.mp3&apos;,
    ),
    Song(
      title: &apos;サンダーソニア&apos;,
      artist: &apos;小花依ある&apos;,
      imageName: &apos;IMG_6412.jpg&apos;,
      audioName: &apos;サンダーソニア.mp3&apos;,
    ),
    Song(
      title: &apos;I Am I Can&apos;,
      artist: &apos;Nine Chen&apos;,
      imageName: &apos;IMG_6413.jpg&apos;,
      audioName: &apos;I am I can.mp3&apos;,
    ),
  ];
  LoopMode prevLoopMode = LoopMode.off;
  double _volumeValue = 0;
  Duration _currentPosition = Duration.zero;
  bool changingPosition = false;

  _MyHomePageState() {
    _audioPlayer.setVolume(1.0);
    _audioPlayer.setLoopMode(LoopMode.off);
    _audioPlayer.setShuffleModeEnabled(false);
    _audioPlayer.setAudioSources(
      songs.map((song) {
        return AudioSource.uri(
          Uri.parse(
            &apos;https://homeworkfileserver.onrender.com/music/${song.audioName}&apos;,
          ),
          tag: MediaItem(
            id: song.audioName,
            title: song.title,
            artist: song.artist,
            artUri: Uri.parse(
              &apos;https://homeworkfileserver.onrender.com/image/${song.imageName}&apos;,
            ),
          ),
        );
      }).toList(),
      initialIndex: 0,
      initialPosition: Duration.zero,
      preload: true,
    );
    _audioPlayer.sequenceStateStream.listen((state) {
      if (state.currentIndex != null) {
        setState(() {});
      }
    });
    _audioPlayer.playerStateStream.listen((state) async {
      if (state.processingState == ProcessingState.completed) {
        if (!_audioPlayer.hasNext &amp;amp;&amp;amp;
            _audioPlayer.loopMode == LoopMode.off &amp;amp;&amp;amp;
            _audioPlayer.shuffleModeEnabled == false) {
          await _audioPlayer.seek(Duration.zero, index: 0);
          await _audioPlayer.stop();
        }
      }
      setState(() {});
    });
    _volumeController = VolumeController.instance;

    _subscription = _volumeController.addListener((volume) {
      setState(() =&amp;gt; _volumeValue = volume);
    }, fetchInitialVolume: true);
  }

  Stream&amp;lt;DurationState&amp;gt; get _durationStateStream =&amp;gt;
      Rx.combineLatest2&amp;lt;Duration, Duration?, DurationState&amp;gt;(
        _audioPlayer.positionStream,
        _audioPlayer.durationStream,
        (position, duration) =&amp;gt;
            DurationState(position: position, total: duration ?? Duration.zero),
      );

  @override
  void dispose() {
    _audioPlayer.dispose();
    super.dispose();
  }

  void _playPauseAudio() async {
    if (_audioPlayer.playing) {
      await _audioPlayer.pause();
    } else {
      await _audioPlayer.play();
    }
  }

  void _setVolume(double volume) async {
    await _volumeController.setVolume(volume);
    setState(() {});
  }

  @override
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        backgroundColor: Colors.black,
        title: Text(widget.title, style: const TextStyle(color: Colors.white)),
      ),
      body: Column(
        mainAxisAlignment: MainAxisAlignment.center,
        children: [
          const Padding(
            padding: EdgeInsets.all(16.0),
            child: Text(
              &apos;Now Playing&apos;,
              style: TextStyle(
                fontSize: 28,
                fontWeight: FontWeight.bold,
                color: Colors.white,
              ),
            ),
          ),
          Padding(
            padding: EdgeInsets.symmetric(horizontal: 16.0),
            child: Text(
              &apos;${songs[_audioPlayer.currentIndex ?? 0].artist} - ${songs[_audioPlayer.currentIndex ?? 0].title}&apos;,
              style: TextStyle(fontSize: 20, color: Colors.white70),
              textAlign: TextAlign.center,
            ),
          ),
          const SizedBox(height: 20),
          SizedBox(
            width: 300,
            height: 300,
            child: ClipRRect(
              borderRadius: BorderRadius.circular(16.0),
              child: Image.network(
                &quot;https://homeworkfileserver.onrender.com/image/${songs[_audioPlayer.currentIndex ?? 0].imageName}&quot;,
                fit: BoxFit.cover,
              ),
            ),
          ),
          const SizedBox(height: 30),
          StreamBuilder&amp;lt;DurationState&amp;gt;(
            stream: _durationStateStream,
            builder: (context, snapshot) {
              final durationState = snapshot.data;
              final position = durationState?.position ?? Duration.zero;
              final total = durationState?.total ?? Duration.zero;

              return Column(
                children: [
                  SizedBox(
                    width: 400,
                    child: Slider(
                      value:
                          changingPosition
                              ? _currentPosition.inSeconds.toDouble()
                              : min(
                                total.inSeconds.toDouble(),
                                position.inSeconds.toDouble(),
                              ),
                      max: total.inSeconds.toDouble(),
                      onChangeStart: (value) {
                        changingPosition = true;
                        _currentPosition = position;
                      },
                      onChanged: (value) {
                        _currentPosition = Duration(seconds: value.toInt());
                      },
                      onChangeEnd: (value) async {
                        await _audioPlayer.seek(
                          Duration(seconds: value.toInt()),
                        );
                        changingPosition = false;
                      },
                      activeColor: Colors.white,
                      inactiveColor: Colors.white54,
                    ),
                  ),
                  SizedBox(
                    width: 400,
                    child: Padding(
                      padding: const EdgeInsets.symmetric(horizontal: 16.0),
                      child: Row(
                        mainAxisAlignment: MainAxisAlignment.spaceBetween,
                        children: [
                          Text(
                            _formatDuration(
                              changingPosition ? _currentPosition : position,
                            ),
                            style: const TextStyle(color: Colors.white),
                          ),
                          Text(
                            _formatDuration(total),
                            style: const TextStyle(color: Colors.white),
                          ),
                        ],
                      ),
                    ),
                  ),
                ],
              );
            },
          ),
          const SizedBox(height: 30),
          Row(
            mainAxisAlignment: MainAxisAlignment.spaceEvenly,
            children: [
              IconButton(
                icon: const Icon(Icons.skip_previous, color: Colors.white),
                iconSize: 48,
                onPressed: () async {
                  if (_audioPlayer.hasPrevious) {
                    await _audioPlayer.seekToPrevious();
                  } else {
                    await _audioPlayer.seek(
                      Duration.zero,
                      index: songs.length - 1,
                    );
                  }
                },
              ),
              IconButton(
                icon: Icon(
                  _audioPlayer.playing
                      ? Icons.pause_circle_filled
                      : Icons.play_circle_filled,
                  color: Colors.white,
                ),
                iconSize: 64,
                onPressed: _playPauseAudio,
              ),
              IconButton(
                icon: const Icon(Icons.skip_next, color: Colors.white),
                iconSize: 48,
                onPressed: () async {
                  if (_audioPlayer.hasNext) {
                    await _audioPlayer.seekToNext();
                  } else {
                    await _audioPlayer.seek(Duration.zero, index: 0);
                  }
                },
              ),
            ],
          ),
          const SizedBox(height: 20),
          SizedBox(
            width: 400,
            child: Row(
              mainAxisAlignment: MainAxisAlignment.spaceAround,
              children: [
                const Icon(Icons.volume_up, color: Colors.white),
                SizedBox(
                  width: 350,
                  child: Slider(
                    value: _volumeValue,
                    min: 0.0,
                    max: 1.0,
                    onChanged: _setVolume,
                    activeColor: Colors.white,
                    inactiveColor: Colors.white54,
                  ),
                ),
              ],
            ),
          ),
          const SizedBox(height: 20),
          Padding(
            padding: EdgeInsets.only(bottom: 20),
            child: Row(
              mainAxisAlignment: MainAxisAlignment.spaceAround,
              children: [
                IconButton(
                  onPressed: () async {
                    await _audioPlayer.seek(
                      null,
                      index: Random().nextInt(songs.length),
                    );
                  },
                  icon: Icon(Icons.casino),
                  color: Colors.white,
                  iconSize: 30,
                ),
                IconButton(
                  onPressed: () async {
                    await _audioPlayer.setShuffleModeEnabled(
                      !_audioPlayer.shuffleModeEnabled,
                    );
                    if (_audioPlayer.shuffleModeEnabled) {
                      prevLoopMode = _audioPlayer.loopMode;
                      await _audioPlayer.setLoopMode(LoopMode.all);
                    } else {
                      await _audioPlayer.setLoopMode(prevLoopMode);
                    }
                    setState(() {});
                  },
                  icon: Icon(
                    _audioPlayer.shuffleModeEnabled
                        ? Icons.shuffle
                        : Icons.double_arrow,
                  ),
                  color: Colors.white,
                  iconSize: 30,
                ),
                IconButton(
                  onPressed:
                      _audioPlayer.shuffleModeEnabled
                          ? null
                          : (() async {
                            int loopMode =
                                loopModeToIndex[_audioPlayer.loopMode]!;
                            loopMode = (loopMode + 1) % 3;
                            await _audioPlayer.setLoopMode(
                              indexToLoopMode[loopMode]!,
                            );
                            setState(() {});
                          }),
                  icon: icons[loopModeToIndex[_audioPlayer.loopMode]!],
                  color: colors[loopModeToIndex[_audioPlayer.loopMode]!],
                  iconSize: 30,
                ),
              ],
            ),
          ),
        ],
      ),
    );
  }

  String _formatDuration(Duration duration) {
    final minutes = duration.inMinutes.remainder(60).toString().padLeft(2, &apos;0&apos;);
    final seconds = duration.inSeconds.remainder(60).toString().padLeft(2, &apos;0&apos;);
    return &apos;$minutes:$seconds&apos;;
  }
}

class DurationState {
  final Duration position;
  final Duration total;

  DurationState({required this.position, required this.total});
}
&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;:::note[Explanation]&lt;/p&gt;
&lt;ol&gt;
&lt;li&gt;確認目前使用者是否有在更改播放位置，若有則將時間與滑桿值設定為使用者目前滑到的位置&lt;/li&gt;
&lt;li&gt;在滑動滑桿時，使音樂不會停止，讓使用者先滑到想聽的地方並鬆開滑桿後，才將音樂位置移到指定位置。&lt;/li&gt;
&lt;li&gt;為了讓打亂歌單循環播放，所以當打亂模式開啟時，強制鎖定成循環播放，待使用者關閉打亂模式後，再恢復原本的播放模式。&lt;/li&gt;
&lt;li&gt;依據隨機歌單模式決定切換循環模式鈕是否啟用。在 listener 為 &lt;code&gt;null&lt;/code&gt; 時，按鈕會被設定為禁用。
:::&lt;/li&gt;
&lt;/ol&gt;
&lt;h2&gt;App Exhibition&lt;/h2&gt;
&lt;p&gt;展示功能：播放音樂、播放暫停、下一首、上一首、歌曲相關訊息展示、隨機播放一首、調整系統音量、自動播放下一首、顯示目前播放時間、滑動調整、打亂歌單、單曲循環、歌單循環
&amp;lt;div style=&quot;position:relative; width:100%; height:0px; padding-bottom:216.216%&quot;&amp;gt;&amp;lt;iframe allow=&quot;fullscreen&quot; allowfullscreen height=&quot;100%&quot; src=&quot;https://streamable.com/e/rxadze?&quot; width=&quot;100%&quot; style=&quot;border:none; width:100%; height:100%; position:absolute; left:0px; top:0px; overflow:hidden;&quot;&amp;gt;&amp;lt;/iframe&amp;gt;&amp;lt;/div&amp;gt;&lt;/p&gt;
&lt;p&gt;展示功能：背景播放與背景控制
&amp;lt;div style=&quot;position:relative; width:100%; height:0px; padding-bottom:163.889%&quot;&amp;gt;&amp;lt;iframe allow=&quot;fullscreen&quot; allowfullscreen height=&quot;100%&quot; src=&quot;https://streamable.com/e/4c3v6u?&quot; width=&quot;100%&quot; style=&quot;border:none; width:100%; height:100%; position:absolute; left:0px; top:0px; overflow:hidden;&quot;&amp;gt;&amp;lt;/iframe&amp;gt;&amp;lt;/div&amp;gt;&lt;/p&gt;
&lt;h2&gt;Wrapping Up&lt;/h2&gt;
&lt;p&gt;雖然說可能又是有點急就章的一次，但是感謝 AI 幫助，讓我寫介面可以寫那麼快。並且這次我也是見識到了 just_audio 模組有多麼強大，作者已經把東西都抽象好了，你只要接上去就好，不用再去重新實作相關的程式碼，真的是非常的方便。&lt;/p&gt;
&lt;h2&gt;GitHub Repository&lt;/h2&gt;
&lt;p&gt;::github{repo=&quot;Kayxue/MusicPlayer&quot;}&lt;/p&gt;
</content:encoded></item><item><title>Android Platform Tools，測試應用程式與改機必備工具</title><link>https://blog.kayxue.dev/posts/androidplatformtool/</link><guid isPermaLink="true">https://blog.kayxue.dev/posts/androidplatformtool/</guid><description>簡介 Android Platform Tools 的功能，以及如何使用它們來測試應用程式、更新系統。</description><pubDate>Sat, 12 Apr 2025 00:00:00 GMT</pubDate><content:encoded>&lt;p&gt;還記得從不知道什麼時候開始，改機風潮興起，不少人開始紛紛研究改機，並分享自己的改機心得與技巧，在那改機盛行的年代，不管是自訂系統主題，還是取得 root 權限，甚至刷系統，基本上網路上都可以找到不少資源。不過隨著時間推移，改機變得越來越困難，從需要解鎖 Bootloader 到解鎖 Bootloader 需要等待一週，甚至有些廠商還把 Bootloader 直接給徹底鎖起來，不讓別人解鎖了。雖然改機潮慢慢減退了，不過現在 Android Platform Tools 還是一個非常重要的工具，它可以幫助我們解鎖 Bootloader、刷入其他系統、取得 root 權限，甚至測試應用程式、更新系統等，讓我們管理自己的 Android 裝置可以更加方便。&lt;/p&gt;
&lt;h2&gt;Download &amp;amp; Install&lt;/h2&gt;
&lt;h3&gt;Using Without Installation&lt;/h3&gt;
&lt;p&gt;可以直接從&lt;a href=&quot;https://developer.android.com/tools/releases/platform-tools&quot;&gt;這裡&lt;/a&gt;下載即可，下載完成後解壓即可使用&lt;/p&gt;
&lt;h3&gt;Installation&lt;/h3&gt;
&lt;h4&gt;Windows&lt;/h4&gt;
&lt;p&gt;可直接安裝 &lt;code&gt;ADB &amp;amp; Fastboot++&lt;/code&gt;&lt;/p&gt;
&lt;p&gt;https://xdaforums.com/t/tool-windows-adb-fastboot-march-2024.3944288/&lt;/p&gt;
&lt;h4&gt;macOS&lt;/h4&gt;
&lt;p&gt;可直接使用 Homebrew 進行安裝：&lt;/p&gt;
&lt;pre&gt;&lt;code&gt;brew install android-platform-tools
&lt;/code&gt;&lt;/pre&gt;
&lt;h4&gt;Linux&lt;/h4&gt;
&lt;p&gt;依據發行版所使用的套件管理器而定，例如：&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;Ubuntu：&lt;code&gt;sudo apt install android-sdk-platform-tools&lt;/code&gt;&lt;/li&gt;
&lt;li&gt;Arch Linux：&lt;code&gt;sudo pacman -S android-tools&lt;/code&gt;&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;安裝完成後即可輸入 &lt;code&gt;adb help&lt;/code&gt; 和 &lt;code&gt;fastboot help&lt;/code&gt; 即可看到 adb 和 fastboot 的指令清單：
&lt;img src=&quot;./commands.png&quot; alt=&quot;&quot; /&gt;&lt;/p&gt;
&lt;p&gt;指令整個可以說是非常的多，但是礙於篇幅的關係，在此不可能一個一個跟各位講說每一個指令要怎麼用，所以接下來就來舉一些情境來示範如何使用這些工具。&lt;/p&gt;
&lt;h2&gt;Use Custom Simulator to Debug Your Application&lt;/h2&gt;
&lt;p&gt;這是一個再經典不過的狀況了，當你的電腦在使用 Android Studio 給的模擬器進行測試，結果卻發現應用程式執行速度非常慢、模擬器嚴重卡頓，不過你卻發現你電腦上裝的那些遊戲用的 Android 模擬器，效能卻非常好，這時你就可以在沒有其他額外需求下，考慮使用那種遊戲專用的 Android 模擬器來進行應用程式測試，以獲得更好地應用程式測試體驗。&lt;/p&gt;
&lt;p&gt;:::note
在此使用 BlueStacks Air 來進行示範，不同模擬器步驟可能會有所不同
:::&lt;/p&gt;
&lt;h3&gt;Steps&lt;/h3&gt;
&lt;ol&gt;
&lt;li&gt;啟動模擬器
&lt;img src=&quot;./launchsimulator.png&quot; alt=&quot;&quot; /&gt;&lt;/li&gt;
&lt;li&gt;點選右下角齒輪開啟設定，接下來在左側列表前往進階設定，然後在右側啟用 Android Debug Bridge (ADB)
&lt;img src=&quot;./enabledebug.png&quot; alt=&quot;&quot; /&gt;&lt;/li&gt;
&lt;li&gt;開啟終端機，輸入以下指令連上模擬器&lt;/li&gt;
&lt;/ol&gt;
&lt;pre&gt;&lt;code&gt;adb connect 127.0.0.1:5555
&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;&lt;img src=&quot;./connected.png&quot; alt=&quot;&quot; /&gt;
看到以上畫面即成功連線，接下來就可以進行應用程式安裝與測試。&lt;/p&gt;
&lt;p&gt;在此我以 Flutter 應用為例，首先我們先在編輯器或 IDE 中打開軟體專案：
&lt;img src=&quot;./openproject.png&quot; alt=&quot;&quot; /&gt;&lt;/p&gt;
&lt;p&gt;啟動後即可開啟編輯器內建的終端機，輸入 &lt;code&gt;flutter run&lt;/code&gt; 即可開始執行應用程式。在中途他會問你要在哪個裝置上執行，在列表中你即可看到 BlueStack Air 模擬器出現了，選擇後即可開始測試應用程式。
&lt;img src=&quot;./runapp.png&quot; alt=&quot;&quot; /&gt;
&lt;img src=&quot;./appresult.png&quot; alt=&quot;&quot; /&gt;
如果要終止測試的話請回到 IDE 點選停止按鈕停止執行，或者像剛剛 Flutter 的話可以直接按下 &lt;code&gt;Ctrl + C&lt;/code&gt; 直接停止應用程式執行。&lt;/p&gt;
&lt;h2&gt;Custom ROM Major Version Update&lt;/h2&gt;
&lt;p&gt;雖然說目前不少專案官方有提供支援的 ROM 都會提供 OTA 更新功能，讓使用者可以直接透過系統內建的系統更新功能進行系統更新，不過以 Lineage OS 為例，雖然官方有提供透過系統內建的更新功能進行更新的方式，但是該功能只能進行小版本的更新，如果是更大版本的話（例如 LineageOS 20 -&amp;gt; LineageOS 21），在系統更新頁面它會不讓你進行該版本的更新下載，只會在那些更新右下角放個資訊按鈕，點擊後只會寫說該更新他系統沒有辦法進行。這時，你就只能自行透過刷機的方式進行更新。&lt;/p&gt;
&lt;p&gt;&lt;img src=&quot;./cannotupdate.png&quot; alt=&quot;&quot; /&gt;&lt;/p&gt;
&lt;p&gt;&lt;img src=&quot;./cannotupdatedialog.png&quot; alt=&quot;&quot; /&gt;&lt;/p&gt;
&lt;p&gt;接下來我們就開始吧！首先，我們需要先前往對應 ROM 的官網下載對應裝置的最新版 ROM：
&lt;img src=&quot;./downloadimg.png&quot; alt=&quot;&quot; /&gt;&lt;/p&gt;
&lt;p&gt;這次以防等一下在刷時會因為 recovery 而造成系統刷不進去，所以這裡兩個檔案都會下載，&lt;code&gt;lineage&lt;/code&gt; 開頭的是 ROM，而 &lt;code&gt;boot.img&lt;/code&gt; 則是 Recovery Image。
接下來就是下載一些其他需要刷的東西，例如 Magisk、Google Play 商店，最後大概下載了四個檔案
&lt;img src=&quot;./images.png&quot; alt=&quot;&quot; /&gt;
而接下來就是將手機連接電腦，並開啟 USB 偵錯：
&lt;img src=&quot;./usbdebug.png&quot; alt=&quot;&quot; /&gt;
確定檔案都下載完成後，接下來即可輸入指令啟動至 Bootloader：&lt;/p&gt;
&lt;pre&gt;&lt;code&gt;adb reboot bootloader
&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;進入 Bootloader 後，手機正常來講會顯示燈號，如圖所示：
&lt;img src=&quot;./bootloader.jpg&quot; alt=&quot;&quot; /&gt;
此時即可輸入以下指令刷入新的 Recovery：&lt;/p&gt;
&lt;pre&gt;&lt;code&gt;fastboot flash boot &amp;lt;boot-image-location&amp;gt;/boot.img
&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;如果有刷成功的話如下圖所示：
&lt;img src=&quot;./bootimg.png&quot; alt=&quot;&quot; /&gt;
此時請先將裝置中斷連線，螢幕上方指示燈會熄滅，然後按下 &lt;code&gt;音量下&lt;/code&gt; + &lt;code&gt;電源&lt;/code&gt; 鍵進入 Recovery。
&lt;img src=&quot;./recovery.jpeg&quot; alt=&quot;&quot; /&gt;
接下來請將手機跟電腦連線，然後選擇 &lt;code&gt;Apply Update&lt;/code&gt; -&amp;gt; &lt;code&gt;Apply from ADB&lt;/code&gt;
&lt;img src=&quot;./applyupdate1.jpeg&quot; alt=&quot;&quot; /&gt;
&lt;img src=&quot;./applyupdate2.jpeg&quot; alt=&quot;&quot; /&gt;
之後請回到電腦上，輸入以下指令開始刷入新版 ROM：&lt;/p&gt;
&lt;pre&gt;&lt;code&gt;adb sideload &amp;lt;rom-image-location&amp;gt;/&amp;lt;rom-name&amp;gt;.zip
&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;刷的中途可能會出現如圖所示的畫面：
&lt;img src=&quot;./installadditional.jpeg&quot; alt=&quot;&quot; /&gt;
選擇 &lt;code&gt;Yes&lt;/code&gt; 即可，終端機可能會出現錯誤，不過這是正常的，沒關係。
重新啟動至 Recovery 後，若您有想要再刷入其他的東西（例如 GApps、Magisk），可再次選擇 &lt;code&gt;Apply Update&lt;/code&gt; -&amp;gt; &lt;code&gt;Apply from ADB&lt;/code&gt; 繼續刷入其他東西。例如我想刷入 GApps 和 Magisk，則將剛剛下載到的 Magisk 安裝包副檔名改成 &lt;code&gt;.zip&lt;/code&gt; 後，依序輸入以下兩個命令刷入，並且每刷完一個就重啟至 Recovery 一次：&lt;/p&gt;
&lt;pre&gt;&lt;code&gt;adb sideload &amp;lt;gapps-image-location&amp;gt;/&amp;lt;gapps-name&amp;gt;.zip
adb sideload &amp;lt;magisk-image-location&amp;gt;/&amp;lt;magisk-installer-name&amp;gt;.zip
&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;在確定所有東西都有刷成功後，即可選擇 &lt;code&gt;Reboot System now&lt;/code&gt; 進行重新開機：
&lt;img src=&quot;./reboot.jpeg&quot; alt=&quot;&quot; /&gt;
確認一切都沒問題後，整個過程就完成了&lt;/p&gt;
</content:encoded></item><item><title>Flutter App 3 - Blue Archinve Introduction</title><link>https://blog.kayxue.dev/posts/flutterapp3/</link><guid isPermaLink="true">https://blog.kayxue.dev/posts/flutterapp3/</guid><description>一個小小的蔚藍檔案介紹 App</description><pubDate>Sat, 29 Mar 2025 00:00:00 GMT</pubDate><content:encoded>&lt;p&gt;這次是使用 Flutter 製作一個電子書 App。主題的部分原本是想說做一個介紹程式語言的 App，但是因為如果真的做的話，可能需要面對程式碼上色、需要自行撰寫相關介紹的問題。並且因為本人上週剛考完微積分大考，然後再下週又有期中考，如果真的再這樣搞下去的話我期中考其他科目可能不用準備了，準備直接完蛋，所以只好找一個主題稍微做一下，先交差然後準備期中考。&lt;/p&gt;
&lt;h2&gt;App Preview&lt;/h2&gt;
&lt;p&gt;畫面右下角有一點奇怪的東西，那個是在電腦上從影片截圖時碰到底部工作列造成的，在使用 App 時不會那些奇怪的東西。
&lt;img src=&quot;./appview.jpg&quot; alt=&quot;&quot; /&gt;
這次學生的部分只放阿拜多斯的，放全部的話因為圖片處理很耗時間，所以就沒放了。&lt;/p&gt;
&lt;h2&gt;Directory Structure&lt;/h2&gt;
&lt;p&gt;基本上還是跟上次差不多的，只是沒有再建立 components 資料夾了。&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;&lt;code&gt;Pages&lt;/code&gt;：所有的頁面，不管是 Tab 或者單個頁面基本上都放在這。&lt;/li&gt;
&lt;li&gt;&lt;code&gt;Types&lt;/code&gt;：自訂資料型別&lt;/li&gt;
&lt;li&gt;&lt;code&gt;Widgets&lt;/code&gt;：畫面上的元件，只是因為很少，所以這次裡面沒有再依頁面分資料夾了
&lt;img src=&quot;./directory.png&quot; alt=&quot;Directory Structure m-auto&quot; /&gt;&lt;/li&gt;
&lt;/ul&gt;
&lt;h2&gt;Code Explanation&lt;/h2&gt;
&lt;p&gt;這次與上兩篇一樣，重複或類似的內容、非該解析所關注的點會進行折疊。&lt;/p&gt;
&lt;h3&gt;Base App&lt;/h3&gt;
&lt;p&gt;整個 App 的基底，改的部分只有標題、主題色與顯示的標題&lt;/p&gt;
&lt;pre&gt;&lt;code&gt;import &apos;package:bluearchiveintroduction/Pages/Introduction.dart&apos;;
import &apos;package:bluearchiveintroduction/Pages/Students.dart&apos;;
import &apos;package:flutter/material.dart&apos;;

void main() {
  runApp(const MyApp());
}

class MyApp extends StatelessWidget {
  const MyApp({super.key});

  // This widget is the root of your application.
  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      debugShowCheckedModeBanner: false,
      title: &apos;BlueArchive Wiki&apos;,
      theme: ThemeData(
        colorScheme: ColorScheme.fromSeed(seedColor: Colors.lightBlue),
      ),
      home: const MyHomePage(title: &apos;BlueArchive Wiki&apos;),
    );
  }
}

class MyHomePage extends StatefulWidget {
  const MyHomePage({super.key, required this.title});

  final String title;

  @override
  State&amp;lt;MyHomePage&amp;gt; createState() =&amp;gt; _MyHomePageState();
}

class _MyHomePageState extends State&amp;lt;MyHomePage&amp;gt;
    with SingleTickerProviderStateMixin {
  late TabController _tabController;

  @override
  void initState() {
    super.initState();
    _tabController = TabController(vsync: this, length: 2);
  }

  @override
  void dispose() {
    _tabController.dispose();
    super.dispose();
  }

  @override
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        backgroundColor: Theme.of(context).colorScheme.inversePrimary,
        title: Text(widget.title),
        bottom: TabBar(
          tabs: [Tab(text: &apos;Introduction&apos;), Tab(text: &apos;Students&apos;)],
          controller: _tabController,
        ),
      ),
      body: TabBarView(
        controller: _tabController,
        children: [SingleChildScrollView(child: Introduction()), Students()],
      ),
    );
  }
}
&lt;/code&gt;&lt;/pre&gt;
&lt;h3&gt;Base View&lt;/h3&gt;
&lt;p&gt;整個主畫面的基底，負責顯示 TabBar，並且決定要顯示哪一個頁面。&lt;/p&gt;
&lt;pre&gt;&lt;code&gt;import &apos;package:bluearchiveintroduction/Pages/Introduction.dart&apos;;
import &apos;package:bluearchiveintroduction/Pages/Students.dart&apos;;
import &apos;package:flutter/material.dart&apos;;

void main() {
  runApp(const MyApp());
}

class MyApp extends StatelessWidget {
  const MyApp({super.key});

  // This widget is the root of your application.
  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      debugShowCheckedModeBanner: false,
      title: &apos;BlueArchive Wiki&apos;,
      theme: ThemeData(
        colorScheme: ColorScheme.fromSeed(seedColor: Colors.lightBlue),
      ),
      home: const MyHomePage(title: &apos;BlueArchive Wiki&apos;),
    );
  }
}

class MyHomePage extends StatefulWidget {
  const MyHomePage({super.key, required this.title});

  final String title;

  @override
  State&amp;lt;MyHomePage&amp;gt; createState() =&amp;gt; _MyHomePageState();
}

class _MyHomePageState extends State&amp;lt;MyHomePage&amp;gt;
    with SingleTickerProviderStateMixin {
  late TabController _tabController;

  @override
  void initState() {
    super.initState();
    _tabController = TabController(vsync: this, length: 2);
  }

  @override
  void dispose() {
    _tabController.dispose();
    super.dispose();
  }

  @override
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        backgroundColor: Theme.of(context).colorScheme.inversePrimary,
        title: Text(widget.title),
        bottom: TabBar(
          tabs: [Tab(text: &apos;Introduction&apos;), Tab(text: &apos;Students&apos;)],
          controller: _tabController,
        ),
      ),
      body: TabBarView(
        controller: _tabController,
        children: [SingleChildScrollView(child: Introduction()), Students()],
      ),
    );
  }
}
&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;:::note[Explanation]&lt;/p&gt;
&lt;ol&gt;
&lt;li&gt;由於協調 &lt;code&gt;TabBar&lt;/code&gt; 和 &lt;code&gt;TabBarView&lt;/code&gt; 的 &lt;code&gt;TabController&lt;/code&gt; 需要一個 &lt;code&gt;TickerProvider&lt;/code&gt;，所以需要為此 widget 加一個 &lt;code&gt;SingleTickerProviderStateMixin&lt;/code&gt; 為此 widget 提供一個 &lt;code&gt;Ticker&lt;/code&gt;，並且在 widget 被插入到樹中時初始化。並且在此 widget 在樹中被永久移除時銷毀。&lt;/li&gt;
&lt;li&gt;取得應用程式主題中的 &lt;code&gt;inversePrimary&lt;/code&gt; 來當作 &lt;code&gt;AppBar&lt;/code&gt; 的底色。&lt;/li&gt;
&lt;li&gt;捲動部分因為一個是要捲動整個頁面，另一個則是交給 &lt;code&gt;ListView&lt;/code&gt;，所以第一個有加 &lt;code&gt;SingleChildScrollView&lt;/code&gt;，第二個沒有。
:::&lt;/li&gt;
&lt;/ol&gt;
&lt;h3&gt;Introduction Page&lt;/h3&gt;
&lt;p&gt;介紹蔚藍檔案的頁面，以下檔案位於 &lt;code&gt;Pages&lt;/code&gt; 資料夾中。&lt;/p&gt;
&lt;pre&gt;&lt;code&gt;import &apos;package:bluearchiveintroduction/Widgets/ScreenShot.dart&apos;;
import &apos;package:flutter/material.dart&apos;;

class Introduction extends StatelessWidget {
  const Introduction({super.key});

  @override
  Widget build(BuildContext context) {
    return Padding(
      padding: EdgeInsets.only(left: 32.0, right: 32.0, top: 32.0),
      child: Column(
        children: [
          Row(
            children: [
              Expanded(
                child: Text(
                  &quot;《蔚藍檔案 Blue Archive》（韓語：블루 아카이브，日語：ブルーアーカイブ -Blue Archive-，英語：Blue Archive，中國大陸有時也用非官方名稱「碧藍檔案」）為 NEXON 旗下子公司 NEXON Games 開發且於 2021 年發行的校園美少女風格手機遊戲。&quot;,
                  overflow: TextOverflow.ellipsis,
                  softWrap: true,
                  maxLines: 20,
                ),
              ),
              SizedBox(width: 32.0),
              Image.asset(&apos;assets/images/icon.jpg&apos;, width: 100, height: 100),
            ],
          ),
          SizedBox(height: 32.0),
          Row(
            children: [
              Text(
                &quot;畫面截圖&quot;,
                style: TextStyle(fontSize: 26, fontWeight: FontWeight.bold),
              ),
            ],
          ),
          SizedBox(height: 32.0),
          GridView.count(
            shrinkWrap: true,
            crossAxisCount: 2,
            crossAxisSpacing: 5,
            mainAxisSpacing: 5,
            physics: NeverScrollableScrollPhysics(),
            children: [
              Screenshot(name: &quot;IMG_3905.PNG&quot;, width: 100),
              Screenshot(name: &quot;IMG_3906.PNG&quot;, width: 100),
              Screenshot(name: &quot;IMG_3907.PNG&quot;, width: 100),
              Screenshot(name: &quot;IMG_3908.PNG&quot;, width: 100),
              Screenshot(name: &quot;IMG_3909.PNG&quot;, width: 100),
              Screenshot(name: &quot;IMG_3904.PNG&quot;, width: 100),
            ],
          ),
        ],
      ),
    );
  }
}
&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;:::note[Explanation]&lt;/p&gt;
&lt;ol&gt;
&lt;li&gt;因為有可能會文字溢出，所以需要設定自動多行顯示，最大行數為 &lt;code&gt;20&lt;/code&gt;，那個是為了讓內容能完整顯示。&lt;/li&gt;
&lt;li&gt;因應作業要求使用 &lt;code&gt;GridView&lt;/code&gt;，故在此使用 &lt;code&gt;GridView&lt;/code&gt; 顯示畫面截圖，每列兩個，並且設定禁止捲動（因為已經設定捲動整個頁面）。
:::
接下來就是顯示畫面截圖的 widget，為了簡化使用所以特別宣告了一個 &lt;code&gt;Screenshot&lt;/code&gt; widget，讓自己在使用時會比較方便。檔案位於 &lt;code&gt;Widgets&lt;/code&gt; 資料夾下。&lt;/li&gt;
&lt;/ol&gt;
&lt;pre&gt;&lt;code&gt;import &apos;package:flutter/material.dart&apos;;

class Screenshot extends StatelessWidget {
  final String name;
  final double width;

  const Screenshot({super.key, required this.name, required this.width});

  @override
  Widget build(BuildContext context) {
    return Container(
      padding: EdgeInsets.all(4.0),
      width: width,
      child: Image.asset(&apos;assets/screenshots/$name&apos;),
    );
  }
}
&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;沒錯就那麼一點點東西而已，因為只是單純顯示某個資料夾下的圖片，所以整個 widget 不會有什麼複雜的結構。&lt;/p&gt;
&lt;h3&gt;Students List Page&lt;/h3&gt;
&lt;p&gt;專門顯示學生清單的頁面，而頁面上會以每列兩個 &lt;code&gt;StudentTile&lt;/code&gt; 的方式列出學生的圖片和名字，點選各個學生的 &lt;code&gt;StudentTile&lt;/code&gt; 可以查看學生的簡單介紹。頁面檔案位於 &lt;code&gt;Pages&lt;/code&gt; 資料夾中。&lt;/p&gt;
&lt;pre&gt;&lt;code&gt;import &apos;package:bluearchiveintroduction/Widgets/StudentList.dart&apos;;

import &apos;../Types/Student.dart&apos;;
import &apos;package:flutter/material.dart&apos;;

class Students extends StatelessWidget {
  final List&amp;lt;Student&amp;gt; students = [
    Student(
      name: &quot;白子&quot;,
      description:
          &quot;喜歡運動的阿拜多斯對策委員會的行動班長。她給人的印象是，基本上沉默寡言且幾乎沒有表情變化，但其實她比任何人珍惜阿拜多斯學園。為了復興學園而不擇手段，偶爾會提出令人意想不到的想法。&quot;,
      imgName: &quot;siroko&quot;,
    ),
    Student(
      name: &quot;芹香&quot;,
      description:
          &quot;阿拜多斯對策委員會的難纏會計。很愛碎碎念，毫不猶豫地表露自己的感情。「這種學園最好快點完蛋！」就像她的口頭禪似的。雖然老是把這句話掛在嘴上，其實她為了償還學園的債務而暗中打工，對學園是很有愛的。&quot;,
      imgName: &quot;serika&quot;,
    ),
    Student(
      name: &quot;星野&quot;,
      description:
          &quot;阿拜多斯高中的原學生會副會長學生會會長，現在是對策委員會委員長的懶惰蟲少女。喜歡用大叔的口吻說話。比起公務，她更愛惡作劇。因此她平常老是被委員會的委員們訓。不過一旦任務開始，她就會為了保護其他學生站到最前線奮戰。&quot;,
      imgName: &quot;hosino&quot;,
    ),
    Student(
      name: &quot;綾音&quot;,
      description: &quot;阿拜多斯對策委員會的誠實書記。重視基本理論與規定的原則主義者，正為了復興阿拜多斯高中而踏實地努力着。&quot;,
      imgName: &quot;ayane&quot;,
    ),
    Student(
      name: &quot;野乃美&quot;,
      description:
          &quot;阿拜多斯高中所屬，對策委員會的一員。感情豐富且品性善良，是讓有着許多極端性格成員的對策委員會團結一致的精神支柱。雖然沒有怎麼表露出來，但她是富裕人家的千金，大部分的對策委員會零食費都來自她的零用錢。&quot;,
      imgName: &quot;nonomi&quot;,
    ),
  ];

  Students({super.key});

  @override
  Widget build(BuildContext context) {
    return StudentList(students);
  }
}
&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;這次因為 &lt;code&gt;StudentList&lt;/code&gt; 較為複雜，所以就就沒有選擇放在這裡，而是選擇直接新建一個 widget，這一個檔案主要是放基底學生資料的。&lt;code&gt;Student&lt;/code&gt; 是自訂的資料型別，用來儲存學生的基本資訊，等一下會介紹。&lt;/p&gt;
&lt;p&gt;接下來就是 &lt;code&gt;StudentList&lt;/code&gt;，用來顯示學生的資料，檔案位於 &lt;code&gt;Widgets&lt;/code&gt; 資料夾中。&lt;/p&gt;
&lt;pre&gt;&lt;code&gt;import &apos;dart:math&apos;;

import &apos;package:flutter/material.dart&apos;;

import &apos;../Types/Student.dart&apos;;
import &apos;StudentTile.dart&apos;;

class StudentList extends StatelessWidget {
  final List&amp;lt;Student&amp;gt; students;

  const StudentList(this.students, {super.key});

  @override
  Widget build(BuildContext context) {
    return ListView.builder(
      itemCount: students.length ~/ 2 + 1,
      itemBuilder: (context, index) {
        List&amp;lt;Student&amp;gt; temp = students.sublist(
          index * 2,
          min(index * 2 + 2, students.length),
        );
        return Row(
          children:
              temp
                  .map(
                    (stu) =&amp;gt; SizedBox(
                      width: MediaQuery.sizeOf(context).width / 2,
                      child: StudentTile(stu),
                    ),
                  )
                  .toList(),
        );
      },
    );
  }
}
&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;:::note[Explanation]&lt;/p&gt;
&lt;ol&gt;
&lt;li&gt;因為 students 是必填，並且基本上即使在參數沒填屬性，也會知道要填什麼，所以就沒有為其具名。&lt;/li&gt;
&lt;li&gt;決定總共有幾項，為了讓其可以根據新增個數變動，所以採用計算的方式，&lt;code&gt;~/&lt;/code&gt; 的部分是整數除法，並且為了讓資料只有一筆時也可以顯示，所以後面需要個 &lt;code&gt;+1&lt;/code&gt;（因為只有 1 個時，&lt;code&gt;1 ~/ 2 = 0&lt;/code&gt;）&lt;/li&gt;
&lt;li&gt;先決定要顯示的學生，因為 index 是指 &lt;code&gt;ListView&lt;/code&gt; 中的第幾項，所以需要將 index 稍作轉換才會抓到正確的學生資料。後面需要用 &lt;code&gt;min&lt;/code&gt; 是因為為避免結束位置超出 &lt;code&gt;List&lt;/code&gt; 長度，故需要取計算出來的值與 &lt;code&gt;List&lt;/code&gt; 長度中的最小值。&lt;/li&gt;
&lt;li&gt;使 &lt;code&gt;StudentTile&lt;/code&gt; 的寬度大小可以根據螢幕寬度自行調整，&lt;code&gt;MediaQuery.sizeOf(context).width&lt;/code&gt; 可取得螢幕的寬度。
:::
接下來就是學生清單中的每一項。&lt;/li&gt;
&lt;/ol&gt;
&lt;pre&gt;&lt;code&gt;import &apos;package:flutter/material.dart&apos;;

import &apos;../Pages/StudentDetail.dart&apos;;
import &apos;../Types/Student.dart&apos;;

class StudentTile extends StatelessWidget {
  final Student student;

  const StudentTile(this.student, {super.key});

  @override
  Widget build(BuildContext context) {
    return Card(
      clipBehavior: Clip.hardEdge,
      child: InkWell(
        splashColor: Colors.grey.withAlpha(30),
        onTap:
            () =&amp;gt; {
              Navigator.push(
                context,
                MaterialPageRoute(
                  builder: (context) =&amp;gt; StudentDetail(student: student),
                ),
              ),
            },
        child: Column(
          children: [
            Padding(
              padding: EdgeInsets.only(top: 16),
              child: SizedBox(
                width: 100,
                child: Image.asset(
                  &quot;assets/students/${student.imgName}.jpg&quot;,
                  fit: BoxFit.contain,
                ),
              ),
            ),
            Padding(
              padding: EdgeInsets.only(top: 8, bottom: 8),
              child: Text(
                student.name,
                style: TextStyle(fontWeight: FontWeight.bold),
              ),
            ),
          ],
        ),
      ),
    );
  }
}
&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;標記處的部分是設定點下去的漣漪效果，將效果的顏色設定為灰色，並且在點下去之後會跳出一個新的頁面顯示學生的資訊。&lt;/p&gt;
&lt;h3&gt;Student Detail Page&lt;/h3&gt;
&lt;p&gt;用於顯示學生的相關資料，頁面檔案位於 &lt;code&gt;Pages&lt;/code&gt; 資料夾中。&lt;/p&gt;
&lt;pre&gt;&lt;code&gt;import &apos;package:flutter/material.dart&apos;;

import &apos;../Types/Student.dart&apos;;

class StudentDetail extends StatelessWidget {
  final Student student;

  const StudentDetail({super.key, required this.student});

  @override
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(title: Text(student.name)),
      body: Padding(
        padding: const EdgeInsets.only(left: 32, right: 32, top: 16),
        child: Column(
          children: [
            Row(
              children: [
                Expanded(
                  child: Text(
                    student.description,
                    overflow: TextOverflow.ellipsis,
                    softWrap: true,
                    maxLines: 20,
                  ),
                ),
                SizedBox(width: 32.0),
                Image.asset(
                  &apos;assets/students/${student.imgName}.jpg&apos;,
                  width: 100,
                  height: 100,
                ),
              ],
            ),
          ],
        ),
      ),
    );
  }
}
&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;介面基本上相當的簡單，標題顯示學生名字，然後頁面顯示學生的其他資訊。這裡因為排版與時間關係，所以只放一部分的資訊。&lt;/p&gt;
&lt;p&gt;最後就是學生資訊的部分，檔案位於 &lt;code&gt;Types&lt;/code&gt; 資料夾中。&lt;/p&gt;
&lt;pre&gt;&lt;code&gt;class Student {
  final String name;
  final String description;
  final String imgName;

  Student({
    required this.name,
    required this.description,
    required this.imgName,
  });
}
&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;沒有什麼成員方法，因為目前沒有需要動學生資料的部分，單純像結構一樣單純封裝資料。&lt;/p&gt;
&lt;h2&gt;App Exhibition&lt;/h2&gt;
&lt;p&gt;&amp;lt;div style=&quot;position:relative; width:100%; height:0px; padding-bottom:216.216%&quot;&amp;gt;&amp;lt;iframe allow=&quot;fullscreen&quot; allowfullscreen height=&quot;100%&quot; src=&quot;https://streamable.com/e/63hw2r?&quot; width=&quot;100%&quot; style=&quot;border:none; width:100%; height:100%; position:absolute; left:0px; top:0px; overflow:hidden;&quot;&amp;gt;&amp;lt;/iframe&amp;gt;&amp;lt;/div&amp;gt;&lt;/p&gt;
&lt;h2&gt;Wrapping Up&lt;/h2&gt;
&lt;p&gt;這次的話是挑蔚藍檔案，然後參考了別人的排版。因為自己也不知道怎麼排會比較舒服，對於這種應用程式我也是第一次做，怎麼排比較好看我也不知道，所以就參考了別人的排版，感覺樣子其實還不錯。不得不說排版真的是需要不少經驗才有辦法知道說怎樣排才有辦法非常好看。&lt;/p&gt;
&lt;p&gt;不過這次也是我第一次利用撰寫前一篇 Flutter 系列文章時所架出來的環境，並且加上 Zed 編輯器撰寫出一個 Flutter App。雖然說 debug 有需要 hot reload 時，會需要先自己輸入指令找要在哪個裝置上執行，再透過指令使用可以在你儲存檔案時自動 hot reload 的模組來執行 App，還有就是你資源改名時他不會重新去讀新資源，但撇開那些不談，其實開發體驗已經可以說是非常舒服的了。雖然說 Zed 對於 Flutter 支援或許還有一段路要走，但是在完全支援之後，或許 Zed 也會是開發 Flutter 應用程式的一個好選擇。&lt;/p&gt;
&lt;p&gt;關於如何使用 Zed 編輯器撰寫 Flutter App，可以參考上一篇系列文章&lt;/p&gt;
&lt;p&gt;&lt;a href=&quot;/posts/flutterzed/&quot;&gt;/posts/flutterzed/&lt;/a&gt;&lt;/p&gt;
&lt;h2&gt;GitHub Repository&lt;/h2&gt;
&lt;p&gt;::github{repo=&quot;Kayxue/BlueArchiveIntroduction&quot;}&lt;/p&gt;
&lt;h2&gt;Image and Content Resources&lt;/h2&gt;
&lt;p&gt;https://www.gamekee.com/ba/&lt;/p&gt;
&lt;p&gt;萌娘百科：https://zh.moegirl.org.cn/&lt;/p&gt;
</content:encoded></item><item><title>Flutter Ex－New Development Experience with Zed</title><link>https://blog.kayxue.dev/posts/flutterzed/</link><guid isPermaLink="true">https://blog.kayxue.dev/posts/flutterzed/</guid><description>如何在 MacOS 上使用 Zed 編輯器進行 Flutter 開發</description><pubDate>Sun, 16 Mar 2025 00:00:00 GMT</pubDate><content:encoded>&lt;p&gt;這個編輯器其實我已經在些許年前就聽過它了，只是因為該編輯器無法新增編輯器背景，所以才沒有用，不過隨著後來看到了 Rust 程式的強悍，而 Zed 也是使用 Rust 製作的，而且我身邊也有些人也開始選擇使用 Zed 進行程式開發，所以我也下載了下來，用了也覺得不錯。而最近也看到了部落客彼得寫了一篇文章&lt;a href=&quot;https://medium.com/%E5%BD%BC%E5%BE%97%E6%BD%98%E7%9A%84-swift-ios-app-%E9%96%8B%E7%99%BC%E6%95%99%E5%AE%A4/%E4%BD%BF%E7%94%A8-zed-ide-%E7%9A%84-ai-%E6%8F%90%E7%A4%BA%E5%AF%AB%E6%96%87%E7%AB%A0-b6840c01400d&quot;&gt;使用 Zed IDE 的 AI 提示寫文章&lt;/a&gt;，所以這次就來研究一下如何在 Mac 上使用 Zed 開發 Flutter 程式吧！&lt;/p&gt;
&lt;h2&gt;Before You Start&lt;/h2&gt;
&lt;p&gt;由於 Zed 目前對於 Flutter 支援沒有那麼完備，所以開發體驗相對來說是不如 VSCode 系列編輯器的，並且目前 extension 部分只有 Dart 的 extension，沒有 Flutter 的 extension，所以在安裝工具、專案建立與執行等多數動作需要透過指令的方式進行，若無法接受，請還是先以 VScode 為主，之後支援完整時再切換即可。&lt;/p&gt;
&lt;h2&gt;Install Zed&lt;/h2&gt;
&lt;p&gt;首先請前往 Zed 官網，並按下 &lt;code&gt;Download Now&lt;/code&gt; 進行下載&lt;/p&gt;
&lt;p&gt;https://zed.dev/&lt;/p&gt;
&lt;p&gt;&lt;img src=&quot;./zedweb.png&quot; alt=&quot;&quot; /&gt;&lt;/p&gt;
&lt;p&gt;然後點選 &lt;code&gt;Download Now&lt;/code&gt; 進行下載&lt;/p&gt;
&lt;p&gt;&lt;img src=&quot;./downloadzed.png&quot; alt=&quot;&quot; /&gt;&lt;/p&gt;
&lt;p&gt;下載完後打開檔案，將程式拖入 Applications 資料夾即完成安裝&lt;/p&gt;
&lt;p&gt;&lt;img src=&quot;./zedinstall.png&quot; alt=&quot;&quot; /&gt;&lt;/p&gt;
&lt;h2&gt;Install Flutter SDK and Relative Tools&lt;/h2&gt;
&lt;p&gt;這裡就會沒有像 VSCode 系列編輯器那麼方便了，由於沒有 extension 的輔助，我們需要自己手動安裝&lt;/p&gt;
&lt;h3&gt;Flutter SDK&lt;/h3&gt;
&lt;p&gt;首先先前往這裡的約中間處下載 Flutter SDK 壓縮檔&lt;/p&gt;
&lt;p&gt;https://docs.flutter.dev/install/manual&lt;/p&gt;
&lt;p&gt;&lt;img src=&quot;./downloadflutter.png&quot; alt=&quot;&quot; /&gt;&lt;/p&gt;
&lt;p&gt;由於 SDK 下載需要一點時間，所以在下載時，我們先建立一個可以安裝 Flutter SDK 的地方，在此本人選擇在 &lt;code&gt;~/development/&lt;/code&gt; 資料夾下：&lt;/p&gt;
&lt;pre&gt;&lt;code&gt;mkdir ~/development/
&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;下載完成後，即可將 Flutter SDK 解壓縮並放進剛剛建立的資料夾下：&lt;/p&gt;
&lt;pre&gt;&lt;code&gt;unzip ~/Downloads/flutter_macos_arm64_3.29.2-stable.zip \
       -d ~/development/
&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;:::note
輸入指令時請注意路徑與檔案名
:::&lt;/p&gt;
&lt;h3&gt;Add Flutter to PATH&lt;/h3&gt;
&lt;p&gt;為了以後方便在終端機執行 Flutter 指令，接下來我們就把 Flutter 加入 PATH 吧！&lt;/p&gt;
&lt;p&gt;首先我們需要以 vim 開啟 &lt;code&gt;~/.zshenv&lt;/code&gt;，若沒有該檔案可先建立：&lt;/p&gt;
&lt;pre&gt;&lt;code&gt;vim ~/.zshenv
&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;接下來按 &lt;code&gt;I&lt;/code&gt; 進行插入，並在檔案尾端加入這行&lt;/p&gt;
&lt;pre&gt;&lt;code&gt;export PATH=$HOME/development/flutter/bin:$PATH
&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;&lt;img src=&quot;./addfluttertopath.png&quot; alt=&quot;&quot; /&gt;&lt;/p&gt;
&lt;p&gt;加入完成後按一下 &lt;code&gt;Esc&lt;/code&gt;，然後輸入 &lt;code&gt;:wq&lt;/code&gt; 寫入並退出，之後重啟終端機就完成了&lt;/p&gt;
&lt;h3&gt;Install Xcode (iOS)&lt;/h3&gt;
&lt;p&gt;首先先前往 App Store 下載 Xcode：
&lt;img src=&quot;./installxcode.png&quot; alt=&quot;&quot; /&gt;
安裝完成後請輸入下方指令進行同意授權與在終端機使用 Xcode 相關設定：&lt;/p&gt;
&lt;pre&gt;&lt;code&gt;sudo sh -c &apos;xcode-select -s /Applications/Xcode.app/Contents/Developer &amp;amp;&amp;amp; xcodebuild -runFirstLaunch&apos;
&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;完成之後，請打開 Xcode 並安裝 iOS 支援的相關元件，若您是第一次安裝，則第一次啟動時會有一個視窗，勾選 iOS 後按下下方按鈕，軟體會自動幫你安裝，如果沒有出現該視窗，則可以前往 &lt;code&gt;Xcode&lt;/code&gt; -&amp;gt; &lt;code&gt;Settings&lt;/code&gt; -&amp;gt; &lt;code&gt;Components&lt;/code&gt; 查看，如果該項如下圖所示，則安裝完成，若無請進行安裝。
&lt;img src=&quot;./iossupport.png&quot; alt=&quot;&quot; /&gt;&lt;/p&gt;
&lt;h3&gt;Update Ruby (iOS)&lt;/h3&gt;
&lt;p&gt;若您以後有需要使用到 iOS Native Code 的 Flutter Plugin 的話，則需要安裝 CocoaPods。&lt;/p&gt;
&lt;p&gt;但在安裝之前，請先透過以下指令查看您電腦上目前的 Ruby 版本：&lt;/p&gt;
&lt;pre&gt;&lt;code&gt;ruby --version
&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;&lt;img src=&quot;./oldruby.png&quot; alt=&quot;&quot; /&gt;
如果版本為舊版（例如：2.6.10）請繼續進行以下步驟，若已經是最新版可直接跳過這部分。&lt;/p&gt;
&lt;p&gt;首先執行以下指令安裝 rbenv：&lt;/p&gt;
&lt;pre&gt;&lt;code&gt;brew install rbenv
&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;安裝完成之後，輸入以下指令進行 rbenv 初始設定：&lt;/p&gt;
&lt;pre&gt;&lt;code&gt;rbenv init
&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;查看最新穩定版的 Ruby：&lt;/p&gt;
&lt;pre&gt;&lt;code&gt;rbenv install -l
&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;&lt;img src=&quot;./listruby.png&quot; alt=&quot;&quot; /&gt;
找到最新的版本後，輸入以下指令安裝：&lt;/p&gt;
&lt;pre&gt;&lt;code&gt;rbenv install 3.4.2
&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;&lt;img src=&quot;./installruby.png&quot; alt=&quot;&quot; /&gt;
安裝好之後，輸入以下兩個指令指定預設 ruby 版本：&lt;/p&gt;
&lt;pre&gt;&lt;code&gt;rbenv global 3.4.2
rbenv shell 3.4.2
&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;之後重啟終端機，輸入以下指令確認版本為剛剛裝的版本即完成&lt;/p&gt;
&lt;pre&gt;&lt;code&gt;ruby --version
&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;&lt;img src=&quot;./newruby.png&quot; alt=&quot;&quot; /&gt;&lt;/p&gt;
&lt;h3&gt;Install CocoaPods (iOS)&lt;/h3&gt;
&lt;p&gt;更新完 Ruby 後就可以安裝 CocoaPods 了，請再次確認您的 Ruby 已經更新完畢，否則等一下是有可能會安裝失敗的喔！&lt;/p&gt;
&lt;p&gt;首先輸入以下指令安裝 CocoaPods：&lt;/p&gt;
&lt;pre&gt;&lt;code&gt;sudo gem install cocoapods
&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;安裝完成後，請再次在 vim 中打開 &lt;code&gt;~/.zshenv&lt;/code&gt;&lt;/p&gt;
&lt;pre&gt;&lt;code&gt;vim ~/.zshenv
&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;然後按 &lt;code&gt;I&lt;/code&gt; 進入插入模式，然後在檔案尾端加入以下這行&lt;/p&gt;
&lt;pre&gt;&lt;code&gt;export PATH=$HOME/.gem/bin:$PATH
&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;&lt;img src=&quot;./addgempath.png&quot; alt=&quot;&quot; /&gt;&lt;/p&gt;
&lt;p&gt;完成編輯後一樣按一下 &lt;code&gt;Esc&lt;/code&gt;，然後輸入 &lt;code&gt;:wq&lt;/code&gt; 一樣寫入並關閉檔案，並重啟終端機&lt;/p&gt;
&lt;p&gt;最後執行一下 &lt;code&gt;flutter doctor&lt;/code&gt; 指令檢查一下，Xcode 左側出現勾勾即安裝完成
&lt;img src=&quot;./flutterdoctorios.png&quot; alt=&quot;&quot; /&gt;&lt;/p&gt;
&lt;h3&gt;Install Android Studio (Android)&lt;/h3&gt;
&lt;p&gt;首先先前往 &lt;a href=&quot;https://developer.android.com/studio?hl=zh-tw&quot;&gt;Android Developer&lt;/a&gt; 頁面下載：
&lt;img src=&quot;./androidstudiodownload.png&quot; alt=&quot;&quot; /&gt;
接下來同意上述條款及細則，然後下載
&lt;img src=&quot;./androidstudiodownload2.png&quot; alt=&quot;&quot; /&gt;
下載完成後點開安裝檔，將 Android Studio 拖入 Application 資料夾即完成安裝
&lt;img src=&quot;./androidstudioinstall.png&quot; alt=&quot;&quot; /&gt;&lt;/p&gt;
&lt;h3&gt;Install Android Toolchain (Android)&lt;/h3&gt;
&lt;p&gt;首先開啟 Android Studio，然後按下一步：
&lt;img src=&quot;./androidsetup1.png&quot; alt=&quot;&quot; /&gt;
這裡不用動，一樣按下一步
&lt;img src=&quot;./androidsetup2.png&quot; alt=&quot;&quot; /&gt;
&lt;img src=&quot;./androidsetup3.png&quot; alt=&quot;&quot; /&gt;
按一下右下角的 &lt;code&gt;Accept&lt;/code&gt; 後，即可按下 &lt;code&gt;Finished&lt;/code&gt; 開始安裝相關套件
&lt;img src=&quot;./androidsetup4.png&quot; alt=&quot;&quot; /&gt;
成功安裝完成後按下 &lt;code&gt;Finished&lt;/code&gt;
&lt;img src=&quot;./androidsetup5.png&quot; alt=&quot;&quot; /&gt;
出現 Android Studio 視窗後，按下快速鍵 &lt;code&gt;Cmd + ,&lt;/code&gt; 打開設定，前往 Android SDK 管理頁面，勾選 &lt;code&gt;Android SDK Command-line Tools&lt;/code&gt;，然後點 &lt;code&gt;Apply&lt;/code&gt; 安裝
&lt;img src=&quot;./androidcommandline.png&quot; alt=&quot;&quot; /&gt;
安裝完成後即可關閉 Android Studio，在終端機中輸入以下指令同意相關條款&lt;/p&gt;
&lt;pre&gt;&lt;code&gt;flutter doctor --android-licenses
&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;中途狂按 &lt;code&gt;y&lt;/code&gt; 即可，完成後輸入 &lt;code&gt;flutter doctor&lt;/code&gt;，確認 &lt;code&gt;Android toolchain&lt;/code&gt; 左側已打勾即安裝完成
&lt;img src=&quot;./flutterdoctorandroid.png&quot; alt=&quot;&quot; /&gt;&lt;/p&gt;
&lt;h2&gt;Start Development&lt;/h2&gt;
&lt;h3&gt;Create Project&lt;/h3&gt;
&lt;p&gt;首先我們要先建立專案。以往各位在 VSCode 開發時，基本上都會直接使用 Flutter extension 提供的指令功能直接建立專案，很少會直接使用 Flutter 的終端機指令，但是在 Zed 裡，由於缺乏 Flutter extension，我們只能直接使用終端機指令直接建立專案。首先先開啟終端機，切換到你想儲存專案的資料夾，然後輸入以下指令&lt;/p&gt;
&lt;pre&gt;&lt;code&gt;flutter create myapp
&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;&lt;img src=&quot;./createproject.png&quot; alt=&quot;&quot; /&gt;&lt;/p&gt;
&lt;p&gt;專案建立完成之後請切換到專案資料夾下，然後在 Zed 中開啟專案：&lt;/p&gt;
&lt;pre&gt;&lt;code&gt;cd myapp
zed .
&lt;/code&gt;&lt;/pre&gt;
&lt;h3&gt;Install Dart Extension&lt;/h3&gt;
&lt;p&gt;開啟後在左側 dock 打開 &lt;code&gt;lib/main.dart&lt;/code&gt; 即可開始編輯，不過......是不是好像少了什麼東西？
&lt;img src=&quot;./nocolorcode.png&quot; alt=&quot;&quot; /&gt;
沒錯，就是 Dart extension，因為他預設沒有支援 Dart，所以我們需要安裝 Dart extension。首先我們需要按下 &lt;code&gt;Cmd + Shift + P&lt;/code&gt;，然後在彈出的列表中找到 &lt;code&gt;zed: extensions&lt;/code&gt; 按下 &lt;code&gt;Enter&lt;/code&gt;
&lt;img src=&quot;./zedextension.png&quot; alt=&quot;&quot; /&gt;
在 Extensions 頁面中的搜尋中輸入關鍵字即可找到 &lt;code&gt;Dart&lt;/code&gt; 模組，點右側的 &lt;code&gt;Install&lt;/code&gt; 即可安裝
&lt;img src=&quot;./installdart.png&quot; alt=&quot;&quot; /&gt;
安裝完後回到 &lt;code&gt;lib/main.dart&lt;/code&gt; 即可看到目前的程式碼已經有顏色了，並且在 &lt;code&gt;main&lt;/code&gt; 旁邊已經多一個執行的按鈕
&lt;img src=&quot;./colorcode.png&quot; alt=&quot;&quot; /&gt;&lt;/p&gt;
&lt;h3&gt;Run Project&lt;/h3&gt;
&lt;p&gt;點一下 &lt;code&gt;void main&lt;/code&gt; 旁的按鈕會出現一個列表，按下 &lt;code&gt;flutter run&lt;/code&gt; 即可執行專案
&lt;img src=&quot;./runproject.png&quot; alt=&quot;&quot; /&gt;
:::note
第二個選項 fvm 是一個可以管裡多個版本的 Flutter 工具，它除了可以為每個專案設定各自使用的 Flutter SDK 版本，也能讓你非常容易的將專案切到新版本的 Flutter SDK 中進行測試。由於篇幅關係，此工具本文不介紹，有興趣者各位可以參考 &lt;a href=&quot;https://fvm.app/&quot;&gt;fvm 官網&lt;/a&gt;
:::
點擊之後，下方就會出現一個執行視窗，請選擇你要在哪個裝置上執行
&lt;img src=&quot;./flutterrun.png&quot; alt=&quot;&quot; /&gt;
本人在此選擇 macOS，選擇後，程式就成功執行了
&lt;img src=&quot;./runapp.png&quot; alt=&quot;&quot; /&gt;&lt;/p&gt;
&lt;p&gt;:::note
iOS 的話會需要進行修改 &lt;code&gt;Bundle Identifier&lt;/code&gt; 等設定，詳細請參考&lt;a href=&quot;https://docs.flutter.dev/get-started/install/macos/mobile-ios#configure-your-target-ios-device&quot;&gt;官方文件&lt;/a&gt;
:::&lt;/p&gt;
&lt;p&gt;並且在 Zed 中的下方執行視窗中，可以看到你可以執行哪些指令，包括 hot reload、重啟程式、終止等，還有 DevTools 的連結
&lt;img src=&quot;./runcommands.png&quot; alt=&quot;&quot; /&gt;&lt;/p&gt;
&lt;h3&gt;Fluttermon - Auto Reload when File Saved&lt;/h3&gt;
&lt;p&gt;有熱載入其實蠻不錯，只是剛剛在執行時各位應該會發現當你修改完檔案並儲存後，必須切回視窗按一下 &lt;code&gt;r&lt;/code&gt; 進行 hot reload，這其實有點不方便，所以接下來就來補足這缺憾吧！&lt;/p&gt;
&lt;p&gt;首先，我們先輸入以下指令安裝 fluttermon：&lt;/p&gt;
&lt;pre&gt;&lt;code&gt;flutter pub global activate fluttermon
&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;因為我們是第一次安裝並執行從 pub 下載的可執行模組，故我們需要開啟 &lt;code&gt;~/.zshrc&lt;/code&gt;，並在裡面加入這行：&lt;/p&gt;
&lt;pre&gt;&lt;code&gt;export PATH=&quot;$PATH&quot;:&quot;$HOME/.pub-cache/bin&quot;
&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;&lt;img src=&quot;./addpubpath.png&quot; alt=&quot;&quot; /&gt;
修改並儲存後，在 Zed 中重開一個終端機，先確認可執行的裝置：&lt;/p&gt;
&lt;pre&gt;&lt;code&gt;flutter devices
&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;確定好要執行的裝置後，即可輸入以下指令執行 App：&lt;/p&gt;
&lt;pre&gt;&lt;code&gt;fluttermon -d &amp;lt;device-name&amp;gt;
&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;在 App 執行後，回到 &lt;code&gt;lib/main.dart&lt;/code&gt; 檔案，按一下 &lt;code&gt;Cmd + S&lt;/code&gt; 儲存，就可以看到專案自動 hot reload 了！
&lt;img src=&quot;./hotreload.png&quot; alt=&quot;&quot; /&gt;&lt;/p&gt;
&lt;p&gt;只是需要注意一下的是：如果要執行指令的話（例如：&lt;code&gt;R&lt;/code&gt; 重啟程式），需要輸入對應指令字母後，按下 &lt;code&gt;Enter&lt;/code&gt; 才會執行，不會像剛剛按下鍵盤上對應指令字母後就會馬上執行。&lt;/p&gt;
&lt;h3&gt;Code with AI&lt;/h3&gt;
&lt;p&gt;AI 的部分有分三種：聊天、補全、直接改。&lt;/p&gt;
&lt;p&gt;聊天的話在 Zed 中按 &lt;code&gt;Cmd + Shift + P&lt;/code&gt; 開啟指令框，找到 &lt;code&gt;assistant: new chat&lt;/code&gt; 即可開啟聊天框
&lt;img src=&quot;./aichat.png&quot; alt=&quot;&quot; /&gt;
&lt;img src=&quot;./zedchat.png&quot; alt=&quot;&quot; /&gt;&lt;/p&gt;
&lt;p&gt;補全的話是你可以寫部分程式碼，或者寫程式碼註解，AI 會幫你生成程式碼，按 &lt;code&gt;Tab&lt;/code&gt; 即可插入
&lt;img src=&quot;./commentai.png&quot; alt=&quot;&quot; /&gt;&lt;/p&gt;
&lt;p&gt;直接改的部分的話是可以請 AI 直接幫你修改程式碼，如果要使用的話，請選擇你想要修改區域，按下快速鍵 &lt;code&gt;Ctrl + Enter&lt;/code&gt; 即可開啟 inline assistant，然後輸入你想請他改什麼，按下 &lt;code&gt;Enter&lt;/code&gt; 後他就會幫你自動處理：
&lt;img src=&quot;./inlineassistant1.png&quot; alt=&quot;&quot; /&gt;
例如我選了一整個 &lt;code&gt;Scaffold&lt;/code&gt;，然後請他在裡面的 counter 下方加入一個可以顯示現在計數器奇偶的一個 &lt;code&gt;Text&lt;/code&gt;
&lt;img src=&quot;./inlineassistant2.png&quot; alt=&quot;&quot; /&gt;
按下 &lt;code&gt;Enter&lt;/code&gt; 鍵後，他會開始修改，修改過的地方他會用顏色進行標記：
&lt;img src=&quot;./inlineassistant3.png&quot; alt=&quot;&quot; /&gt;
再按下 &lt;code&gt;Enter&lt;/code&gt; 即可接受變更&lt;/p&gt;
&lt;h2&gt;Wrapping Up&lt;/h2&gt;
&lt;p&gt;由此可見 Zed 其實是一款不錯的編輯器，並且使用下來個人也覺得該編輯器真的是非常的順暢，果真是用 Rust 寫的軟體，而且內建 AI 幫助模式除了聊天外，也有註解、寫程式碼的方式，而且直接改的方式也很好的保護了使用者的隱私，讓使用者只提供他想請 AI 處理的部分程式碼，而不是要請 AI 改就是需要讓 AI 看整個檔案。雖然說對於 Flutter 部分，目前 Zed 支援沒有那麼完備，但是畢竟現在還沒有進到 1.0 版，所以個人感覺這一部分其實是可以體諒的，相信在 Zed 未來對 Flutter 支援度更好之後，或許就會有更多人使用這款軟體開發 Flutter 了。&lt;/p&gt;
</content:encoded></item><item><title>GitHubPushWebhookLineBotRust 使用教學</title><link>https://blog.kayxue.dev/posts/githubpushwebhooklinebotrust/</link><guid isPermaLink="true">https://blog.kayxue.dev/posts/githubpushwebhooklinebotrust/</guid><description>如何使用 GitHubPushWebhookLineBotRust 專案將 GitHub 專案的 Push Webhook 推送到 Line。</description><pubDate>Tue, 11 Mar 2025 00:00:00 GMT</pubDate><content:encoded>&lt;p&gt;由於去年上學期的軟體工程課程，我們很多組員都還在用 Line 群組進行討論與溝通，因為組員互相不太認識，並且因為其他組員多為學長姐，所以當初寫了這個的初始版本，讓他們可以更方便追蹤專案程式碼撰寫進度，但後來有一天突然好奇如果使用 Rust 來寫會是怎樣一個體驗，所以自己決定寫一個將初始版本以 Rust 重新撰寫的版本，並結合 GitHub CI 與 Rust 可編譯成 zero-dependency 執行檔的優勢，也順便做出了可直接部署的 Docker Image，除了讓自己未來需要使用時可以使用外，也可以讓需要的人一起使用。
::github{repo=&quot;Kayxue/GitHubPushWebhookLineBotRust&quot;}
如果想要看初始版本的也歡迎，初始版本除了可以部署至 &lt;a href=&quot;https://deno.com/deploy&quot;&gt;Deno Deploy&lt;/a&gt; 外，也可以自行 fork 修改並部署至 Docker，想提 Pull Request 也非常歡迎喔！
::github{repo=&quot;Kayxue/GitHubPushNotificationLineBot&quot;}&lt;/p&gt;
&lt;h2&gt;Run Directly&lt;/h2&gt;
&lt;ol&gt;
&lt;li&gt;安裝 Rust 環境&lt;/li&gt;
&lt;/ol&gt;
&lt;p&gt;https://www.rust-lang.org/zh-TW/tools/install&lt;/p&gt;
&lt;ol&gt;
&lt;li&gt;複製此專案&lt;/li&gt;
&lt;/ol&gt;
&lt;pre&gt;&lt;code&gt;git clone https://github.com/Kayxue/GitHubPushWebhookLineBotRust.git
&lt;/code&gt;&lt;/pre&gt;
&lt;ol&gt;
&lt;li&gt;切換至專案目錄並在 IDE 中開啟&lt;/li&gt;
&lt;/ol&gt;
&lt;pre&gt;&lt;code&gt;cd GitHubPushWebhookLineBotRust
zed .
&lt;/code&gt;&lt;/pre&gt;
&lt;ol&gt;
&lt;li&gt;新增 &lt;code&gt;.env&lt;/code&gt; 檔案，並填入以下內容，&lt;code&gt;&amp;lt;LINE_BOT_ACCESS_TOKEN&amp;gt;&lt;/code&gt; 請替換成你自己的 Line Bot Access Token：&lt;/li&gt;
&lt;/ol&gt;
&lt;pre&gt;&lt;code&gt;ACCESSTOKEN=&amp;lt;LINE_BOT_ACCESS_TOKEN&amp;gt;
&lt;/code&gt;&lt;/pre&gt;
&lt;ol&gt;
&lt;li&gt;執行&lt;/li&gt;
&lt;/ol&gt;
&lt;pre&gt;&lt;code&gt;cargo run
&lt;/code&gt;&lt;/pre&gt;
&lt;ol&gt;
&lt;li&gt;查看終端機輸出，如果沒有任何錯誤，即可進行端口映射或者 Cloudflare Tunnel 等設定 （此 server 監聽之端口：&lt;code&gt;3000&lt;/code&gt;）。&lt;/li&gt;
&lt;/ol&gt;
&lt;h2&gt;Deploy to Docker&lt;/h2&gt;
&lt;h3&gt;Supported CPU Architecture&lt;/h3&gt;
&lt;ul&gt;
&lt;li&gt;&lt;code&gt;linux/amd64&lt;/code&gt;&lt;/li&gt;
&lt;li&gt;&lt;code&gt;linux/arm64&lt;/code&gt;&lt;/li&gt;
&lt;/ul&gt;
&lt;h3&gt;Image&lt;/h3&gt;
&lt;ul&gt;
&lt;li&gt;&lt;code&gt;ghcr.io/kayxue/githubpushwebhooklinebotrust:latest&lt;/code&gt;：一般穩定版本&lt;/li&gt;
&lt;li&gt;&lt;code&gt;ghcr.io/kayxue/githubpushwebhooklinebotrustnightly:xitcanightly&lt;/code&gt;：結合了 Rust 目前尚未完成的 &lt;a href=&quot;https://github.com/rust-lang/rust/issues/95174&quot;&gt;unsized_const_params&lt;/a&gt; feature 製作的版本，由於使用 nightly 分支的 rust toolchain 進行編譯，可能會相對比較不穩定，無法接受者請不要使用版本&lt;/li&gt;
&lt;/ul&gt;
&lt;h3&gt;Deploy&lt;/h3&gt;
&lt;p&gt;請遠端連線至要部署的裝置，並確保已經安裝好 Docker，輸入以下指令即可執行 Docker Image，&lt;code&gt;&amp;lt;container_name&amp;gt;&lt;/code&gt; 請換成你想要的容器名稱，&lt;code&gt;&amp;lt;LINE_BOT_ACCESS_TOKEN&amp;gt;&lt;/code&gt; 請替換成你自己的 Line Bot Access Token：&lt;/p&gt;
&lt;pre&gt;&lt;code&gt;docker run --name &amp;lt;container_name&amp;gt; -p 3000:3000 -e ACCESSTOKEN=&amp;lt;LINE_BOT_ACCESS_TOKEN&amp;gt; --restart=unless-stopped -d ghcr.io/kayxue/githubpushwebhooklinebotrust:latest
&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;:::note
若是使用 Cloudflare Tunnel，則 &lt;code&gt;-p 3000:3000&lt;/code&gt; 參數可省略，設定時直接填入容器 ip 和端口 &lt;code&gt;3000&lt;/code&gt; 即可。若出現 host 端口已經被使用的狀況，請將冒號左側的 &lt;code&gt;3000&lt;/code&gt; 替換成其他可用的端口。
:::
執行成功後會有一串容器 ID，請使用 &lt;code&gt;docker container list&lt;/code&gt; 與 &lt;code&gt;docker container logs &amp;lt;container_id&amp;gt;&lt;/code&gt; 確認容器正常執行後，即可進行端口映射或者 Cloudflare Tunnel 等設定。&lt;/p&gt;
&lt;h2&gt;Add Webhook&lt;/h2&gt;
&lt;p&gt;設定完成後，即可前往需要發送 push notification 的 GitHub 專案頁面，點選 &lt;code&gt;Settings&lt;/code&gt; -&amp;gt; &lt;code&gt;Webhooks&lt;/code&gt; -&amp;gt; &lt;code&gt;Add webhook&lt;/code&gt; 進行新增 Webhook：
&lt;img src=&quot;./addwebhook.png&quot; alt=&quot;&quot; /&gt;
在新增 Webhook 頁面，請依以下填入相關資訊：&lt;/p&gt;
&lt;ol&gt;
&lt;li&gt;&lt;strong&gt;Payload URL&lt;/strong&gt;：&lt;code&gt;&amp;lt;your_server_url&amp;gt;/github&lt;/code&gt;&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Content type&lt;/strong&gt;：&lt;code&gt;application/json&lt;/code&gt;&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;SSL verification&lt;/strong&gt;：請選 &lt;code&gt;Disable&lt;/code&gt;&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Which event would you like to trigger this webhook?&lt;/strong&gt;：請選 &lt;code&gt;Just the push event&lt;/code&gt;
&lt;img src=&quot;./addwebhookpage.png&quot; alt=&quot;&quot; /&gt;&lt;/li&gt;
&lt;/ol&gt;
&lt;p&gt;確定填入資料皆正確後，即可按下下方 &lt;code&gt;Add webhook&lt;/code&gt; 新增 Webhook，確認你剛剛新增的 Webhook 是否成功。
&lt;img src=&quot;./checkwebhook.png&quot; alt=&quot;&quot; /&gt;&lt;/p&gt;
&lt;p&gt;成功之後就可以開始修改你的專案，並且在每一次發生 push 時，都會收到 Line Bot 的通知。
&lt;img src=&quot;./notification.jpg&quot; alt=&quot;&quot; /&gt;&lt;/p&gt;
&lt;h2&gt;Contribution&lt;/h2&gt;
&lt;p&gt;此專案歡迎各位進行貢獻，使專案更加完整，貢獻專案時請遵守 &lt;a href=&quot;https://www.rust-lang.org/policies/code-of-conduct&quot;&gt;Code of Conduct&lt;/a&gt;。&lt;/p&gt;
</content:encoded></item><item><title>Flutter App 2 - Landrop App Interface Imitation</title><link>https://blog.kayxue.dev/posts/flutterapp2/</link><guid isPermaLink="true">https://blog.kayxue.dev/posts/flutterapp2/</guid><description>學習使用 Flutter 模仿 Landrop App 介面</description><pubDate>Mon, 10 Mar 2025 00:00:00 GMT</pubDate><content:encoded>&lt;p&gt;這次的話是第二次的 Flutter 課程作業，作業可以兩個挑一個，一個是打造吸睛的 about 頁面，一個是模仿上架的 App，個人因為 about page 不知道要做什麼，而且本人有 Windows 電腦，所以一直都要面對需要將 iPhone 檔案傳至 Windows 電腦的狀況，後來遇到了一個 Youtuber 推薦了 Landrop App，讓使用者可以輕鬆跨平台傳送檔案，個人用了也覺得非常不錯，所以這次作業就決定模仿一下 Landrop App 的介面。&lt;/p&gt;
&lt;p&gt;而這次的作業雖然是只要一個頁面就好，但......因為作業規定必須使用的 widget 中有一個 widget 在僅模仿一個 page 的狀況下無法做到，故這次基本上把三個 tab 量的 page 全部刻了。&lt;/p&gt;
&lt;h2&gt;Original App Interface&lt;/h2&gt;
&lt;p&gt;&lt;img src=&quot;./originalapp/1.png&quot; alt=&quot;&quot; /&gt;
&lt;img src=&quot;./originalapp/2.png&quot; alt=&quot;&quot; /&gt;
&lt;img src=&quot;./originalapp/3.png&quot; alt=&quot;&quot; /&gt;&lt;/p&gt;
&lt;h2&gt;My App Interface&lt;/h2&gt;
&lt;h3&gt;iOS (Device: iPhone 12 Pro Max)&lt;/h3&gt;
&lt;p&gt;&lt;img src=&quot;./myapp/1.png&quot; alt=&quot;&quot; /&gt;
&lt;img src=&quot;./myapp/2.png&quot; alt=&quot;&quot; /&gt;
&lt;img src=&quot;./myapp/3.png&quot; alt=&quot;&quot; /&gt;&lt;/p&gt;
&lt;h3&gt;Android (Device: Sony Xperia XZ2 Premium, Lineage OS 21)&lt;/h3&gt;
&lt;p&gt;&lt;img src=&quot;./myappandroid/1.png&quot; alt=&quot;&quot; /&gt;
&lt;img src=&quot;./myappandroid/2.png&quot; alt=&quot;&quot; /&gt;
&lt;img src=&quot;./myappandroid/3.png&quot; alt=&quot;&quot; /&gt;&lt;/p&gt;
&lt;h2&gt;Directory Structure&lt;/h2&gt;
&lt;p&gt;首先來看這次資料夾結構的部分，因為這次元件量其實是不少的，所以這次只好在目前上課還沒教到的狀況下，直接開始對所有的專案檔案進行分類存放。資料夾分類如下：&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;&lt;code&gt;Components&lt;/code&gt;：放置小型元件 (e.g. Circle IconButton, ListTile Card)&lt;/li&gt;
&lt;li&gt;&lt;code&gt;Pages&lt;/code&gt;：放置頁面 (那些真正完整的頁面)&lt;/li&gt;
&lt;li&gt;&lt;code&gt;Types&lt;/code&gt;：放置類型 (e.g. custom enumerations)&lt;/li&gt;
&lt;li&gt;&lt;code&gt;Widgets&lt;/code&gt;：放置頁面上部分體積較大的 widget
&lt;img src=&quot;./Directory.png&quot; alt=&quot;Directory Structure m-auto&quot; /&gt;&lt;/li&gt;
&lt;/ul&gt;
&lt;h2&gt;Code Explanation&lt;/h2&gt;
&lt;p&gt;:::note
以下 &lt;code&gt;collapsed lines&lt;/code&gt; 請不用展開，程式碼部分稍後全部都會進行解析，折疊部分之所以摺疊起來是希望各位在閱讀時可以先專注於特定部分，而不是與分析無關或重複的部分。
:::&lt;/p&gt;
&lt;h3&gt;Base&lt;/h3&gt;
&lt;p&gt;首先是基底的部分，我們要先建立 App 的根 Widget：&lt;/p&gt;
&lt;pre&gt;&lt;code&gt;import &apos;package:flutter/material.dart&apos;;
import &apos;Pages/FilesPage.dart&apos;;
import &apos;Pages/HomePage.dart&apos;;
import &apos;Pages/SettingsPage.dart&apos;;

void main() {
  runApp(const MyApp());
}

class MyApp extends StatelessWidget {
  const MyApp({super.key});

  // This widget is the root of your application.
  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      debugShowCheckedModeBanner: false,
      title: &apos;LanDrop&apos;,
      theme: ThemeData(
        useMaterial3: true,
        colorScheme: ColorScheme.fromSeed(seedColor: Colors.blue),
        menuTheme: const MenuThemeData(
          style: MenuStyle(
            shape: WidgetStatePropertyAll(
              RoundedRectangleBorder(
                borderRadius: BorderRadius.all(Radius.circular(10)),
              ),
            ),
            backgroundColor: WidgetStatePropertyAll(Colors.white),
          ),
        ),
      ),
      home: const NavigationWidget(),
    );
  }
}

class NavigationWidget extends StatefulWidget {
  const NavigationWidget({super.key});

  @override
  State&amp;lt;NavigationWidget&amp;gt; createState() =&amp;gt; _NavigationWidgetState();
}

class _NavigationWidgetState extends State&amp;lt;NavigationWidget&amp;gt; {
  int currentPageIndex = 0;

  @override
  Widget build(BuildContext context) {
    return Scaffold(
      bottomNavigationBar: NavigationBar(
        onDestinationSelected: (int index) {
          setState(() {
            currentPageIndex = index;
          });
        },
        indicatorColor: Colors.lightBlueAccent.shade100,
        selectedIndex: currentPageIndex,
        destinations: const &amp;lt;Widget&amp;gt;[
          NavigationDestination(
            selectedIcon: Icon(Icons.home),
            icon: Icon(Icons.home_outlined),
            label: &apos;Home&apos;,
          ),
          NavigationDestination(
            selectedIcon: Icon(Icons.folder),
            icon: Icon(Icons.folder_outlined),
            label: &apos;Files&apos;,
          ),
          NavigationDestination(
            selectedIcon: Icon(Icons.settings),
            icon: Icon(Icons.settings_outlined),
            label: &apos;Settings&apos;,
          ),
        ],
      ),
      body: SafeArea(
        child:
            &amp;lt;Widget&amp;gt;[
              const HomePage(),
              const FilesPage(),
              const SettingsPage(),
            ][currentPageIndex],
      ),
    );
  }
}
&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;注意第 &lt;code&gt;17&lt;/code&gt; 行，該行可以在 App 處於 debug 模式下，關閉畫面右上角的 debug 標籤。&lt;/p&gt;
&lt;p&gt;其餘部分的話就是設定主題，例如顏色、標題等。&lt;/p&gt;
&lt;h3&gt;AppBar &amp;amp; PageView&lt;/h3&gt;
&lt;p&gt;再來就是底部的 AppBar。&lt;/p&gt;
&lt;pre&gt;&lt;code&gt;import &apos;package:flutter/material.dart&apos;;
import &apos;Pages/FilesPage.dart&apos;;
import &apos;Pages/HomePage.dart&apos;;
import &apos;Pages/SettingsPage.dart&apos;;

void main() {
  runApp(const MyApp());
}

class MyApp extends StatelessWidget {
  const MyApp({super.key});

  // This widget is the root of your application.
  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      debugShowCheckedModeBanner: false,
      title: &apos;LanDrop&apos;,
      theme: ThemeData(
        useMaterial3: true,
        colorScheme: ColorScheme.fromSeed(seedColor: Colors.blue),
        menuTheme: const MenuThemeData(
          style: MenuStyle(
            shape: WidgetStatePropertyAll(
              RoundedRectangleBorder(
                borderRadius: BorderRadius.all(Radius.circular(10)),
              ),
            ),
            backgroundColor: WidgetStatePropertyAll(Colors.white),
          ),
        ),
      ),
      home: const NavigationWidget(),
    );
  }
}

class NavigationWidget extends StatefulWidget {
  const NavigationWidget({super.key});

  @override
  State&amp;lt;NavigationWidget&amp;gt; createState() =&amp;gt; _NavigationWidgetState();
}

class _NavigationWidgetState extends State&amp;lt;NavigationWidget&amp;gt; {
  int currentPageIndex = 0;

  @override
  Widget build(BuildContext context) {
    return Scaffold(
      bottomNavigationBar: NavigationBar(
        onDestinationSelected: (int index) {
          setState(() {
            currentPageIndex = index;
          });
        },
        indicatorColor: Colors.lightBlueAccent.shade100,
        selectedIndex: currentPageIndex,
        destinations: const &amp;lt;Widget&amp;gt;[
          NavigationDestination(
            selectedIcon: Icon(Icons.home),
            icon: Icon(Icons.home_outlined),
            label: &apos;Home&apos;,
          ),
          NavigationDestination(
            selectedIcon: Icon(Icons.folder),
            icon: Icon(Icons.folder_outlined),
            label: &apos;Files&apos;,
          ),
          NavigationDestination(
            selectedIcon: Icon(Icons.settings),
            icon: Icon(Icons.settings_outlined),
            label: &apos;Settings&apos;,
          ),
        ],
      ),
      body: SafeArea(
        child:
            &amp;lt;Widget&amp;gt;[
              const HomePage(),
              const FilesPage(),
              const SettingsPage(),
            ][currentPageIndex],
      ),
    );
  }
}
&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;:::note[解析]&lt;/p&gt;
&lt;ol&gt;
&lt;li&gt;因為需要記錄目前所在的頁面，所以其必須為 &lt;code&gt;StatefulWidget&lt;/code&gt;。&lt;/li&gt;
&lt;li&gt;接下來就是透過 &lt;code&gt;Scaffold&lt;/code&gt; 的 &lt;code&gt;bottomNavigationBar&lt;/code&gt; 屬性，在頁面中加入 AppBar，AppBar 部分使用 &lt;code&gt;NavigationBar&lt;/code&gt; widget 建立。&lt;/li&gt;
&lt;li&gt;在 &lt;code&gt;52~56&lt;/code&gt; 行的部分是設定當使用者點選 bar 上的按鈕時，會切換頁面。&lt;/li&gt;
&lt;li&gt;而 &lt;code&gt;59~75&lt;/code&gt; 的部分是設定在 &lt;code&gt;NavigationBar&lt;/code&gt; 上會顯示的頁面切換按鈕。&lt;/li&gt;
&lt;li&gt;最後 &lt;code&gt;77~84&lt;/code&gt; 是設定顯示頁面主體，這裡透過 &lt;code&gt;SafeArea&lt;/code&gt; widget 包裝，確保頁面內容不會被系統元件遮擋。然後透過 &lt;code&gt;currentPageIndex&lt;/code&gt; 來決定顯示哪個頁面。
:::&lt;/li&gt;
&lt;/ol&gt;
&lt;h3&gt;Home&lt;/h3&gt;
&lt;p&gt;首頁頁面的部分，位於 &lt;code&gt;Pages/HomePage.dart&lt;/code&gt;&lt;/p&gt;
&lt;pre&gt;&lt;code&gt;import &apos;package:flutter/material.dart&apos;;

import &apos;../Widgets/Home/TopBar.dart&apos;;
import &apos;../Widgets/Home/Devices.dart&apos;;
import &apos;../Widgets/Home/NearbyDevices.dart&apos;;
import &apos;../Widgets/Home/Send.dart&apos;;
import &apos;../Widgets/Home/Transfers.dart&apos;;

class HomePage extends StatelessWidget {
  const HomePage({super.key});

  @override
  Widget build(BuildContext context) {
    return Padding(
      padding: const EdgeInsets.only(left: 30.0, right: 30.0),
      child: Column(
        children: [
          Topbar(),
          Expanded(
            child: SingleChildScrollView(
              child: Column(
                children: [Send(), Devices(), NearbyDevices(), Transfers()],
              ),
            ),
          ),
        ],
      ),
    );
  }
}
&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;:::note[解析]&lt;/p&gt;
&lt;ol&gt;
&lt;li&gt;設定與螢幕邊界的距離。&lt;/li&gt;
&lt;li&gt;使用 &lt;code&gt;SingleChildScrollView&lt;/code&gt; 包裝，使其子 widget 可以滾動。&lt;strong&gt;請注意外部必須有 Expanded widget 包裝，否則無法正常顯示。&lt;/strong&gt;
:::
接下來就是各個 Widget，全數皆在 &lt;code&gt;Widgets/Home&lt;/code&gt; 資料夾中。&lt;/li&gt;
&lt;/ol&gt;
&lt;p&gt;首先是 TopBar 部分，用於顯示 TopBar 區塊的版面。&lt;/p&gt;
&lt;pre&gt;&lt;code&gt;import &apos;package:device_friendly_name/device_friendly_name.dart&apos;;
import &apos;package:flutter/material.dart&apos;;

class Topbar extends StatefulWidget {
  const Topbar({super.key});

  @override
  State&amp;lt;Topbar&amp;gt; createState() =&amp;gt; _TopbarState();
}

class _TopbarState extends State&amp;lt;Topbar&amp;gt; {
  Future&amp;lt;String&amp;gt; _getDeviceName() async {
    final String deviceName =
        await DeviceFriendlyName().getDeviceFriendlyName() ?? &quot;User&quot;;
    return deviceName;
  }

  bool discoverTurnedOn = true;

  @override
  Widget build(BuildContext context) {
    return Padding(
      padding: const EdgeInsets.only(top: 20.0),
      child: Row(
        mainAxisAlignment: MainAxisAlignment.spaceBetween,
        children: [
          FutureBuilder(
            future: _getDeviceName(),
            builder: (context, snapshot) {
              if (snapshot.hasData) {
                return SizedBox(
                  width: MediaQuery.of(context).size.width * 0.6,
                  child: Text(
                    &quot;Hello ${snapshot.data} 👋&quot;,
                    style: TextStyle(fontSize: 24),
                    overflow: TextOverflow.ellipsis,
                    maxLines: 1,
                    softWrap: false,
                  ),
                );
              }
              return Text(&quot;Hello, User 👋&quot;, style: TextStyle(fontSize: 24));
            },
          ),
          IconButton(
            icon: Icon(
              discoverTurnedOn
                  ? Icons.wifi_tethering
                  : Icons.wifi_tethering_off,
            ),
            onPressed: () {
              setState(() {
                discoverTurnedOn = !discoverTurnedOn;
              });
            },
          ),
        ],
      ),
    );
  }
}
&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;因為 &lt;code&gt;device_friendly_name&lt;/code&gt; 模組需要透過非同步的方式去抓取裝置名稱，故需要使用 &lt;code&gt;StatefulWidget&lt;/code&gt; 和 &lt;code&gt;FutureBuilder&lt;/code&gt;，透過非同步的方式，將裝置名稱顯示在畫面上，且由於避免裝置名稱過長造成 widget 溢出，故顯示裝置名稱的 widget 需要使用 &lt;code&gt;SizedBox&lt;/code&gt; 包起來，並指定當長度超過螢幕寬度的 60% 時將內容自動截斷。間隔部分只設定頂部間隔，因為左右已經在 &lt;code&gt;HomePage&lt;/code&gt; 中設定。&lt;/p&gt;
&lt;p&gt;其次是 Send 部分，用於顯示 Send 區塊的版面。&lt;/p&gt;
&lt;pre&gt;&lt;code&gt;import &apos;package:flutter/material.dart&apos;;
import &apos;../../Components/CircleButton.dart&apos;;

class Send extends StatelessWidget {
  const Send({super.key});

  @override
  Widget build(BuildContext context) {
    return Padding(
      padding: const EdgeInsets.only(top: 30.0),
      child: Column(
        crossAxisAlignment: CrossAxisAlignment.start,
        children: [
          Text(
            &quot;Send&quot;,
            style: TextStyle(fontSize: 14, color: Colors.grey.shade600),
          ),
          SizedBox(height: 20),
          Row(
            mainAxisAlignment: MainAxisAlignment.spaceAround,
            children: [
              CircleButton(
                backgroundColor: Colors.tealAccent,
                iconColor: Colors.teal,
                icon: Icons.description_outlined,
                text: &quot;Files&quot;,
              ),
              CircleButton(
                backgroundColor: Colors.blueAccent,
                iconColor: Colors.blue,
                icon: Icons.photo_outlined,
                text: &quot;Photos&quot;,
              ),
              CircleButton(
                backgroundColor: Colors.pinkAccent,
                iconColor: Colors.pink,
                icon: Icons.article_outlined,
                text: &quot;Text&quot;,
              ),
              CircleButton(
                backgroundColor: Colors.purpleAccent,
                iconColor: Colors.purple,
                icon: Icons.topic_outlined,
                text: &quot;Folder&quot;,
              ),
            ],
          ),
        ],
      ),
    );
  }
}
&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;按鈕的部分是採用 &lt;code&gt;Row&lt;/code&gt; 來進行排版，而中間間隔的部分則交由 &lt;code&gt;Row&lt;/code&gt; 自行去計算，讓按鈕間隔在不同裝置上看起來都舒適，&lt;code&gt;CircleButton&lt;/code&gt; 為 custom component，稍後會展示。&lt;/p&gt;
&lt;p&gt;其次是 Devices 部分，用於顯示 Devices 區塊的版面。&lt;/p&gt;
&lt;pre&gt;&lt;code&gt;import &apos;package:flutter/material.dart&apos;;

import &apos;../../Components/CircleButton.dart&apos;;

class Devices extends StatelessWidget {
  const Devices({super.key});

  @override
  Widget build(BuildContext context) {
    return Padding(
      padding: const EdgeInsets.only(top: 30.0),
      child: Column(
        crossAxisAlignment: CrossAxisAlignment.start,
        children: [
          Row(
            mainAxisAlignment: MainAxisAlignment.spaceBetween,
            children: [
              Text(
                &quot;Devices&quot;,
                style: TextStyle(fontSize: 14, color: Colors.grey.shade600),
              ),
              MenuAnchor(
                menuChildren: &amp;lt;Widget&amp;gt;[
                  MenuItemButton(
                    leadingIcon: Icon(Icons.public),
                    onPressed: () {},
                    child: Text(&quot;Add via IP &amp;amp; Port&quot;),
                  ),
                ],
                builder: (context, controller, child) {
                  return IconButton(
                    onPressed: () {
                      if (controller.isOpen) {
                        controller.close();
                      } else {
                        controller.open();
                      }
                    },
                    icon: Icon(Icons.add),
                  );
                },
              ),
            ],
          ),
          SizedBox(height: 5),
          Row(
            crossAxisAlignment: CrossAxisAlignment.start,
            children: [
              CircleButton(
                backgroundColor: Colors.amberAccent,
                iconColor: Colors.amber,
                icon: Icons.computer_outlined,
                text: &quot;Aaron&apos;s MacBook&quot;,
              ),
              SizedBox(width: 20),
              CircleButton(
                backgroundColor: Colors.blueAccent,
                iconColor: Colors.blue,
                icon: Icons.phone_iphone_outlined,
                text: &quot;iPhone&quot;,
              ),
            ],
          ),
        ],
      ),
    );
  }
}
&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;因為按鈕與文字所在位置分別為頭和尾，故可以維持使用 &lt;code&gt;Row&lt;/code&gt; 佈局，以達到更好的版面效果。而 &lt;code&gt;MenuAnchor&lt;/code&gt; 的部分是下拉式選單，因為有設定偏好 Material 3 的風格，所以使用 &lt;code&gt;MenuAnchor&lt;/code&gt;。而關於外觀的部分則已經在 &lt;code&gt;main.dart&lt;/code&gt; 中設定：&lt;/p&gt;
&lt;pre&gt;&lt;code&gt;import &apos;package:flutter/material.dart&apos;;
import &apos;Pages/FilesPage.dart&apos;;
import &apos;Pages/HomePage.dart&apos;;
import &apos;Pages/SettingsPage.dart&apos;;

void main() {
  runApp(const MyApp());
}

class MyApp extends StatelessWidget {
  const MyApp({super.key});

  // This widget is the root of your application.
  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      debugShowCheckedModeBanner: false,
      title: &apos;LanDrop&apos;,
      theme: ThemeData(
        useMaterial3: true,
        colorScheme: ColorScheme.fromSeed(seedColor: Colors.blue),
        menuTheme: const MenuThemeData(
          style: MenuStyle(
            shape: WidgetStatePropertyAll(
              RoundedRectangleBorder(
                borderRadius: BorderRadius.all(Radius.circular(10)),
              ),
            ),
            backgroundColor: WidgetStatePropertyAll(Colors.white),
          ),
        ),
      ),
      home: const NavigationWidget(),
    );
  }
}

class NavigationWidget extends StatefulWidget {
  const NavigationWidget({super.key});

  @override
  State&amp;lt;NavigationWidget&amp;gt; createState() =&amp;gt; _NavigationWidgetState();
}

class _NavigationWidgetState extends State&amp;lt;NavigationWidget&amp;gt; {
  int currentPageIndex = 0;

  @override
  Widget build(BuildContext context) {
    return Scaffold(
      bottomNavigationBar: NavigationBar(
        onDestinationSelected: (int index) {
          setState(() {
            currentPageIndex = index;
          });
        },
        indicatorColor: Colors.lightBlueAccent.shade100,
        selectedIndex: currentPageIndex,
        destinations: const &amp;lt;Widget&amp;gt;[
          NavigationDestination(
            selectedIcon: Icon(Icons.home),
            icon: Icon(Icons.home_outlined),
            label: &apos;Home&apos;,
          ),
          NavigationDestination(
            selectedIcon: Icon(Icons.folder),
            icon: Icon(Icons.folder_outlined),
            label: &apos;Files&apos;,
          ),
          NavigationDestination(
            selectedIcon: Icon(Icons.settings),
            icon: Icon(Icons.settings_outlined),
            label: &apos;Settings&apos;,
          ),
        ],
      ),
      body: SafeArea(
        child:
            &amp;lt;Widget&amp;gt;[
              const HomePage(),
              const FilesPage(),
              const SettingsPage(),
            ][currentPageIndex],
      ),
    );
  }
}
&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;其次是 NearbyDevices 部分，用於顯示 NearbyDevices 區塊的版面。&lt;/p&gt;
&lt;pre&gt;&lt;code&gt;import &apos;package:flutter/material.dart&apos;;
import &apos;package:landroppage/Widgets/Home/ModalBottomSheet.dart&apos;;

import &apos;../../Components/CircleButton.dart&apos;;

class NearbyDevices extends StatelessWidget {
  const NearbyDevices({super.key});

  @override
  Widget build(BuildContext context) {
    return Padding(
      padding: const EdgeInsets.only(top: 10.0),
      child: Column(
        crossAxisAlignment: CrossAxisAlignment.start,
        children: [
          Row(
            mainAxisAlignment: MainAxisAlignment.start,
            children: [
              Text(
                &quot;Nearby Devices&quot;,
                style: TextStyle(fontSize: 14, color: Colors.grey.shade600),
              ),
              Transform.scale(
                scale: 0.7,
                child: IconButton(
                  onPressed: () {
                    showModalBottomSheet(
                      context: context,
                      builder: (BuildContext content) {
                        return ModalBottomSheet();
                      },
                    );
                  },
                  icon: Icon(Icons.chevron_right),
                ),
              ),
              Badge(
                label: Text(&quot;BETA&quot;),
                backgroundColor: Colors.blueAccent,
                textColor: Colors.white,
                padding: EdgeInsets.symmetric(horizontal: 8),
              ),
            ],
          ),
          SizedBox(height: 5),
          Row(
            crossAxisAlignment: CrossAxisAlignment.start,
            children: [
              CircleButton(
                backgroundColor: Colors.redAccent,
                iconColor: Colors.red,
                icon: Icons.phone_android_outlined,
                text: &quot;Phone&quot;,
              ),
              SizedBox(width: 20),
              CircleButton(
                backgroundColor: Colors.greenAccent,
                iconColor: Colors.green,
                icon: Icons.tablet_android_outlined,
                text: &quot;Tablet&quot;,
              ),
            ],
          ),
        ],
      ),
    );
  }
}
&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;:::note[解析]&lt;/p&gt;
&lt;ol&gt;
&lt;li&gt;&lt;code&gt;26~33&lt;/code&gt; 行：在使用者按下按鈕後，會從畫面底部彈出一個 dialog，顯示關於該功能的一些資訊。&lt;/li&gt;
&lt;li&gt;&lt;code&gt;30&lt;/code&gt; 行的 &lt;code&gt;ModalBottomSheet&lt;/code&gt; 稍後會展示
:::
再來是 Transfers 部分，用於顯示 Transfers 區塊的版面。&lt;/li&gt;
&lt;/ol&gt;
&lt;pre&gt;&lt;code&gt;import &apos;package:flutter/material.dart&apos;;

import &apos;../../Components/TransferItem.dart&apos;;
import &apos;../../Types/TransferStatus.dart&apos;;

class Transfers extends StatelessWidget {
  const Transfers({super.key});

  @override
  Widget build(BuildContext context) {
    return Padding(
      padding: const EdgeInsets.only(top: 20.0, bottom: 20),
      child: Column(
        crossAxisAlignment: CrossAxisAlignment.start,
        children: [
          Row(
            mainAxisAlignment: MainAxisAlignment.start,
            children: [
              Text(
                &quot;Transfers&quot;,
                style: TextStyle(fontSize: 14, color: Colors.grey.shade600),
              ),
            ],
          ),
          SizedBox(height: 20),
          ListView(
            shrinkWrap: true,
            physics: NeverScrollableScrollPhysics(),
            children: [
              TransferItem(
                name: &quot;IMG_5868.jpeg&quot;,
                size: &quot;111.55KB&quot;,
                status: TransferStatus.Done,
                code: &quot;947839&quot;,
                device: &quot;iPhone&quot;,
                progress: 100,
              ),
              TransferItem(
                name: &quot;IMG_5869.jpeg&quot;,
                size: &quot;123.45MB&quot;,
                status: TransferStatus.InProgress,
                code: &quot;123456&quot;,
                device: &quot;Aaron&apos;s Macbook&quot;,
                progress: 55,
              ),
              TransferItem(
                name: &quot;ubuntu-24.04-arm.iso&quot;,
                size: &quot;1.5GB&quot;,
                status: TransferStatus.Failed,
                code: &quot;123456&quot;,
                device: &quot;Aaron&apos;s Macbook&quot;,
                progress: 55,
              ),
              TransferItem(
                name: &quot;Homework.docx&quot;,
                size: &quot;456MB&quot;,
                status: TransferStatus.Done,
                code: &quot;947839&quot;,
                device: &quot;iPhone&quot;,
                progress: 100,
              ),
              TransferItem(
                name: &quot;IMG_5890.png&quot;,
                size: &quot;429.23MB&quot;,
                status: TransferStatus.Pending,
                code: &quot;123456&quot;,
                device: &quot;Aaron&apos;s Macbook&quot;,
                progress: 55,
              ),
              TransferItem(
                name: &quot;Report.ppt&quot;,
                size: &quot;372MB&quot;,
                status: TransferStatus.InProgress,
                code: &quot;947839&quot;,
                device: &quot;iPhone&quot;,
                progress: 40,
              ),
            ],
          ),
        ],
      ),
    );
  }
}
&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;:::note[解析]&lt;/p&gt;
&lt;ol&gt;
&lt;li&gt;&lt;code&gt;12&lt;/code&gt; 行的 &lt;code&gt;bottom&lt;/code&gt; 部分是使畫面完全滑到底時，底部可以稍微留白，讓使用者看起來更舒服。&lt;/li&gt;
&lt;li&gt;&lt;code&gt;28&lt;/code&gt; 行的 &lt;code&gt;NeverScrollableScrollPhysics()&lt;/code&gt; 是讓 &lt;code&gt;ListView&lt;/code&gt; 不可滾動，因為在 parent widget 中已經在外層套了 &lt;code&gt;SingleChildScrollView&lt;/code&gt;，這裡得設定不能滾動。
:::
最後是 ModalBottomSheet，用於在點擊 Nearby Device 旁邊按鈕時，可以顯示關於此功能的底部 Dialog&lt;/li&gt;
&lt;/ol&gt;
&lt;pre&gt;&lt;code&gt;import &apos;package:flutter/material.dart&apos;;

class ModalBottomSheet extends StatelessWidget {
  const ModalBottomSheet({super.key});

  @override
  Widget build(BuildContext context) {
    return SizedBox(
      height: 220,
      child: Padding(
        padding: EdgeInsets.only(top: 20, left: 30, right: 30, bottom: 20),
        child: Column(
          mainAxisAlignment: MainAxisAlignment.start,
          children: [
            Row(
              mainAxisAlignment: MainAxisAlignment.start,
              children: [
                Text(&quot;Nearby Devices&quot;, style: TextStyle(fontSize: 24)),
                SizedBox(width: 10),
                Badge(
                  label: Text(&quot;BETA&quot;),
                  backgroundColor: Colors.blueAccent,
                  textColor: Colors.white,
                  padding: EdgeInsets.symmetric(horizontal: 8),
                ),
              ],
            ),
            SizedBox(height: 20),
            Expanded(
              child: Text(
                &quot;You can now send files to nearby devices, even if you&apos;re not connected to the same Wi-Fi network.&quot;,
                style: TextStyle(
                  fontSize: 14,
                  color: Colors.grey.shade600,
                  fontWeight: FontWeight.w600,
                ),
              ),
            ),
            Expanded(
              child: Text(
                &quot;Heads up: If you&apos;re not connected to any Wi-Fi network and are using cellular data, be mindful of potential data charges.&quot;,
                style: TextStyle(fontSize: 12, color: Colors.grey.shade600),
              ),
            ),
          ],
        ),
      ),
    );
  }
}
&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;:::note[解析]
因為要讓內容文字不會溢出，所以在內容文字部分外層需要加上 &lt;code&gt;Expanded&lt;/code&gt; 讓文字可以自動換行顯示。
:::&lt;/p&gt;
&lt;h3&gt;Files&lt;/h3&gt;
&lt;p&gt;檔案頁面的部分，位於 &lt;code&gt;Pages/FilesPage.dart&lt;/code&gt;。&lt;/p&gt;
&lt;p&gt;由於整個不複雜，故沒有將 widget 拆成不同檔案。&lt;/p&gt;
&lt;pre&gt;&lt;code&gt;import &apos;package:flutter/material.dart&apos;;

import &apos;../Components/FileItem.dart&apos;;

class FilesPage extends StatelessWidget {
  const FilesPage({super.key});

  @override
  Widget build(BuildContext context) {
    return Padding(
      padding: const EdgeInsets.only(left: 36.0, right: 36.0),
      child: Column(
        children: [
          const Padding(
            padding: EdgeInsets.only(top: 20.0),
            child: Row(
              mainAxisAlignment: MainAxisAlignment.spaceBetween,
              children: [Text(&quot;Files&quot;, style: TextStyle(fontSize: 24))],
            ),
          ),
          Padding(
            padding: const EdgeInsets.only(top: 25),
            child: Stack(
              alignment: Alignment.center,
              children: [
                Align(
                  alignment: Alignment.center,
                  child: Row(
                    mainAxisSize: MainAxisSize.min,
                    children: const [
                      Icon(Icons.folder_rounded, color: Colors.amber, size: 20),
                      SizedBox(width: 5),
                      Text(&quot;Documents&quot;, style: TextStyle(fontSize: 18)),
                    ],
                  ),
                ),
                Positioned(
                  right: 28,
                  child: MenuAnchor(
                    menuChildren: &amp;lt;Widget&amp;gt;[
                      MenuItemButton(
                        leadingIcon: const Icon(
                          Icons.delete_outline_rounded,
                          color: Colors.red,
                        ),
                        onPressed: () {},
                        child: const Text(
                          &quot;Delete All Files&quot;,
                          style: TextStyle(color: Colors.red),
                        ),
                      ),
                    ],
                    builder: (context, controller, child) {
                      return IconButton(
                        icon: const Icon(Icons.more_horiz_rounded),
                        onPressed: () {
                          if (controller.isOpen) {
                            controller.close();
                          } else {
                            controller.open();
                          }
                        },
                      );
                    },
                  ),
                ),
              ],
            ),
          ),
          Expanded(
            child: ListView(
              padding: const EdgeInsets.only(top: 20, bottom: 20),
              children: [
                FileItem(
                  name: &quot;IMG_5868.jpeg&quot;,
                  size: &quot;111.55KB&quot;,
                  time: DateTime.parse(&quot;2025-03-05T17:22:41+08:00&quot;),
                ),
                FileItem(
                  name: &quot;Homework.docs&quot;,
                  size: &quot;456MB&quot;,
                  time: DateTime.parse(&quot;2025-03-04T09:22:41+08:00&quot;),
                ),
                FileItem(
                  name: &quot;Windows11.iso&quot;,
                  size: &quot;5.4GB&quot;,
                  time: DateTime.parse(&quot;2025-03-02T09:56:41+08:00&quot;),
                ),
                FileItem(
                  name: &quot;IMG_5867.jpeg&quot;,
                  size: &quot;12MB&quot;,
                  time: DateTime.parse(&quot;2025-02-26T09:00:03+08:00&quot;),
                ),
                FileItem(
                  name: &quot;Fortuna for Tuna.zip&quot;,
                  size: &quot;5.4MB&quot;,
                  time: DateTime.parse(&quot;2025-02-23T16:08:47+08:00&quot;),
                ),
                FileItem(
                  name: &quot;Cutter.rar&quot;,
                  size: &quot;2.5MB&quot;,
                  time: DateTime.parse(&quot;2025-01-31T20:34:26+08:00&quot;),
                ),
                FileItem(
                  name: &quot;Programming Language.zip&quot;,
                  size: &quot;1GB&quot;,
                  time: DateTime.parse(&quot;2024-12-31T15:00:26+08:00&quot;),
                ),
                FileItem(
                  name: &quot;zed-darwin.dmg&quot;,
                  size: &quot;328.03MB&quot;,
                  time: DateTime.parse(&quot;2024-12-17T09:36:13+08:00&quot;),
                ),
                FileItem(
                  name: &quot;vscodium-Mac-arm64.dmg&quot;,
                  size: &quot;147.03MB&quot;,
                  time: DateTime.parse(&quot;2024-12-13T22:16:47+08:00&quot;),
                ),
                FileItem(
                  name: &quot;clop-apple-arm.dmg&quot;,
                  size: &quot;326.93MB&quot;,
                  time: DateTime.parse(&quot;2024-12-09T17:08:15+08:00&quot;),
                ),
              ],
            ),
          ),
        ],
      ),
    );
  }
}
&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;:::note[解析]&lt;/p&gt;
&lt;ol&gt;
&lt;li&gt;因為一個 widget 在中間，另一個在右側，故個人感覺相較於使用 &lt;code&gt;SizedBox&lt;/code&gt; 和 &lt;code&gt;Row&lt;/code&gt;，用 &lt;code&gt;Stack&lt;/code&gt; 是比較好的選擇，因為位置會比較精準。&lt;/li&gt;
&lt;li&gt;因為是固定在正中間，所以用 &lt;code&gt;Align&lt;/code&gt; 來進行定位，因為 Stack 大小不知道。&lt;/li&gt;
&lt;li&gt;因為知道確切的位置，所以可以使用 &lt;code&gt;Positioned&lt;/code&gt; 進行定位，而下拉式選單按鈕一樣使用 &lt;code&gt;MenuAnchor&lt;/code&gt;。
:::&lt;/li&gt;
&lt;/ol&gt;
&lt;h3&gt;Settings&lt;/h3&gt;
&lt;p&gt;設定頁面的部分，位於 &lt;code&gt;Pages/SettingsPage.dart&lt;/code&gt;。&lt;/p&gt;
&lt;pre&gt;&lt;code&gt;import &apos;package:flutter/material.dart&apos;;
import &apos;package:landroppage/Types/Language.dart&apos;;

import &apos;../Components/SettingsList.dart&apos;;
import &apos;../Widgets/Settings/UserInfo.dart&apos;;

class SettingsPage extends StatefulWidget {
  const SettingsPage({super.key});

  @override
  State&amp;lt;SettingsPage&amp;gt; createState() =&amp;gt; _SettingsPageState();
}

class _SettingsPageState extends State&amp;lt;SettingsPage&amp;gt; {
  bool discoverable = true;
  bool saveToGallery = true;
  ThemeMode themeMode = ThemeMode.system;
  Language language = Language.Auto;

  @override
  Widget build(BuildContext context) {
    return Padding(
      padding: EdgeInsets.only(left: 36.0, right: 36.0, bottom: 20.0),
      child: Column(
        children: [
          const Padding(
            padding: EdgeInsets.only(top: 20.0),
            child: Row(
              mainAxisAlignment: MainAxisAlignment.spaceBetween,
              children: [Text(&quot;Settings&quot;, style: TextStyle(fontSize: 24))],
            ),
          ),
          Expanded(
            child: SingleChildScrollView(
              child: Column(
                children: [
                  UserInfo(),
                  SettingsList(
                    category: &quot;General&quot;,
                    settings: [
                      ListTile(
                        leading: Icon(Icons.visibility),
                        title: Text(&quot;Discoverable&quot;),
                        trailing: Switch(
                          value: discoverable,
                          onChanged: (value) {
                            setState(() {
                              discoverable = value;
                            });
                          },
                        ),
                      ),
                      ListTile(
                        leading: Icon(Icons.photo_library),
                        title: Text(&quot;Save to Gallery&quot;),
                        trailing: Switch(
                          value: saveToGallery,
                          onChanged: (value) {
                            setState(() {
                              saveToGallery = value;
                            });
                          },
                        ),
                      ),
                      ListTile(
                        leading: Icon(Icons.brightness_medium),
                        title: Text(&quot;Theme Mode&quot;),
                        trailing: DropdownButton(
                          items: const [
                            DropdownMenuItem(
                              value: ThemeMode.system,
                              child: Text(&quot;System&quot;),
                            ),
                            DropdownMenuItem(
                              value: ThemeMode.light,
                              child: Text(&quot;Light&quot;),
                            ),
                            DropdownMenuItem(
                              value: ThemeMode.dark,
                              child: Text(&quot;Dark&quot;),
                            ),
                          ],
                          onChanged: (value) {
                            setState(() {
                              themeMode = value!;
                            });
                          },
                          value: themeMode,
                        ),
                      ),
                      ListTile(
                        leading: Icon(Icons.public),
                        title: Text(&quot;Language&quot;),
                        trailing: DropdownButton(
                          items: const [
                            DropdownMenuItem(
                              value: Language.Auto,
                              child: Text(&quot;Auto&quot;),
                            ),
                            DropdownMenuItem(
                              value: Language.English,
                              child: Text(&quot;English&quot;),
                            ),
                            DropdownMenuItem(
                              value: Language.SimplifiedChinese,
                              child: Text(&quot;简体中文&quot;),
                            ),
                            DropdownMenuItem(
                              value: Language.TraditionalChinese,
                              child: Text(&quot;繁體中文&quot;),
                            ),
                          ],
                          onChanged: (value) {
                            setState(() {
                              language = value!;
                            });
                          },
                          value: language,
                        ),
                      ),
                      ListTile(
                        leading: Icon(Icons.delete),
                        title: Text(&quot;Clear Cache&quot;),
                        onTap: () {},
                      ),
                      ListTile(
                        leading: Icon(Icons.update),
                        title: Text(&quot;Check for Updates&quot;),
                        onTap: () {},
                      ),
                    ],
                  ),
                  SettingsList(
                    category: &quot;Advanced&quot;,
                    settings: [
                      ListTile(
                        leading: Icon(Icons.devices),
                        title: Text(&quot;Manage Trusted Devices&quot;),
                        trailing: Icon(Icons.chevron_right),
                        onTap: () {},
                      ),
                      ListTile(
                        leading: Icon(Icons.copy_outlined),
                        title: Text(&quot;Copy My Device ID&quot;),
                        onTap: () {},
                      ),
                      ListTile(
                        leading: Icon(Icons.info_outline_rounded),
                        title: Text(&quot;IP Address &amp;amp; Port&quot;),
                        onTap: () {},
                      ),
                    ],
                  ),
                  SettingsList(
                    category: &quot;About&quot;,
                    settings: [
                      ListTile(
                        leading: Icon(Icons.feedback),
                        title: Text(&quot;Report Feedback&quot;),
                        onTap: () {},
                      ),
                      ListTile(
                        leading: Icon(Icons.gpp_maybe),
                        title: Text(&quot;Privacy Policy&quot;),
                        trailing: Icon(Icons.chevron_right),
                        onTap: () {},
                      ),
                      ListTile(
                        leading: Icon(Icons.info_rounded),
                        title: Text(&quot;About&quot;),
                        trailing: Icon(Icons.chevron_right),
                        onTap: () {},
                      ),
                    ],
                  ),
                ],
              ),
            ),
          ),
        ],
      ),
    );
  }
}
&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;:::note[解析]&lt;/p&gt;
&lt;ol&gt;
&lt;li&gt;因為要記錄設定值，故需要使用 &lt;code&gt;StatefulWidget&lt;/code&gt;&lt;/li&gt;
&lt;li&gt;宣告 state 已儲存設定值，&lt;code&gt;ThemeMode&lt;/code&gt; 和 &lt;code&gt;Language&lt;/code&gt; 為 enumeration，分別表示顯示主題與顯示語言，稍後會展示。&lt;/li&gt;
&lt;li&gt;因為要使部分 widget 可以滾動，故使用 &lt;code&gt;SingleChildScrollView&lt;/code&gt;，以確保內容可以垂直滾動，&lt;code&gt;Expanded&lt;/code&gt; 的部分也是一樣，如果不加會無法顯示。&lt;/li&gt;
&lt;li&gt;兩個皆為自定義 widget/component，稍後皆會展示&lt;/li&gt;
&lt;li&gt;&lt;code&gt;DropdownButton&lt;/code&gt; 部分為下拉式選單，選項部分可透過 &lt;code&gt;items&lt;/code&gt; 屬性填入，而 &lt;code&gt;DropdownMenuItem&lt;/code&gt; 是下拉選單的選項。而最後 value 部分下拉式選單的值，並且與對應設定值綁定。
:::
接下來就是 &lt;code&gt;UserInfo&lt;/code&gt;，檔案在 &lt;code&gt;Widgets/Settings&lt;/code&gt; 資料夾中。&lt;/li&gt;
&lt;/ol&gt;
&lt;pre&gt;&lt;code&gt;import &apos;package:flutter/material.dart&apos;;
import &apos;package:device_friendly_name/device_friendly_name.dart&apos;;

class UserInfo extends StatefulWidget {
  const UserInfo({super.key});

  @override
  State&amp;lt;UserInfo&amp;gt; createState() =&amp;gt; _UserInfoState();
}

class _UserInfoState extends State&amp;lt;UserInfo&amp;gt; {
  Future&amp;lt;String&amp;gt; _getDeviceName() async {
    final String deviceName =
        await DeviceFriendlyName().getDeviceFriendlyName() ?? &quot;User&quot;;
    return deviceName;
  }

  @override
  Widget build(BuildContext context) {
    return Padding(
      padding: EdgeInsets.only(top: 25),
      child: Row(
        mainAxisAlignment: MainAxisAlignment.start,
        children: [
          CircleAvatar(
            backgroundColor: Colors.white,
            radius: 30,
            child: ClipOval(
              child: Image(image: AssetImage(&quot;assets/avatar.jpeg&quot;)),
            ),
          ),
          SizedBox(width: 20),
          FutureBuilder(
            future: _getDeviceName(),
            builder: (context, snapshot) {
              return Text(
                snapshot.hasData ? snapshot.data! : &quot;User&quot;,
                style: TextStyle(fontSize: 20),
              );
            },
          ),
          IconButton(icon: Icon(Icons.edit_outlined), onPressed: () {}),
        ],
      ),
    );
  }
}
&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;:::note[解析]&lt;/p&gt;
&lt;ol&gt;
&lt;li&gt;跟 &lt;code&gt;HomePage&lt;/code&gt; 中的 &lt;code&gt;TopBar&lt;/code&gt; 一樣，因為要非同步取得裝置名稱，所以此 widget 一樣是 &lt;code&gt;StatefulWidget&lt;/code&gt;。&lt;/li&gt;
&lt;li&gt;因為要符合作業要求使用 &lt;code&gt;Image&lt;/code&gt; widget，所以才使用這種寫法設定 &lt;code&gt;CircleAvatar&lt;/code&gt; 中顯示的圖片，在普通狀況下直接將圖片資訊填入 &lt;code&gt;CircleAvatar&lt;/code&gt; 的 &lt;code&gt;backgroundImage&lt;/code&gt; 屬性即可，不需要寫得如此彆扭。
:::&lt;/li&gt;
&lt;/ol&gt;
&lt;h3&gt;Components&lt;/h3&gt;
&lt;p&gt;相關檔案皆放置於 &lt;code&gt;Components&lt;/code&gt; 資料夾中&lt;/p&gt;
&lt;h4&gt;CircleButton&lt;/h4&gt;
&lt;p&gt;用於顯示那些有顏色底且下方有按鈕描述的圓形 IconButton。&lt;/p&gt;
&lt;pre&gt;&lt;code&gt;import &apos;package:flutter/material.dart&apos;;

class CircleButton extends StatelessWidget {
  const CircleButton({
    super.key,
    required this.backgroundColor,
    required this.iconColor,
    required this.icon,
    required this.text,
  });

  final MaterialAccentColor backgroundColor;
  final MaterialColor iconColor;
  final IconData icon;
  final String text;

  @override
  Widget build(BuildContext context) {
    return Column(
      children: [
        Container(
          width: 65,
          height: 65,
          decoration: BoxDecoration(
            shape: BoxShape.circle,
            color: backgroundColor.shade100.withAlpha(50),
          ),
          child: IconButton(
            icon: Icon(icon, color: iconColor.shade400),
            iconSize: 30,
            onPressed: () {},
          ),
        ),
        SizedBox(height: 8),
        SizedBox(
          width: 65,
          child: Text(
            text,
            style: TextStyle(fontSize: 12),
            textAlign: TextAlign.center,
            softWrap: true,
            overflow: TextOverflow.visible,
            maxLines: 2,
          ),
        ),
      ],
    );
  }
}
&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;:::note[解析]&lt;/p&gt;
&lt;ol&gt;
&lt;li&gt;因為要為 IconButton 加上一個有顏色的底，故外面需要包一個 &lt;code&gt;Container&lt;/code&gt;，然後透過 &lt;code&gt;decoration&lt;/code&gt; 屬性設定要加上的底色。&lt;/li&gt;
&lt;li&gt;為避免讓按鈕的描述文字在非常長時影響到其他按鈕的位置，故使用 &lt;code&gt;SizedBox&lt;/code&gt; 包住 &lt;code&gt;Text&lt;/code&gt;，設定寬度為 &lt;code&gt;65&lt;/code&gt;，並為 &lt;code&gt;Text&lt;/code&gt; 加上相關屬性，這樣即使文字過長也會自動換行，不會影響其他按鈕的位置。
:::&lt;/li&gt;
&lt;/ol&gt;
&lt;h4&gt;FileItem&lt;/h4&gt;
&lt;p&gt;用於顯示檔案列表內的檔案資訊&lt;/p&gt;
&lt;pre&gt;&lt;code&gt;import &apos;package:flutter/material.dart&apos;;
import &apos;package:intl/intl.dart&apos;;

class FileItem extends StatelessWidget {
  const FileItem({
    super.key,
    required this.name,
    required this.size,
    required this.time,
  });

  final String name;
  final String size;
  final DateTime time;

  @override
  Widget build(BuildContext context) {
    return Card.filled(
      clipBehavior: Clip.hardEdge,
      color: Colors.white,
      shape: RoundedRectangleBorder(
        borderRadius: BorderRadius.circular(20),
        side: BorderSide(color: Colors.grey.shade300),
      ),
      child: InkWell(
        onTap: () {},
        child: Padding(
          padding: EdgeInsets.only(top: 5, bottom: 5),
          child: ListTile(
            leading: Container(
              width: 50,
              height: 50,
              decoration: BoxDecoration(
                borderRadius: BorderRadius.circular(15),
                color: Colors.greenAccent.shade100.withAlpha(50),
              ),
              child: Icon(
                Icons.description_outlined,
                color: Colors.green,
                size: 30,
              ),
            ),
            title: Text(name, style: TextStyle(fontSize: 14)),
            subtitle: Text(
              &quot;${(DateFormat.yMd().add_jm().format(time.toLocal()))} | $size&quot;,
              style: TextStyle(fontSize: 12, color: Colors.grey.shade600),
            ),
            trailing: MenuAnchor(
              menuChildren: &amp;lt;Widget&amp;gt;[
                MenuItemButton(
                  leadingIcon: Icon(Icons.open_in_new),
                  onPressed: () {},
                  child: Text(&quot;Open with...&quot;),
                ),
                MenuItemButton(
                  leadingIcon: Icon(
                    Icons.delete_outline_rounded,
                    color: Colors.red,
                  ),
                  onPressed: () {},
                  child: Text(&quot;Delete&quot;, style: TextStyle(color: Colors.red)),
                ),
              ],
              builder: (context, controller, child) {
                return IconButton(
                  onPressed: () {
                    if (controller.isOpen) {
                      controller.close();
                    } else {
                      controller.open();
                    }
                  },
                  icon: Icon(Icons.more_horiz, color: Colors.grey.shade600),
                );
              },
            ),
          ),
        ),
      ),
    );
  }
}
&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;:::note[解析]&lt;/p&gt;
&lt;ol&gt;
&lt;li&gt;因為下方有 &lt;code&gt;InkWell&lt;/code&gt;，所以需要設定 &lt;code&gt;clipBehavior&lt;/code&gt; 為 &lt;code&gt; Clip.hardEdge&lt;/code&gt;，否則 &lt;code&gt;InkWell&lt;/code&gt; 效果會看不到。&lt;/li&gt;
&lt;li&gt;使用 &lt;code&gt;InkWell&lt;/code&gt; 使 &lt;code&gt;Card&lt;/code&gt; 被點擊時能有一個點擊效果，&lt;code&gt;onTap&lt;/code&gt; 的 function 即使沒有要做什麼動作也不可省略，否則點擊時不會有任何效果。&lt;/li&gt;
&lt;li&gt;使用第三方模組 &lt;code&gt;intl&lt;/code&gt; 將日期時間格式化成字串，格式為 &lt;code&gt;mm/dd/yyyy HH:mm PM/AM&lt;/code&gt;。
:::&lt;/li&gt;
&lt;/ol&gt;
&lt;h4&gt;SettingsList&lt;/h4&gt;
&lt;p&gt;用於顯示分類的設定列表&lt;/p&gt;
&lt;pre&gt;&lt;code&gt;import &apos;package:flutter/material.dart&apos;;

class SettingsList extends StatelessWidget {
  const SettingsList({
    super.key,
    required this.settings,
    required this.category,
  });

  final String category;
  final List&amp;lt;ListTile&amp;gt; settings;

  @override
  Widget build(BuildContext context) {
    return Padding(
      padding: const EdgeInsets.only(top: 20.0),
      child: Column(
        crossAxisAlignment: CrossAxisAlignment.start,
        children: [
          Text(
            category,
            style: TextStyle(fontSize: 14, color: Colors.blue),
          ),
          SizedBox(height: 10),
          ListView(
            physics: NeverScrollableScrollPhysics(),
            shrinkWrap: true,
            children: settings,
          ),
        ],
      ),
    );
  }
}
&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;:::note[解析]
一樣為避免 &lt;code&gt;ListView&lt;/code&gt; 能夠捲動，故一樣將 &lt;code&gt;physics&lt;/code&gt; 設定為 &lt;code&gt;NeverScrollableScrollPhysics()&lt;/code&gt;。
:::&lt;/p&gt;
&lt;h4&gt;TransferItem&lt;/h4&gt;
&lt;p&gt;用於顯示傳輸列表中的檔案&lt;/p&gt;
&lt;pre&gt;&lt;code&gt;import &apos;package:flutter/material.dart&apos;;

import &apos;../Types/TransferStatus.dart&apos;;

class TransferItem extends StatelessWidget {
  const TransferItem({
    super.key,
    required this.name,
    required this.size,
    required this.status,
    required this.code,
    required this.device,
    required this.progress,
  });

  final String name;
  final String size;
  final String code;
  final String device;
  final TransferStatus status;
  final int progress;

  @override
  Widget build(BuildContext context) {
    return Card.filled(
      color: Colors.white,
      shape: RoundedRectangleBorder(
        borderRadius: BorderRadius.circular(20),
        side: BorderSide(color: Colors.grey.shade300),
      ),
      child: ListTile(
        leading: Container(
          width: 50,
          height: 50,
          decoration: BoxDecoration(
            borderRadius: BorderRadius.circular(15),
            color: (status == TransferStatus.InProgress
                    ? Colors.blueAccent
                    : (status == TransferStatus.Done
                        ? Colors.greenAccent
                        : (status == TransferStatus.Failed
                            ? Colors.redAccent
                            : Colors.orangeAccent)))
                .shade100
                .withAlpha(50),
          ),
          child: Icon(
            Icons.description_outlined,
            color:
                status == TransferStatus.InProgress
                    ? Colors.blue
                    : (status == TransferStatus.Done
                        ? Colors.green
                        : (status == TransferStatus.Failed
                            ? Colors.red
                            : Colors.orange)),
            size: 30,
          ),
        ),
        title: Text(
          name,
          style: TextStyle(fontSize: 14, fontWeight: FontWeight.w500),
        ),
        subtitle: Padding(
          padding: EdgeInsets.only(top: 2),
          child: Column(
            crossAxisAlignment: CrossAxisAlignment.start,
            children: [
              Text(
                &quot;$size・Code: $code&quot;,
                style: TextStyle(fontSize: 12, color: Colors.grey.shade600),
              ),
              Text(
                device,
                style: TextStyle(fontSize: 12, color: Colors.grey.shade600),
              ),
            ],
          ),
        ),
        trailing: Row(
          mainAxisSize: MainAxisSize.min,
          children: [
            (status == TransferStatus.InProgress
                ? CircularProgressIndicator(
                  constraints: BoxConstraints(
                    minWidth: 15,
                    minHeight: 15,
                  ),
                  valueColor: AlwaysStoppedAnimation&amp;lt;Color&amp;gt;(Colors.blue),
                  backgroundColor: Colors.grey.shade300,
                  value: progress / 100,
                )
                : Icon(
                  status == TransferStatus.Done
                      ? Icons.check_circle
                      : (status == TransferStatus.Failed
                          ? Icons.cancel
                          : Icons.schedule_outlined),
                  color:
                      status == TransferStatus.Done
                          ? Colors.green
                          : (status == TransferStatus.Failed
                              ? Colors.red
                              : Colors.orange),
                )),
            SizedBox(width: 10),
            Text(
              status == TransferStatus.InProgress
                  ? &quot;$progress%&quot;
                  : (status == TransferStatus.Done
                      ? &quot;Done&quot;
                      : (status == TransferStatus.Failed
                          ? &quot;Failed&quot;
                          : &quot;Pending&quot;)),
              style: TextStyle(
                fontSize: 12,
                color:
                    status == TransferStatus.InProgress
                        ? Colors.blue
                        : (status == TransferStatus.Done
                            ? Colors.green
                            : (status == TransferStatus.Failed
                                ? Colors.red
                                : Colors.orange)),
              ),
            ),
          ],
        ),
      ),
    );
  }
}
&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;:::note[解析]&lt;/p&gt;
&lt;ol&gt;
&lt;li&gt;&lt;code&gt;TransferStatus&lt;/code&gt; 為 custom enumeration，稍後會展示，用於表示檔案傳輸的狀態。&lt;/li&gt;
&lt;li&gt;利用連續三元運算子，以 &lt;code&gt;status&lt;/code&gt; 值決定相關屬性&lt;/li&gt;
&lt;li&gt;因為 &lt;code&gt;status&lt;/code&gt; 為 &lt;code&gt;TransferStatus.InProgress&lt;/code&gt; 時要顯示不同的 widget，故第一個三元運算子在最外層。而 &lt;code&gt;CircularProgressIndicator&lt;/code&gt; 則用於顯示檔案傳輸的進度，顯示的進度由 &lt;code&gt;progress&lt;/code&gt; 值決定。
:::&lt;/li&gt;
&lt;/ol&gt;
&lt;h3&gt;Types&lt;/h3&gt;
&lt;p&gt;檔案全部位於 &lt;code&gt;Types&lt;/code&gt; 資料夾中，全部皆為自訂資料型別。&lt;/p&gt;
&lt;h4&gt;Language&lt;/h4&gt;
&lt;pre&gt;&lt;code&gt;enum Language {
  Auto,
  English,
  TraditionalChinese,
  SimplifiedChinese,
}
&lt;/code&gt;&lt;/pre&gt;
&lt;h4&gt;ThemeMode&lt;/h4&gt;
&lt;pre&gt;&lt;code&gt;enum ThemeMode{
  System,
  Light,
  Dark
}
&lt;/code&gt;&lt;/pre&gt;
&lt;h4&gt;TransferStatus&lt;/h4&gt;
&lt;pre&gt;&lt;code&gt;enum TransferStatus {
  InProgress,
  Done,
  Failed,
  Pending
}
&lt;/code&gt;&lt;/pre&gt;
&lt;h2&gt;App Exhibition&lt;/h2&gt;
&lt;p&gt;&amp;lt;div style=&quot;position:relative; width:100%; height:0px; padding-bottom:216.216%&quot;&amp;gt;&amp;lt;iframe allow=&quot;fullscreen&quot; allowfullscreen height=&quot;100%&quot; src=&quot;https://streamable.com/e/menwkg?loop=0&quot; width=&quot;100%&quot; style=&quot;border:none; width:100%; height:100%; position:absolute; left:0px; top:0px; overflow:hidden;&quot;&amp;gt;&amp;lt;/iframe&amp;gt;&amp;lt;/div&amp;gt;&lt;/p&gt;
&lt;p&gt;關於 &lt;code&gt;MenuAnchor&lt;/code&gt; 沒有動畫的部分請參考此 issue：&lt;/p&gt;
&lt;p&gt;https://github.com/flutter/flutter/issues/135025&lt;/p&gt;
&lt;h2&gt;Wrapping Up&lt;/h2&gt;
&lt;p&gt;這次 App 老實說做起來真的有點累，為了要用到全部的 widget，需要一次刻到三個 page，早知道做 about page 就好了。但是其實換個角度想，如果沒有寫出這次的東西，我現在知道的可能會比寫 about page 還要少，所以感覺寫出了這次的作業還是很值得的。裡面雖然有非常多我沒用過的東西，但是其實沒關係，邊用邊學，其實用著用著就知道怎麼用了。&lt;/p&gt;
&lt;h2&gt;GitHub Repository&lt;/h2&gt;
&lt;p&gt;::github{repo=&quot;Kayxue/LandropPageImitation&quot;}&lt;/p&gt;
</content:encoded></item><item><title>ActixStaticServe 實戰－架設 Astro 靜態網站</title><link>https://blog.kayxue.dev/posts/actixstaticsereveastro/</link><guid isPermaLink="true">https://blog.kayxue.dev/posts/actixstaticsereveastro/</guid><description>使用 ActixStaticServe 架設一個 Astro 靜態網站</description><pubDate>Tue, 04 Mar 2025 00:00:00 GMT</pubDate><content:encoded>&lt;p&gt;在&lt;a href=&quot;/posts/actixstaticserve/&quot;&gt;上一篇文章&lt;/a&gt;中，我大概介紹了本人製作的 ActixStatic Docker image 簡單的使用方法，但是在實務上，如果每次都要手動將網頁專案 build 好，再將靜態網站檔案放入資料夾，然後自己手動下指令 build image 將打包好的 image 上傳至 registry，這其實是非常麻煩的一件事，所以這次的文章將會以 Astro 靜態網站為例，介紹如何在使用前端框架的專案中，使用此 image 與使用 GitHub Actions 自動化 build image 流程，將 image 上傳至 registry，並在目標裝置上架設網站。
::github{repo=&quot;Kayxue/ActixStaticServe&quot;}&lt;/p&gt;
&lt;h2&gt;Preparation&lt;/h2&gt;
&lt;p&gt;首先，我們需要一個 Astro 靜態網站的專案，在此我以 &lt;a href=&quot;https://github.com/saicaca/fuwari&quot;&gt;fuwari&lt;/a&gt; 為例，打開 fuwari 的 GitHub 專案網頁後，點選右上角的 &lt;code&gt;Use this template&lt;/code&gt; -&amp;gt; &lt;code&gt;Create a new repository&lt;/code&gt;，以此 repo 為模板建立一個新的 repo。
&lt;img src=&quot;./newrepo.png&quot; alt=&quot;使用模板建立 repo m-auto&quot; /&gt;
進入建立新 repo 的介面後，先確認模板是否正確，然後寫上 repo 名稱等相關資訊，確認填寫的資訊 OK 後即可點選 &lt;code&gt;Create repository&lt;/code&gt; 建立 repo。
&lt;img src=&quot;./createrepo.png&quot; alt=&quot;建立 repo&quot; /&gt;
建立完成後，請打開終端機，並且使用 &lt;code&gt;cd&lt;/code&gt; 指令切換到你想存放此專案的資料夾，然後輸入以下指令，將剛剛建立的 repo 複製到資料夾下：&lt;/p&gt;
&lt;pre&gt;&lt;code&gt;git clone https://github.com/&amp;lt;your-username&amp;gt;/&amp;lt;repo-name&amp;gt;.git
&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;以上指令中的 &lt;code&gt;&amp;lt;your-username&amp;gt;&lt;/code&gt; 請替換成你的 GitHub 使用者名稱，&lt;code&gt;&amp;lt;repo-name&amp;gt;&lt;/code&gt; 請替換成你剛剛建立的 repo 名稱。以我為例，我剛剛建立的 repo 名稱為 &lt;code&gt;Tutorial&lt;/code&gt;，則指令如下：&lt;/p&gt;
&lt;pre&gt;&lt;code&gt;git clone https://github.com/Kayxue/Tutorial.git
&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;複製完成後，請進入專案資料夾下，使用對應指令在編輯器中開啟專案：&lt;/p&gt;
&lt;pre&gt;&lt;code&gt;cd &amp;lt;project-folder&amp;gt; # &amp;lt;project-folder&amp;gt; 請替換成你的專案資料夾名稱
zed .
&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;:::note
在此本人使用 &lt;a href=&quot;https://zed.dev/&quot;&gt;Zed&lt;/a&gt; 編輯器，故在編輯器中開啟專案的指令為 &lt;code&gt;zed .&lt;/code&gt;，若您使用其他編輯器，請自行替換指令。指令舉例如下：&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;&lt;a href=&quot;https://code.visualstudio.com/&quot;&gt;Visual Studio Code&lt;/a&gt;：&lt;code&gt;code .&lt;/code&gt;&lt;/li&gt;
&lt;li&gt;&lt;a href=&quot;https://vscodium.com/&quot;&gt;VScodium&lt;/a&gt;：&lt;code&gt;codium .&lt;/code&gt;
:::
在編輯器中開啟專案後，若您不是使用 pnpm 作為 package manager，請先打開 &lt;code&gt;package.json&lt;/code&gt;，並進行修改：&lt;/li&gt;
&lt;/ul&gt;
&lt;pre&gt;&lt;code&gt;{
  &quot;name&quot;: &quot;fuwari&quot;,
  &quot;type&quot;: &quot;module&quot;,
  &quot;version&quot;: &quot;0.0.1&quot;,
  &quot;scripts&quot;: {
    &quot;dev&quot;: &quot;bunx --bun astro dev&quot;,
    &quot;start&quot;: &quot;bunx --bun astro dev&quot;,
    &quot;build&quot;: &quot;bunx --bun astro build &amp;amp;&amp;amp; bunx --bun pagefind --site dist&quot;,
    &quot;preview&quot;: &quot;bunx --bun astro preview&quot;,
    &quot;astro&quot;: &quot;bunx --bun astro&quot;,
    &quot;type-check&quot;: &quot;tsc --noEmit --isolatedDeclarations&quot;,
    &quot;new-post&quot;: &quot;bun run --bun scripts/new-post.js&quot;,
    &quot;format&quot;: &quot;biome format --write ./src&quot;,
    &quot;lint&quot;: &quot;biome check --apply ./src&quot;,
    &quot;preinstall&quot;: &quot;npx only-allow pnpm&quot;
  },
  &quot;dependencies&quot;: {
    &quot;@astrojs/check&quot;: &quot;^0.9.4&quot;,
    &quot;@astrojs/rss&quot;: &quot;^4.0.11&quot;,
    &quot;@astrojs/sitemap&quot;: &quot;^3.2.1&quot;,
    &quot;@astrojs/svelte&quot;: &quot;7.0.3&quot;,
    &quot;@astrojs/tailwind&quot;: &quot;^5.1.4&quot;,
    &quot;@fontsource-variable/jetbrains-mono&quot;: &quot;^5.1.1&quot;,
    &quot;@fontsource/roboto&quot;: &quot;^5.1.0&quot;,
    &quot;@iconify-json/fa6-brands&quot;: &quot;^1.2.3&quot;,
    &quot;@iconify-json/fa6-regular&quot;: &quot;^1.2.2&quot;,
    &quot;@iconify-json/fa6-solid&quot;: &quot;^1.2.2&quot;,
    &quot;@iconify-json/material-symbols&quot;: &quot;^1.2.8&quot;,
    &quot;@iconify/svelte&quot;: &quot;^4.0.2&quot;,
    &quot;@swup/astro&quot;: &quot;^1.5.0&quot;,
    &quot;@tailwindcss/typography&quot;: &quot;^0.5.15&quot;,
    &quot;astro&quot;: &quot;5.1.6&quot;,
    &quot;astro-compress&quot;: &quot;^2.3.5&quot;,
    &quot;astro-icon&quot;: &quot;^1.1.4&quot;,
    &quot;hastscript&quot;: &quot;^9.0.0&quot;,
    &quot;katex&quot;: &quot;^0.16.19&quot;,
    &quot;markdown-it&quot;: &quot;^14.1.0&quot;,
    &quot;mdast-util-to-string&quot;: &quot;^4.0.0&quot;,
    &quot;overlayscrollbars&quot;: &quot;^2.10.1&quot;,
    &quot;pagefind&quot;: &quot;^1.2.0&quot;,
    &quot;photoswipe&quot;: &quot;^5.4.4&quot;,
    &quot;reading-time&quot;: &quot;^1.5.0&quot;,
    &quot;rehype-autolink-headings&quot;: &quot;^7.1.0&quot;,
    &quot;rehype-components&quot;: &quot;^0.3.0&quot;,
    &quot;rehype-katex&quot;: &quot;^7.0.1&quot;,
    &quot;rehype-slug&quot;: &quot;^6.0.0&quot;,
    &quot;remark-directive&quot;: &quot;^3.0.0&quot;,
    &quot;remark-directive-rehype&quot;: &quot;^0.4.2&quot;,
    &quot;remark-github-admonitions-to-directives&quot;: &quot;^1.0.5&quot;,
    &quot;remark-math&quot;: &quot;^6.0.0&quot;,
    &quot;remark-sectionize&quot;: &quot;^2.0.0&quot;,
    &quot;sanitize-html&quot;: &quot;^2.13.1&quot;,
    &quot;sharp&quot;: &quot;^0.33.5&quot;,
    &quot;stylus&quot;: &quot;^0.63.0&quot;,
    &quot;svelte&quot;: &quot;^5.5.3&quot;,
    &quot;tailwindcss&quot;: &quot;^3.4.16&quot;,
    &quot;typescript&quot;: &quot;^5.7.2&quot;,
    &quot;unist-util-visit&quot;: &quot;^5.0.0&quot;
  },
  &quot;devDependencies&quot;: {
    &quot;@astrojs/ts-plugin&quot;: &quot;^1.10.4&quot;,
    &quot;@biomejs/biome&quot;: &quot;1.8.3&quot;,
    &quot;@rollup/plugin-yaml&quot;: &quot;^4.1.2&quot;,
    &quot;@types/markdown-it&quot;: &quot;^14.1.2&quot;,
    &quot;@types/mdast&quot;: &quot;^4.0.4&quot;,
    &quot;@types/sanitize-html&quot;: &quot;^2.13.0&quot;,
    &quot;postcss-import&quot;: &quot;^16.1.0&quot;,
    &quot;postcss-nesting&quot;: &quot;^13.0.1&quot;
  },
  &quot;packageManager&quot;: &quot;pnpm@9.14.4&quot;
}
&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;:::note
在此以 &lt;a href=&quot;https://bun.sh/&quot;&gt;Bun&lt;/a&gt; 為例，上方實際修改的地方與等一下輸入的指令皆依據您使用的 package manager 而定。
:::
接下來請輸入以下指令安裝專案所需的模組：&lt;/p&gt;
&lt;pre&gt;&lt;code&gt;bun install
&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;待模組安裝完成後，即可輸入以下指令啟動 development server：&lt;/p&gt;
&lt;pre&gt;&lt;code&gt;bun run dev
&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;確認執行起來沒有問題後，即可進行下一步。
:::note&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;礙於篇幅關係，此處就不提及修改模板設定與撰寫文章等其他部分了，若您有此部分的需求，請查看 &lt;code&gt;/src/config.ts&lt;/code&gt; 與 &lt;code&gt;/src/content/posts&lt;/code&gt; 資料夾下的檔案，裡面皆有相關內容與註解讓您參考。&lt;/li&gt;
&lt;li&gt;若您不是使用 pnpm 作為 package manager，可刪除專案根目錄下的 &lt;code&gt;pnpm-lock.yaml&lt;/code&gt; 檔案。
:::&lt;/li&gt;
&lt;/ul&gt;
&lt;h2&gt;Writeing Dockerfile&lt;/h2&gt;
&lt;p&gt;接下來就是撰寫 dockerfile 的部分，請在專案根目錄下建立 &lt;code&gt;Dockerfile&lt;/code&gt; 檔案，並輸入以下內容：&lt;/p&gt;
&lt;pre&gt;&lt;code&gt;FROM oven/bun:alpine AS builder

WORKDIR /app
COPY . .

RUN bun install
RUN bun run build

FROM ghcr.io/kayxue/actixstaticserve:latest

WORKDIR /

COPY --from=builder /app/dist/ ./public/
&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;:::note&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;&lt;code&gt;1&lt;/code&gt; 行：從 &lt;code&gt;oven/bun:alpine&lt;/code&gt; image 開始一個新的階段，&lt;strong&gt;image 部分依據您使用的 package manager 而定。&lt;/strong&gt; 本人使用 &lt;a href=&quot;https://bun.sh/&quot;&gt;Bun&lt;/a&gt;，所以使用 &lt;code&gt;oven/bun:alpine&lt;/code&gt; 來進行建置，&lt;code&gt;alpine&lt;/code&gt; 部分純屬個人喜好，您也可以使用其他 tag 的 image，&lt;strong&gt;但切忌使用 distroless&lt;/strong&gt;。&lt;/li&gt;
&lt;li&gt;&lt;code&gt;3~4&lt;/code&gt; 行：設定工作資料夾為 &lt;code&gt;/app&lt;/code&gt;，並將專案複製至工作資料夾中。&lt;/li&gt;
&lt;li&gt;&lt;code&gt;6&lt;/code&gt; 行：安裝專案所需的模組。&lt;/li&gt;
&lt;li&gt;&lt;code&gt;7&lt;/code&gt; 行：執行專案的 build 指令，建置靜態網頁。&lt;/li&gt;
&lt;li&gt;&lt;code&gt;9&lt;/code&gt; 行：從 &lt;code&gt;ghcr.io/kayxue/actixstaticserve:latest&lt;/code&gt; image 開始另一個新的階段。&lt;/li&gt;
&lt;li&gt;&lt;code&gt;11&lt;/code&gt; 行：設定工作資料夾為根目錄。&lt;/li&gt;
&lt;li&gt;&lt;code&gt;13&lt;/code&gt; 行：將第一個階段建置好的靜態網頁複製至 &lt;code&gt;/public&lt;/code&gt; 資料夾。
:::
:::warning
若您使用 pnpm 作為 package manager，詳細請參考 pnpm 官方文件的 &lt;a href=&quot;https://pnpm.io/docker&quot;&gt;Working with Docker&lt;/a&gt;
:::&lt;/li&gt;
&lt;/ul&gt;
&lt;h2&gt;Writeing GitHub Actions&lt;/h2&gt;
&lt;p&gt;再來就是撰寫 GitHub Actions 的部分，請在專案根目錄下建立 &lt;code&gt;.github/workflows&lt;/code&gt; 資料夾，並在資料夾中建立 &lt;code&gt;publish.yml&lt;/code&gt; 檔案，然後輸入以下內容：&lt;/p&gt;
&lt;pre&gt;&lt;code&gt;name: Publish Docker Image
on: [push]

jobs:
  publish-docker-image:
    runs-on: ubuntu-24.04-arm
    permissions:
      contents: read
      packages: write
    steps:
      - uses: actions/checkout@v4
      - name: Login to GitHub Container Registry
        uses: docker/login-action@v3
        with:
          registry: ghcr.io
          username: ${{ github.actor }}
          password: ${{ secrets.GITHUB_TOKEN }}

      - name: Set up Docker Buildx
        uses: docker/setup-buildx-action@v3

      - name: Build and push
        uses: docker/build-push-action@v6
        with:
          platforms: linux/arm64
          push: true
          provenance: false
          tags: ghcr.io/&amp;lt;username&amp;gt;/&amp;lt;image-name&amp;gt;:latest
&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;:::note&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;&lt;code&gt;runs-on&lt;/code&gt; 是指定您想在哪個環境下執行建置 image，因為本人是架在 SBC（單板電腦）上，而 SBC 多數 CPU 皆為 ARM64 架構，故這邊的環境選擇 &lt;code&gt;ubuntu-24.04-arm&lt;/code&gt;。若您架設之機器的架構為 &lt;code&gt;x86_64&lt;/code&gt;，請將上方第 6 行的 &lt;code&gt;ubuntu-24.04-arm&lt;/code&gt; 改為 &lt;code&gt;ubuntu-latest&lt;/code&gt;。若想同時支援多個 CPU architecture，請參考 &lt;a href=&quot;https://docs.docker.com/build/ci/github-actions/multi-platform/&quot;&gt;Multi-platform image with GitHub Actions&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;&lt;code&gt;12~17&lt;/code&gt; 行的部分是執行登入 GitHub Container Registry 的動作，若您是想將 image 推上 Docker Hub，請將該段落修改成如下內容，並在專案 repo 設定處設定相關 secrets：&lt;/li&gt;
&lt;/ul&gt;
&lt;pre&gt;&lt;code&gt;      - name: Login to Docker Hub
        uses: docker/login-action@v3
        with:
          registry: docker.io
          username: ${{ secrets.DOCKER_USERNAME }}
          password: ${{ secrets.DOCKER_PASSWORD }}
&lt;/code&gt;&lt;/pre&gt;
&lt;ul&gt;
&lt;li&gt;&lt;code&gt;28&lt;/code&gt; 行的 &lt;code&gt;&amp;lt;username&amp;gt;&lt;/code&gt; 與 &lt;code&gt;&amp;lt;image-name&amp;gt;&lt;/code&gt; 請分別替換成您想推送到平台的使用者名稱與 image 名稱（若為 GitHub Container Registry，則 &lt;code&gt;&amp;lt;username&amp;gt;&lt;/code&gt; 為 GitHub 使用者名稱）。若您想推送到 Docker Hub，請將 &lt;code&gt;ghcr.io&lt;/code&gt; 改為 &lt;code&gt;docker.io&lt;/code&gt;。
:::
修改完成後，即可在終端機中輸入以下指令將修改後的檔案推送至 GitHub：&lt;/li&gt;
&lt;/ul&gt;
&lt;pre&gt;&lt;code&gt;git add .
git commit -am &quot;&amp;lt;your-commit&amp;gt;&quot;
git push origin master
&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;成功推送後，即可在 GitHub 專案頁面中的 &lt;code&gt;Actions&lt;/code&gt; 頁面看到剛剛新增的 GitHub Actions，並且可以看到 Actions 的執行狀態。
&lt;img src=&quot;./githubactions.png&quot; alt=&quot;Github Actions 列表&quot; /&gt;
稍等一下，即可看到 Actions 已經成功執行完畢。
&lt;img src=&quot;./actionfinished.png&quot; alt=&quot;已經成功執行完的 actions&quot; /&gt;
如果推送至 GitHub Container Registry，您可以在專案的 code 頁面右下角看到 image 已經成功上傳至 registry。若您是推送至 Docker Hub，請至 Docker Hub 網站確認。
&lt;img src=&quot;./packagelocation.png&quot; alt=&quot;Build 出來的 image&quot; /&gt;&lt;/p&gt;
&lt;h2&gt;Deployments&lt;/h2&gt;
&lt;p&gt;在 build 出 image 後，最後就是在目標裝置上拉取該 image，並且執行 image 了。在此假設您已經在目標裝置上安裝 Docker，並且已經設定好 Docker 的相關設定。
接下來請遠端連線至您的目標裝置，或者在您的目標裝置上開啟終端機，並輸入以下指令拉取 image：&lt;/p&gt;
&lt;pre&gt;&lt;code&gt;docker pull ghcr.io/&amp;lt;username&amp;gt;/&amp;lt;image-name&amp;gt;:latest
&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;&lt;img src=&quot;./pullimage.png&quot; alt=&quot;拉取 Image&quot; /&gt;
拉取完成後，即可輸入以下指令建立容器並執行 image：&lt;/p&gt;
&lt;pre&gt;&lt;code&gt;docker run -d --name &amp;lt;container-name&amp;gt; -p 3000:3000 --restart=unless-stopped ghcr.io/&amp;lt;username&amp;gt;/&amp;lt;image-name&amp;gt;:latest
&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;:::note&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;&lt;code&gt;&amp;lt;container-name&amp;gt;&lt;/code&gt; 請替換成您想要設定的容器名稱。&lt;/li&gt;
&lt;li&gt;&lt;code&gt;-p 3000:3000&lt;/code&gt; 的部分是設定容器的 port，左邊的 &lt;code&gt;3000&lt;/code&gt; 是您想要設定的 port，右邊的 &lt;code&gt;3000&lt;/code&gt; 是 container 內部的 port，若您的主機上的 &lt;code&gt;3000&lt;/code&gt; port 已經被使用，請將左邊的 port 改為其他 port。若您使用 Cloudflare Tunnel，則可以省略此參數，稍後在 Tunnel 設定時僅需 protocol 設定成 &lt;code&gt;http&lt;/code&gt;，IP 直接輸入 &lt;code&gt;&amp;lt;container-IP&amp;gt;:3000&lt;/code&gt; 即可，&lt;code&gt;&amp;lt;container-IP&amp;gt;&lt;/code&gt; 可以使用 &lt;code&gt;docker inspect &amp;lt;container-name&amp;gt; | grep &quot;IPAddress&quot;&lt;/code&gt; 指令查看，或前往維運面版的 Docker 管理相關頁面查看。
:::
確定容器執行成功後，請進行端口映射或者 Cloudflare Tunnel 設定。在完成設定後，輸入域名或者 IP 即可看到您的網站。&lt;/li&gt;
&lt;/ul&gt;
&lt;h2&gt;Wrapping Up&lt;/h2&gt;
&lt;p&gt;這次的文章雖然主要是以 Astro 靜態網站為例，但是其實只要是靜態網站專案，都可以使用此方法進行部署。雖然說目前沒有什麼自訂義可言，但是對於一般的靜態網站來說，這個 image 已經足夠使用了。並且打包方式也是非常的簡單，只要準備好靜態網站的檔案，然後撰寫好 dockerfile，再透過 GitHub Actions 自動化 build image，即可輕鬆部署您的靜態網站，真的是相當方便呢！&lt;/p&gt;
&lt;p&gt;如果您有任何問題或者建議，歡迎在下方留言，如果文章有任何錯誤，也請不吝指正，謝謝！&lt;/p&gt;
&lt;h2&gt;GitHub Repo of This Tutorial&lt;/h2&gt;
&lt;p&gt;::github{repo=&quot;Kayxue/ActixStaticServeTutorial&quot;}&lt;/p&gt;
</content:encoded></item><item><title>ActixStaticServe Docker Image 使用教學</title><link>https://blog.kayxue.dev/posts/actixstaticserve/</link><guid isPermaLink="true">https://blog.kayxue.dev/posts/actixstaticserve/</guid><description>ActixStaticServe Docker Image 使用教學</description><pubDate>Wed, 26 Feb 2025 00:00:00 GMT</pubDate><content:encoded>&lt;p&gt;這個是一個本人製作的 Docker image，這個 Docker image 可以讓你非常容易在 Docker 上部署您的靜態網站，起初這個部分是我部落格專案的一部分，但為了部署可以順暢，故本人將此部分從本人的部落格專案獨立出來，也順便將打包過後的 image 分享出去，讓可能需要用的人可以使用。並且因為使用 Actix-web，所以執行時所佔資源極低，並且壓縮完 image 只有大約 1.02KB 左右，所以個人感覺此 image 非常適合使用在單板電腦上，各位想試用看看的話非常歡迎喔！
::github{repo=&quot;Kayxue/ActixStaticServe&quot;}
:::warning&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;&lt;strong&gt;無自訂：&lt;/strong&gt; 此 image 目前並不支援自訂任何 server 相關設定。伺服器預設監聽位置為 &lt;code&gt;0.0.0.0:3000&lt;/code&gt;，並且預設 serving &lt;code&gt;/public&lt;/code&gt; 資料夾&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;不包含任何終端機：&lt;/strong&gt; 此 image 奠基於 Docker 保留的最小映像—scratch，所以此 image 不包含任何終端機！並且只能執行無需任何依賴的執行檔！
:::&lt;/li&gt;
&lt;/ul&gt;
&lt;h2&gt;Docker File Usage Example&lt;/h2&gt;
&lt;pre&gt;&lt;code&gt;FROM ghcr.io/kayxue/actixstaticserve:latest

WORKDIR /

COPY ./public/ ./public/
&lt;/code&gt;&lt;/pre&gt;
&lt;ul&gt;
&lt;li&gt;第一行的部分是代表從 &lt;code&gt;ghcr.io/kayxue/actixstaticserve:latest&lt;/code&gt; 開始一個新的階段&lt;/li&gt;
&lt;li&gt;第二行代表將工作資料夾設定為根目錄&lt;/li&gt;
&lt;li&gt;第三行的部分是將您的靜態網站複製至 image 中的 &lt;code&gt;/public&lt;/code&gt; 資料夾&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;沒錯，用起來非常簡單吧！以下順便再給各位一個範例&lt;/p&gt;
&lt;h2&gt;Example: Using with an Astro Static Site Project&lt;/h2&gt;
&lt;p&gt;:::note
在此以 Bun 為例，實際 first stage 使用哪個 image 請依據您使用的程式語言與 package manager 而定。
:::&lt;/p&gt;
&lt;pre&gt;&lt;code&gt;FROM oven/bun:alpine AS builder

WORKDIR /app
COPY . .

RUN bun install
RUN bun run build

FROM ghcr.io/kayxue/actixstaticserve:latest

WORKDIR /

COPY --from=builder /app/dist/ ./public/
&lt;/code&gt;&lt;/pre&gt;
&lt;h2&gt;Contribution&lt;/h2&gt;
&lt;p&gt;此 repo 歡迎各位進行貢獻，若您想要貢獻，請遵守 &lt;a href=&quot;https://www.rust-lang.org/policies/code-of-conduct&quot;&gt;Code of Conduct&lt;/a&gt;&lt;/p&gt;
</content:encoded></item><item><title>Flutter App 1 - First App Created with Using AI</title><link>https://blog.kayxue.dev/posts/flutterapp1/</link><guid isPermaLink="true">https://blog.kayxue.dev/posts/flutterapp1/</guid><description>使用 Flutter 和 AI 開發第一個 App</description><pubDate>Tue, 25 Feb 2025 00:00:00 GMT</pubDate><content:encoded>&lt;p&gt;個人最近因為系上物聯網課程剛開始，所以目前有在稍微研究 WebSocket，但因為都感覺沒有什麼好用的 WebSocket Client，所以藉這次作業的機會，我決定看 AI 看能不能幫我做一個。&lt;/p&gt;
&lt;h2&gt;1st Version&lt;/h2&gt;
&lt;p&gt;:::tip[PROMPT]
please develop a simple websocket application which can send message to websocket server and show message from websocket server
:::
畫面截圖
&lt;img src=&quot;./version1/1_XLnlzADYdaJPWFxhwzj6Jg.webp&quot; alt=&quot;&quot; /&gt;
感覺還不錯，只是標題感覺有點不合適，所以自己修改了一下標題，也順便將連上的 WebSocket Server 換成我自己的。但修改完成後，App 剛執行時卻直接噴錯誤，錯誤為 &lt;code&gt;SocketException: connection refused&lt;/code&gt;，切到我寫的 WebSocket Server 專案才發現我的 server 忘了開，所以問題不大，開了以後那個錯誤就消失了。修改之後如下圖所示：
&lt;img src=&quot;./version1/1_4jZO1Mm5Ge36hssKGO5kRg.webp&quot; alt=&quot;&quot; /&gt;
所以個人感覺或許可以在下一版實作個開關，以啟動或關閉連線&lt;/p&gt;
&lt;h2&gt;2nd Version&lt;/h2&gt;
&lt;p&gt;:::tip[PROMPT]
Please insert a row above the text input, and it contains a text and a switch, text is on the left and content is &quot;Connection Status: {status}&quot; where {status} is current connection status, switch is on the right, if it turn on, establish the connection, or else close the connection.
:::
軟體畫面與使用效果截圖：
&lt;img src=&quot;./version2/1_ARmSvKJB1noxL7Q_VCpzmA.webp&quot; alt=&quot;&quot; /&gt;
看一下 server 的 console:
&lt;img src=&quot;./version2/1_J2blSCxbrsvUkdd9H1Zj8g@2x.webp&quot; alt=&quot;&quot; /&gt;
那些 Session closed 訊息皆是在關掉 switch 後出現的，所以程式部分目前沒問題。接下來就是小防禦的部分，其實在第一版剛修改完時直接啟動，他會直接噴 &lt;code&gt;SocketException&lt;/code&gt;，並且程式直接變成無法載入，所以接下來就是要對無法連線的狀況進行處理&lt;/p&gt;
&lt;h2&gt;3rd Version&lt;/h2&gt;
&lt;p&gt;:::tip[PROMPT]
please add a checking to check whether can connect to websocket server after user toggled the switch, if can&apos;t connect to the websocket server, please show a toast &quot;Can&apos;t connect to websocket server&quot; and remain the switch in off state
:::
沒操作時畫面跟上一版是一樣的，所以在此不放了。&lt;/p&gt;
&lt;p&gt;但是滿懷期待的先關掉 server，然後點一下連線開關，結果很不幸的……又是 Connection refused：
&lt;img src=&quot;./version3/1_N87R_JNThR4WwOn46KMkog@2x.webp&quot; alt=&quot;&quot; /&gt;
我嘗試下了一個 prompt：
:::tip[PROMPT]
After I toggle the switch when server down, the app throws SocketException: connection refused
:::
然後 GitHub Copilot 跟我講說修復了，結果安裝程式並操作後還是噴出了一樣的錯誤，還好我以前有看過一些 Dart 官方教學，所以我稍微觀察了一下，相較修改前，我發現他只是增加 &lt;code&gt;SocketException&lt;/code&gt; 處理罷了（圖中上方）：
&lt;img src=&quot;./version3/1_zhOjv_-SLJMbbAlmKWMCUg@2x.webp&quot; alt=&quot;&quot; /&gt;
可見這個問題 AI 似乎已經不知道怎麼處理了，且該問題並不是這樣處理的，所以我只好先把程式碼還原，並開始自己處理。
首先找到了模組的網站，發現剛剛他是裝舊版的，所以先使用 &lt;code&gt;flutter pub add web_socket_channel&lt;/code&gt; 進行了模組更新。&lt;/p&gt;
&lt;p&gt;https://pub.dev/packages/web_socket_channel&lt;/p&gt;
&lt;p&gt;&lt;img src=&quot;./version3/1_ZIdLgCNwO6gHMuSwusYlhw@2x.webp&quot; alt=&quot;&quot; /&gt;
接下來就是找整個的問題所在，既然是連線出問題，稍微看了一下 Flutter 官方的教學，知道了進行連線的方法是 &lt;code&gt;WebSocketChannel#connect&lt;/code&gt; ，所以在 docs 裡找 &lt;code&gt;WebSocketChannel&lt;/code&gt; 類別的 &lt;code&gt;connect&lt;/code&gt; 方法或許會有相關線索。幸運的是我稍微找一下就挖到了，並且從下圖可以看到該方法是一個 static method:
&lt;img src=&quot;./version3/1_IrAnuPhAXnsgL59Ex__1EA@2x.webp&quot; alt=&quot;&quot; /&gt;
點進去後，發現了關鍵線索：
&lt;img src=&quot;./version3/1_4ib5EbDgSzn31TPVTrXF2Q@2x.webp&quot; alt=&quot;&quot; /&gt;
所以可見該方法執行時，他會以 synchronous 的方式傳回 WebSocketChannel 物件，但是發起連線這動作並不是同步的，並且 &lt;code&gt;ready&lt;/code&gt; 這個 future 會在連線成功後完成，如果有錯誤的話，它會結束並丟出錯誤。
可見解決問題的關鍵是 &lt;code&gt;ready&lt;/code&gt; 這個 future，點一下該段落中的 &lt;code&gt;ready&lt;/code&gt;，進到了該屬性的 docs 頁面，解決方案總算出現了：
&lt;img src=&quot;./version3/1__6rfRkNherFRjqxYtggLaA@2x.webp&quot; alt=&quot;&quot; /&gt;
在這就可以跟著範例直接將正確程式碼寫入，寫好正確程式碼後，再透過註解插入法請 AI 插入個 Toast 的程式碼，讓連線成功時會顯示 Toast。
&lt;img src=&quot;./version3/1_4cIEQ4CyKODAjQfd4qwqpw@2x.webp&quot; alt=&quot;&quot; /&gt;
此時提示出現了：
:::note
Don&apos;t use &apos;BuildContext&apos;s across async gaps.
Try rewriting the code to not use the &apos;BuildContext&apos;, or guard the use with a &apos;mounted&apos; check.
:::
上網查了一下，大概知道了如何採用以上訊息後半提的方法解決，不過因為目前程式個人看上去沒有什麼關於程式執行時 unmount 的部分，所以這部分個人就決定先不處理。
接下來本人又下了一個 prompt 請 AI 加上程式碼，當使用者點開關關閉連線時，會顯示 Toast:
:::tip[PROMPT]
Show a toast when user toggle the switch to close connection
:::
無法連線效果：
&lt;img src=&quot;./version3/1__VFWwKGivdL0Q5Y0PmZ2HQ.gif&quot; alt=&quot;&quot; /&gt;
最後看出來怎麼搞個 Toast 後，最後自己也針對沒連線或沒輸入訊息的狀況新增了 Toast：
&lt;img src=&quot;./version3/1_2NFrofb38W4usbY2DpnPAw.gif&quot; alt=&quot;&quot; /&gt;
但是稍後成功和 server 連線後，點 switch 關閉連線時卻又不幸發生了 Exception:
:::caution[ERROR]
Invalid argument: 1001, close code must be 1000 or in the range 3000–4999
:::
所以可見是關閉連線時出了問題，看了一下，當時 AI 在寫時幫我在關閉連線時加了 status code，所以當下本人決定先把 status code 先移除，結果問題就這樣解決了。
原始 AI 寫的：
&lt;img src=&quot;./version3/1_IdkMzhmUbrFZNLT7wlc4xQ@2x.webp&quot; alt=&quot;&quot; /&gt;
然後下了這版最後一個 prompt，讓 Toast 顯示時間短一點：
:::tip[PROMPT]
Change all toast display time to 2 secs
:::
最終效果（無法連線的部分就不展示了）：
&lt;img src=&quot;./version3/1_xjALUMcvowPO5QoMWV_odw.gif&quot; alt=&quot;&quot; /&gt;
接下來就是依作業要求加點圖片，然後還有聲音&lt;/p&gt;
&lt;h2&gt;4th Version&lt;/h2&gt;
&lt;p&gt;因為畢竟是工具軟體，圖片與音效自然會不太容易融入，不如在左下角加個圖片小按鈕當做作者小頭像，並且在送出訊息時加個音效吧！
首先先用 prompt 在畫面左下角插入有圖片的懸浮按鈕吧：
:::tip[PROMPT]
Add a flow button locate at bottom-left of the screen, and which can display a picture
:::
結果寫錯了一個單字，並且 AI 幫我加了不是我想要的程式碼，所以只好還原重寫：
:::tip[PROMPT]
Add a floating button at the bottom-left of the screen, and filling textures is a picture
:::
這次 AI 比較理解了，只是他還是插入了一個不是我預期的點擊監聽器，等一下再搞成自己需要的功能吧：
&lt;img src=&quot;./version4/1_tohzLs0lac2FUsj7ihM6EA@2x.webp&quot; alt=&quot;&quot; /&gt;
在這先自己把按鈕改成想要的樣子：
&lt;img src=&quot;./version4/1_3NPEkBnJzlQTylEBtzchDA@2x.webp&quot; alt=&quot;&quot; /&gt;
結果按鈕位置非常奇怪，並且圖片也整個使按鈕失去了原有形狀：
&lt;img src=&quot;./version4/1_35reQJ5hYezDfGQfp-jJfQ.webp&quot; alt=&quot;&quot; /&gt;
所以又在檔案中的元件屬性內寫註解 prompt:&lt;/p&gt;
&lt;pre&gt;&lt;code&gt;//Make the button fill with the image
&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;結果 AI 新增程式碼後儲存，圖片直接變成了圓型
&lt;img src=&quot;./version4/1_escn5IJungrxSqL34R1lUw.webp&quot; alt=&quot;&quot; /&gt;
再次找了 AI:
:::tip[PROMPT]
Change avatar to rounded square
:::
雖然變成圓角方形，但圓角的部分跟按鈕還是有點不合拍，所以最後自行調整了圓角程度，好看多了，順帶一提，鳩真的好可愛喔.w.
&lt;img src=&quot;./version4/1_RP4wzMIgjHRcGPLFzyY4kA.webp&quot; alt=&quot;&quot; /&gt;
嘗試請 AI 修復左下角按鈕與左螢幕邊界距離：
:::tip[PROMPT]
make bottom-left corner button a little bit futher to left screen margin, just like bottom-right corner button
:::
結果請 AI 調整許久還是沒辦法調好位置，最後只能自行調整了
&lt;img src=&quot;./version4/1_F79qILXZw4WhhTDz3nrmiw.webp&quot; alt=&quot;&quot; /&gt;
接下來就是點擊後的效果部分，這邊個人決定是點了會出現製作者的名字：
:::tip[PROMPT]
When click on bottom-left corner button, show a toast to display creator&apos;s name
:::
效果如下：
&lt;img src=&quot;./version4/1_b5zmI07JxDp8iluzhqz6tQ.gif&quot; alt=&quot;&quot; /&gt;&lt;/p&gt;
&lt;h2&gt;5th Version&lt;/h2&gt;
&lt;p&gt;接下來就是送出音效的部分：
:::tip[PROMPT]
Play a sound before sending a message
:::
AI 剛修改完，程式碼馬上跳紅線，按接受後輸入 &lt;code&gt;flutter pub add audioplayers&lt;/code&gt; 即可，只是個人覺得有點扯的是為什麼他都不是給你裝最新的，還要自己再輸入一次才能裝到最新的。
找好音檔，將東西放入資料夾並寫好相關東西後，然後改個程式碼就 OK 了
&amp;lt;div style=&quot;position:relative; width:100%; height:0px; padding-bottom:216.216%&quot;&amp;gt;&amp;lt;iframe allow=&quot;fullscreen&quot; allowfullscreen height=&quot;100%&quot; src=&quot;https://streamable.com/e/8etoz3?&quot; width=&quot;100%&quot; style=&quot;border:none; width:100%; height:100%; position:absolute; left:0px; top:0px; overflow:hidden;&quot;&amp;gt;&amp;lt;/iframe&amp;gt;&amp;lt;/div&amp;gt;&lt;/p&gt;
&lt;h2&gt;6th Version&lt;/h2&gt;
&lt;p&gt;最後再做一點小美化跟人性化，因為最近我也不知道為什麼某天我突然上網去查 switch 元件的 docs，發現它可以在開關上插入小圖示，所以接下來就來在 switch 上插入小圖示吧
:::tip[PROMPT]
Add icons to switch, and the icon can be changed, the icon to change depends on connection status
:::
結果沒想到出現在了奇怪的位置，這真的不是我想要的
&lt;img src=&quot;./version6/1_SBqCN81QXwr5MYb6sWBGSQ.webp&quot; alt=&quot;&quot; /&gt;
原本以為又是我要自己動手的時候了，但最後決定換了一個 prompt 再次嘗試，他終於理解我想要加什麼了：
:::tip[PROMPT]
Add icons on switch, and the icon can be changed, the icon to change depends on connection status
:::
但是最好笑的是他居然是換成本地沒有的 asset，我 hot reload 看到錯誤才知道你這樣搞，請問你認真的？
&lt;img src=&quot;./version6/1_PijasVI1UFtgRdeVpQaQBw@2x.webp&quot; alt=&quot;&quot; /&gt;
因為真的不知道怎樣再下 prompt 了，所以只能看官方文件範例開改，這 AI 感覺有點……
&lt;img src=&quot;./version6/1_n8Ek8-aMv04C8QN7Ms_nqg@2x.webp&quot; alt=&quot;&quot; /&gt;
中途我知道你想幫我，但不好意思，我想用比較保險的官方做法
&lt;img src=&quot;./version6/1_Y5-P4qhHduFgUA_3ZLrw0g@2x.webp&quot; alt=&quot;&quot; /&gt;
效果：
&lt;img src=&quot;./version6/1_f7MIwJXLlJpcNOlZ7dGFtw.gif&quot; alt=&quot;&quot; /&gt;
接下來就是字型，照著老師給的文章設定，然後下 prompt 請 AI 幫我換：
:::tip[PROMPT]
Add font to all text
:::
結果全數報錯， 請問 AI 你資料還太少嗎？
&lt;img src=&quot;./version6/1_cWj6D6lbme0Eq4nEarEl5w@2x.webp&quot; alt=&quot;&quot; /&gt;
所以只能先接受，然後自己看 docs 換，超大一坨
&lt;img src=&quot;./version6/1_WaoSvkC9ASvmKT9-u3PGeQ@2x.webp&quot; alt=&quot;&quot; /&gt;
但到後面我才不知道為什麼自己剛剛要那樣做
&lt;img src=&quot;./version6/1_QIdX_l1uPOBhIpunbg3NnA@2x.webp&quot; alt=&quot;&quot; /&gt;
到後面才發現官方其實有寫怎麼套全域字體，所以後來自己就把套字體方式換成 docs 上面寫的了
套用字型後效果可以說是非常好
&lt;img src=&quot;./version6/1_dojWjHG936DMhrNNmDb57Q.webp&quot; alt=&quot;&quot; /&gt;
最後自己換個不錯的顏色
&lt;img src=&quot;./version6/1_I3EYyIfeGRcjU8-9jCy4hw.webp&quot; alt=&quot;&quot; /&gt;&lt;/p&gt;
&lt;h2&gt;7th Version - Final Challenge&lt;/h2&gt;
&lt;p&gt;這樣的 app 其實基本上來說已經算不錯了，但是不知道哪來的想法……最後就來搞發通知吧！這個除了是對 AI 的最後考驗，但或許也是最多我需要自己動手的部分了！接下來就準備開始吧！首先，第一個 prompt:
:::tip[PROMPT]
Send a notification when receive message from websocket server
:::
結果按下接受變更，補模組後，程式剛執行時卻馬上被編譯器打臉：
&lt;img src=&quot;./version7/1_rM65Hin0TJm4JN0XvTuhrg@2x.webp&quot; alt=&quot;&quot; /&gt;
簡單來講就是我沒有針對 iOS 進行設定，在此就請 AI 先幫忙設定：
:::tip[PROMPT]
Pease set up notification settings for iOS
:::
但是這波看起來 AI 資料還沒更新，插了一個 linting 不認識的東西進去
&lt;img src=&quot;./version7/1_kt7T4B7WYAVCaEExcVWK6Q@2x.webp&quot; alt=&quot;&quot; /&gt;
滑鼠滑上去 &lt;code&gt;InitializationSettings&lt;/code&gt; 類別 constructor 的 &lt;code&gt;ios&lt;/code&gt; property 上其實不難發現 AI 寫錯型別了……我自己改吧！
&lt;img src=&quot;./version7/1_tt9w9sF3kXEVUMObePJQuw@2x.webp&quot; alt=&quot;&quot; /&gt;
下方 &lt;code&gt;IOSNotificationDetails&lt;/code&gt; 也是跟剛剛一樣的做法進行探索跟修正
&lt;img src=&quot;./version7/1_82un7WHTLNkcY_e_MLtbCQ@2x.webp&quot; alt=&quot;&quot; /&gt;
修改完後啟動 app，看到了這個東西，在這按下接受吧！這個時候，應該距離成功已經不遠了！
&lt;img src=&quot;./version7/1__klYrlalrr5rWKwEHVyHIw.webp&quot; alt=&quot;&quot; /&gt;
結果很不幸的，錯了……請問通知呢？
&lt;img src=&quot;./version7/1_HdbyCY-JFDxGt-A37-dZCQ.gif&quot; alt=&quot;&quot; /&gt;
這應該不是 Flutter 本身的問題吧？如果有或許早拋 exception 了。
所以只好去模組的介紹頁看有沒有一些線索，結果終於找到問題所在。
&lt;img src=&quot;./version7/1_q51fz82hQ6qNIdXs_GNSPw@2x.webp&quot; alt=&quot;&quot; /&gt;
以上作者大概的意思是說你需要將下方對應程式語言程式碼插入 &lt;code&gt;AppDelegate.swift&lt;/code&gt; 檔案，雖然剛開始看到檔案不知道是要怎麼處理，但是還好作者有給範例，看了就知道了，如下插入即可：
&lt;img src=&quot;./version7/1_h_lV_-JdwEO9bi24rG0BkA@2x.webp&quot; alt=&quot;&quot; /&gt;
最後就是一個小 bug，通知會在關閉連線時再次送出，在此本人自己手動加個 state 和一些程式碼防止後，問題就消失了：
&lt;img src=&quot;./version7/1_jGwK3XOlU2_6nM1K0C2d-g@2x.webp&quot; alt=&quot;&quot; /&gt;
&lt;img src=&quot;./version7/1_T04qoyZavm3QgLPq-rYqsQ@2x.webp&quot; alt=&quot;&quot; /&gt;
&lt;img src=&quot;./version7/1_6zNsk_DkkHoR_ZUgy5bUbg@2x.webp&quot; alt=&quot;&quot; /&gt;
最後來享受成果吧！&lt;/p&gt;
&lt;h2&gt;Finished Version&lt;/h2&gt;
&lt;p&gt;無法連上 WebSocket 狀況與無連線展示：
&amp;lt;div style=&quot;position:relative; width:100%; height:0px; padding-bottom:216.216%&quot;&amp;gt;&amp;lt;iframe allow=&quot;fullscreen&quot; allowfullscreen height=&quot;100%&quot; src=&quot;https://streamable.com/e/sjil94?&quot; width=&quot;100%&quot; style=&quot;border:none; width:100%; height:100%; position:absolute; left:0px; top:0px; overflow:hidden;&quot;&amp;gt;&amp;lt;/iframe&amp;gt;&amp;lt;/div&amp;gt;&lt;/p&gt;
&lt;p&gt;其他部分展示：
&amp;lt;div style=&quot;position:relative; width:100%; height:0px; padding-bottom:216.216%&quot;&amp;gt;&amp;lt;iframe allow=&quot;fullscreen&quot; allowfullscreen height=&quot;100%&quot; src=&quot;https://streamable.com/e/1mzz4n?&quot; width=&quot;100%&quot; style=&quot;border:none; width:100%; height:100%; position:absolute; left:0px; top:0px; overflow:hidden;&quot;&amp;gt;&amp;lt;/iframe&amp;gt;&amp;lt;/div&amp;gt;&lt;/p&gt;
&lt;h2&gt;Github Repo&lt;/h2&gt;
&lt;p&gt;:::warning[自行使用注意]
自行使用注意：此應用程式目前所連線的 WebSocket server 仍為本人自己寫的本地 server 位置，若想測試效果，請將 WebSocket server 連線位置改成 &lt;code&gt;wss://echo.websocket.events&lt;/code&gt; 或者你自己寫的 WebSocket server 位置。並且若在 iOS 之外系統執行，因為本人沒有進行特別設定，故無法看到通知，請見諒。
:::
::github{repo=&quot;Kayxue/MyFirstFlutterApp&quot;}&lt;/p&gt;
&lt;h2&gt;Wrapping Up&lt;/h2&gt;
&lt;p&gt;不得不說 AI 真的蠻強大的，對於這種 app 來說，在我對 Flutter 不熟的狀況下，可能自己不知道寫出來要花多久時間，但只要交給 AI，只要跟他講你想要有怎樣的東西，他就可以幫你做出來，雖然說還是會有錯的可能，但是確實是一個可以減輕自己工作負擔的一個好工具。&lt;/p&gt;
&lt;h2&gt;Image Resource&lt;/h2&gt;
&lt;p&gt;&amp;lt;blockquote class=&quot;twitter-tweet&quot;&amp;gt;&amp;lt;p lang=&quot;qme&quot; dir=&quot;ltr&quot;&amp;gt;&amp;lt;a href=&quot;https://twitter.com/hashtag/Phigros_art?src=hash&amp;amp;ref_src=twsrc%5Etfw&quot;&amp;gt;#Phigros_art&amp;lt;/a&amp;gt; &amp;lt;a href=&quot;https://t.co/m9NqVDCaJX&quot;&amp;gt;pic.twitter.com/m9NqVDCaJX&amp;lt;/a&amp;gt;&amp;lt;/p&amp;gt;— 蒼紫 (@tit_phin3005) &amp;lt;a href=&quot;https://twitter.com/tit_phin3005/status/1891825480757657965?ref_src=twsrc%5Etfw&quot;&amp;gt;February 18, 2025&amp;lt;/a&amp;gt;&amp;lt;/blockquote&amp;gt; &amp;lt;script async src=&quot;https://platform.twitter.com/widgets.js&quot; charset=&quot;utf-8&quot;&amp;gt;&amp;lt;/script&amp;gt;&lt;/p&gt;
</content:encoded></item><item><title>如何使用 Thunder Client 測試 API</title><link>https://blog.kayxue.dev/posts/thunderclient/</link><guid isPermaLink="true">https://blog.kayxue.dev/posts/thunderclient/</guid><description>一個 Thunder Client 使用小教學</description><pubDate>Mon, 09 Dec 2024 00:00:00 GMT</pubDate><content:encoded>&lt;p&gt;或許各位有一些使用 API 的經驗或者撰寫 API 的經驗，但是測試 API 時，如果沒有簡易的測試工具，對於新手來講會是一件麻煩的事。不只要自己額外手動安裝 API Client 軟體，還有的甚至還要學指令，對於剛開始接觸的人來說有一定的門檻。所以今天我們要來介紹一款擁有圖形界面的 API Client 測試工具，除了功能強大，且只要你有裝 VSCode 系列編輯器（Visual Studio Code、VSCodium、Code-OSS 等，以下簡稱 VSCode），即可直接從擴充商店直接安裝並使用，可謂相當方便。&lt;/p&gt;
&lt;p&gt;:::warning&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;本文只會講解基礎用法與免費功能，對於其他進階用法或付費功能的部分，請自行前往&lt;a href=&quot;https://docs.thunderclient.com/&quot;&gt;官方文件&lt;/a&gt;了解相關內容&lt;/li&gt;
&lt;li&gt;此文章會涉及到程式碼撰寫，本文會簡單解釋程式碼的用意，但如果想更深入研究程式碼中所使用的語法和框架用法等資訊，請自行利用 Google 進行查詢。
:::&lt;/li&gt;
&lt;/ul&gt;
&lt;h2&gt;What is Thunder Client?&lt;/h2&gt;
&lt;p&gt;Thunder Client 是一個可以用來測試 API 的輕量級 Rest API Client，由 Ranga Vadhineni 製作，該擴充其中包含了不少的功能，例如 Local Storage，將 request 資料同步至 Git 等好用功能。
&lt;img src=&quot;https://hackmd.io/_uploads/HJixpRfE1l.png&quot; alt=&quot;&quot; /&gt;
雖然說現在他們已經盈利化了，不少功能都要收費，但是基本上單純小小測試一個基礎 API 基本上個人覺得已經夠用了，如果你還是學生、教師或者你是有在經營小企業，你也可以選擇申請 Community Plan，以下是官網的小介紹：
&lt;img src=&quot;https://hackmd.io/_uploads/S1m_xk7Ekx.png&quot; alt=&quot;&quot; /&gt;
申請方式的話也不會很麻煩，點選左上角「聯絡」，然後填寫所有欄位，並且詢問類型選擇 &lt;code&gt;Community License&lt;/code&gt;，送出後等待消息
&lt;img src=&quot;https://hackmd.io/_uploads/B19NfJ7Nyg.png&quot; alt=&quot;&quot; /&gt;
&lt;img src=&quot;https://hackmd.io/_uploads/BJsofkXNkx.png&quot; alt=&quot;&quot; /&gt;
最後在這裡附上官網的功能比較表給各位參考一下：
&lt;img src=&quot;https://hackmd.io/_uploads/B1lWl1X4Jg.png&quot; alt=&quot;&quot; /&gt;&lt;/p&gt;
&lt;h2&gt;Let&apos;s Create a Micro API First!&lt;/h2&gt;
&lt;p&gt;雖然說現在網路上有公開的 API 其實一大堆，但為了後續的教學方便，還有方便各位進行實驗，所以我們先來自行架設一個 API 吧！&lt;/p&gt;
&lt;p&gt;:::note
此節會帶各位使用 Deno 執行環境和 Hono 框架進行架設，如果你有自己習慣的框架或者 Runtime Environment，您也可以選擇自行架設，並跳至下一章節。
:::&lt;/p&gt;
&lt;h3&gt;Install Runtime Environment&lt;/h3&gt;
&lt;p&gt;首先，我們先來安裝 Deno 吧！&lt;/p&gt;
&lt;h4&gt;Windows&lt;/h4&gt;
&lt;p&gt;請以系統管理員身份開啟一個 Powershell，並輸入以下指令：&lt;/p&gt;
&lt;pre&gt;&lt;code&gt;irm https://deno.land/install.ps1 | iex
&lt;/code&gt;&lt;/pre&gt;
&lt;h4&gt;Mac/Linux&lt;/h4&gt;
&lt;p&gt;請開啟終端機並輸入以下指令：&lt;/p&gt;
&lt;pre&gt;&lt;code&gt;curl -fsSL https://deno.land/install.sh | sh
&lt;/code&gt;&lt;/pre&gt;
&lt;h3&gt;Prepare Project&lt;/h3&gt;
&lt;p&gt;接下來我們要建立一個專案，請在你喜歡的位置建立一個新的資料夾，並且在 VSCode 中開啟
&lt;img src=&quot;https://hackmd.io/_uploads/SkqSbem4Jg.png&quot; alt=&quot;&quot; /&gt;
再來請點選 VSCode 左邊 sidebar 上的擴充功能，然後在上方搜尋框搜尋 &lt;code&gt;Deno&lt;/code&gt; 並安裝以下擴充功能：
&lt;img src=&quot;https://hackmd.io/_uploads/HkZ6Qxm4Jx.png&quot; alt=&quot;&quot; /&gt;
然後請先在該專案資料夾下建立一個 &lt;code&gt;deno.json&lt;/code&gt; 檔案，以利 Deno Extension 自動識別此專案為 Deno 類型的專案&lt;/p&gt;
&lt;h3&gt;Let&apos;s Start coding!&lt;/h3&gt;
&lt;p&gt;請在專案資料夾下新增 &lt;code&gt;main.ts&lt;/code&gt; 檔案，並且輸入以下內容：&lt;/p&gt;
&lt;pre&gt;&lt;code&gt;import { Hono } from &quot;jsr:@hono/hono&quot;;

const hono = new Hono();

hono.get(&quot;/&quot;, (c) =&amp;gt; {
    return c.text(&quot;Hello Hono!&quot;);
});

Deno.serve({ port: 3000 }, hono.fetch);
&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;:::note
若匯入模組時出現找不到模組之類的錯誤訊息，通常是因為您安裝或更新 Deno 後第一次匯入該模組，請先稍等一下，該錯誤便會自動消失。若過了一段時間後沒有消失，請自行將滑鼠游標移到紅色波浪線上，會出現一個錯誤提示訊息框，滑到錯誤提示框最下方，點選「快速修復」-&amp;gt; &lt;code&gt;Install xxx as dependencies&lt;/code&gt;，Deno 就會自動安裝所需模組。
:::&lt;/p&gt;
&lt;p&gt;在此檔案中，我們定義了一個 Hono Instance，並且定義了根路徑在接受到 &lt;code&gt;Get&lt;/code&gt; 請求時的處理方式：Server 在接收到請求後，會傳回一段文字（也就是 &lt;code&gt;Hello Hono&lt;/code&gt;）給請求者。定義完路徑之後，之後透過 &lt;code&gt;Deno.serve&lt;/code&gt; 建立一個監聽端口 &lt;code&gt;3000&lt;/code&gt; 的 Web Server，並且在接收到 request 之後，將 request 交給 hono 處理。&lt;/p&gt;
&lt;h3&gt;Run the project&lt;/h3&gt;
&lt;p&gt;接下來，請在專案資料夾下開啟一個新的終端機，並輸入以下指令：&lt;/p&gt;
&lt;pre&gt;&lt;code&gt;# 下方 -N 參數的話 -N 或 --allow-net 皆可，表允許進行網路存取
deno run -N main.ts
&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;順利的話，您會在終端機看到以下訊息：&lt;/p&gt;
&lt;pre&gt;&lt;code&gt;Listening on http://0.0.0.0:3000/
&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;之後打開網路瀏覽器，並前往上方訊息所列出的網址，即可看到 API Server 的回應
&lt;img src=&quot;https://hackmd.io/_uploads/r1Eqa-XEkg.png&quot; alt=&quot;&quot; /&gt;
截至目前，一個簡單的 API Server 就已經架設完畢了，接下來我們來安裝這次文章最主要的主角——Thunder Client 吧！&lt;/p&gt;
&lt;h2&gt;Install Thunder Client&lt;/h2&gt;
&lt;p&gt;接下來，我們再次點選視窗左邊 sidebar 上的「擴充功能」按鈕，然後搜尋 &lt;code&gt;Thunder&lt;/code&gt;，並安裝以下模組：
&lt;img src=&quot;https://hackmd.io/_uploads/B1QjDmQ4yl.png&quot; alt=&quot;&quot; /&gt;
安裝完成之後，在左側 sidebar 就可以看到 Thunder Client 的圖示，點一下即可開啟 Thunder Client 的介面
&lt;img src=&quot;https://hackmd.io/_uploads/ryytK7mE1e.png&quot; alt=&quot;&quot; /&gt;&lt;/p&gt;
&lt;h2&gt;First Request&lt;/h2&gt;
&lt;p&gt;剛剛我們已經安裝好 Thunder Client，現在，我們就用它來對我們的小型 API Server 發出第一個請求吧！
首先我們先點選 &lt;code&gt;New Request&lt;/code&gt; 按鈕建立一個新的請求
&lt;img src=&quot;https://hackmd.io/_uploads/Sk27F6X4Jl.png&quot; alt=&quot;&quot; /&gt;
接下來擴充會自動開啟一個新的 GUI 介面，在這裡我們就可以開始寫請求相關內容了
&lt;img src=&quot;https://hackmd.io/_uploads/SyExc67N1g.png&quot; alt=&quot;&quot; /&gt;
以我們這個小型 API 為例，在確定我們架的小型 API Server 是位於啟動的狀態後，即可在此處寫上請求連結：
&lt;img src=&quot;https://hackmd.io/_uploads/rJg_n6XNJg.png&quot; alt=&quot;&quot; /&gt;
寫完後，按下連結輸入框右側的 &lt;code&gt;Send&lt;/code&gt; 即可送出請求，稍微等一下，即可在右側看到 API Server 回應的內容了！
&lt;img src=&quot;https://hackmd.io/_uploads/BJ0Dp6mE1e.png&quot; alt=&quot;&quot; /&gt;&lt;/p&gt;
&lt;h2&gt;Create Collections&lt;/h2&gt;
&lt;p&gt;在繼續下去之前，我們先來建立 collection 吧！在沒有建立 collection 的時候，過去所送出的 request 皆只會出現在 Thunder Client 的 &lt;code&gt;Activity&lt;/code&gt; 列表，長久下來，在不使用搜尋功能尋找的狀況下，會造成要尋找過去請求時會非常麻煩！
&lt;img src=&quot;https://hackmd.io/_uploads/B1Ppm0XEJl.png&quot; alt=&quot;&quot; /&gt;
所以接下來我們就來建立 Collection 歸類並儲存請求吧！&lt;/p&gt;
&lt;h3&gt;Create Collections&lt;/h3&gt;
&lt;p&gt;首先，我們切換至 Thunder Client 的 &lt;code&gt;Collections&lt;/code&gt; 頁面，點選 &lt;code&gt;filter collections&lt;/code&gt; 旁邊的圖示打開選單，並選擇 &lt;code&gt;New Collection&lt;/code&gt; 來建立新的 Collection
&lt;img src=&quot;https://hackmd.io/_uploads/SJ37rR7Eye.png&quot; alt=&quot;&quot; /&gt;
接下來視窗上方會跳出一個輸入框，要你輸入 Collections 的名字，輸入完之後按下 Enter，之後我們就可以在左側 Collections List 中看到剛剛建立的 collection 了
&lt;img src=&quot;https://hackmd.io/_uploads/S1rzLCmVke.png&quot; alt=&quot;&quot; /&gt;
&lt;img src=&quot;https://hackmd.io/_uploads/H1IePAX41l.png&quot; alt=&quot;&quot; /&gt;
往後我們如果想建立請求並將其存入此 collection，我們只要將滑鼠游標移到 collection 上，右側會出現三個點，點一下打開選單後，選擇 &lt;code&gt;New Request&lt;/code&gt;
&lt;img src=&quot;https://hackmd.io/_uploads/SkCdDRXNkl.png&quot; alt=&quot;&quot; /&gt;
接下來視窗上方會出現一個輸入框，輸入你想給 request 取什麼名字後，按下 Enter 即可建立
&lt;img src=&quot;https://hackmd.io/_uploads/Sk54uAQV1l.png&quot; alt=&quot;&quot; /&gt;
&lt;img src=&quot;https://hackmd.io/_uploads/rJs__CQV1g.png&quot; alt=&quot;&quot; /&gt;
然後接下來就可以跟剛剛一樣開始寫 request 內容並測試了！
&lt;img src=&quot;https://hackmd.io/_uploads/Syg7YR7Nyx.png&quot; alt=&quot;&quot; /&gt;&lt;/p&gt;
&lt;h3&gt;Import from source&lt;/h3&gt;
&lt;p&gt;當然，如果您想測試的 API 有提供 collection 並且提供匯出功能的話，您也可以選擇從別的資源進行匯入，目前 Postman、Thunder Client、Insomnia 或者 Open API 都有支援喔！
:::note
此部分僅稍做介紹，因為免費版只有支援 Thunder Client 格式，並且只能匯入自己的 Collection，通常只會在你自己需要在別人的電腦上測試時，才會需要使用此功能，若想了解更多，請查閱&lt;a href=&quot;https://docs.thunderclient.com/features/import&quot;&gt;官方文件&lt;/a&gt;。
:::
首先，將滑鼠游標移到你想匯出的 Collection 上，點選右側的三個點按鈕開啟選單，然後選擇 &lt;code&gt;Export&lt;/code&gt; 進行匯出
&lt;img src=&quot;https://hackmd.io/_uploads/SyMMEW441l.png&quot; alt=&quot;&quot; /&gt;
匯出格式請選擇 &lt;code&gt;Thunder Client&lt;/code&gt;
&lt;img src=&quot;https://hackmd.io/_uploads/r1ZL4ZNVkl.png&quot; alt=&quot;&quot; /&gt;
接下來選擇一個合適的地方儲存即完成匯出
&lt;img src=&quot;https://hackmd.io/_uploads/ryVK4bNV1e.png&quot; alt=&quot;&quot; /&gt;
接下來將檔案轉到你想要匯入 collection 的電腦後，再次進入 Thunder Client 的 Collection 頁面，點選 &lt;code&gt;filter collections&lt;/code&gt; 右側的按鈕打開選單，並點選 &lt;code&gt;Import&lt;/code&gt; 按鈕進行匯入
&lt;img src=&quot;https://hackmd.io/_uploads/H1qGLZNEJl.png&quot; alt=&quot;&quot; /&gt;
選擇完檔案並點選 &lt;code&gt;Open&lt;/code&gt; 後，即可看到匯入完成的 collection。
&lt;img src=&quot;https://hackmd.io/_uploads/SywKI-EVyx.png&quot; alt=&quot;&quot; /&gt;&lt;/p&gt;
&lt;h2&gt;Writing Request Contents &amp;amp; Testing&lt;/h2&gt;
&lt;p&gt;再來我們來撰寫 request 的其他內容吧！在 request 的編輯器中，您可以看到他提供了非常多 request 相關撰寫與測試工具：
&lt;img src=&quot;https://hackmd.io/_uploads/BJkZnCQEye.png&quot; alt=&quot;&quot; /&gt;
接下來就來介紹一下官方免費提供的相關工具吧！&lt;/p&gt;
&lt;h3&gt;Query&lt;/h3&gt;
&lt;p&gt;Query 是屬於 URL 的一部分，他提供你或者應用程式在送出相關請求時，可以提供相關數值，讓 API 可以依據您提供的相關數值進行資料過濾等操作！
在開始介紹相關功能之前，首先我們先修改一下我們 API 的程式碼吧！現在我們有一個資料庫中存著學生的成績，並且學生的成績可以透過向 &lt;code&gt;/scores&lt;/code&gt; 發送 &lt;code&gt;GET&lt;/code&gt; request 取得，並且在 requester 有提供學生名稱的狀況下，僅傳回該學生的成績內容：&lt;/p&gt;
&lt;pre&gt;&lt;code&gt;import { Hono } from &quot;jsr:@hono/hono&quot;;

//Defining type
type studentScore = {
    name: string;
    scores: {
        chinese: number;
        english: number;
        mathematics: number;
    };
};

//Defining a small database
const studentsScore: studentScore[] = [
    {
        name: &quot;Mario&quot;,
        scores: {
            chinese: 55,
            english: 66,
            mathematics: 26,
        },
    },
    {
        name: &quot;Barry&quot;,
        scores: {
            chinese: 85,
            english: 68,
            mathematics: 94,
        },
    },
    {
        name: &quot;Isabella&quot;,
        scores: {
            chinese: 10,
            english: 67,
            mathematics: 95,
        },
    },
];

const hono = new Hono();

hono.get(&quot;/&quot;, (c) =&amp;gt; {
    return c.text(&quot;Hello Hono!&quot;);
});

//Defining Path
hono.get(&quot;/scores&quot;, (c) =&amp;gt; {
    const { name } = c.req.query();
    if (!name?.length) return c.json(studentsScore);
    const student = studentsScore.find((e) =&amp;gt; e.name === name);
    if (student) return c.json(student);
    return c.text(&quot;Student not found&quot;, 400);
});

Deno.serve({ port: 3000 }, hono.fetch);
&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;:::note&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;&lt;code&gt;4~11&lt;/code&gt; 行：定義學生成績資料的類型&lt;/li&gt;
&lt;li&gt;&lt;code&gt;14~39&lt;/code&gt; 行：定義一個小型學生成績資料庫&lt;/li&gt;
&lt;li&gt;&lt;code&gt;48~54&lt;/code&gt; 行：定義 &lt;code&gt;/scores&lt;/code&gt; 路徑在接收到 &lt;code&gt;GET&lt;/code&gt; 請求後如何處理。首先會先確認 requester 是否有提供 &lt;code&gt;name&lt;/code&gt; （也就是學生名稱）參數，若無，傳回全部學生的成績資料，有則進行查詢。若有找到指定學生成績資料，則傳回該筆學生的成績資料，否則傳回找不到資料的訊息並附加狀態碼 &lt;code&gt;400 (Bad Request)&lt;/code&gt;
:::
接下來，請先啟動 API Server，然後回到 Thunder Client 中，建立一個新的 request，並切換到 Query 編輯器
&lt;img src=&quot;https://hackmd.io/_uploads/HkvO9kVEyx.png&quot; alt=&quot;&quot; /&gt;
再填上對應的 URL，先不要加上任何 Query，並按下 &lt;code&gt;Send&lt;/code&gt; 按鈕送出請求，即可看到 API 傳回了所有學生的成績
&lt;img src=&quot;https://hackmd.io/_uploads/S12N5-4Vye.png&quot; alt=&quot;&quot; /&gt;
接下來我們來嘗試加上 Query 吧！我們到下方 Query Parameters 處，將空欄位直接填入以下資訊，此時你就會發現上方網址列也自動同步幫你加上 Query 了
&lt;img src=&quot;https://hackmd.io/_uploads/BkXnc-EVJe.png&quot; alt=&quot;&quot; /&gt;
送出請求，你會發現 API 傳回的資訊變成了只有學生 Mario 的成績資料
&lt;img src=&quot;https://hackmd.io/_uploads/B1uSob4Eye.png&quot; alt=&quot;&quot; /&gt;
接下來可以點一下下方我們建立的 Query 左邊的勾勾，你就會發現那個 Query 從上方的連結中消失了，再次點選 &lt;code&gt;Send &lt;/code&gt; 按鈕你會發現傳回資料又變成了所有學生的成績資料
&lt;img src=&quot;https://hackmd.io/_uploads/SJdy2b441g.png&quot; alt=&quot;&quot; /&gt;
&lt;img src=&quot;https://hackmd.io/_uploads/H1DrnW44kg.png&quot; alt=&quot;&quot; /&gt;
再來我們稍微惡搞一下，假設我們在參數值中填的是資料庫中不存在的學生名稱呢？
&lt;img src=&quot;https://hackmd.io/_uploads/r1AA3-VE1g.png&quot; alt=&quot;&quot; /&gt;
沒錯，API 就會傳回一個學生找不到的訊息和狀態碼 &lt;code&gt;400&lt;/code&gt;
&lt;img src=&quot;https://hackmd.io/_uploads/HJh76ZNE1e.png&quot; alt=&quot;&quot; /&gt;
之後如果這個 Query 你不需要了，您可以點選該 Query 旁邊的 &lt;code&gt;X&lt;/code&gt; 按鈕從 &lt;code&gt;Query Parameters&lt;/code&gt; 刪除該參數&lt;/li&gt;
&lt;/ul&gt;
&lt;h3&gt;Headers&lt;/h3&gt;
&lt;p&gt;Request Header 是一種 HTTP Header，其可以用於發起請求時，用於告訴 Server 關於 Request Context 的相關資訊，而有些 API 也會請 requester 在向該 API 發起請求時，透過在 Header 處加上 API Key 的方式，將 API Key 傳送給 API Server。
接下來我們修改程式碼，未來將請求送至 &lt;code&gt;scores&lt;/code&gt; 路徑時，需要在 Header 提供一個金鑰，且其值需要為 &lt;code&gt;123&lt;/code&gt;，否則傳回錯誤：&lt;/p&gt;
&lt;pre&gt;&lt;code&gt;hono.get(&quot;/scores&quot;, (c) =&amp;gt; {
    const { key } = c.req.header();
    if (key !== &quot;123&quot;) return c.text(&quot;Invalid Key&quot;, 400);

    const { name } = c.req.query();
    if (!name?.length) return c.json(studentsScore);
    const student = studentsScore.find((e) =&amp;gt; e.name === name);
    if (student) return c.json(student);
    return c.text(&quot;Student not found&quot;, 400);
});
&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;修改後重新啟動 Server，回到剛剛的編輯 request 的頁面，然後點選連結輸入框下方的 &lt;code&gt;Headers&lt;/code&gt; 切換到編輯 Request Headers 的頁面，此時你會發現他已經為你新增該 API Client 預設的 Headers 了
&lt;img src=&quot;https://hackmd.io/_uploads/SkocmMV4kx.png&quot; alt=&quot;&quot; /&gt;
接下來我們先不加其他 Header，直接送出請求看一下效果如何
&lt;img src=&quot;https://hackmd.io/_uploads/H1VvNMNN1g.png&quot; alt=&quot;&quot; /&gt;
會看到他傳回了 &lt;code&gt;Invalid Key&lt;/code&gt; 訊息和狀態碼 &lt;code&gt;400&lt;/code&gt;。
此時，我們在下方 &lt;code&gt;HTTP Headers&lt;/code&gt; 處加入以下 Header
&lt;img src=&quot;https://hackmd.io/_uploads/rkFxrfVEJg.png&quot; alt=&quot;&quot; /&gt;
再次送出請求後，你就會發現 Server 再次傳回所有學生的成績了
&lt;img src=&quot;https://hackmd.io/_uploads/ryVNHMN4yl.png&quot; alt=&quot;&quot; /&gt;&lt;/p&gt;
&lt;h3&gt;Auth&lt;/h3&gt;
&lt;p&gt;Auth 工具的話主要負責 authentication 相關管理，裡面有支援非常多的 authentication method，Bearer、OAuth2 等全部都有，對於測試時可說是非常方便。
&lt;img src=&quot;https://hackmd.io/_uploads/SyStVVE4Jx.png&quot; alt=&quot;&quot; /&gt;
:::note
礙於篇幅關係，在此只會示範 &lt;code&gt;Basic Authentication&lt;/code&gt;，其餘 Authentication Method 若您有興趣可以自行參考&lt;a href=&quot;https://docs.thunderclient.com/features/auth&quot;&gt;官方文件&lt;/a&gt;。
:::
首先回到我們的 API 並修改以下段落程式碼：&lt;/p&gt;
&lt;pre&gt;&lt;code&gt;import { Hono } from &quot;jsr:@hono/hono&quot;;
//Import basicAuth middleware
import { basicAuth } from &quot;jsr:@hono/hono/basic-auth&quot;;

//Defining type
type studentScore = {
    name: string;
    scores: {
        chinese: number;
        english: number;
        mathematics: number;
    };
};

//Defining a small database
const studentsScore: studentScore[] = [
    {
        name: &quot;Mario&quot;,
        scores: {
            chinese: 55,
            english: 66,
            mathematics: 26,
        },
    },
    {
        name: &quot;Barry&quot;,
        scores: {
            chinese: 85,
            english: 68,
            mathematics: 94,
        },
    },
    {
        name: &quot;Isabella&quot;,
        scores: {
            chinese: 10,
            english: 67,
            mathematics: 95,
        },
    },
];

const hono = new Hono();

hono.get(&quot;/&quot;, (c) =&amp;gt; {
    return c.text(&quot;Hello Hono!&quot;);
});

// Add basicAuth middleware and specified correct username and password
hono.get(&quot;/scores&quot;, basicAuth({ username: &quot;Josh&quot;, password: &quot;12345&quot; }), (c) =&amp;gt; {
    const { key } = c.req.header();
    if (key !== &quot;123&quot;) return c.text(&quot;Invalid Key&quot;, 400);

    const { name } = c.req.query();
    if (!name?.length) return c.json(studentsScore);
    const student = studentsScore.find((e) =&amp;gt; e.name === name);
    if (student) return c.json(student);
    return c.text(&quot;Student not found&quot;, 400);
});

Deno.serve({ port: 3000 }, hono.fetch);
&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;修改完後請重新啟動 API Server。
接下來回到 request 的 &lt;code&gt;Headers&lt;/code&gt; 頁面，刪除剛剛建立的 &lt;code&gt;key&lt;/code&gt; Header。再來切換到 &lt;code&gt;Auth&lt;/code&gt; 頁面，然後 authentication method 先選擇 &lt;code&gt;None&lt;/code&gt;。
&lt;img src=&quot;https://hackmd.io/_uploads/HJpTKENNye.png&quot; alt=&quot;&quot; /&gt;
此時送請求過去，你會發現 API 傳回了狀態碼 &lt;code&gt;401&lt;/code&gt; 代表我們目前是 unauthenticated 的狀態
&lt;img src=&quot;https://hackmd.io/_uploads/Bkl_qVV4ye.png&quot; alt=&quot;&quot; /&gt;
:::note
基本上不管 Unauthenticated 與 Unauthorized，通常皆會回傳此狀態碼，但是其實兩者是有差別的。Unauthenticated 是代表尚未確認或無法確認您的身份，而 Unauthorized 是代表您沒有權限進行存取或執行動作。
:::
接下來我們將 Authentication Method 改成 &lt;code&gt;Basic&lt;/code&gt;，並輸入剛剛在專案中，在 &lt;code&gt;basicAuth&lt;/code&gt; middleware 寫的 username 與 password
&lt;img src=&quot;https://hackmd.io/_uploads/H1OQRNV4ke.png&quot; alt=&quot;&quot; /&gt;
再次送出請求你就會發現 API Server 這次傳回資料了
&lt;img src=&quot;https://hackmd.io/_uploads/HJgFCEVNJx.png&quot; alt=&quot;&quot; /&gt;&lt;/p&gt;
&lt;h3&gt;Body&lt;/h3&gt;
&lt;p&gt;此頁面可以撰寫該 Request 的 Request Body，當你要送出到 API 時，您有可能需要將特殊資料送給 API 處理（e.g. JSON、Form-data），此時即可把那些資料透過 Request Body 將整坨資料傳送至 API。請注意，&lt;code&gt;GET&lt;/code&gt; and &lt;code&gt;HEAD&lt;/code&gt; request 無法傳送 Request Body。
接下來我們就來寫程式碼吧！假設現在有人想要將成績送到資料庫內，所以我們需要定義一個新路徑，讓那個人可以透過 JSON 格式的 Request Body 將學生成績新增到資料庫！&lt;/p&gt;
&lt;pre&gt;&lt;code&gt;import { Hono } from &quot;jsr:@hono/hono&quot;;
import { basicAuth } from &quot;jsr:@hono/hono/basic-auth&quot;;

type studentScore = {
    name: string;
    scores: {
        chinese: number;
        english: number;
        mathematics: number;
    };
};

const studentsScore: studentScore[] = [
    {
        name: &quot;Mario&quot;,
        scores: {
            chinese: 55,
            english: 66,
            mathematics: 26,
        },
    },
    {
        name: &quot;Barry&quot;,
        scores: {
            chinese: 85,
            english: 68,
            mathematics: 94,
        },
    },
    {
        name: &quot;Isabella&quot;,
        scores: {
            chinese: 10,
            english: 67,
            mathematics: 95,
        },
    },
];

const hono = new Hono();

hono.get(&quot;/&quot;, (c) =&amp;gt; {
    return c.text(&quot;Hello Hono!&quot;);
});

hono.get(&quot;/scores&quot;, basicAuth({ username: &quot;Josh&quot;, password: &quot;12345&quot; }), (c) =&amp;gt; {
    const { name } = c.req.query();
    if (!name?.length) return c.json(studentsScore);
    const student = studentsScore.find((e) =&amp;gt; e.name === name);
    if (student) return c.json(student);
    return c.text(&quot;Student not found&quot;, 400);
});

//Defining Path
hono.post(&quot;/scores&quot;, async (c) =&amp;gt; {
    const data = await c.req.json();
    studentsScore.push(data);
    return c.json(studentsScore.at(-1), 201);
});

Deno.serve({ port: 3000 }, hono.fetch);
&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;這次此路徑是改接收 &lt;code&gt;POST&lt;/code&gt; request，因為 &lt;code&gt;GET&lt;/code&gt; request 的話 Client 端是無法傳送 Request Body 的。接下來在接收到 post 請求後，我們會先呼叫 &lt;code&gt;c.req.json()&lt;/code&gt; 取得 Request Body 並將其轉成 JavaScript Object，之後直接將資料新增至資料庫，並傳回新增進去的資料。&lt;code&gt;studentsScore.at(-1)&lt;/code&gt; 表取得 &lt;code&gt;studentScore&lt;/code&gt; 陣列中倒數第一筆資料，即我們剛剛新增進去的資料。
:::note
這次因為我們處理的程式中有需要處理 Promise，故這次在 handling function 前面加了 &lt;code&gt;async&lt;/code&gt; 關鍵字，使我們在 handling function 中可以使用 &lt;code&gt;await&lt;/code&gt; 來處理 Promise 的資料，降低處理 Promise 時的程式碼複雜度。
:::
修改完程式碼之後請再次重啟 API Server，然後回到 Thunder Client 的介面，新增一個 Request
&lt;img src=&quot;https://hackmd.io/_uploads/Hylcwr4N1x.png&quot; alt=&quot;&quot; /&gt;
接下來到該列表右側的 Request 編輯器，將連結輸入框左側的 &lt;code&gt;GET&lt;/code&gt; 改成 &lt;code&gt;POST&lt;/code&gt;，並輸入剛剛新增路徑的連結
&lt;img src=&quot;https://hackmd.io/_uploads/ByZyqS44ke.png&quot; alt=&quot;&quot; /&gt;
再來，請切換到 &lt;code&gt;Body&lt;/code&gt; 頁面，下方格式選擇 &lt;code&gt;JSON&lt;/code&gt;，並在 &lt;code&gt;JSON Content&lt;/code&gt; 處填寫你想插入的資料
&lt;img src=&quot;https://hackmd.io/_uploads/rJMG9BENJg.png&quot; alt=&quot;&quot; /&gt;
送出請求後，右側如果出現剛剛新增的資料，就代表新增成功了！
&lt;img src=&quot;https://hackmd.io/_uploads/SJUq5BVNyg.png&quot; alt=&quot;&quot; /&gt;
再次查詢所有學生成績，就會發現資料成功新增進去了！
&lt;img src=&quot;https://hackmd.io/_uploads/BJKFiH44Jg.png&quot; alt=&quot;&quot; /&gt;&lt;/p&gt;
&lt;h3&gt;Tests&lt;/h3&gt;
&lt;p&gt;最後就是測試功能了，你可以在此制定測試通過的條件，然後送出請求，API Client 會自動依據您所提供的測試條件，來對回傳的資料進行檢查，進而讓你確認測試是否有通過。以下為 Tests 頁面展示：
&lt;img src=&quot;https://hackmd.io/_uploads/BJ4ZnH4Vyx.png&quot; alt=&quot;&quot; /&gt;
:::note
測試部分，Thunder Client 有提供兩種測試方式，一種是給予測試條件（&lt;code&gt;Tests&lt;/code&gt;），一種是透過寫程式碼進行測試（&lt;code&gt;Scripting&lt;/code&gt;）。因為 &lt;code&gt;Scripting&lt;/code&gt; 為付費功能，此處僅示範 &lt;code&gt;Tests&lt;/code&gt;。
:::
假如我們想要測試查詢學生 Mario 的成績，確認是否回傳碼為 &lt;code&gt;200&lt;/code&gt;、並且該學生英文成績是否為 86 分，我們可以先新增 Query
&lt;img src=&quot;https://hackmd.io/_uploads/SyUWCBVV1g.png&quot; alt=&quot;&quot; /&gt;
接下來撰寫測試條件
&lt;img src=&quot;https://hackmd.io/_uploads/BJpnCHV4kx.png&quot; alt=&quot;&quot; /&gt;
送出 Request 並且 API 傳回資料後，我們可以在右側的 &lt;code&gt;Results&lt;/code&gt; 查看測試結果：
&lt;img src=&quot;https://hackmd.io/_uploads/S1VNyI4E1x.png&quot; alt=&quot;&quot; /&gt;
在此結果中我們可以看到第一個測試「傳回狀態碼為 &lt;code&gt;200&lt;/code&gt;」，因為請求成功，所以傳回狀態碼為 &lt;code&gt;200&lt;/code&gt;，所以通過測試；但第二個測試「Mario 學生的英文成績為 85」因為回傳的資料中，英文成績為 66，故測試不通過。如果您正在開發 API 且遇到有測試條件無法通過測試的狀況，請檢查程式碼並修正後再次進行測試。&lt;/p&gt;
&lt;h2&gt;Wrapping Up&lt;/h2&gt;
&lt;p&gt;在此文中，我們介紹了 Thunder Client 的基礎功能，並且如何利用那些功能去對 API Server 進行測試。與 Postman 相比，它不僅只是單純用來做請求測試的工具，他提供了更多圖形界面，讓開發者能夠更容易撰寫要發出的 Request，並能透過 GUI 介面撰寫測試來自動化測試回傳資料是否滿足通過條件。雖然說免費版限制了不少功能，但是在沒有特殊要求下，免費方案提供的功能基本上也已經敷用了，如果免費版功能不足夠的話，也可以透過購買付費方案來解鎖其他更強大的功能（e.g. Scripting、Request Chaining）。整體來講是一個不錯的擴充功能，希望未來開發者可以再開放更多功能，讓這個 Extension 可以更加實用。&lt;/p&gt;
</content:encoded></item><item><title>Discord.js-Framwork-Typescript 使用教學</title><link>https://blog.kayxue.dev/posts/discordjsframworkts/</link><guid isPermaLink="true">https://blog.kayxue.dev/posts/discordjsframworkts/</guid><description>Discord.js-Framwork-Typescript 框架使用教學</description><pubDate>Tue, 10 Aug 2021 00:00:00 GMT</pubDate><content:encoded>&lt;h2&gt;簡介與製作動機&lt;/h2&gt;
&lt;p&gt;此專案改寫自 &lt;a href=&quot;https://github.com/xiaoxigua-1&quot;&gt;xiaoxigua-1&lt;/a&gt; 的 &lt;a href=&quot;https://github.com/xiaoxigua-1/Discord.js-framework&quot;&gt;Discord.js-Framwork&lt;/a&gt;，這專案同時也是我正式開始 Typescript 旅程的第一步。當初因為 Discord.js 沒有指令處理器，讓我不是很想跨入 Discord.js ，後來感謝 &lt;a href=&quot;https://github.com/xiaoxigua-1&quot;&gt;xiaoxigua-1&lt;/a&gt; 介紹了他製作的 &lt;a href=&quot;https://github.com/xiaoxigua-1/Discord.js-framework&quot;&gt;Discord.js-Framwork&lt;/a&gt;，讓我可以不用苦惱指令處理器的撰寫，可以直接開始寫指令。&lt;/p&gt;
&lt;p&gt;後來接觸到了 TypeScript，發掘到 TypeScript 相較於 Javascript，TypeScript 還有強大的型別註記與語法提示，所以便將 &lt;a href=&quot;https://github.com/xiaoxigua-1&quot;&gt;xiaoxigua-1&lt;/a&gt; 的 &lt;a href=&quot;https://github.com/xiaoxigua-1/Discord.js-framework&quot;&gt;Discord.js-Framwork&lt;/a&gt; 稍微優化並改寫成此專案。&lt;/p&gt;
&lt;p&gt;順便附上 &lt;a href=&quot;https://github.com/xiaoxigua-1/Discord.js-framework&quot;&gt;Discord.js-Framwork&lt;/a&gt; 專案的README：&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;單純隨便寫的&lt;/li&gt;
&lt;li&gt;恩~~如果覺得好用ㄉ話歡迎使用?&lt;/li&gt;
&lt;li&gt;寫得很爛別介意
::github{repo=&quot;Kayxue/Discord.js-Framwork-Typescript&quot;}&lt;/li&gt;
&lt;/ul&gt;
&lt;h2&gt;下載方式：&lt;/h2&gt;
&lt;pre&gt;&lt;code&gt;git clone https://github.com/Kayxue/Discord.js-Framwork-Typescript.git
&lt;/code&gt;&lt;/pre&gt;
&lt;h2&gt;使用方式：&lt;/h2&gt;
&lt;h3&gt;1.先以 vscode 打開專案資料夾&lt;/h3&gt;
&lt;h3&gt;2.安裝模組：&lt;/h3&gt;
&lt;p&gt;輸入以下指令安裝專案所有所需模組：&lt;/p&gt;
&lt;pre&gt;&lt;code&gt;#使用npm
npm i                            #安裝專案所需模組
npm install --global typescript  #安裝 TypeScript

#使用yarn
yarn                             #安裝專案所需模組
yarn global add typescript       #安裝 TypeScript
&lt;/code&gt;&lt;/pre&gt;
&lt;h3&gt;3.編輯設定檔：&lt;/h3&gt;
&lt;p&gt;打開 &lt;code&gt;src/Config.ts&lt;/code&gt; 並編輯設定&lt;/p&gt;
&lt;pre&gt;&lt;code&gt;export const prefix = &quot;&quot;;     //你想要的機器人前綴
export const owner_id = &quot;&quot;;   //機器人擁有者 ID
export const token = &quot;&quot;;      //機器人的 token
export const youtubeapitoken = &quot;&quot;; //YoutubeAPIToken，若不使用音樂功能則免填
export const blacklist = [];  //使用指令黑名單，將使用者ID填入後該使用者使用指令時將不會有反應
&lt;/code&gt;&lt;/pre&gt;
&lt;h3&gt;4.執行專案：&lt;/h3&gt;
&lt;h4&gt;方法1：使用 tsc 編譯&lt;/h4&gt;
&lt;p&gt;打開終端機輸入：&lt;/p&gt;
&lt;pre&gt;&lt;code&gt;tsc         #編譯程式碼
cd dist     #切換到 dist 資料夾(程式碼編譯結果輸出處)
node .      #執行專案
&lt;/code&gt;&lt;/pre&gt;
&lt;h4&gt;方法2：使用 ts-node 直接執行&lt;/h4&gt;
&lt;p&gt;:::note
若未安裝 ts-node 請使用下面指令安裝：&lt;/p&gt;
&lt;pre&gt;&lt;code&gt;#使用 npm
npm install --global ts-node

#使用 yarn
yarn global add ts-node
&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;:::&lt;/p&gt;
&lt;p&gt;打開終端機輸入：&lt;/p&gt;
&lt;pre&gt;&lt;code&gt;cd src      #切換到 src 資料夾(專案資料夾)
ts-node .   #執行專案
&lt;/code&gt;&lt;/pre&gt;
&lt;h2&gt;指令與事件監聽器撰寫方式：&lt;/h2&gt;
&lt;h3&gt;新增類別部分：&lt;/h3&gt;
&lt;h4&gt;1.在 Command 資料夾下新增 &lt;code&gt;[檔名].ts&lt;/code&gt;&lt;/h4&gt;
&lt;h4&gt;2.匯入模組：&lt;/h4&gt;
&lt;pre&gt;&lt;code&gt;import Commands from &quot;../core/commands&quot;;
import { Client, Message } from &quot;discord.js&quot;;

&lt;/code&gt;&lt;/pre&gt;
&lt;h4&gt;3.宣告類別&lt;/h4&gt;
&lt;pre&gt;&lt;code&gt;class w extends Commands { //類別名稱可自取

}
&lt;/code&gt;&lt;/pre&gt;
&lt;h4&gt;4.宣告匯出函數&lt;/h4&gt;
&lt;pre&gt;&lt;code&gt;export default function setup(bot: Client) {
    //實例化類別，此例類別為w(bot 必要傳入參數)，classname 非必要傳入(該 cog 名稱)
    let commands = new w(bot, &quot;classname&quot;)

    /*指令與事件監聽器撰寫處*/

    bot.AddCog(commands)
}
&lt;/code&gt;&lt;/pre&gt;
&lt;h3&gt;撰寫指令部分：&lt;/h3&gt;
&lt;pre&gt;&lt;code&gt;    /*撰寫指令*/
    let w2 = commands.command(async function w(msg: Message, ...text: string[]) {
        await msg.channel.send(text.join(&quot; &quot;))
    }, { aliases: [&quot;ee&quot;, &quot;ww&quot;] })

    /*發生錯誤處理*/
    w2.error((msg:Message, error) =&amp;gt; {
        console.log(error)
        msg.channel.send(error)
    })
&lt;/code&gt;&lt;/pre&gt;
&lt;ol&gt;
&lt;li&gt;command 函式第一個參數為該指令程式碼撰寫處，傳入型別為函式&lt;/li&gt;
&lt;li&gt;command 函式第一個參數之傳入參數部分：第一個傳入參數為 Message 物件，第二個以後之傳入參數則是指令參數&lt;/li&gt;
&lt;li&gt;command 函式第二個參數部分為指令相關資訊：
&lt;ul&gt;
&lt;li&gt;&lt;code&gt;name&lt;/code&gt;：型別為字串，指令名稱&lt;/li&gt;
&lt;li&gt;&lt;code&gt;aliases&lt;/code&gt;：型別為字串陣列，指令別名&lt;/li&gt;
&lt;li&gt;&lt;code&gt;help&lt;/code&gt;：型別為字串，完整指令幫助&lt;/li&gt;
&lt;li&gt;&lt;code&gt;brief&lt;/code&gt;：型別為字串，簡短指令幫助&lt;/li&gt;
&lt;/ul&gt;
&lt;/li&gt;
&lt;/ol&gt;
&lt;p&gt;:::warning
command函式第一個傳入參數可為具名函式或匿名函式（含箭頭函式）：&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;若&lt;strong&gt;傳入具名函式&lt;/strong&gt;，指令相關資訊的 &lt;strong&gt;name 欄位可留空&lt;/strong&gt;&lt;/li&gt;
&lt;li&gt;若&lt;strong&gt;傳入匿名函式&lt;/strong&gt;，指令相關資訊的 &lt;strong&gt;name 欄位則必須填寫&lt;/strong&gt;，若無填寫該欄位，則&lt;strong&gt;該指令將無法被載入、觸發&lt;/strong&gt;&lt;/li&gt;
&lt;li&gt;若&lt;strong&gt;傳入具名函式&lt;/strong&gt;，指令相關資訊的 &lt;strong&gt;name 欄位也有填寫&lt;/strong&gt;，則該指令之&lt;strong&gt;指令名稱為該指令相關資訊的 name 欄位值&lt;/strong&gt;
:::
:::note
&lt;strong&gt;&amp;lt;類別實體之名稱&amp;gt;.bot&lt;/strong&gt; 可以傳回機器人物件：&lt;/li&gt;
&lt;/ul&gt;
&lt;pre&gt;&lt;code&gt;    commands.command((msg: Message) =&amp;gt; {
        console.log(commands.bot.user.username) //在終端機中印出機器人名稱
    }, { name: &quot;botname&quot; })
&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;:::&lt;/p&gt;
&lt;h3&gt;撰寫指令群組部分：&lt;/h3&gt;
&lt;pre&gt;&lt;code&gt;    /*宣告指令群組*/
    let e = commands.group(async function wq(msg: Message) {
        console.log(msg.content)
    }, { aliases: [&quot;ep&quot;, &quot;qq&quot;] })

    /*撰寫指令群組錯誤處理*/
    e.error(async function (msg: Message, error) {
        msg.channel.send(error.toString())
    })

    /*撰寫指令群組指令*/
    let r = e.command(async function rr(msg: Message, x: string) {
        commands.is_owner(msg)
        commands.bot
        await msg.channel.send(&quot;e.r&quot;)
    }, { aliases: [&quot;ep&quot;, &quot;qq&quot;] })

    /*撰寫指令群組指令錯誤處理*/
    r.error((msg: Message, error) =&amp;gt; {
        msg.channel.send(error.toString())
    })

    /*撰寫指令群組指令*/
    e.command(function ww(message: Message) {
        message.member.voice.channel.join().then(voicechannel =&amp;gt; {
            let w = voicechannel.play(youtubedl(&quot;https://www.youtube.com/watch?v=jIpiLvkDIK8&quot;, { quality: &apos;highestaudio&apos; }), { volume: 0.5 })
            w.pause()
            voicechannel.play(youtubedl(&quot;https://www.youtube.com/watch?v=7i2knHE7ofQ&quot;, { quality: &apos;highestaudio&apos; }), { volume: 0.5 })
        })
    })
&lt;/code&gt;&lt;/pre&gt;
&lt;ol&gt;
&lt;li&gt;group 函式的作用：宣告一個指令群組&lt;/li&gt;
&lt;li&gt;group 函式第一個參數為當該指令無輸入子指令時所執行之函式&lt;/li&gt;
&lt;li&gt;group 函式第二個參數部分為指令相關資訊：
&lt;ul&gt;
&lt;li&gt;&lt;code&gt;name&lt;/code&gt;：型別為字串，指令名稱&lt;/li&gt;
&lt;li&gt;&lt;code&gt;aliases&lt;/code&gt;：型別為字串陣列，指令別名&lt;/li&gt;
&lt;li&gt;&lt;code&gt;help&lt;/code&gt;：型別為字串，完整指令幫助&lt;/li&gt;
&lt;li&gt;&lt;code&gt;brief&lt;/code&gt;：型別為字串，簡短指令幫助&lt;/li&gt;
&lt;/ul&gt;
&lt;/li&gt;
&lt;li&gt;group 函式會傳回 Group 物件：
&lt;ul&gt;
&lt;li&gt;Group.command 函式用法：與上方 command 函式相同
:::warning&lt;/li&gt;
&lt;/ul&gt;
&lt;/li&gt;
&lt;/ol&gt;
&lt;ul&gt;
&lt;li&gt;Group &lt;strong&gt;沒有 Listener 函式！&lt;/strong&gt; 您&lt;strong&gt;無辦法在指令群組內建立事件監聽器！&lt;/strong&gt;&lt;/li&gt;
&lt;li&gt;group 函式第一個傳入參數可為具名函式或匿名函式（含箭頭函式）：
&lt;ul&gt;
&lt;li&gt;若&lt;strong&gt;傳入具名函式&lt;/strong&gt;，指令群組相關資訊的 &lt;strong&gt;name 欄位可留空&lt;/strong&gt;&lt;/li&gt;
&lt;li&gt;若&lt;strong&gt;傳入匿名函式&lt;/strong&gt;，指令群組相關資訊的 &lt;strong&gt;name 欄位則必須填寫&lt;/strong&gt;，若無填寫該欄位，則&lt;strong&gt;該指令群組將無法被載入、觸發&lt;/strong&gt;&lt;/li&gt;
&lt;li&gt;若&lt;strong&gt;傳入具名函式&lt;/strong&gt;，指令群組相關資訊的 &lt;strong&gt;name 欄位也有填寫&lt;/strong&gt;，則該指令群組之&lt;strong&gt;指令群組名稱為該指令群組相關資訊的 name 欄位值&lt;/strong&gt;
:::&lt;/li&gt;
&lt;/ul&gt;
&lt;/li&gt;
&lt;/ul&gt;
&lt;h3&gt;撰寫事件監聽器部分：&lt;/h3&gt;
&lt;pre&gt;&lt;code&gt;    /*撰寫事件監聽器*/
    commands.listener(function message(message: Message) {
        console.log(`on_message:${message.author.tag}:${message.content}`)
    })

    commands.listener((msg: Message) =&amp;gt; {
        console.log(&quot;OK&quot;)
    }, { event: &quot;message&quot; })
&lt;/code&gt;&lt;/pre&gt;
&lt;ol&gt;
&lt;li&gt;listener 函式第一個參數為該事件程式碼撰寫處，傳入型別為函式&lt;/li&gt;
&lt;li&gt;listener 函式第一個參數之傳入參數部分請查看 &lt;a href=&quot;https://discord.js.org/#/docs/main/stable/class/Client?scrollTo=channelCreate&quot;&gt;Discord.js 官方文件的 client 事件&lt;/a&gt;，因為不同 client 之事件會傳入不同參數，在此就不一一列舉&lt;/li&gt;
&lt;li&gt;listener 函式第二個參數部分為監聽事件相關資訊：
&lt;ul&gt;
&lt;li&gt;&lt;code&gt;event&lt;/code&gt;：型別為字串，事件名稱&lt;/li&gt;
&lt;/ul&gt;
&lt;/li&gt;
&lt;/ol&gt;
&lt;p&gt;:::warning&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;若&lt;strong&gt;傳入具名函式&lt;/strong&gt;，監聽事件相關資訊的 &lt;strong&gt;event 欄位可留空&lt;/strong&gt;&lt;/li&gt;
&lt;li&gt;若&lt;strong&gt;傳入匿名函式&lt;/strong&gt;，監聽事件相關資訊的 &lt;strong&gt;event 欄位則必須填寫&lt;/strong&gt;，若無填寫該欄位，則&lt;strong&gt;該事件函式將無法被觸發&lt;/strong&gt;&lt;/li&gt;
&lt;li&gt;若&lt;strong&gt;傳入具名函式&lt;/strong&gt;，監聽事件相關資訊的 &lt;strong&gt;event 欄位也有填寫&lt;/strong&gt;，則該事件函式之&lt;strong&gt;監聽事件名稱為監聽事件相關資訊的 event 欄位值&lt;/strong&gt;
:::&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;:::note
以此範例為例，該事件函式會在機器人偵測到有人發訊息時被觸發。當該事件被觸發時，函式會傳入 Message 物件，並且執行事件函式裡的內容（印出指定內容）&lt;/p&gt;
&lt;h3&gt;官方文件：&lt;/h3&gt;
&lt;p&gt;&lt;img src=&quot;https://i.imgur.com/0HUF5om.png&quot; alt=&quot;&quot; /&gt;
:::&lt;/p&gt;
</content:encoded></item></channel></rss>