【文章內容使用 Gemini 1.5 Pro 自動產生】

學習 Flutter 的全新導航和路由系統

本文說明 Flutter 的全新 Navigator 和 Router API 如何運作。如果您關注 Flutter 的公開 設計文件，您可能已經看到這些新功能被稱為 Navigator 2.0 和 Router。我們將探討這些 API 如何讓您更精細地控制應用程式中的螢幕，以及如何使用它們來解析路由。

這些新的 API 並不是重大變更，它們只是添加了一個新的 聲明式 API。在 Navigator 2.0 之前，很難推送或彈出多個頁面，或移除當前頁面下方的一個頁面。但是，如果您對當前 Navigator 的運作方式感到滿意，您可以繼續以相同的方式（命令式）使用它。

Router 提供了從底層平台處理路由和顯示適當頁面的能力。在本文中，Router 被配置為解析瀏覽器 URL 以顯示適當的頁面。

本文將幫助您選擇最適合您的應用程式的 Navigator 模式，並說明如何使用 Navigator 2.0 來解析瀏覽器 URL 並完全控制活動頁面堆疊。本文中的練習展示了如何構建一個應用程式，該應用程式可以處理來自平台的進站路由，並管理應用程式的頁面。以下 GIF 顯示了示例應用程式的運作方式：

Navigator 1.0

如果您使用 Flutter，您可能正在使用 Navigator，並且熟悉以下概念：

• Navigator - 一個管理 Route 物件堆疊的 Widget。
• Route - 由 Navigator 管理的一個物件，表示一個螢幕，通常由 MaterialPageRoute 等類別實作。

在 Navigator 2.0 之前，Route 被推送和彈出到 Navigator 的堆疊上，使用 命名路由 或 匿名路由。接下來的幾節將簡要回顧這兩種方法。

匿名路由

大多數行動應用程式會在彼此之上顯示螢幕，就像一個堆疊一樣。在 Flutter 中，使用 Navigator 就可以輕鬆實現這一點。

MaterialApp 和 CupertinoApp 在幕後都已使用 Navigator。您可以使用 Navigator.of() 存取 Navigator，或使用 Navigator.push() 顯示一個新的螢幕，並使用 Navigator.pop() 返回上一個螢幕：

當呼叫 push() 時，DetailScreen Widget 會被放置在 HomeScreen Widget 的頂部，如下所示：

上一個螢幕 (HomeScreen) 仍然是 Widget 樹的一部分，因此與其關聯的任何 State 物件都會在 DetailScreen 可見時保留下來。

命名路由

Flutter 也支援命名路由，這些路由在 MaterialApp 或 CupertinoApp 的 routes 參數中定義：

這些路由必須預先定義。雖然您可以 將參數傳遞給命名路由，但您無法從路由本身解析參數。例如，如果應用程式在網頁上運行，您無法從像 /details/:id 這樣的路由中解析 ID。

使用 onGenerateRoute 的進階命名路由

處理命名路由的更靈活方法是使用 onGenerateRoute。此 API 使您能夠處理所有路徑：

以下是完整的示例：

這裡，settings 是 RouteSettings 的一個實例。name 和 arguments 字段是呼叫 Navigator.pushNamed 時提供的數值，或者設定為 initialRoute 的數值。

Navigator 2.0

Navigator 2.0 API 為框架添加了新的類別，以便使應用程式的螢幕成為應用程式狀態的函數，並提供從底層平台（例如 Web URL）解析路由的能力。以下是新功能的概述：

• Page - 一個不可變的物件，用於設定導航器的歷史堆疊。
• Router - 配置 Navigator 要顯示的頁面列表。通常，這個頁面列表會根據底層平台或應用程式狀態的變化而變化。
• RouteInformationParser，它會從 RouteInformationProvider 中獲取 RouteInformation，並將其解析為一個使用者定義的資料類型。
• RouterDelegate - 定義 Router 如何了解應用程式狀態變化以及如何對它們做出響應的應用程式特定行為。它的工作是監聽 RouteInformationParser 和應用程式狀態，並使用當前的 Page 列表構建 Navigator。
• BackButtonDispatcher - 向 Router 報告後退按鈕按下。

下圖顯示了 RouterDelegate 如何與 Router、RouteInformationParser 和應用程式的狀態交互：

以下是這些部分如何交互的示例：

1. 當平台發出一個新的路由（例如，「books/2」）時，RouteInformationParser 會將其轉換為一個抽象資料類型 T，您可以在您的應用程式中定義這個資料類型（例如，一個名為 BooksRoutePath 的類別）。
2. RouterDelegate 的 setNewRoutePath 方法會使用這個資料類型被呼叫，並且必須更新應用程式狀態以反映變化（例如，透過設定 selectedBookId）並呼叫 notifyListeners。
3. 當呼叫 notifyListeners 時，它會告訴 Router 重新建立 RouterDelegate（使用其 build() 方法）。
4. RouterDelegate.build() 返回一個新的 Navigator，其頁面現在反映了應用程式狀態的變化（例如，selectedBookId）。

Navigator 2.0 練習

本節將引導您完成使用 Navigator 2.0 API 的練習。我們將最終獲得一個應用程式，該應用程式可以與 URL 列保持同步，並處理來自應用程式和瀏覽器的後退按鈕按下，如以下 GIF 所示：

若要繼續操作，請 切換到 master channel，使用 Web 支援建立一個新的 Flutter 專案，並將 lib/main.dart 的內容替換為以下內容：

頁面

Navigator 在其建構函數中有一個新的 pages 參數。如果 Page 物件列表發生變化，Navigator 會更新路由堆疊以匹配。若要了解這如何運作，我們將構建一個顯示書籍列表的應用程式。

在 _BooksAppState 中，保留兩個狀態資訊：書籍列表和選中的書籍：

然後在 _BooksAppState 中，返回一個帶有 Page 物件列表的 Navigator：

由於這個應用程式有兩個螢幕，一個是書籍列表，另一個是顯示詳細資訊的螢幕，因此如果選中了書籍，請添加第二個（詳細資訊）頁面（使用 集合中的 if）：

請注意，頁面的鍵由書籍物件的數值定義。這告訴 Navigator，當書籍物件不同時，這個 MaterialPage 物件與另一個物件不同。如果沒有唯一的鍵，框架無法確定何時顯示不同 Page 之間的轉場動畫。

注意：如果您願意，您也可以擴展 Page 以自訂行為。例如，此頁面添加了一個自訂轉場動畫：

最後，在沒有提供 onPopPage 回撥的情況下提供 pages 參數是一個錯誤。此函數在呼叫 Navigator.pop() 時被呼叫。它應該用於更新狀態（決定頁面列表的狀態），並且必須呼叫路由上的 didPop 來確定彈出是否成功：

在更新應用程式狀態之前檢查 didPop 是否失敗非常重要。

使用 setState 會通知框架呼叫 build() 方法，該方法在 _selectedBook 為 null 時返回一個帶有單個頁面的列表。

以下是完整的示例：

就目前而言，這個應用程式只允許我們以聲明式的方式定義頁面堆疊。我們無法處理平台的後退按鈕，並且瀏覽器的 URL 在我們導航時不會改變。

Router

到目前為止，應用程式可以顯示不同的頁面，但它無法處理來自底層平台的路由，例如，如果使用者在瀏覽器中更新 URL。

本節將說明如何實作 RouteInformationParser、RouterDelegate 並更新應用程式狀態。設定好後，應用程式將與瀏覽器的 URL 保持同步。

資料類型

RouteInformationParser 會將路由資訊解析為一個使用者定義的資料類型，因此我們將首先定義它：

在這個應用程式中，應用程式中的所有路由都可以使用單個類別來表示。相反，您可能選擇使用實作超類別的不同類別，或以其他方式管理路由資訊。

RouterDelegate

接下來，添加一個擴展 RouterDelegate 的類別：

在 RouterDelegate 上定義的泛型類型是 BookRoutePath，它包含決定要顯示哪些頁面所需的所有狀態。

我們需要將一些邏輯從 _BooksAppState 移動到 BookRouterDelegate，並建立一個 GlobalKey。在這個示例中，應用程式狀態直接儲存在 RouterDelegate 上，但也可以分開到另一個類別中。

為了在 URL 中顯示正確的路徑，我們需要根據應用程式的當前狀態返回一個 BookRoutePath：

接下來，RouterDelegate 中的 build 方法需要返回一個 Navigator：

onPopPage 回撥現在使用 notifyListeners 而不是 setState，因為這個類別現在是 ChangeNotifier，而不是 Widget。當 RouterDelegate 通知其監聽器時，Router Widget 也會被通知 RouterDelegate 的 currentConfiguration 已更改，並且需要再次呼叫其 build 方法以構建一個新的 Navigator。

_handleBookTapped 方法也需要使用 notifyListeners 而不是 setState：

當一個新的路由被推送到應用程式時，Router 會呼叫 setNewRoutePath，這讓我們的應用程式有機會根據路由的變化來更新應用程式狀態：

RouteInformationParser

RouteInformationParser 提供了一個鉤子來解析進站路由 (RouteInformation) 並將其轉換為使用者定義的類型 (BookRoutePath)。使用 Uri 類別來處理解析：

此實作特定於此應用程式，而不是通用的路由解析解決方案。稍後將詳細說明。

若要使用這些新的類別，我們使用新的 MaterialApp.router 建構函數，並傳遞我們自定義的實作：

以下是完整的示例：

在 Chrome 中運行此示例現在會顯示路由的導航方式，並在手動編輯 URL 時導航到正確的頁面。

TransitionDelegate

您可以提供 TransitionDelegate 的自定義實作，它會自訂當頁面列表發生變化時路由在螢幕上出現（或從螢幕中移除）的方式。如果您需要自訂此功能，請繼續閱讀，但如果您對預設行為感到滿意，您可以跳過本節。

為 Navigator 提供一個自訂 TransitionDelegate，它定義了所需的行為：

例如，以下實作會禁用所有轉場動畫：

此自定義實作會覆蓋 resolve()，它負責將各種路由標記為推送、彈出、添加、完成或移除：

• markForPush - 使用動畫轉場顯示路由
• markForAdd - 使用 無 動畫轉場顯示路由
• markForPop - 使用動畫轉場移除路由，並使用結果完成它。在這個上下文中，「完成」意味著結果物件會被傳遞給 AppRouterDelegate 上的 onPopPage 回撥。
• markForComplete - 使用無轉場移除路由，並使用結果完成它
• markForRemove - 使用無動畫轉場移除路由，並且不完成。

此類別只會影響 聲明式 API，這就是為什麼 後退 按鈕仍然顯示轉場動畫的原因。

此示例如何運作： 此示例會查看新的路由和即將離開螢幕的路由。它會遍歷 newPageRouteHistory 中的所有物件，並使用 markForAdd 將它們標記為無轉場動畫地添加。接下來，它會遍歷 locationToExitingPageRoute 映射的數值。如果它找到一個被標記為 isWaitingForExitingDecision 的路由，那麼它會呼叫 markForRemove 來指示該路由應該使用無轉場和無完成的方式移除。

以下是完整的示例（Gist）。

嵌套路由

這個更大的演示展示了如何在另一個 Router 中添加 Router。許多應用程式需要為 BottomAppBar 中的目標設定路由，以及為其上方的視圖堆疊設定路由，這 需要兩個 Navigator。若要做到這一點，應用程式會使用一個應用程式狀態物件來儲存應用程式特定的導航狀態（選中的菜單索引和選中的書籍物件）。此示例還展示了如何配置哪個 Router 處理後退按鈕。

嵌套路由示例（Gist）

接下來要做什麼

本文探討了如何為特定應用程式使用這些 API，但也可以用於構建一個更高階的 API 套件。我們希望您能加入我們，探索建立在這些功能之上的更高階 API 能夠為使用者做些什麼。

學習 Flutter 的全新導航和路由系統 最初發佈在 Flutter 上的 Medium，人們在那裡透過突出顯示和回應這個故事來繼續討論。

【文章內容使用 Gemini 1.5 Pro 自動產生】

使用 flutter_driver 進行整合測試

單元測試確保應用程式的個別部分按預期運作，但整個應用程式呢？這就是整合測試發揮作用的地方。

Flutter driver

如果您從未在 Flutter（或任何地方）進行過整合測試，別擔心！在 Flutter 中為您的應用程式添加整合測試是一項簡單的任務。有一組非常有用的文章將引導您。

1. 整合測試簡介：這個東西是什麼，我該如何設定？
2. 處理捲動：我該如何處理捲動到某個東西的常見模式？

到達這一點可以確保您的應用程式可以正常運行、可以到達特定螢幕、特定操作會產生一些結果，等等。您創建的測試取決於您的需求。您可以使用一個測試打開應用程式的所有螢幕，或者使用測試完成特定使用者旅程。

但我們可以使用 flutter_driver 進一步進行效能測試。

效能分析

只需將您的測試用 flutterDriver.traceAction 包裹起來，就會在您的測試運行時記錄您的應用程式的效能。此輸出資料（以 JSON 格式）可以在持續整合 (CI) 測試中使用，以確保例如某些指標保持在特定臨界值之上或之下。該資料還可以用於除錯效能問題。有關如何進行效能分析的詳細資訊，請參閱整合測試文章，效能分析。

作為參考，Flutter Gallery 有個 整合測試，會瀏覽所有演示並為其中的一部分捕獲效能指標。

螢幕截圖測試

螢幕截圖測試是一種渲染 UI、捕獲輸出螢幕截圖，然後將結果與預期圖片進行比較。為您的應用程式添加螢幕截圖測試的一個簡單方法是使用 flutterDriver.screenshot。若要了解更多資訊並查看實際的程式碼範例，請參閱 Medium 文章，使用 Flutter Driver 測試 Flutter UI，作者是社群成員 Darshan Kawar。

此方法可以輕鬆整合到您的持續整合測試設定中，以防止 UI 回歸。Flutter Gallery 有幾個 螢幕截圖測試 和一個 GitHub 工作流程設定，用於自動測試進來的 PR。

a11y 測試

a11y 或無障礙測試是一種可用性測試，用於確保應用程式可以被有障礙的人使用，例如視力障礙、聽力障礙、肢體障礙，等等。使用 flutterDriver.getSemanticsId 驗證語義標籤，例如，驗證所有圖片是否都有語義標籤。

在 Darshan Kawar 的另一篇很棒的文章中，了解更多關於無障礙測試的資訊，在 Flutter 中開發和測試無障礙應用程式。

i18n 測試

i18n 或國際化測試是測試應用程式是否可以在不同的語言和地區使用而無需任何變更的過程。

根據您的本地化程式碼的設定方式，您可以使用本地化的委派來更改語言環境。

ExampleAppLocalizationsDelegate.load(Locale('fr'));

或者，在使用 MaterialApp 時，只需允許覆蓋應用程式的語言環境，以便在不同的語言環境中運行。

在啟動應用程式的驅動程式檔案中，設定語言環境。

額外提示

想知道頁面上是否存在某個元素嗎？

您可以選擇任何適合您的應用程式的超時時間。

結語

到目前為止，您應該對 flutter_driver 的功能有了很好的了解。您可以結合方法以滿足您的需求；例如，使用不同的語言環境執行螢幕截圖測試。如果我們遺漏了什麼，請在評論中告訴我們！若要了解更多資訊，請參閱 flutter_driver API 文件。

關於作者：Pierre-Louis 是滑鐵盧大學的應屆大學畢業生。他住在慕尼黑，是維護 Flutter Material 函式庫的團隊中的一員。他對 UI、UX 和應用程式開發非常感興趣。您可以在 LinkedIn 和 GitHub 上與他聯繫。

使用 flutter_driver 進行整合測試 最初發佈在 Flutter 上的 Medium，人們在那裡透過突出顯示和回應這個故事來繼續討論。

【文章內容使用 Gemini 1.5 Pro 自動產生】

宣布 Flutter Windows Alpha 版本

我們的使命是為開發人員提供一個開源、高生產力的框架，用於在任何平台上構建美觀的原生應用程式。到目前為止，我們已經為 Android 和 iOS 發佈了生產級別的支援，擁有 8 個穩定版本，僅 Google Play 商店就發佈了超過 100,000 個應用程式。我們繼續擴大我們的關注範圍，包括其他平台，包括網頁、macOS 和 Linux。今天，我們很高興宣布 Flutter 的另一個目標是為 Windows 發佈 Flutter 支援的 alpha 版本。

Windows 仍然是桌面和筆記型電腦設備的熱門選擇，微軟報告稱 超過 10 億台設備運行 Windows 10。我們自己的統計數據顯示，超過一半的 Flutter 開發人員使用 Windows，因此它自然成為 Flutter 的目標。原生桌面支援為 Flutter 開啟了各種令人興奮的可能性，包括改進的開發人員工具、降低新使用者的摩擦，當然還有可以從單個程式碼庫到達使用者可能擁有的任何設備的應用程式。

將 Windows 加入 Flutter

如我們的 架構概述 中所述，Flutter 是一個跨平台 UI 工具包，旨在允許在 iOS 和 Android 等操作系統之間重複使用程式碼，同時也允許應用程式直接與底層平台服務進行互動。目標是讓開發人員能夠交付高效能的應用程式，這些應用程式在不同的平台上感覺自然，在存在差異的地方擁抱差異，同時盡可能共享程式碼。Flutter 的核心是引擎，它支援支援所有 Flutter 應用程式所必需的基本元素。引擎負責在需要繪製新畫面時對合成場景進行光柵化。它提供了 Flutter 核心 API 的低階實作，包括圖形、文字佈局、檔案和網路 I/O、輔助功能支援、外掛架構，以及 Dart 執行時和編譯工具鏈。

我們添加到 Flutter 的每個新平台都會使用新的服務擴展核心框架，以便它在該平台上發光。我們從 Android 和 iOS 開始，採用 Material Design 以及基於觸控的、以行動為中心的使用者介面，該介面旨在讓兩個行動平台上的像素完美。為網頁、Windows、macOS 和 Linux 添加對桌面外觀尺寸的支援帶來了全新的服務集，包括對鍵盤、滑鼠、滑鼠滾輪和控制器（輸入端）的強大支援，以及在網頁和桌面應用程式附帶的較大螢幕尺寸上適應或甚至最有效工作的 Widget。

此外，每個新平台不僅會影響 Flutter 框架和引擎，還會影響許多其他方面：

• 工具鏈更新：將新目標添加到 CLI 和 IDE 工具（在本例中為 Windows）
• 外殼程式：支援透過 WM_* 訊息處理來自 Windows 的輸入，以及透過 ANGLE 輸出，ANGLE 使用 Skia 以原生速度渲染到底層 DirectX 表面
• 執行器：每個專案都有一個外殼程式應用程式，適用於受支援的目標。對於 Windows，它是一個載入您的 Flutter 程式碼並在執行時執行的 Win32/C++ 程式。如果您需要，這是將原生程式碼添加到您的應用程式的好地方。
• 外掛：外掛是 Dart 程式碼和原生程式碼的混合，適用於外掛支援的每個平台。需要為編譯到 Windows 上的 Flutter 應用程式中的每個外掛添加該原生程式碼。

此 alpha 版本提供了堅實的基礎，我們將在接下來的幾個月內將其穩定下來。透過對 Windows 7 及更高版本的支援，我們希望這能讓具有冒險精神的開發人員擁有一些可以開始使用的東西。

探索一些範例應用程式

若要查看 Flutter 對 Windows 的支援，您可能需要嘗試一些我們建立的範例應用程式，這些應用程式在我們的最新支援下可以在 Windows 上良好運行。第一個是 Flokk 應用程式，它是與 gskinner.com 的設計師和開發人員共同建立的。目標是透過建立一個創新的、美觀的 Flutter 桌面應用程式來證明 Flutter 已經準備好迎接桌面。Flokk 是一個與您的真實 Google 聯繫人資料配合使用的應用程式，同時還顯示了您的聯繫人在 GitHub 和 Twitter 上的活動。

如果您想在 Windows 電腦上使用 Flokk 應用程式，您可以 在 GitHub 上下載最新版本。如果您想了解 gskinner 如何構建這個應用程式，請參閱他們的出色部落格文章：Flokk - 我們如何使用 Flutter 建立桌面應用程式。

此外，Flutter Gallery 應用程式（我們用於所有 Flutter 事物的展示應用程式）最近已完全重寫，以添加對桌面外觀尺寸的支援。這讓我們可以檢查它在 網頁 以及 Windows、macOS 和 Linux 上是否運行良好。

Gallery 中的許多研究展示了我們在使用 Flutter 設計自己的 Windows 應用程式時推薦的不同應用程式樣式的想法。當您找到喜歡的內容時，程式碼可在 GitHub 上獲得。

開始使用 Flutter for Windows

按照 Windows 安裝說明 安裝 Flutter SDK 以開始。若要以 Windows 桌面為目標，您首先需要 安裝桌面文件中描述的工具。預設情況下，Flutter 假設您正在構建生產軟體，並且沒有配置為開發 Windows 應用程式。但是，這可以輕鬆地從命令行中修復：

1
2
3

$ flutter channel dev
$ flutter upgrade
$ flutter config --enable-windows-desktop

第一個命令將 Flutter 設定為使用實驗性品質的「dev」頻道（而不是預設的「stable」頻道）。這讓您可以使用仍處於 alpha 階段的平台支援，例如 Windows。第二個命令會在該頻道上提取最新的位元。第三個命令會在您的電腦上啟用 Windows 應用程式開發。

設定好之後，每次您使用 Android Studio 或 Visual Studio Code 的擴展支援，或者從命令行建立新的 Flutter 應用程式時，它都會建立一個 windows 子資料夾。

如果您感到好奇，在 Windows 上運行預設應用程式看起來像這樣：

最後，建立應用程式後，構建它會建立一個發佈模式的原生 EXE 檔案以及必要的支援 DLL。在那之後，如果您想嘗試在任何 Windows 10 電腦上運行您的新 Windows 應用程式，甚至那些沒有安裝 Flutter 的電腦，您可以 按照將必要檔案壓縮成壓縮檔的步驟 進行操作。

Windows 的外掛

儘管我們才剛剛達到 alpha 版本，但 Flutter 社群已經開始為 Windows 開發外掛。這裡有一些：

• url_launcher：從您的應用程式啟動瀏覽器中的 URL
• path_provider：查找使用者電腦上特殊位置（如文件或臨時文件）的路徑
• shared_preferences：在您的應用程式會話之間將使用者偏好設定序列化到磁碟上
• biometric_storage：透過生物識別資訊加密的儲存
• flutter_audio_desktop：從您的桌面應用程式播放音訊

使用這些外掛的好處是，它們中的大多數也支援其他 Flutter 平台，這使您可以將應用程式定位到 Android、iOS、網頁等以及 Windows。此外，儘管 pub.dev（Dart 和 Flutter 的套件管理器）上約三分之一的可用套件是包含平台特定程式碼的外掛，但大多數卻不是。例如，許多品質最高、使用最廣泛的套件 是 Flutter Favorite 程式的一部分，它們中的大多數都在 Windows 上運行。如果您想查看在 Windows 上運行的套件的完整列表，您可以 在 pub.dev 上運行此查詢。

與 Windows 互操作

如果您想為 Windows 建立自己的外掛，您可以。在您位於 dev 頻道並為您的電腦啟用 Windows 後，您可以使用以下命令開始：

1

$ flutter create --template plugin --platforms windows hello_plugin

在那之後，您就可以將 Flutter 程式碼添加到外掛專案中的 lib 子資料夾，以及將 Windows 程式碼添加到 Windows 子資料夾中。您將透過 平台通道 在兩個堆疊之間進行通訊，平台通道本質上是 Dart 和 C++ 程式碼之間的訊息傳遞。若要查看此方面的精心製作的範例，請 查看 url_launcher 實作。

但是，平台通道並不是您與 Windows 互操作的唯一選擇。如果您願意，可以使用 Dart FFI（外部函數介面） 來載入函式庫並呼叫 C 樣式的 API，例如 Win32 API。與使用平台通道的 url_launcher 不同，path_provider 外掛是使用 FFI 實作的，如您在 GitHub 儲存庫 中看到的那樣。FFI 不需要在 Dart 和 C++ 之間來回切換，它讓您能夠撰寫程式碼來直接匯入您想要的 API。例如，以下是呼叫 MessageBox API 的程式碼：

此程式碼不會像平台通道那樣在兩個執行緒之間轉換時產生額外的開銷。FFI 包括對許多不同類型的 API 的支援，包括 Win32、WinRT 和 COM。但在您開始運作並封裝整個基於 C 的 Windows API 之前，請查看 win32 外掛，它已經在進行這項工作。事實上，path_provider 外掛本身是使用 win32 外掛實作的。有關 win32 外掛的開發方式及其運作方式的詳細資訊，請查看部落格文章：使用 Dart FFI 的 Windows 樂趣。

Flutter for Windows 資源

無論您在 Flutter for Windows 之旅中處於哪個階段，您都應該確保 閱讀 flutter.dev 上的桌面文件，其中包括最新的詳細資訊。此外，您還需要嘗試使用 Flutter 用於撰寫以 Windows、macOS 和 Windows 桌面為目標的應用程式的 Codelab，其中包含用於實際情況的程式碼，例如使用 OAuth進行身份驗證、存取 GitHub API 以及使用 GraphQL。或者，若要查看另一個在 Windows 上運行的 Flutter 桌面程式碼的好範例，請 查看 Photo Search 範例。

它使用標準的 Windows 檔案開啟對話方塊、樹狀檢視 Widget、分割器 Widget，並將結果與實際的 REST API 整合。

對於其他有用的以桌面為導向的 Widget，我們建議使用 menubar 外掛、NavigationRail Widget 和 DataTable Widget。您可能也對 InteractiveViewer Widget 感興趣，它對滑鼠手勢（用於平移和縮放子 Widget）提供了完整的桌面支援。

另一組有用的 Widget 可以探索的是來自 SyncFusion 的 Widget，SyncFusion 在 Windows 開發社群中已經很有名。他們提供了大量企業級品質的 Widget，用於建立圖表、量規、資料網格等等。

這些 Widget 具有社群和企業許可證，因此您可以為您的專案找到合適的選項。

Flutter for Windows 的實際應用

除了 Windows 的套件和外掛（以及總體上的 Flutter 桌面）之外，Flutter 開發人員也一直在構建很棒的應用程式來以 Windows 為目標，例如來自 Invoice Ninja 的這個實驗性版本：

Invoice Ninja 是一家發票公司，它依賴 Flutter 來帶來收入。他們目前在生產環境中以 Android 和 iOS 為目標，並且為您提供了一個可以嘗試的 基於網頁的演示，但他們也展望著提供桌面版本。

“在 Invoice Ninja，我們過去一直努力僅支援網頁和行動，一度維護了三個獨立的程式碼庫。使用 Flutter，更近一步使用 Flutter 桌面，我們已經能夠使用單個程式碼庫為所有主要平台構建應用程式。我們不僅基本獲得了應用程式的免費桌面版本，而且它的效能也最佳！”

— Hillel Coren，Invoice Ninja 的共同創辦人

如果您對實作在行動和桌面外觀尺寸上運行的實際、產生收入的 Flutter 應用程式感興趣，程式碼可在 GitHub 上獲得。

Aartos 是另一家正在構建很棒的產品的公司，包括一個使用 Flutter 撰寫的多平台客戶端 的即時無人機偵測系統。以下是一個早期版本的 Windows 客戶端，它與行動客戶端並排運行：

這兩個版本都以 iOS 和 Windows 為目標，共享完全相同的程式碼庫。

如果您是經驗豐富的 Flutter 開發人員，並且發現自己經常在不同版本的 Flutter 之間切換；例如，一個版本用於發佈您的生產行動應用程式，另一個版本用於嘗試 Windows alpha 版本，那麼您可能會喜歡 Flutter 版本管理器，Flutter 版本管理器現在附帶了 可以下載的 Windows GUI。

這個工具是開源的，因此您可以 親眼看看 Leo 如何讓它看起來如此棒。

未來展望

現在我們已經發佈了 alpha 版本，我們的注意力將轉移到完成功能集並穩定產品以供發佈。作為一個開源專案，您可以在我們的 GitHub 網站上追踪我們的貝他版進度，其中包括需要完成的剩餘工作，包括輔助功能、全球化和本地化、增強的鍵盤和文字處理、對命令行參數的支援等等。

除了支援經典的 Win32 API 之外，我們還在嘗試 基於 UWP 的 Flutter 外殼版本，這讓 Flutter 可以到達更多種類的基於 Windows 的設備，包括 Xbox。作為該實驗的一部分，本週我們向 Windows 商店發佈了一個基於 UWP 的 Flutter Gallery 版本。

以下螢幕截圖顯示了基於 UWP 的 Flutter Gallery 在 Xbox 上運行：

以下是在運行 Windows 10X 模擬器 的雙螢幕 Windows 設備上運行的相同應用程式：

您可以在 GitHub 上閱讀更多有關 Flutter for UWP 進度。

總結

透過此版本，我們將 Flutter 的強大功能帶到了 Windows，它具有用於開發人員生產力的宣告式、可組合、反應式框架，以及 Material 規格的適應性實作，因此您可以讓應用程式以您想要的方式呈現和感覺，以及完整的 Flutter 開發和除錯工具集。完成後，您的應用程式將編譯為原生 64 位程式碼，您可以像任何其他原生應用程式一樣將其封裝並帶到其他 Windows 電腦。最後，您可以使用相同的程式碼庫來建立一個以 Android、iOS、網頁、macOS 和 Linux 為目標的應用程式。

如果您想開始使用 Flutter 建立 Windows 應用程式，我們非常歡迎您的 回饋！如果您想使用您的 Windows 專業知識來 構建熱門外掛的 Windows 實作，或者為 Flutter 建立一些以 Windows 為中心的工具（也許是一個從 flutter build windows 命令的輸出建立 MSIX 的 CLI…），也非常歡迎！

有了 Flutter 對 Windows 的新支援，您打算構建什麼？

宣布 Flutter Windows Alpha 最初發佈在 Flutter 上的 Medium，人們在那裡透過突出顯示和回應這個故事來繼續討論。

http://creativecommons.org/licenses/by/4.0/

【文章內容使用 Gemini 1.5 Pro 自動產生】

在 Flutter 中處理網頁手勢

Flutter 發佈了網頁支援，讓您可以建立動態網站。有了 Flutter 網頁、MacOS、Linux 和 Windows 作業系統（甚至在連接到滑鼠、鍵盤或其他週邊設備的行動裝置上），您現在可以存取平台特定行為，包括焦點支援、鍵盤輸入、自訂滑鼠游標和懸停輸入。但是，您如何在 Flutter 中使用這些平台行為呢？

本文說明如何使用 FocusableActionDetector Widget，它處理鍵盤輸入、焦點輸入、懸停輸入和自訂滑鼠游標。

如何使用 FocusableActionDetector Widget

FocusableActionDetector Widget 允許您處理幾個網頁特定動作，包括：

1. 鍵盤輸入
2. 焦點輸入
3. 懸停輸入
4. 自訂滑鼠游標

在 DartPad #1 範例中查看 FocusableActionDetector 的實際應用。

**注意：**本文使用了兩個 DartPad 範例，儘管每個範例都有多個連結。[DartPad #1](https://dartpad.dev/d16345202d0e26d40fe14904657dc24a) 展示了 `FocusableActionDetector` 範例，而 [DartPad #2](https://dartpad.dev/5544c57e20454fe212e3ec5cf10b1f0a) 展示了 `FocusableActionDetector` 的懸停和焦點支援。

鍵盤輸入

Flutter 允許您定義自訂動作來處理鍵盤輸入。假設您想要有一個隱藏的選單，或者您的應用程式必須處理大量的自訂鍵盤輸入。使用 FocusableActionDetector Widget 很容易做到這一點。

首先，加入以下匯入：

1

import 'package:flutter/services.dart';

接下來，從調用 FocusableActionDetector 的類別中，初始化兩個私有變數。這些變數將鍵盤輸入映射到所需的動作：

1

Map<LogicalKeySet, Intent> _shortcutMap;

1

Map<Type, Action<Intent>> _actionMap;

定義一個 FocusableActionDetector Widget。請注意，自訂鍵盤輸入僅在子 Widget 獲得焦點時才會啟用：

1
2
3
4
5

FocusableActionDetector(
  actions: _actionMap,
  shortcuts: _shortcutMap,
  child: 
)

此類別將列舉和鍵盤輸入類型映射到 Intent 類別。以下設定是必要的，因為 actions 和 shortcuts 參數需要一個繼承自 Intent 的類別：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23

class _ShowSecretMessageIntent extends Intent {
  const _ShowSecretMessageIntent({@required this.type});
  const _ShowSecretMessageIntent.P() : type = _SecretMessageType.P;
  const _ShowSecretMessageIntent.L() : type = _SecretMessageType.L;
  const _ShowSecretMessageIntent.A() : type = _SecretMessageType.A;
  const _ShowSecretMessageIntent.T() : type = _SecretMessageType.T;
  const _ShowSecretMessageIntent.F() : type = _SecretMessageType.F;
  const _ShowSecretMessageIntent.O() : type = _SecretMessageType.O;
  const _ShowSecretMessageIntent.R() : type = _SecretMessageType.R;
  const _ShowSecretMessageIntent.M() : type = _SecretMessageType.M;
  final _SecretMessageType type;
}

enum _SecretMessageType {
  P,
  L,
  A,
  T,
  F,
  O,
  R,
  M,
}

在 initState 方法中，初始化之前定義的映射：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25

void initState() {
  _shortcutMap = <LogicalKeySet, Intent>{
    LogicalKeySet(LogicalKeyboardKey.keyP):
      const _ShowSecretMessageIntent.P(),
    LogicalKeySet(LogicalKeyboardKey.keyL):
      const _ShowSecretMessageIntent.L(),
    LogicalKeySet(LogicalKeyboardKey.keyA):
      const _ShowSecretMessageIntent.A(),
    LogicalKeySet(LogicalKeyboardKey.keyT):
      const _ShowSecretMessageIntent.T(),
    LogicalKeySet(LogicalKeyboardKey.keyF):
      const _ShowSecretMessageIntent.F(),
    LogicalKeySet(LogicalKeyboardKey.keyO):
      const _ShowSecretMessageIntent.O(),
    LogicalKeySet(LogicalKeyboardKey.keyR):
      const _ShowSecretMessageIntent.R(),
    LogicalKeySet(LogicalKeyboardKey.keyM):
      const _ShowSecretMessageIntent.M(),
    };
  _actionMap = <Type, Action<Intent>>{
    _ShowSecretMessageIntent: CallbackAction<_ShowSecretMessageIntent>(
      onInvoke: _actionHandler,
    ),
  };
}

動作處理程序將鍵盤輸入連結到應用程式中的特定函數。每次按下字元時，都會在應用程式的主要部分加入一個展開的容器。但在您的應用程式中，您可以將其用於更具創意目的：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17

void _actionHandler(_ShowSecretMessageIntent intent) {
  switch (intent.type) {
    case _SecretMessageType.P:
      setState(() {
        children.add(
          Expanded(
            child: Container(
              color: Colors.orange,
              child: Text('Press L'),
            ),
          ),
        );
      });
    break;
    …
  }
}

焦點輸入

FocusableActionDetector Widget 允許您在指定 Widget 獲得焦點時執行動作呼叫。

焦點樹允許您使用 Tab 鍵在應用程式中瀏覽。這讓有視力障礙的人能夠瀏覽您的網站。

FocusableActionDetector 子 Widget 被選為初始焦點，當其作用域中的其他節點目前沒有焦點時。如果您希望您的自訂鍵盤輸入在子 Widget 是否有焦點都不受影響的情況下運作，則將 autofocus 參數變數設定為 true 很重要。這是因為，預設情況下，此 FocusableActionDetector Widget 將不會獲得焦點，因此您將無法使用自訂鍵盤輸入：

1
2
3
4

FocusableActionDetector(
  autofocus: true,
  child : …
),

假設您希望子 Widget 在獲得焦點時具有不同的顏色，以識別此 Widget 目前是否有焦點。如果您需要在 Widget 獲得焦點時設定自訂動作，請使用 onShowFocusHighlight 屬性。

DartPad #2 範例展示了如何使用 onShowFocusHighlight 屬性。

焦點是一個進階主題。透過閱讀 Focus 類別的 API 文件，您可以進一步了解焦點。

懸停輸入

FocusableActionDetector Widget 允許您處理懸停輸入。這樣一來，每當游標懸停在特定 Widget 上時，就會發生自訂動作。與 onShowFocusHighlight 屬性類似，onShowHoverHighlight 屬性讓您能夠在滑鼠游標懸停在特定 Widget 上時建立自訂動作。

查看 DartPad #2 範例，它展示了如何實作自訂懸停和焦點動作。

在 DartPad #2 範例中，每當滑鼠懸停在 Widget 上時，它就會更改 Widget 的顏色。如果您使用 Tab 鍵在應用程式中瀏覽，您會注意到，與目前被懸停的 Widget 相比，獲得焦點的 Widget 會對 Widget 應用不同的陰影。

這意味著您可以在 Widget 獲得焦點或滑鼠游標懸停在該 Widget 上時，執行不同的自訂動作。如果您將滑鼠懸停在同一個 Widget 上並使它獲得焦點，您就可以看出來。該 Widget 會同時對該 Widget 應用兩個陰影。若要了解更多資訊，請查看 FocusableActionDetector 類別的 API 文件。

自訂滑鼠游標

FocusableActionDetector Widget 讓您能夠實作自訂滑鼠游標。例如，如果您希望使用者知道特定 Widget 是可拖曳的，更改滑鼠游標是一個很好的指示，表示您可以執行此操作。FocusableActionDetector Widget 具有 mouseCursor 參數。

1

mouseCursor: SystemMouseCursors.grabbing

DartPad #1 範例展示了 Flutter 中不同類型的滑鼠游標。點擊應用程式列中的任何圖示以嘗試使用。有九種不同的系統預設滑鼠游標：

1. SystemMouseCursors.basic
2. SystemMouseCursors.text
3. SystemMouseCursors.click
4. SystemMouseCursors.forbidden
5. SystemMouseCursors.grab
6. SystemMouseCursors.grabbing
7. SystemMouseCursors.horizontalDoubleArrow（未在穩定版本中）
8. SystemMouseCursors.verticalDoubleArrow（未在穩定版本中）
9. SystemMouseCursors.none

結語

在 Flutter 中，您可以存取網頁特定 API。FocusableActionDetector Widget 讓您能夠在 Flutter 中處理網頁特定功能。若要進一步了解 Flutter 網頁，請查看 Medium 文章 Handling 404: Page not found error in Flutter。

關於作者：Jose 最近從大學畢業，現在在 Material 工作，這是一個幫助團隊構建高品質數位體驗的設計系統。Jose 的團隊維護 Flutter 的 material 函式庫。若要了解更多資訊，請訪問 Jose 在 GitHub、LinkedIn、YouTube 和 Instagram 上的頁面。

在 Flutter 中處理網頁手勢 最初發佈在 Flutter 上的 Medium，人們在那裡透過突出顯示和回應這個故事來繼續討論。

【文章內容使用 Gemini 1.5 Pro 自動產生】

使用 Flutter 支援 iOS 14 和 Xcode 12

與往常一樣，我們的目標是讓開發人員在 Flutter 上取得成功，無論您要鎖定的平台為何。自 6 月宣布 iOS 14 以來，我們一直在努力為 Flutter 加入支援此版本的新功能，包括更新 Xcode 12 支援，以及加入支援 iOS 14 的新功能和改進。

如果您的 iOS 14 應用程式使用 TextField、CupertinoTextField 或 TextFormField，您需要確保它使用 Flutter 1.20 或更高版本構建，以確保您的使用者不會受到不必要的剪貼簿通知訊息的困擾，這符合 Apple 更新的剪貼簿政策。

否則，現有的生產應用程式將在您的終端使用者 iOS 14 設備上順利運行。 但是，如果您今天要將開發手機升級到 iOS 14 並希望繼續與 Flutter 一起使用它，您有兩個選擇。

您的第一個選擇是使用穩定頻道上的 Flutter 最新修補程式版本 (1.20.4)，它支援將應用程式部署到實體 iOS 14 設備進行開發。不幸的是，還需要另一個更具侵入性（因此風險更大）的變更才能在 iOS 14 上進行除錯和熱重載。我們將此修復推遲到我們下一個穩定版本，我們計劃在下週釋出。

您的第二個選擇是使用我們今天釋出的即將到來的 Flutter 1.22 的 beta 版。此版本包含對 iOS 14 的更全面支援，包括更新的視覺效果、應用程式片段和 Xcode 12 支援。當它發佈到穩定頻道時，我們將分享更多關於其功能集的信息，但在此之前，我們建議您在需要立即支援 iOS 14 的情況下使用此 beta 版本。

若要取得 Flutter 1.22 beta 版，請使用以下命令：

1
2

$ flutter channel beta
$ flutter upgrade

無論哪種情況，您都需要查看 針對 iOS 14 開發頁面，以獲取有關使用 Flutter 鎖定 iOS 14 的有用資訊。如果您在 iOS 14 中遇到任何問題，請 在 Flutter 儲存庫中提交議題。如果您有任何問題，請在 flutter-dev 群組 中發布。

使用 Flutter 支援 iOS 14 和 Xcode 12 最初發佈在 Flutter 上的 Medium，人們在那裡透過突出顯示和回應這個故事來繼續討論。

http://creativecommons.org/licenses/by/4.0/

【文章內容使用 Gemini 1.5 Pro 自動翻譯產生】

探索 Dart 中的集合

如果您曾經調用 add()、addAll()、map() 或 toList() 來建立列表或映射，您可能需要查看 collection if、collection for 和 spreads。去年，Dart 在 2.3 版中加入了這些功能。

在本文中，我們將研究集合，探索這些新功能，並查看一些有趣的範例。透過掌握這些功能，您可以使您的程式碼更簡潔、更易於閱讀。

集合

首先，我們需要了解什麼是集合。集合 是一個包含其他物件的物件。例如：

• List：具有長度的有序物件集合（也稱為 陣列）
• Set：唯一物件的無序集合
• Map：鍵值對的無序集合
• Queue：可以在兩端添加/移除物件的有序集合
• SplayTreeMap：基於自平衡二元樹的鍵值對的有序集合

這些類型在 dart:collection 套件中可用。如需更多集合類型，請在 pub.dev 上查看 package:collection。

這些集合類型都實作了 Iterable，它提供了一些常用行為，例如在集合中的每個物件上運行函數、獲取第一個物件、確定集合的長度等等。

集合字面量

Dart 支援用於構造三種類型集合的語法：列表字面量 ([])、映射字面量 ({}) 和集合字面量（也是 {}）。

以下是一個列表字面量：

1
2
3
4
5
6
7

List<String> getArtists() {
  return [
    'Picasso',
    'Warhol',
    'Monet',
  ];
}

以下是一個映射字面量：

1
2
3
4
5
6
7

Map<String, String> getArtistsByPainting {
  return {
    'The Old Guitarist': 'Picasso',
    'Orange Prince': 'Warhol',
    'The Water Lily Pond': 'Monet',
  };
}

以下是一個集合字面量，在 Dart 2.3 中加入：

1
2
3
4
5
6
7

Set<String> getArtistsSet() {
  return {
    'Picasso',
    'Warhol',
    'Monet',
  };
}

如果您想知道為什麼映射和集合可以使用相同的 {} 語法，那是因為 Dart 使用 類型推斷 來區分。類型系統根據參數 a 和 b 的類型確定類型。它通常可以根據內容確定這一點——例如，{1} 顯然是一個 Set，而 {1: 2} 顯然是一個 Map。

注意： 使用 {} 預設構造一個映射。要建立一個集合，您可以使用泛型類型註釋：<String>{}。使用兩個泛型類型參數則建立一個映射：<String, String>{}。

元素的類型

集合字面量中的每個項目通常是一個值或表達式，但也可以是以下新功能之一：collection if、collection for 或 spread。所有這些都被稱為 元素。

每個元素解包零個或多個項目，並將它們放入周圍的集合中。例如，一個字串字面量（例如「oatmeal」）會產生一個項目，但 collection for 會解包 0 個或多個項目。這些功能也可以以有趣的方式組合，我們將在下面探討。

Spreads

spread 接收一個集合（例如，一個列表），並將其內容放入周圍的集合中：

1
2
3
4
5
6

List<String> combineLists(List<String> a, List<String> b) {
  return [
    ...a,
    ...b,
  ];
}

前面的程式碼相當於：

1
2
3
4
5
6

List<String> combineLists(List<String> a, List<String> b) {
  var list = [];
  list.addAll(a);
  list.addAll(b);
  return list;
}

您也可以在映射和集合字面量中使用 spreads：

1
2
3
4
5
6

Map<String, String> combineMaps(Map<String, String> a, Map<String, String> b) {
  return {
    ...a,
    ...b,
  };
}

1
2
3
4
5
6

Set<String> combineSets(Set<String> a, Set<String> b) {
  return {
    ...a,
    ...b,
  };
}

在映射和集合中，當發生衝突時，b 的內容會覆蓋 a 中的內容。例如，調用 combineMaps({'foo': 'bar'}, {'foo': 'baz'}) 會產生一個包含 {'foo': 'baz'} 的映射。

Null-aware spreads (…?)

null-aware spread 僅當運算符後的表達式為非 null 時才將內容加入到集合中：

1
2
3
4
5
6

List<String> combineIfExists(List<String> a, List<String> b) {
  return [
    ...?a,
    ...?b,
  ];
}

1
2
3
4

void main() {
  var result = combineIfExists(['foo'], null);
  print(result); // [foo]
}

Collection if

使用 if、else 和 else if 關鍵字根據條件將某些內容加入到集合中。以下是一個使用 collection if 的範例：

1
2
3
4
5
6
7
8
9
10
11
12
13

class Article {
  String title;
  DateTime date;

  Article(this.title, this.date);

  String toString() {
    return [
      if (title != null) title,
      date.toString(),
    ].join(', ');
  }
}

可以在末尾加入 else 關鍵字：

1
2
3
4
5

String toString() {
  return [
     if (title != null) title else '(no title)',
  ].join(', ');
}

請注意逗號的位置。逗號不能在 title 之後，因為 else 是同一個元素的一部分。將 if 和 else 保持在一起，在逗號之前，可以將它們與集合中的下一個元素區分開來。

加入 else if 也可以：

1
2
3
4
5
6
7
8
9
10
11

String toString() {
  return [
    if (title != null) title else '(no title)',
    if (date == null)
      '(no date)'
    else if (date.year == DateTime.now().year)
      'this year'
    else
      '${date.year}',
  ].join(', ');
}

Collection for

最後，使用 for 關鍵字將序列插入到集合中：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15

class Article {
  String title;
  DateTime date;
  List<String> tags;

  Article(this.title, this.date, this.tags);

  String toString() {
    return [
      title,
      date.toString(),
      for (var tag in tags) 'tag: $tag'
    ].join(', ');
  }
}

在此範例中，for 表達式為 tags 列表中的每個項目加入一個字串。就像 Dart 中的普通 for 迴圈一樣，tags 表達式可以是任何 Iterable。

Flutter 程式碼中的集合

如果您正在使用 Dart，很有可能您正在使用它來構建 Flutter 應用程式。由於這裡描述的功能是在設計時考慮到 Flutter 的，讓我們來看看一些 Flutter 程式碼。

重構 build() 方法

在 Flutter 中，通常在 build() 方法中構建 Widget 列表：

1
2
3
4
5
6
7
8
9
10

@override
Widget build(BuildContext context) {
  var articleWidgets = articles
      .map<Widget>((article) => ArticleWidget(article: article))
      .toList();

  return ListView(
    children: articleWidgets,
  );
}

可以使用 spread 重寫此程式碼：

1
2
3
4
5
6
7
8

Widget build(BuildContext context) {

  return ListView(
    children: [
      ...articles.map((article) => ArticleWidget(article:article))
    ],
  );
}

或者使用 collection for：

1
2
3
4
5
6
7
8

Widget build(BuildContext context) {
  return ListView(
    children: [
      for (var article in articles)
        ArticleWidget(article: article)
    ],
  );
}

第一個程式碼片段使用 map() 將 Article 類別轉換為 ArticleWidget 物件的集合，然後應用 spread 運算符將它們展開到周圍的列表中。在第二個範例中，collection for 運算符讓您可以更簡潔地表達這一點。

更大的 build() 方法

以下是一個更複雜的範例：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15

Widget build(BuildContext context) {
  var headerStyle = Theme.of(context).textTheme.headline4;

  return Column(
    children: [
      if (article.title != null)
        Text(article.title, style: headerStyle),
      if (article.date != null)
        Text(article.date.toString()),
      Text('Tags:'),
      for (var tag in article.tags)
        Text(tag),
    ],
  );
}

放置 Widget 到 Column 中的邏輯就在讀者可能期望的位置，並且節省了大量程式碼。在這些功能出現之前，實現相同行為最常用的方法是建立一個變數，並使用調用 add() 的普通 if 陳述式。

組合這些功能

這些功能可以以有趣的方式組合，如本節中的範例所示。以下是一些需要注意的事項：

• 從語法上講，collection if、collection for 或 spread 是一個 單個元素——即使它最終建立了多個物件。
• 任何表達式都可以放在 collection if 或 collection for 的主體中。
• 任何 元素 都可以放在 collection if 或 collection for 的主體中。

結合使用 if 和 for

以下是一些使用 collection for 內部的 collection if 建立列表的程式碼。在這裡，如果每個文章的日期晚於特定日期，則將其加入到列表中：

1
2
3
4
5
6
7
8

List<Article> recentArticles(List<Article> allArticles) {
  var ninetyDaysAgo = DateTime.now().subtract(Duration(days: 90));
  return [
    for (var article in allArticles)
      if (article.date.isAfter(ninetyDaysAgo))
        article
  ];
}

如果您更喜歡 spreads，則返回值可以寫成 ...allArticles.where((article) => article.date.isAfter(ninetyDaysAgo))。

將 collection if 和 spreads 結合使用

collection if 接收單個元素，但如果您想包含多個元素，則可以使用 spread：

1
2
3
4
5
6
7
8
9
10

Widget build(BuildContext context) {
  return Column(
    children: [
      if (article.date != null) ...[
        Icon(Icons.calendar_today),
        Text('${article.date}'),
      ],
    ],
  );
}

將集合功能與 async-await 結合使用

您也可以將非同步調用與集合字面量結合使用。例如，一個常見的模式是使用 Future.wait() 觸發一組非同步調用：

1
2
3
4
5
6
7
8
9

Future<Article> fetchArticle(String id);

Future<List<Article>> fetchArticles() async {
  return Future.wait([
    fetchArticle('1'),
    fetchArticle('2'),
    fetchArticle('3'),
  ]);
}

可以使用 collection for 改進該程式碼：

1
2
3
4
5
6

Future<List<Article>> fetchArticles(List<String> ids) async {
  return Future.wait([
    for (var id in ids)
      fetchArticle(id),
  ]);
}

也可以在集合字面量中放入 await，儘管它會依次等待每個 Future：

1
2
3
4
5
6
7

Future<List<Article>> fetchArticles(List<String> ids) async {
  return [
    // 一次獲取一個
    for (var id in ids)
      await fetchArticle(id),
  ];
}

前面的程式碼會依次等待，因為它相當於以下程式碼：

1
2
3
4
5
6
7
8

Future<List<Article>> fetchArticles() async {
  return <Article>[
    // 一次獲取一個
    await fetchArticle('1'),
    await fetchArticle('2'),
    await fetchArticle('3'),
  ];
}

您也可以使用 await for 展開 Stream：

1
2
3
4
5
6
7
8
9
10
11

Stream<String> get idStream => Stream.fromIterable(['1','2','3']);
Future<List<String>> gatherIds(Stream<String> ids) async {
  return [
    await for (var id in ids)
      id
  ];
}

void main() async {
  print(await gatherIds(idStream)); // [1, 2, 3]
}

這是 collection if、collection for 和 spreads 如何與語言的其他部分一起使用的另一個範例。如果您使用過 await for 陳述式，您可能會猜到其行為：它偵聽 Stream 中的新值，並將主體放入周圍的列表中。

進一步探索

希望這些技巧能幫助您編寫更乾淨的 Dart 程式碼。除了這裡提到的之外，還有更多使用這些功能的方法。如果您發現了一個好的技巧，請與社群分享或在 Twitter 上提及 @dart_lang。如需更多詳細資訊，請查看使 Dart 成為更好的 UI 語言或 GitHub 上的初始語言提案。

探索 Dart 中的集合 最初發佈在 Dart 上的 Medium，人們在那裡透過突出顯示和回應這個故事來繼續討論。

【文章內容使用 Gemini 1.5 Pro 自動翻譯產生】

Google 暑期程式碼計畫 2020 成果

Google 暑期程式碼計畫 (GSoC) 是一個全球性的計畫，旨在讓學生開發者參與開放原始碼軟體開發。Google 贊助學生在暑假期間與一個指導性的開放原始碼組織合作，進行為期 3 個月的程式設計專案。

在 二月，我們很興奮地宣布 Dart 團隊將成為 2020 年 GSoC 的指導組織。我們最終 指導了 5 個專案，這些專案是從來自世界各地學生的 170 多份申請中選出的。今天，我們很高興與大家分享我們的成果，這些成果將由參與專案的學生們來描述。

使用 package:ffigen 為 Dart-C 互通性產生 dart:ffi 繫結

Prerak Mann

package:ffigen 是一個 FFI 產生器，它透過從 C 標頭檔 (.h) 產生 Dart 繫結，大大減少了使用 dart:ffi 的工作量。

為了理解這個工具的需求，請考慮 LibClang（Clang 的 C 介面）。LibClang 的 API 大約有 8,000 行程式碼 (LOC)。如果您要手動為 LibClang 編寫 Dart 繫結，您將需要將近 4,500 LOC。使用 package:ffigen，您只需傳入一個小於 20 LOC 的 小型 YAML 設定檔，然後就可以產生繫結。

您可以控制要產生的 C 函式，並使用簡單的正規表示式來重新命名巨集、列舉和個別的結構成員。您也可以 產生 巢狀在結構中的陣列成員（dart:ffi 中尚不完全支援）。

請查看 github.com/dart-lang/ffigen 以取得完整的 設定、常見問題、範例 等等。

使用新的 Flutter 範例學習測試

Abdullah Deshmukh

您已經使用 Flutter 一段時間了，但仍然不知道如何測試 Flutter 應用程式嗎？那麼您可能會對我們建立的範例感興趣，該範例展示了測試 Flutter 應用程式的最佳實踐。您將能夠快速輕鬆地學習在 Flutter 中進行測試。

該 範例 展示了不同類型的測試，包括：

• 單元測試
• Widget 測試
• 整合測試
• 效能測試
• 狀態管理測試

作為額外福利，我們還建立了一個關於如何測試 Flutter 應用程式的程式碼實驗室。您可以在文章 使用新的 Flutter 範例學習測試 中查看專案下完成工作的詳細報告。

使用者可擴展的翻譯檔案格式

Jaime Blasco

intl_translation 套件僅支援 ARB 檔案格式，該格式在 Dart 之外並未廣泛使用。在 GSoC 2020 期間建立的 intl_translation_format 套件建基於 intl_translation，並添加了一個 TranslationFormat 類別，可以支援各種不同的格式。開發人員可以在自己的套件中添加對其他格式的支援，並且只需幾行程式碼即可建立與現有工具整合的提取和產生命令列工具。有了這些，其他格式（即使是專有格式）的現有翻譯可以輕鬆匯入到 Dart 專案中，並且源自 Dart 程式碼的新訊息可以整合到現有的翻譯工具和工作流程中。

作為這些功能的展示，新的套件包含對多種格式的支援。除了 ARB 之外，它還支援 XLIFF v1.2 (iOS)、XLIFF v2.0 和 帶有 ICU 訊息的 JSON。實驗性函式庫 展示了如何實作對其他格式的支援，甚至是可以在執行階段更新的翻譯。

行動應用程式和聯合 Plugin 中的平台通道

Ayush Bherwani

在研究了平台通道（用於在 Dart 與原生程式碼（如 Swift 或 Kotlin）之間來回傳送訊息的 Flutter API）之後，我們決定使用兩個不同的範例來介紹這個主題。一個是 簡單的 Android 和 iOS 範例，而另一個是 聯合 Plugin，能夠使用主頻道為 Web 和桌面建構。在這兩個範例之間，程式碼庫不僅展示了平台通道和用於移動資料的編解碼器的詳細資訊，還展示了聯合 Plugin 的 API 以及在 Web 和桌面（Windows 和 Linux）API 上調用原生程式碼的技術。

如果您是一位正在尋找建構 Plugin 或僅存取平台 API 的開發人員，這些範例是開始學習的好地方。有關此專案的更多資訊，請參閱文章 平台通道範例。

編寫 package:yaml_edit 以啟用 pub add <package>

Garett Tok Ern Liang

Dart 專案在 pubspec.yaml 檔案中指定套件依賴項。YAML 很好，因為它允許我們編寫註釋，但是以程式設計方式修改 YAML 是一個挑戰。

為了應對這一挑戰，我們編寫了 package:yaml_edit 以輕鬆執行上下文感知的字串操作，從而保留格式和註釋。該套件的測試套件包含超過 40,000 個測試，我們認為我們有一個非常好的解決方案。試用它並 提交錯誤！

使用 package:yaml_edit，我們在 pub（Dart 和 Flutter 的套件管理工具）中添加了一個新的子命令 pub add <package>。pub add 會自動解析目標套件的最新相容版本，並將其添加到使用者的 pubspec.yaml 中。具體來說，pub add <package> 自動化了以下所有操作的繁瑣過程：

1. 訪問 https://pub.dev/packages/
2. 選擇要添加到套件的版本
3. 修改 pubspec.yaml
4. 執行 pub get
5. 根據需要重複步驟 2-4 多次，以獲得與其他依賴項相容的版本

一個類似的移除依賴項的命令 - pub remove <package> - 也正在開發中。請密切關注即將在 pub 中推出的這兩個命令！

非常感謝所有向 Dart 申請 Google 暑期程式碼計畫 2020 的人，以及今年完成專案的學生，以及每週花時間讓這個夏天成為一個很棒的程式碼夏天的導師。我們希望在整個 Dart 生態系統中再次見到你們這些學生作為貢獻者。

Google 暑期程式碼計畫 2020 成果 最初發佈在 Dart 上的 Medium，人們在那裡透過突出顯示和回應這個故事來繼續討論。

【文章內容使用 Gemini 1.5 Pro 自動翻譯產生】

隆重推出全新的 pub.dev

今天，我們推出了全新的 pub.dev 網站。它採用了新的評分指標，讓您可以更好地了解可能有用的套件，並為套件發布者提供更多可操作的回饋，以提高套件品質。為了幫助您找到支援您感興趣的所有平台的套件，我們新增了識別和搜尋多平台套件的功能。總體而言，我們重新設計了使用者介面，目標是提供與我們的 dart.dev 和 dartpad.dev 網站一致的愉悅而優雅的體驗。

找到最符合您需求的套件

在過去一年中發布了近 7,000 個新套件，在尋找擴展應用程式功能的套件時，您不乏選擇。但是有這麼多套件可供選擇，您自然希望最受歡迎、品質最高、最常用的套件能夠脫穎而出。為了支援更好的套件搜尋結果，我們圍繞三個維度重新設計了 pub.dev 中的評分系統：

1. 點讚數: 衡量有多少開發者點讚了一個套件。這提供了一個對套件整體評價的原始指標。
2. Pub 分數: 一種新的品質衡量標準。這包括品質的幾個維度，例如程式碼風格、平台支援和可維護性。詳情請見下文。
3. 熱門度: 衡量有多少開發者使用一個套件。這反映了过去六十天內依賴該套件的應用程式數量。標準化後的評分範圍從 100%（最常用的套件）到 0%（最少使用的套件），但我們正在研究是否可以在未來版本中提供絕對使用計數。

我們希望這些新的維度可以幫助正在尋找依賴套件的套件使用者，以及致力於發布高品質套件的套件發布者。

使用 Pub 分數衡量品質

點讚數和熱門度提供了社群提供的、主觀的衡量標準，Pub 分數的目標是提供一個可衡量的、客觀品質的近似值。這並不容易；開發者以各種方式感知品質，但我們仍然相信大多數開發者都在尋找我們可以衡量的核心特徵。以前的 pub.dev 評分模型基於對問題的扣分。新的評分模型扭轉了這種方法，而是根據五個類別中的特徵授予分數：

1. 遵循 Dart 檔案規範: 遵循 pubspec、readme 和 changelog 檔案的最佳實務
2. 提供文件: 提供 API 文件和說明性範例
3. 支援多個平台: 支援盡可能多的 Dart 和 Flutter 平台
4. 通過靜態分析: 提供無錯誤、警告和 lint 的程式碼
5. 支援最新的相依: 具有支援最新 Dart 和 Flutter SDK 以及最新套件相依的相依限制

我們預計隨著時間的推移，會為 Pub 分數新增更多檢查和類別，提高套件可以獲得的分數上限。例如，我們計劃在該功能推出時，為支援 空安全 新增一個分數。我們正在研究如何衡量可維護性（問題和拉取請求的回應速度）、可測試性（自動化測試覆蓋率）和社群友好度（貢獻者、維護者數量等）。如果您對一個好的衡量標準有任何想法，我們很樂意 聽取您的意見！

支援多平台應用程式

Dart 和 Flutter 都擅長建立針對多個平台的應用程式。在 pub.dev 上，我們為行動（iOS 和 Android）和 Web 平台提供了清晰的平台標籤，以及這些平台的搜尋篩選器：

為了確保您的套件標記了正確的平台支援，請遵循 pub.dev 評分說明頁面 上的指南。

當桌面平台（macOS、Windows 和 Linux）發展到更最終的狀態時，我們將新增類似的支援。目前，您可以在「進階」搜尋選項中找到這些平台的篩選器：

優雅而令人愉悅的設計

Dart pub.dev 團隊與我們的內部創意團隊 Google Developer Studio 合作，Jeremy Sie 擔任主要設計師。除了功能更新之外，團隊還仔細研究了視覺設計，分享了他們對該專案的想法。為了提供一致的、易於存取的、以使用者為中心的體驗，我們根據 Google 的 Material Design 系統 進行了一系列改進。我們的目標是建立一個輕量級且簡化的介面，為套件發布者和使用者提供清晰簡潔的工作流程。

更新後的設計採用了 Material 元件，例如卡片和晶片，可以清晰地顯示套件詳細資訊，並讓單個套件的功能更加透明。我們更新了排版系統，並改進了整個網站的 字體比例，使搜尋結果更加清晰，並改進了套件資訊的顯示方式。套件分數等元件也經過重新設計，使其更加清晰，並以一種使評分過程更加透明且更容易理解的方式進行組織。

我們還對首頁進行了更改。我們知道快速搜尋套件的能力是網站的核心部分，但我們希望透過顯示最有用的工具和函式庫來改進體驗。我們在前面加入了「Flutter 精選」和「最熱門套件」等區塊，幫助您快速瀏覽一些最好的套件。我們仔細研究了調色板和藝術方向，加入了插圖，並使程式碼範例等元件與 dart.dev 和 dartpad.dev 在視覺上保持一致。

立即試用 pub.dev

我們邀請您立即試用新的 pub.dev 瀏覽和搜尋體驗，並使用新的評分維度和 Pub 分數報告。

如果您是套件開發者，我們鼓勵您查看套件的 Pub 分數，尋找改進套件的機會。有關評分系統如何運作的更多詳細資訊，請參閱 pub.dev 評分說明。

與往常一樣，我們喜歡回饋。請在下方留言，或在 pub.dev 問題追蹤器 中提交問題。

作者：Michael Thomsen（Dart 產品經理）和 Jeremy Sie（Google Developer Studio 視覺設計師）

隆重推出全新的 pub.dev 最初發佈於 Dart 上的 Medium，人們在那裡透過突出顯示和回應這個故事來繼續討論。

http://creativecommons.org/licenses/by/4.0/

【文章內容使用 Gemini 1.5 Pro 自動翻譯產生】

正確操作 Dart 字串 👉

像許多其他在表情符號開始主導我們的日常通訊和多語言支援在商業應用程式中興起之前設計的程式語言一樣，Dart 將字串表示為 UTF-16 編碼單元序列。這種編碼在大多數情況下都能正常工作，直到國際化的加強和伴隨任何語言出現的表情符號的引入，使得該編碼的固有問題成為每個人的問題。

考慮這個例子：

在字串 “Hello👋” 中，除了揮手表情符號 👋 之外，每個使用者可感知的字元都映射到一個編碼單元。這種映射的直接後果是對該字串長度的混淆。以下程式碼行的輸出是 6 還是 7？

1

print('Hello👋'.length);

對於使用者來說，這個字串中顯然有 6 個字元，除非你進行哲學思考。但 Dart String API 會告訴你 長度 是 7，或者更準確地說，是 7 個 UTF-16 編碼單元。這種差異會產生各種各樣的後果，因為許多文字操作任務都涉及到使用 String API 的字元索引。例如，”Hello👋”[5] 不會返回 👋 表情符號。相反，它會返回一個表示表情符號第一個編碼單元的錯誤字元。

好消息是，Dart 有一個名為 characters 的新套件，它操作使用者可感知的字元，而不是 UTF-16 編碼單元。但是，作為 Dart 程式設計師，您需要知道何時使用 characters 套件。我們的研究表明，即使是經驗豐富的 Dart 程式設計師在閱讀文字操作程式碼時也很容易忽略此類問題。在本文中，我將介紹一些常見的場景，在這些場景中您需要注意並考慮使用 characters 套件而不是 Dart String。

需要注意的場景

在本節中，我將介紹一些常見的文字操作場景，解釋為什麼在這些場景中使用 Dart 的 String API 可能會導致問題，並展示如何使用 characters 套件獲得更可靠的結果。以下用例通常假設我們正在處理人類使用者輸入的字串，其中可能包含表情符號或應用程式開發人員未預期的語言的字元。

場景 1：計算字串中的字元數

假設您正在撰寫一個函數，用於檢查使用者輸入的文字是否超過了特定數量的字元。如果未達到限制，則該函數返回剩餘字元的正數；如果超過了限制，則返回額外字元的負數。

使用 String API 執行此操作非常簡單：

1
2
3

int remainingCharacters(String text, int limit) {
  return limit - text.length;
}

但是，以下測試揭示了此程式碼的問題：

1
2
3

test('remainingCharacters emoji', () {
  expect(remainingCharacters('How are you doing today 😀', 50), 47);
});

以下是測試結果：

1
2

Expected: <47>
  Actual: <46>

我們可以使用 characters 套件重寫此函數，該套件在 String 上提供了一個方便的擴展方法，以產生正確的字元數，如下所示：

1
2
3

int remainingCharacters(String text, int limit) {
  return limit - text.characters.length;
}

場景 2：擷取子字串

在此場景中，我們想要實作一個函數，該函數從字串中刪除最後一個字元並將結果作為新字串返回。讓我們假設此字串來自使用者輸入。

使用 String 上的 substring 方法可以輕鬆實作此函數，如下所示：

1
2
3

String deleteLastCharacter(String text) {
  return text.substring(0, text.length - 1);
}

但是，一個好的表情符號測試可以快速破壞程式碼：

1
2
3

test('deleteLastCharacter emoji', () {
  expect(deleteLastCharacter('Hi 🇩🇪'), 'Hi ');
});

以下是測試結果：

1
2
3

Expected: ‘Hi ’
  Actual: ‘Hi 🇩???’
    Which: is different. Both strings start the same, but the actual value also has the following trailing characters: 🇩???

characters 套件可以輕鬆處理這種情況，因為它提供了高階方法，例如 skipLast(int count)。我們可以將此程式碼片段重寫為以下程式碼：

1
2
3
4

String deleteLastCharacter(String text) {
  return text.characters.skipLast(1).toString();
}

場景 3：根據表情符號分割字串

在第三個場景中，我們想要根據給定的表情符號分割字串。以下是一個使用 String 上的 split 方法執行此操作的函數：

1
2
3

List<String> splitString(String text, String emoji) {
  return text.split(emoji);
}

它會起作用嗎？它可能在 99% 的情況下都能正常工作，但以下測試說明了一個例子，其中上面的程式碼產生了相當令人驚訝的結果。

1
2
3

test('splitString emoji', () {
  expect(splitString('abc👨‍👩‍👧‍👦abc abc abc', '👨‍👩‍👧‍👦'), ['abc', 'abc', 'abc', 'abc']);
});

以下是測試結果：

1
2
3

Expected: ['abc👨‍👩‍👧‍👦', 'abc', 'abc', 'abc']
  Actual: ['abc👨‍👩‍', '‍👦', 'abc', 'abc', 'abc']
    Which: was 'abc👨‍👩‍' instead of 'abc👨‍👩‍👧‍👦' at location [0]

那麼，為什麼當字串被分割時，👨‍👩‍👧‍👦 變成了兩個表情符號 👨‍👩？這是因為 👨‍👩‍👧‍👦 實際上由四個不同的表情符號組成：👨👩👧👦。當字串在 👧 上被分割時，“abc👨‍👩‍👧‍👦” 被分成了兩部分：“abc👨‍👩” 和 “‍👦”。

您可以透過使用 Characters 類別上的 split 方法來避免此問題，如下列程式碼所示：

1
2
3

List<String> splitString(String text, String emoji) {
  return text.characters.split(emoji.characters).map((e) => e.toString()).toList();
}

場景 4：根據索引存取特定字元

在文字操作中，通常根據字串中的索引（即位置）存取特定字元。例如，以下程式碼片段顯示了一個函數，該函數從使用者在兩個單獨的文字欄位中輸入的名和姓中返回首字母縮寫：

1
2
3

String getInitials(String firstName, String lastName) {
  return firstName[0] + lastName[0];
}

但是，正如我們在本文開頭所演示的那樣，在基於 UTF-16 的字串中使用索引可能會有風險。讓我們用以下測試案例驗證上述程式碼的正確性：

1
2
3

test('getInitials accent', () {
  expect(getInitials('Élise', 'Boisson'), 'ÉB');
});

以下是測試結果：

1
2
3

Expected: ‘ÉB’
  Actual: ‘EB’
    Which: is different.

為什麼測試失敗了？這是因為字母 “É” 可能是 “E” 和重音符號的組合。您可以使用 characters 套件輕鬆避免此問題：

1
2
3

String getInitials(String firstName, String lastName) {
  return firstName.characters.first.toString() + lastName.characters.first.toString();
}

練習：省略文字溢位

現在，這是一個挑戰。在此場景中，應用程式需要顯示訊息列表，每行顯示一條訊息。要求您檢查實作一個函數的程式碼，該函數在訊息長度超過給定字元限制時將文字溢位顯示為省略號。

1
2
3
4
5
6

String omitTextOverflow(String text, int limit) {
  if (text.length <= limit) {
    return text;
  }
  return text.substring(0, limit - 3) + '...';
}

您能否提出一個測試來揭示此程式碼片段的潛在問題？您將如何使用 characters 套件重寫它？答案在本文末尾。

緩解措施和可能的長期解決方案

期望 Dart 使用者對上述陷阱保持高度警惕是不合理的。例如，在我們進行的一項實驗中，53.7% 的 Dart 使用者無法檢測到第一個場景（計算字元數）中說明的問題，即使他們在幾分鐘前收到了兩頁關於 characters 套件以及該套件旨在解決的問題的資訊。因此，我們正在採取兩階段方法來幫助開發人員為他們的文字操作需求選擇最合適的 API。

短期內，我們將在 Flutter 框架和 Dart 分析器中引入一組緩解措施，以使 characters 套件更容易在 Dart UI 程式設計中發現和調用。這涉及幾個步驟：

1. 在 TextField Widget 的內部實作中使用 characters 套件。有關更多詳細資訊，請參閱 此 PR 和 此設計文件。
2. 透過 Flutter 框架公開 characters 套件的 API。完成此操作後，Flutter 使用者將更有可能透過擴展方法 String.characters 發現 API，該方法將在對 String 執行自動完成時顯示。此工作的狀態在此議題中追蹤：https://github.com/flutter/flutter/issues/55593。
3. 更新 Flutter 框架的 API 文件和範例程式碼，以建議在適用時使用 Characters 類別，例如在 TextField.onChanged 的回調中。此工作在 https://github.com/flutter/flutter/issues/55598 中追蹤，相關詳細資訊在 此文件 中。
4. 讓 Dart 分析器在自動完成用於處理使用者輸入文字的回調模板時建議將 String 物件轉換為 Characters 物件。例如，在使用者在 onChanged 上自動完成後，IDE 可以填寫以下程式碼片段中的所有內容。此工作在 https://github.com/dart-lang/sdk/issues/41677 中追蹤。

1
2
3
4
5
6
7

TextField(
onChanged: (text) {
    final characters = text.characters;
    // …
},
);

這些緩解措施可以提供幫助，但它們僅限於在 Flutter 專案上下文中執行的字串操作。我們需要在它們可用後仔細衡量它們的有效性。Dart 語言層面更完整的解決方案可能需要遷移至少一些現有程式碼，儘管一些選項（例如，靜態擴展類型）可能會使重大變更易於管理。需要更多技術調查才能完全了解權衡取捨。

如何提供幫助

請幫助我們提高對如何使用 characters 套件修復字串問題的認識：

• 在您自己的程式碼中尋找使用 String.length 或 String.substring 的實例。如果字串可能源自使用者輸入，請嘗試使用 characters 套件重寫程式碼。
• 與 Dart 社群中的其他人分享這篇文章。
• 嘗試更新 StackOverflow 上關於 Dart 文字操作的 現有答案。如果已接受的答案忽略了 String API 的此限制，請提醒人們注意風險。
• 對上面列出的 GitHub 議題發表評論，讓我們知道您的想法和意見。

現在，祝您編碼愉快 😉！

致謝

感謝 Kathy Walrath、Lasse Nielsen 和 Michael Thomson 審閱本文。我還要感謝參與我們使用者研究的開發人員。他們的參與幫助 Dart 和 Flutter 團隊更好地了解了處理 Dart String API 此限制的挑戰。

PS：以下是練習的解決方案：

1
2
3
4
5
6
7
8
9
10

String omitTextOverflow(String text, int limit) {
  if (text.characters.length <= limit) {
    return text;
  }
  return text.characters.take(limit - 3).toString() + '...';
}

test("omitTextOverflow doesn't break emoji", () {
    expect(omitTextOverflow("How are you doing today 😀", 20), "How are you doing...");
});

正確操作 Dart 字串 👉 最初發佈在 Dart 上的 Medium，人們在那裡透過突出顯示和回應這個故事來繼續討論。

【文章內容使用 Gemini 1.5 Pro 自動產生】

Flutter 釋出了網頁支援，允許您建立動態網站。Flutter 支援處理任何可能來自網頁使用的錯誤，例如 404 錯誤。但是，如何為您的 Flutter 應用程式製作自訂 404 頁面呢？

本文將說明如何建立在使用者導航到不存在的頁面時顯示的自訂頁面。

如何在 Flutter 中將客戶端重新導向到自訂 404 頁面

在瀏覽網際網路時，每個人都遇到過「404：頁面未找到錯誤」。Flutter 透過自動將您重新導向到初始路徑來處理此問題。這通常是您應用程式的首頁。但是，如果您想要像 [AirBnb](https://36bvmt283fg61unuud3h7qua-wpengine.netdna-ssl.com/wp-content/uploads/2013/03/airbnb-404.gif)、[GitHub](https://mamchenkov.net/wordpress/wp-content/uploads/2013/11/github-404.png) 甚至 [Flutter 網站](https://flutter.dev/foo) 那樣擁有華麗的 404 頁面該怎麼辦？您可以使用 Flutter 很輕鬆地做到這一點。

若要建立自訂 404 頁面，您的應用程式需要使用 MaterialApp、CupertinoApp 或 WidgetsApp Widget。大多數應用程式使用這三個 Widget 之一；它是在建立 Flutter 應用程式時呼叫的第一個 Widget。

MaterialApp 會將頂層 Navigator 組態設定為按以下順序搜尋路徑：

1. 對於 `/` 路徑，如果非空，則使用 [home](https://api.flutter.dev/flutter/material/MaterialApp/home.html) 屬性。
2. 否則，如果它包含該路徑的條目，則使用 [routes](https://api.flutter.dev/flutter/material/MaterialApp/routes.html) 表格。
3. 否則，如果提供，則呼叫 [onGenerateRoute](https://api.flutter.dev/flutter/material/MaterialApp/onGenerateRoute.html)。它應該為任何有效的路徑返回一個非空值，這些路徑未由 [home](https://api.flutter.dev/flutter/material/MaterialApp/home.html) 和 [routes](https://api.flutter.dev/flutter/material/MaterialApp/routes.html) 處理。
4. 最後，如果所有其他方法都失敗了，則呼叫 [onUnknownRoute](https://api.flutter.dev/flutter/material/MaterialApp/onUnknownRoute.html)。

如果您的路徑在這些表格中都沒有處理，則它使用 [onUnknownRoute](https://api.flutter.dev/flutter/material/MaterialApp/onUnknownRoute.html) 屬性來處理您的導航。此回呼通常用於錯誤處理。例如，此函數可能會始終產生一個「未找到」頁面，描述未找到的路徑。位置不明的路徑可能是由於應用程式中的錯誤或從 Android 意圖等外部請求推送路徑造成的。

以下範例程式碼演示如何為 onUnknownRoute 屬性定義一個匿名函數，該函數使用 RouteFactory，RouteFactory 是一個工廠方法，它以 RouteSettings 函數作為輸入，並返回一個 Route。以下程式碼片段顯示定義 onUnknownRoute 屬性可以多麼簡單：

1
2
3

onUnknownRoute: (settings) {
  return MaterialPageRoute(builder: (_) => PageNotFound());
},

PageNotFound 是一個自訂 Widget，用於建立 404 頁面。此頁面可能會說明發生了什麼情況，並將使用者重新導向到首頁，但在建立 404 頁面時，您可以隨心所欲。

結束語

在建立 Flutter 應用程式時，重要的是要處理任何可能發生的問題。在 MaterialApp、CupertinoApp 或 WidgetApp 中使用 onUnknownRoute 屬性，可以讓您處理網站中不可避免的「頁面未找到」錯誤。

若要進一步了解 Flutter 中的路徑，請參閱 Medium 文章 [「使用命名路徑導航 URL 」](https://medium.com/flutter/flutter-web-navigating-urls-using-named-routes-307e1b1e2050)。

關於作者：Jose 最近從大學畢業，現在在 [Material](https://material.io) 工作，Material 是一個設計系統，幫助團隊建立高品質的數位體驗。Jose 的團隊維護 Flutter 的 [material 函式庫](https://api.flutter.dev/flutter/material/material-library.html)。若要進一步了解，請訪問 Jose 在 [GitHub](https://github.com/JoseAlba)、[LinkedIn](https://www.linkedin.com/in/josealba1996/)、[YouTube](https://www.youtube.com/channel/UCOdKA_On0oPe1tz02z1QfxA?view_as=subscriber) 和 [Instagram](https://www.instagram.com/jose.alba/) 上的頁面。

處理 Flutter 中的 404：頁面未找到錯誤 最初發佈在 Flutter 上的 Medium，人們在那裡透過突出顯示和回應這個故事來繼續討論。