【文章翻譯】Dart extension method fundamentals

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

Dart 擴展方法基礎

在未來的版本中,Dart 語言將添加一個新功能,擴展方法,它允許您(假裝)向現有類型添加新成員。即使它實際上只是一個靜態函數,擴展方法也可以像普通方法一樣被調用,例如 o.extensionMethod(42)

為什麼我們要添加擴展方法?它們有什麼用?您如何使用它們?為什麼我稱它們為「擴展方法」,而您也可以添加其他成員?(最後一個很簡單:我個人認為它們是擴展成員,但「擴展方法」是工作標題,而且它與其他語言中的類似功能的名稱相同,因此秉承 Dart 的良好傳統,我們選擇了熟悉且不出所料的名稱。在這裡我不會用到擴展 getter、setter 或運算子,但如果您願意,您可以完全向 String 添加一個 % 運算子,無論我們怎麼稱呼這個功能。)

由於我是設計此功能的人員之一,因此我將抓住機會在其他人有機會之前回答所有這些問題。(而且,因為我在完成此功能之前發佈了這篇文章,所以我甚至可以編輯掉那些不再正確的東西!)

但首先,我們要繞個彎路!

在擴展方法之前我會做什麼

假設,純粹假設,我認為 Future 上的 catchError 函數很糟糕,應該用更新、更閃亮、更好的東西來代替。例如,因為它將 Function 作為參數而不是適當的函數類型,這是出於完全合理的歷史原因,這意味著您不會獲得任何靜態類型檢查。這很糟糕,而且這個方法應該讓人感覺很糟糕。

顯然我不能移除這個函數,這會破壞幾乎所有曾經出現過的 Dart 程式。

那麼我至少想向 Future<T> 添加一個新方法,以便使用者可以使用它來代替,例如:

1
2
3
4
extension MyFuture<T> on Future<T> {
Future<T> onError(void Function(Object, StackTrace) onError) =>
catchError(onError);
}

您可以這樣調用它:

1
eventualInteger.onError((e, s) { ... });

遺憾的是,我不能直接將其添加到 Future 類中。如果我這樣做,我也會將其添加到 Future 介面中,而任何其他實作該介面的類將不完整,並且將無法再編譯。在某個時候,我們計算了 76 個實作 Future 的類別。那是一段時間以前的事了,我們已經停止計算了。我們仍然不能讓所有人失望,因此這個選項也不在考慮範圍內。

那麼,我會使用一個靜態輔助函數:

1
2
3
Future<T> onError<T>(Future<T> future, 
void Function(Object, StackTrace) onError) =>
future.catchError(onError);

您可以這樣調用它:

1
onError(eventualInteger, (e, s) { ... });

同樣遺憾的是,這讀起來不太好。我們喜歡使用基於 . 的方法鏈,因為它允許我們從左到右閱讀:「執行此操作,然後執行該操作,然後執行更多操作」。使用靜態輔助函數會迫使我們將其讀作:「對以下內容執行該操作:執行此操作。之後,執行更多操作」… 什麼?它沒有相同的流程,相同的schwung。在實踐中,它幾乎是不可讀的。

好吧,我沒有被嚇倒,所以我沒有改進 Future 類別,而是引入了一個新的改進的介面,並為使用者提供了一種包裝舊介面的方法:

1
2
3
4
5
6
7
8
class MyFuture<T> {
final Future<T> _wrappee;
MyFuture(this._wrappee);
// ...
MyFuture<T> onError(void Function(Object, StackTrace) onError) =>
MyFuture(_wrappee.catchError(onError));
// ... other forwarding methods
}

您可以這樣使用它:

1
MyFuture(eventualInteger).onError((e, s) { ... });

我甚至可能會讓 MyFuture 實作 Future 並將所有 Future 成員轉發到 _wrappee future,然後讓所有方法再次返回 MyFuture 包裝器,這樣我就可以繼續下去了。

如果我這麼說的話,那就太好了!

在擴展方法出現之前,這幾乎是最好的方法…這意味著手動添加包裝器,並承擔額外的包裝器物件和中間轉發函數帶來的效能損失。

我將如何使用擴展方法

一旦我們擺脫了沒有擴展的黑暗時代,我就可以使用擴展方法來獲得我真正想要的東西。我會這樣寫:

1
2
3
4
extension MyFuture<T> on Future<T> {
Future<T> onError(void Function(Object, StackTrace) onError) =>
this.catchError(onError);
}

然後您可以這樣調用它:

1
eventualInteger.onError((e, s) { ... });

就這樣。任務在五行內完成!

「但它是如何運作的?」,您可能會問。它運行得非常好,謝謝。

事實上,它的行為與包裝器類別幾乎完全相同,即使它實際上只是一個靜態輔助函數。您甚至可以顯式地寫 MyFuture(eventualInteger).onError(...),就好像擴展是一個包裝器類別一樣。它不是,但它看起來和行為幾乎就像它是。而且您可以省略顯式包裝,並在類型正確時隱式地應用它。

它(不是)一個包裝器類別

擴展聲明的設計故意使其看起來像一個類別或混入聲明,並且它的行為就像一個帶有隱藏 _wrappee 的包裝器類別一樣。您甚至可以在聲明中使用靜態成員,它們就像類別或混入聲明中的靜態成員一樣工作。

與包裝器類別相比,有一個改進:您可以在實例成員內部編寫 this 來引用 _wrappee 而不是包裝器物件。

更改 this 的含義不僅僅是一個改進。這些是靜態擴展方法,正如我之前所說的,它們只是一種更方便的調用靜態函數的方式。這意味著沒有包裝器物件。它從未存在過,我們只是假裝它存在,但這意味著我們不能讓 this 引用不存在的物件。

我們也不允許您將 MyFuture(eventualInteger) 作為一個值使用,因此如果您嘗試執行 var myFuture = MyFuture(eventualInteger),我們將不允許。使用 MyFuture(eventualInteger) 的唯一方法是作為擴展成員調用的目標。

1
2
MyFuture(eventualInteger).onError(...); // 良好:用於調用方法。
var x = MyFuture(eventualInteger); // 錯誤:用作獨立值。

這與您可以使用 super 來調用方法,但不能用於其值的方式相同。或者就像一個函式庫前綴。您所能做的就是存取一個成員;您不能將其視為一個值,因為它沒有值,也沒有值可以供它使用。

因為沒有物件,所以您不能在擴展聲明中聲明實例欄位。但是,您可以聲明 getter 和 setter,甚至可以透過 Expando 支援它們。擴展也不能聲明任何構造函數,因為沒有任何東西被構造;它只是假裝有一個構造函數接受 wrappee 物件。

它(不)擴展類型

如果您每次使用擴展成員時都必須編寫 MyFuture(...) 包裝器,那麼這將不是一個很大的改進。我們可以直接編寫包裝器類別,並花費一些編譯器工程師的時間來確保我們優化掉中間物件。

我在上面說過,您可以編寫 eventualInteger.onError(...)。這是可行的,因為我們會根據表達式的靜態類型和它們所調用成員的名稱隱式地包裝表達式。當以下所有條件都為真時,我們會自動將 expr.method() 包裝為 Ext(expr).method()

  • expr 的靜態類型沒有名稱為 method 的成員(介面始終獲勝)。
  • 擴展 Ext 已導入或在當前函式庫範圍內聲明(擴展是可存取的)。
  • 擴展聲明了一個名稱為 method 的成員,並且 expr 的靜態類型是 Ext 聲明的 on 類型的子類型(擴展是適用的)。

如果成員調用有多個可存取且適用的擴展,則有一些規則可以決定哪個擴展將在衝突中獲勝。在某些情況下,沒有辦法選擇獲勝者,那麼它只是一個編譯時錯誤。這些規則僅取決於擴展聲明的 on 類型,而不是成員聲明。(Dart 沒有「重載」——多個具有相同名稱和不同簽名的方法,您可以根據參數結構或類型在它們之間進行選擇——而擴展方法不提供後門來獲得重載。)

這一切都是靜態的

我在上面說了「靜態擴展方法」,我這樣做是有原因的!

Dart 是靜態類型的。編譯器在編譯時知道每個表達式的類型,因此如果您編寫 target.member(42),並且 member 是一個擴展成員,則編譯器需要弄清楚要隱式地將 target 包裝成哪個擴展,以便找到整個成員調用的類型。

如果隱式擴展包裝必須在找到目標表達式的類型找到成員調用的類型之間發生,那麼很明顯,「擴展推斷」必須在越來越不準確地命名為「類型推斷」的階段中發生。這個階段主要以填補缺少的泛型而聞名。

我的確寫了 eventualInteger.onError((FormatException e, s) {...}),即使 MyFuture 擴展和 onError 方法都是泛型的。在進行類型推斷時,Dart 編譯器既選擇擴展,也推斷缺少的類型參數。在這裡,它首先決定使用 MyFuture 擴展,然後插入隱式包裝器,最後對擴展應用 MyFuture(eventualInteger).onError((FormatException e, s) {...}) 執行類型推斷,其方式與對應的包裝器類別完全相同

1
2
3
4
5
6
7
8
class MyFuture<T> {
final Future<T> _wrappee;
MyFuture(this._wrappee);
Future<T> onError(void Function(Object, StackTrace) onError) =>
_wrappee.catchError(onError);
}

MyFuture(eventualInteger).onError((FormatException e, s) { ... });

在這種情況下,類型推斷將推斷以下擴展應用,並完成調用的完整類型:

1
2
MyFuture<int>(eventualInteger).onError<int>((FormatException e, s) {...});

這意味著擴展的類型參數基於被包裝表達式的靜態類型。如果您有 Future<num> fut = Future<int>.value(42);,則 fut.onError(...) 將在編譯時將 MyFutureT 類型參數綁定到 num,而不是綁定到 int。這一切都是靜態的,就像任何其他推斷的類型參數一樣。

這也意味著您將永遠無法在類型為 dynamic 的目標上調用擴展成員。

衝突解決

如上所述,當範圍內有多個適用的擴展時,有一些規則可以決定哪個擴展將獲勝。基本上,獲勝者是 on 類型最接近您正在調用成員的表達式的實際類型的擴展,有一些注意事項和決勝局。對於一起編寫的擴展,它通常「可以正常工作」。我不會詳細介紹這些細節,而是告訴您當它不能正常工作時該怎麼辦。

當兩個不同的作者為相同的類型和成員名稱編寫了衝突的擴展時,您可能會遇到問題。假設擴展 Ext1Ext2 都定義了一個適用於您的 List 物件的 bubbleSort 方法,並且衝突沒有明確的獲勝者,或者獲勝的不是您實際想要調用的那個(例如 Ext2 獲勝,而您想要調用 Ext1.bubbleSort)。那麼您必須做點什麼

最簡單的解決方案是使用顯式擴展應用:Ext1(list).bubbleSort()。這樣可以避免自動解析,只選擇您想要的那個。如果您只有少數幾個衝突,那麼這既簡單又可讀。

但是,如果您在同一個檔案中有三百個衝突,那麼您可能希望避免額外的輸入。很難更改擴展是否適用於調用,但您可以更改它是否可存取

您可以透過在導入衝突擴展(或擴展,如果您真的運氣不好)時隱藏它來做到這一點:import "ext2lib.dart" hide Ext2;。這樣做將阻止 Ext2 擴展被導入到當前的函式庫範圍內,從而使其無法存取。顯然,完全不導入 ext2lib.dart 也會這樣做,但除非擴展是您從該函式庫中使用的唯一東西,否則這是不切實際的。

(12 月 11 日編輯)在這裡我曾經說過,您可以使用前綴導入其中一個衝突的擴展,然後它將無法隱式使用。事實證明,有些人會在與他們擴展的類別相同的函式庫中聲明擴展方法,如果在使用前綴導入該函式庫時它無法工作,那就真的很煩人。所以我們修復了這個問題。使用前綴導入的擴展可以隱式地工作。如果您真的需要在同一個函式庫中使用兩個衝突的擴展,則必須在每個存在衝突的地方使用顯式擴展應用。我們可能會考慮在未來添加一種不同的方法來禁用隱式擴展,至少如果衝突的擴展成為一個反復出現的問題的話。

總結

Dart 將在即將發佈的版本中獲得擴展方法——一種調用靜態函數的漂亮方法。

您可以為實例方法運算子settergetter 定義擴展成員,但不能定義欄位

您可以顯式地調用擴展方法,或者在沒有與介面成員或其他擴展衝突時隱式地調用:

1
2
Ext1(list).bubbleSort() // 顯式,就像它是一個包裝器類別一樣。
list.bubbleSort() // 隱式,就像它擴展了類型一樣。

隱式調用與顯式調用的工作方式相同,但它們首先推斷正在應用哪個擴展。如果由於衝突的擴展而導致擴展推斷失敗,則您可以執行以下任一操作:

  • 顯式地應用擴展。
  • 完全不導入衝突的擴展(移除導入或隱藏擴展)。
  • (12 月 11 日編輯):就這樣(目前)。

擴展是靜態的。關於它們的一切都是基於靜態類型決定的。

負責任地享受!


Dart 擴展方法基礎 最初發佈在 Dart 上的 Medium,人們在那裡透過突出顯示和回應這個故事來繼續討論。

【文章翻譯】Announcing verified publishers on pub.dev

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

Pub.dev 正式推出驗證發佈者

今天,我們宣布在 pub.dev(Dart 套件庫)上推出一項新功能:驗證發佈者。當您使用 具有驗證發佈者的套件時,您可以確定發佈者就是他們聲稱的身份。當您以驗證發佈者的身份發佈 套件時,您將獲得更輕鬆的套件管理的額外好處。

提升套件使用者的信任度

使用 Flutter 建構應用程式的應用程式開發人員告訴我們,擁有豐富的高品質套件選擇對他們的生產力至關重要,這使他們能夠重複使用常見的組件並存取熱門的 SDK 和函式庫。我們看到 pub.dev 生態系統的巨大增長,在過去一年中發佈了數千個套件,並且每個月都有數十萬開發人員使用 pub.dev 瀏覽和搜尋新的套件內容。

我們從套件使用者那裡聽到的最重要的選擇標準之一是誰發佈了套件。驗證發佈者透過驗證發佈者的身份,並在套件搜尋結果和套件詳細資訊頁面中清楚地列出發佈者身份(請注意下方螢幕截圖中 dart.dev 旁邊的藍色徽章),增強了這個訊號。

套件搜尋結果顯示由已驗證發佈者發佈的套件
套件詳細資訊頁面顯示由已驗證發佈者發佈的套件

當您點擊發佈者時,您可以看到更多詳細資訊,包括發佈者的聯絡電子郵件、發佈者首頁的連結,以及發佈者的簡短描述。發佈者描述由發佈者提供,提供了一個小的品牌推廣機會。

您還可以查看該發佈者發佈的所有套件的列表。以下是新的 dart.dev 發佈者 的範例。

發佈者的套件列表樣本

發佈者驗證流程

在設計驗證流程時,我們希望建立一個值得信賴、成本低廉且任何有興趣成為驗證發佈者的人都可以使用的機制。我們也希望這個流程是自動化的,這樣帳戶就可以立即建立。

在審查了幾種替代方案之後,我們決定將驗證建立在 DNS(網域名稱系統)二級網域的基礎上。我們選擇 DNS 是因為我們相信大多數套件發佈者已經擁有一個網域和一個位於該網域的首頁。在 建立發佈者的過程中,pub.dev 會根據 Google Search Console 中的現有邏輯,驗證建立驗證發佈者的使用者是否具有對相關網域的管理員存取權限。

改進的套件管理

除了驗證發佈者身份的明顯好處之外,驗證發佈者功能還提供了管理上的好處。以前,如果您發佈許多套件,存取權管理是一項繁瑣的、逐個套件的工作,這會佔用您原本可以花在改進套件上的時間。有了驗證的發佈者,您可以為您的發佈者帳戶設定一個管理員團隊,所有團隊成員都可以發佈對發佈者擁有的所有套件的更新。

我們還加入了一些新的自我管理選項,包括將現有套件移動到發佈者帳戶(如下所示)或將套件標記為 已停止

轉移現有套件

將現有套件轉移到已驗證的發佈者很容易。只需 建立一個已驗證的發佈者,並對現有套件使用 轉移功能。每個套件的這個簡單過程只需幾分鐘。

Pub.dev 路線圖

我們正在討論 pub.dev 的許多未來改進。以下是一些想法:

  • 支援特定平台(例如,Android 或 Web;#187)的套件的搜尋支援,包括更好地理解 Dart Web 與 Flutter Web 套件
  • 套件的標籤或類別 (#367)
  • 對高品質套件進行投票或點讚 (#798)
  • 舉報可疑內容的明確政策和流程 (#1570)

如果您對某個特定想法感興趣,我們鼓勵您查看 pub.dev 議題追蹤器,以確保該想法已被追蹤,並透過對議題最上面的評論加入豎起大拇指的反應來表示您的興趣。

後續步驟

如果您是套件發佈者,我們鼓勵您盡快將您的套件轉移到已驗證的發佈者帳戶,以便為您自己和您的套件使用者獲得上述好處。我們已經轉移了許多最受歡迎的 dart.dev 套件,並預計很快會轉移更多套件。

目前就這些。我們期待在 pub.dev 上看到更多高品質的套件!


宣布 pub.dev 上的驗證發佈者 最初發佈於 Medium 上的 Dart,人們在那裡透過醒目顯示和回應這個故事來繼續對話。

【文章翻譯】Dart asynchronous programming: Futures

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

Dart 非同步程式設計:Futures

許多非同步 Dart API 會返回 futures。

Dart 用於非同步程式設計的最基本 API 之一是 futures——Future 類型的物件。在大多數情況下,Dart 的 futures 與其他語言中的 futurepromise API 非常相似。

本文討論 Dart futures 背後的概念,並告訴您如何使用 Future API。它還討論了 Flutter FutureBuilder widget,它可以根據 future 的狀態,幫助您非同步更新 Flutter UI。

由於 Dart 語言功能(例如 async-await),您可能永遠不需要直接使用 Future API。但是您幾乎肯定會在 Dart 程式碼中遇到 futures。而且您可能想要 建立 futures 或 讀取 使用 Future API 的程式碼。

本文是基於 Flutter in Focus 影片系列 Dart 中的非同步程式設計 的第二篇文章。第一篇文章,隔離區和事件迴圈,涵蓋了 Dart 支援背景工作的基礎。

如果您喜歡透過觀看或聆聽來學習,本文中的所有內容都包含在以下影片中。

您可以將 futures 想像成資料的小禮盒。有人遞給您其中一個禮盒,一開始是關閉的。過了一會兒,盒子彈開了,裡面要麼是一個值,要麼是一個錯誤。

因此,future 可以處於以下三種狀態之一:

  1. 未完成: 禮盒是 關閉的
  2. 已完成並帶有值: 禮盒是打開的,您的禮物(資料)已 準備好
  3. 已完成並帶有錯誤: 禮盒是打開的,但 出現了問題

您即將看到的大部分程式碼都圍繞著處理這三種狀態。您收到一個 future,您需要決定在盒子打開之前做什麼,在盒子打開並帶有值時做什麼,以及如果出現錯誤時做什麼。您會經常看到這種 1-2-3 模式。

future 的 3 種狀態

您可能還記得我們關於 Dart 事件迴圈 的文章中的事件迴圈(如下圖所示)。關於 futures,需要了解的一件好事是,它們實際上只是一個 API,旨在使事件迴圈的使用更容易。

Dart 事件迴圈一次處理一個事件。

您編寫的 Dart 程式碼由單個執行緒執行。在您的應用程式執行的整個過程中,那個小小的執行緒一直不斷地循環,從事件佇列中提取事件並處理它們。

假設您有一些下載按鈕的程式碼(如下所示,實現為 RaisedButton)。使用者點擊,您的按鈕開始下載圖片。

首先發生點擊事件。事件迴圈獲取事件,並調用您的點擊處理程式(您使用 onPressed 參數設定給 RaisedButton 建構函式)。您的處理程式使用 http 函式庫發出請求 (http.get()),並返回一個 future (myFuture)。

因此,現在您有了您的小盒子 myFuture。它一開始是關閉的。要註冊一個回呼函式,以便在它打開時執行,您可以使用 then()

一旦您有了您的禮盒,您就等待。也許其他事件進來了,使用者做了一些事情,而您的小盒子就放在那裡,而事件迴圈繼續循環。

最終,圖片的資料被下載,http 函式庫說:「太好了!我這裡有這個 future。」它將資料放入盒子中並彈開它,這將觸發您的回呼函式。

現在,您傳遞給 then() 的那小段程式碼執行了,它顯示了圖像。

在整個過程中,您的程式碼從未需要直接接觸事件迴圈。其他正在發生的事情,或者其他進來的事件都無關緊要。您需要做的就是從 http 函式庫獲取 future,然後說明 future 完成後要做什麼。

在實際程式碼中,您還需要處理錯誤。我們稍後會向您展示如何做到這一點。

讓我們仔細看看 Future API,其中一些您剛剛在使用中看到了。

好的,第一個問題:您如何獲得 Future 的實例?在大多數情況下,您不會直接建立 futures。這是因為許多常見的非同步程式設計任務已經有為您產生 futures 的函式庫。

例如,網路通訊返回一個 future:

1
final myFuture = http.get('http://example.com');

存取共享偏好設定也會返回一個 future:

1
final myFuture = SharedPreferences.getInstance();

但是您也可以使用 Future 建構函式來建立 futures。

Future 建構函式

最簡單的建構函式是 Future(),它接受一個函式並返回一個與函式返回類型匹配的 future。稍後,函式會非同步運行,future 會以函式的返回值完成。以下是如何使用 Future() 的示例:

讓我們添加一些列印語句以使非同步部分更清楚:

如果您在 DartPad (dartpad.dev) 中運行該程式碼,則整個 main 函式會在傳遞給 Future() 建構函式的函式之前完成。這是因為 Future() 建構函式一開始只返回一個未完成的 future。它說:「這是這個盒子。您先拿著它,稍後我會去運行您的函式,並在其中放入一些資料。」以下是上述程式碼的輸出:

1
2
Done with main().
Creating the future.

另一個建構函式 Future.value() 在您已經知道 future 的值時很方便。當您構建使用快取的服務時,此建構函式非常有用。有時您已經擁有所需的值,因此您可以將其放入其中:

1
final myFuture = Future.value(12);

Future.value() 建構函式有一個用於完成並帶有錯誤的對應項。它被稱為 Future.error(),它的工作原理基本相同,但接受一個錯誤物件和一個可選的堆疊追蹤:

1
final myFuture = Future.error(ArgumentError.notNull('input'));

最方便的 future 建構函式可能是 Future.delayed()。它的工作原理與 Future() 類似,只是它會在運行函式和完成 future 之前等待指定的時長。

使用 Future.delayed() 的一種方法是當您為測試建立模擬網路服務時。如果您需要確保您的載入微調器正確顯示,則延遲的 future 是您的朋友。

使用 futures

現在您知道了 futures 的來源,讓我們來談談如何使用它們。正如我們前面提到的,使用 future 主要與處理它的三種狀態有關:未完成,已完成並帶有值,或已完成並帶有錯誤。

以下程式碼使用 Future.delayed() 建立一個 future,該 future 在 3 秒後完成,值為 100。

當此程式碼執行時,main() 從上到下運行,建立 future 並列印「Waiting for a value…」。在整個過程中,future 都是未完成的。它在 3 秒後才會完成。

使用 完成的值,您可以使用 then()。這是每個 future 上的一個實例方法,您可以使用它來註冊一個回呼函式,以便在 future 完成並帶有值時執行。您給它一個接受單個參數的函式,該參數與 future 的類型匹配。一旦 future 完成並帶有值,您的函式將使用該值被調用。

以下是上述程式碼的輸出:

1
2
Waiting for a value... _(3 秒後回呼函式執行)_
The value is 100.

除了執行您的程式碼外,then() 還會返回一個它自己的 future,與您傳遞給它的任何函式的返回值匹配。因此,如果您需要進行幾次非同步調用,即使它們的返回類型不同,您也可以將它們鏈接在一起。

回到我們的第一個示例,如果初始 future 沒有完成並帶有值 - 如果它完成並帶有錯誤會發生什麼?then() 方法需要一個值。您需要一種方法來註冊另一個回呼函式以防出現錯誤。

答案是使用 catchError()。它的工作原理與 then() 類似,只是它接受一個錯誤而不是一個值,並且如果 future 完成並帶有錯誤,它就會執行。就像 then() 一樣,catchError() 方法也返回它自己的 future,因此您可以構建一個由 then()catchError() 方法組成的完整鏈,它們彼此等待。

注意:如果您使用 async-await 語言功能,則無需調用 then()catchError()。相反,您 await 完成的值,並使用 try-catch-finally 來處理錯誤。有關詳細資訊,請參閱 Dart 語言導覽的 非同步支援 部分。

以下是如何使用 catchError() 來處理 future 完成並帶有錯誤的情況的示例:

您甚至可以給 catchError() 一個測試函式來檢查錯誤,然後再調用回呼函式。您可以透過這種方式擁有多個 catchError() 函式,每個函式檢查不同類型的錯誤。以下是如何使用 catchError() 的可選 test 參數指定測試函式的示例:

現在您已經了解到這裡,希望您可以看到 future 的三種狀態通常如何反映在程式碼的結構中。上例中有三個程式碼塊:

  1. 第一個程式碼塊建立一個未完成的 future。
  2. 然後,如果 future 完成並帶有值,則會有一個函式被調用。
  3. 然後,如果 future 完成並帶有錯誤,則會有一個函式被調用。

還有一個您可能想要使用的方法:whenComplete()。您可以使用它在 future 完成時執行一個函式,無論它是帶有值還是錯誤。

它有點像 try-catch-finally 中的 finally 程式碼塊。如果一切順利,則會執行程式碼;如果有錯誤,則會執行程式碼;無論如何都會執行程式碼。

在 Flutter 中使用 futures

這就是您如何建立 futures,以及一些關於如何使用它們的值的資訊。現在讓我們來談談如何在 Flutter 中使用它們。

假設您有一個網路服務將返回一些 JSON 資料,並且您想要顯示該資料。您可以建立一個 StatefulWidget 來建立 future,檢查完成或錯誤,調用 setState(),並通常手動處理所有連線。

或者您可以使用 FutureBuilder。它是 Flutter SDK 附帶的一個 widget。您給它一個 future 和一個 builder 函式,它會在 future 完成時自動重建其子項。

FutureBuilder widget 的工作原理是調用其 builder 函式,該函式接受一個上下文和 future 當前狀態的快照。

您可以檢查快照以查看 future 是否完成並帶有錯誤:

否則,您可以檢查 hasData 屬性以查看它是否完成並帶有值:

如果 hasErrorhasData 都不是 true,那麼您就知道您仍在等待,您也可以為此輸出一些內容。

即使在 Flutter 程式碼中,您也可以看到這三種狀態如何不斷出現:未完成,已完成並帶有值,以及已完成並帶有錯誤。

總結

本文討論了 futures 代表什麼,以及如何使用 Future 和 FutureBuilder API 來建立 futures 並使用它們的完成值。

如果您想了解更多關於使用 futures 的資訊 - 可以使用可運行的示例和互動式練習來測試您的理解 - 請查看關於 futures、async 和 await 的非同步程式碼實驗室。

或者繼續觀看 Dart 中的非同步程式設計 系列中的下一個影片。它討論了 streams,它們與 futures 非常相似,因為它們可以提供值或錯誤。但是,futures 只給您一個結果就停止了,而 streams 則繼續運行。

非常感謝 Andrew Brogdon,他製作了本文所依據的影片。


Dart 非同步程式設計:Futures 最初發佈在 Dart 上的 Medium,人們在那裡透過突出顯示和回應這個故事來繼續討論。

【文章翻譯】What do Flutter package users need? Findings from Q2 user survey

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

由第二季調查意見組成的文字雲 ☁️(連結到原始 圖片程式碼

我們最近進行了第六次季度使用者調查,並從超過 7,000 位 Flutter 使用者那裡收集了回應。我們發現 92.5% 的受訪者對 Flutter 感到滿意或非常滿意,略高於 上個季度!我們很興奮地看到 Flutter 的滿意度始終如一。在本文中,我們將探討有關 Flutter 生態系統的一些深入問題,因為我們認識到幫助 Flutter 社群發展生態系統非常重要。

截至 2019 年 7 月,您可以在 pub.dev 上找到超過 2,800 個依賴 Flutter 的套件。去年同期,只有約 350 個依賴 Flutter 的套件可用,這顯示了巨大的成長!而且這還不包括數千個與 Flutter 應用程式相容的其他 Dart 套件。

儘管生態系統一直在蓬勃發展,但我們認識到,在 Flutter 專案周圍建立一個出色的生態系統仍然有很多工作要做。為了更好地了解使用者的需求和困難,我們在本季度的調查中提出了一些與 Flutter 生態系統相關的問題。我們將在本文中分享這些結果,以幫助套件作者建立更多有用的套件,以滿足更多使用者的需求。

總體而言,在 5,250 位受訪者中,有 80.6% 對 Flutter 生態系統感到 非常滿意有點滿意。這還不錯,但同時它也是調查中得分最低的部分之一。

對生態系統的滿意度
對 Flutter 的整體滿意度

當被問及對 Flutter 生態系統的不滿意時,大多數受訪者選擇的原因是「我需要的關鍵套件 尚未存在」(18%),這對於相對較新的技術來說可能是可以預期的。

但是,我們很高興地發現我們的社群正在積極為 Flutter 套件生態系統做出貢獻。15% 的受訪者有為 Flutter 開發套件的經驗,而 59% 的受訪者已將他們的套件發佈到 pub.dev,這是用於分享為 Flutter 和 Dart 應用程式編寫的套件的網站。如果您已撰寫了套件,但尚未發佈,您可以閱讀 pub.dev 上的 開發套件與 Plugin,並透過發佈您的套件回饋給 Flutter 社群。這並不難 - 在那些已發佈到 pub.dev 的人中,81% 認為這 非常容易有點容易

如果您無法決定與 Flutter 社群分享哪個套件,請訪問 GitHub 上的 Flutter 儲存庫,並搜尋 標記為「會是個好套件」的議題,以查看有哪些要求。您可以為您最喜歡的請求投票,以提高其可見度。

對 Flutter 生態系統不滿意的原因(多選題)

但是,如果您有興趣幫助,還有一個更好的方法可以為生態系統做出貢獻。請注意,所有其他原因都以「我需要的關鍵套件 確實存在…」開頭,這意味著即使套件存在,套件使用者也面臨著挑戰。這告訴我們,我們可以透過改進現有套件來改進生態系統 - 透過提交錯誤、改進文件、加入缺少的功能、實作對「其他」平台的支援、加入測試等等。考慮找到一個有潛力但還不夠受重視的套件,並為它做出貢獻 - 透過測試、錯誤報告、功能貢獻或範例!

使用者對現有套件不滿意最常見的原因是「它們沒有很好的 文件」(17%)。這是社群可以幫助的另一個領域。調查問題「您希望對套件生態系統的整體體驗做些什麼改進?」產生的建議如下:

  • 加入更多樣化的程式碼使用範例
  • 加入螢幕截圖、動畫 GIF 或影片
  • 加入指向對應程式碼儲存庫的連結

以下是意見欄中的一些相關引言:

「仍然有一些套件在第一頁上沒有程式碼範例。應該強制要求至少有一個簡單的範例。」
「強調套件開發者提供更全面的套件使用方法範例。」
「強制所有套件都有一個動畫 GIF 或影片展示它(首選)或一個螢幕截圖,並且有一個範例 Dart 檔案。」
「一個套件範例的圖形顯示將十分有益。很多時候,看到套件指的是什麼比運行範例更容易。」
「希望看到「範例」部分更常被填寫。有些套件沒有任何範例。也許在這個頁面上有一個更清晰的指向對應 GitHub 儲存庫的連結?」

此外,如上圖所示,與套件實際使用相關的困難(例如相依問題、套件的錯誤、套件的設定)與選擇合適套件相關的活動(例如缺少功能、發佈者的可信度、選擇指南、足夠的平台支援)相比,對使用者的影響相對較小。

Google 的 Flutter/Dart 團隊也在調查如何改善您使用和貢獻生態系統的體驗。正在考慮的一些選項包括,但不限於:

  • 提供更好的 pub.dev 搜尋體驗
  • 讓很容易看出套件支援哪些平台
  • 提供更可靠的品質指標
  • 改善可測試性

同時,可能值得指出的是,pub.dev 上的每個套件都已經獲得了流行度、健康度和維護度的評分;這些得分有助於使用者評估套件的品質。您可以在 pub.dev/help#scoring 上找到評分系統的詳細資訊。

評分範例
維護建議

透過評分系統,套件作者可以了解如何改進套件的品質,而套件使用者可以估計套件的品質(例如,過時程度)。

我們希望評分系統隨著時間推移而擴展,以幫助使用者做出更明智的決策。更具體地說,我們希望看到加入測試覆蓋率,並且希望公開更多關於平台覆蓋率的資訊,特別是隨著 Flutter 支援的平台清單擴展。我們還希望提供一個標誌,說明特定套件是否「推薦」,以便使用者清楚了解 Flutter 社群認為值得考慮的內容。隨著這些評分變更的出現,我們將與套件作者溝通,以確保他們擁有滿足不斷提高的品質標準所需的所有資訊。

我們要向填寫了冗長調查的超過 7,000 位 Flutter 使用者表示衷心的感謝。我們學到了很多東西 - 一些其他的重點列在下面。

  • 一些 Flutter 使用者對動畫框架並不完全滿意,不是因為很難實現預期的效果,而是因為很難入門。受訪者,尤其是新使用者,不知道從哪裡開始,而且很難理解各種概念是如何相互聯繫的。因此,我們將在動畫框架的學習資料上投入更多。

  • 對於 api.flutter.dev 上的 API 文件,類別文件中的程式碼範例被評為最有用的資源。在 1.7 版本中,我們已在 API 文件中的一些類別中加入了完整的程式碼範例,但我們將繼續將此功能擴展到更多類別。(我們也接受針對 flutter/flutter 儲存庫 上的 API 文件的 PR!)

  • 最後,你們中有許多人注意到 GitHub 儲存庫中未解決的議題數量正在增加,這是 Flutter 爆發式流行的負面影響。雖然我們在上一個版本中關閉了超過 1,250 個議題,但我們在這方面還有很多工作要做。如 Flutter 1.7 部落格文章中所述,我們正在努力增加這方面的員工數量,這將有助於更快地對新錯誤進行分類、更快地關注關鍵/崩潰問題、關閉和合併重複的議題,以及將支援請求重新導向到 StackOverflow

我們重視您對調查的回應,並將在決定工作優先順序時使用這些資訊。請參加我們將於 8 月發佈的第三季度調查,該調查將探討新的主題領域。

Flutter 的 UX 研究團隊進行了各種使用者體驗研究,以便我們了解如何使您對 Flutter 的體驗更加愉快。如果您有興趣參與,請 註冊 以參加未來的研究。


Flutter 套件使用者需要什麼?來自第二季使用者調查的發現 最初發佈在 Flutter 上的 Medium,人們在那裡透過突出顯示和回應這個故事來繼續討論。

【文章翻譯】Dart asynchronous programming: Isolates and event loops

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

Dart 非同步程式設計:Isolate 和事件迴圈

Dart 儘管是單執行緒語言,但它支援 futures、streams、背景工作以及你在現代非同步和(在 Flutter 的情況下)反應式編寫程式碼所需的所有其他功能。本文涵蓋 Dart 支援背景工作的基礎:isolate事件迴圈

如果您更喜歡透過觀看或聆聽來學習,本文中的所有內容都包含在以下影片中,該影片是 Flutter in Focus 影片系列 Dart 中的非同步程式設計 的一部分:

還在這裡嗎?讓我們來談談 isolate。

Isolate

Isolate 是所有 Dart 程式碼執行的環境。它就像機器上的一個小空間,擁有自己的私有記憶體區塊和一個運行事件迴圈的單執行緒。

一個 isolate 擁有自己的記憶體和一個運行事件迴圈的單執行緒。

在許多其他語言(如 C++)中,您可以讓多個執行緒共用相同的記憶體並執行您想要的任何程式碼。然而,在 Dart 中,每個執行緒都在其自己的 isolate 中,擁有自己的記憶體,並且該執行緒僅處理事件(稍後會詳細介紹)。

許多 Dart 應用程式在其單個 isolate 中運行所有程式碼,但如果需要,您可以擁有多個 isolate。如果您要執行的計算量非常大,以至於如果在主 isolate 中運行它可能會導致掉幀,那麼您可以使用 Isolate.spawn()Flutter 的 compute() 函數。這兩個函數都會建立一個單獨的 isolate 來進行數字運算,讓您的主 isolate 可以自由地(例如)重建和渲染 Widget 樹。

兩個 isolate,每個 isolate 都有自己的記憶體和執行緒。

新的 isolate 將獲得自己的事件迴圈和自己的記憶體,即使原始 isolate 是這個新 isolate 的父級,也不允許存取。這就是名稱 isolate 的來源:這些小空間彼此 隔離

事實上,isolate 合作的唯一途徑是透過來回傳遞訊息。一個 isolate 向另一個 isolate 發送訊息,接收 isolate 使用其事件迴圈處理該訊息。

Isolate 可以向其他 isolate 發送訊息。

這種缺乏共用記憶體的設計可能聽起來有點嚴格,尤其是如果您來自 Java 或 C++ 等語言,但它對 Dart 程式設計師來說有一些關鍵好處。

例如,isolate 中的記憶體分配和垃圾回收不需要鎖定。只有一個執行緒,所以如果它不忙,您就知道記憶體沒有被改變。這對於 Flutter 應用程式來說非常有用,因為它們有時需要快速地建立和銷毀大量 Widget。

事件迴圈

現在您已經對 isolate 有了基本的了解,讓我們深入了解真正使非同步程式碼成為可能的因素:事件迴圈

想像一個應用程式在其生命週期中的時間線。應用程式啟動、應用程式停止,並且在這之間會發生許多事件——來自磁碟的 I/O、來自使用者的點擊……各種各樣的事情。

您的應用程式無法預測這些事件何時發生或以何種順序發生,並且它必須使用永不阻塞的單執行緒來處理所有這些事件。因此,應用程式運行一個事件迴圈。它從其事件佇列中抓取最舊的事件,處理它,然後返回以獲取下一個事件,處理它,依此類推,直到事件佇列為空。

在應用程式運行的整個過程中——您點擊螢幕、下載內容、計時器關閉——事件迴圈只是不斷地循環,一次處理一個事件。

事件迴圈一次處理一個事件。

當動作中斷時,執行緒就會掛起,等待下一個事件。它可以觸發垃圾回收器、喝杯咖啡等等。

Dart 擁有的所有用於非同步程式設計的高階 API 和語言功能——futures、streams、async 和 await——都建立在這個簡單的迴圈之上和周圍。

例如,假設您有一個按鈕可以啟動網路請求,如下所示:

當您運行應用程式時,Flutter 會建立按鈕並將其顯示在螢幕上。然後您的應用程式等待。

您的應用程式的事件迴圈只是閒置,等待下一個事件。與按鈕無關的事件可能會進入並被處理,而按鈕則坐在那裡等待使用者點擊它。最終他們點擊了它,並且一個點擊事件進入佇列。

該事件被提取以進行處理。Flutter 查看它,渲染系統說:「這些座標與凸起的按鈕匹配」,因此 Flutter 執行 onPressed 函數。該程式碼啟動網路請求(返回一個 future)並使用 then() 方法為 future 註冊一個完成處理程式。

就這樣。迴圈完成了對該點擊事件的處理,並將其捨棄。

現在,onPressedRaisedButton 的一個屬性,網路事件使用 future 的回調函數,但這兩種技術都在做同樣的基本事情。它們都是一種告訴 Flutter 的方式:「嘿,稍後,您可能會看到特定類型的事件進入。當您看到時,請執行這段程式碼。」

因此,onPressed 正在等待點擊,future 正在等待網路資料,但從 Dart 的角度來看,這些都只是佇列中的事件。

這就是 Dart 中非同步程式碼的工作原理。Futures、streams、async 和 await——這些 API 只是您告訴 Dart 的事件迴圈:「這裡有一些程式碼,請稍後運行它」的方式。

如果我們回顧程式碼範例,您現在可以準確地看到它是如何被分解成針對特定事件的區塊的。有初始構建 (1)、點擊事件 (2) 和網路響應事件 (3)。

習慣使用非同步程式碼後,您將開始在各處識別這些模式。了解事件迴圈將有助於您繼續學習更高級別的 API。

總結

我們快速瀏覽了 isolate、事件迴圈和 Dart 中非同步程式碼的基礎。

如果您想了解更多資訊,請查看 Dart 中的非同步程式設計 系列的下一個影片。它討論了 Future API,您可以使用它來進行非同步程式設計,而無需大量程式碼。

非常感謝 Andrew Brogdon,他創作了本文所依據的影片。


Dart 非同步程式設計:Isolate 和事件迴圈 最初發佈於 Medium 上的 Dart,人們在那裡透過醒目顯示和回應這個故事來繼續對話。

【文章翻譯】Flutter for web early adopter program now open

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

迎接生產級 Web 應用程式的積極開發

我們對 Flutter 的願景一直是提供一個快速、高效且開放的工具集,用於在任何平台上創造出色的使用者體驗。我們從行動裝置開始,使用一個已經被成千上萬大大小小的應用程式使用的工具集。今年的 Google I/O 上,我們宣布了 Flutter 對網頁的首次預覽,允許開發人員使用相同的技能和程式碼來定位網頁瀏覽器,而且我們已經看到了 非常 多的興趣。感謝成千上萬的您,你們已經在網頁上試驗 Flutter 並給我們回饋。

我們很興奮地宣布,隨著我們越來越接近生產級網頁支援的發佈,我們正在進入開發的新階段。今天,我們 為準備在 Flutter 上認真構建網頁的企業、設計機構和新創公司開放一個專屬計畫。我們向那些準備直接參與第一波生產級 Flutter 網頁應用程式的公司提供有限的可用名額。

我們正在尋找具有引人注目的情景、計劃在未來六到十二個月內發佈基於網頁的 Flutter 體驗以及願意在行銷和發佈活動中作為展示的候選人。像任何預覽計畫一樣,不可避免地會有一些粗糙的邊緣,但我們準備提供支援和搶先體驗,以克服您遇到的任何障礙。

入選的參與者將獲得優先支援,以及在 Google/Flutter 媒體和活動中突出顯示其專案的機會。

如何申請

完成表格以申請審核。我們將從現在開始到 8 月底接受合格的申請。

更多關於 Flutter 對網頁的支援資訊,請參閱 flutter.dev/web。我們期待您的回覆!


Flutter 網頁搶先體驗計畫現已開放 最初發佈在 Flutter 上的 Medium,人們在那裡透過突出顯示和回應這個故事來繼續討論。

【文章翻譯】Hamilton Flare Design Challenge

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

Hamilton Flare 設計挑戰

Flutter 社群持續帶給我們驚喜,我們經常看到許多新的計畫,幫助世界各地的開發者學習 Flutter 並樂在其中。VeryGoodVentures 剛宣布與 2Dimensions 合作,為 Hamilton App 舉辦首屆 Flare 設計挑戰。想了解更多資訊,請查看此比賽的 官方網站

Hamilton 是 首批使用 Flutter 建立的應用程式 之一。該應用程式在 3 個月內建成,下載量超過 100 萬次,並在 Apple App Store 和 Google Play 商店上獲得推薦。以下是我們製作的有關該應用程式的影片:

Flare 是一款全新的設計和動畫工具,允許使用者建立真實的互動式動畫資產,這些資產可以在其最終產品中實時運行。沒有什麼比將 Flare 的潛力應用到 Hamilton 應用程式上更好的方式了,方法是將其開放給設計師、開發者和 Hamilton 粉絲。

#HAMAPPFLARE

#HamAppFlare 挑戰是一個獨特的機會,讓您贏取獎品並在 Hamilton 應用程式(使用 Flutter 建立)中獲得展示,同時學習使用 Flare。

這是您使用 Flare 和 Flutter 以 Hamilton 應用程式為靈感創作驚人動畫的機會。思考動畫可以如何以有趣、引人入勝和實用的方式改善 Hamilton 應用程式,並透過 Flare 將它們變為現實。或者,您也可以用 Flare 創建一些令人驚嘆的內容來表達您對 Hamilton 的愛。

參加方法:

  1. 創建一個適合 Hamilton 的 Flare 動畫。
  2. 使用 #HamAppFlare 推文連結到您的作品。
  3. 2019 年 8 月 15 日晚上 11:59 EST 之前 將您的作品 提交到提交網站
  4. 獲獎者將由 Hamilton、Very Good Ventures 和 2Dimensions 選擇。

獲獎者將獲得:

  • 價值 250 美元的 Hamilton 商品包
  • 價值 250 美元的 Broadway.com 禮物卡
  • 1 年 Flare 訂閱(價值 250 美元)+ Flare T 恤
  • 應用程式內獲獎者公告
  • @HamiltonMusical 的社群媒體提及

立即參加挑戰

Hamilton Flare 挑戰於 2019 年 7 月 20 日開始,於 2019 年 8 月 15 日晚上 11:59 EST 結束。

Hamilton - 與 Flutter 和 Flare 一起崛起!

2017 年,百老匯熱門音樂劇 Hamilton 首個非 Google 品牌,推出了使用 Flutter 建立的製作應用程式。Hamilton 應用程式自推出以來,一直是 Flutter 的旗艦應用程式,在全球擁有超過 300 萬次下載。

雖然 Flutter 現在在開發者中已成為知名度極高的遊戲規則改變者,成為可移植 UI 框架,但 Hamilton 在 Flutter 的預覽版階段就早早採用了它。Hamilton 和 Very Good Ventures 一直致力於使用 Flutter 建立革命性的應用程式體驗…現在也包括 Flare。

詳細信息

提交指南

提交網站 上可以找到官方詳細信息和規則。以下任何信息僅供參考,並非「官方」信息。

  • 提交時間為 2019 年 7 月 20 日凌晨 12:00 EST 至 2019 年 8 月 15 日晚上 11:59 EST。
  • 提交作品 必須 包含 Flare 檔案。理想情況下,Flare 動畫也應在您提供的 Flutter 程式碼中使用。
  • 您的提交作品必須使用 GitHub 上的公共儲存庫的有效 URL 或 2Dimensions Flare 網站 提交。
  • 每個提交作品都必須附帶 MIT 許可證:https://opensource.org/licenses/MIT
  • 您的作品不得具有攻擊性或惡意 - 這是為了娛樂,並鼓勵設計師和開發者使用 Flare!

作品評審標準

Flare 作品將由 Hamilton、Very Good Ventures 和 Flare 團隊的成員根據以下標準進行評審:

  • 創意: 動畫及其使用的獨特性和新穎性。
  • 品牌一致性: 動畫與 Hamilton 品牌一致的程度,以及是否適合在應用程式中使用。
  • 驚豔: 動畫讓使用者露出笑容,並展示 Flare 強大功能的程度。

傳播訊息!

挑戰的官方標籤是 #HamAppFlare。請務必推文或發布您的作品,並提及 @HamiltonMusical@VGVentures@2Dimentions@FlutterDev

Hamilton 商品包包含哪些物品?

  • Hamilton 金星 T 恤 - 連結
  • Hamilton 棒球帽 - 連結
  • Hamilton 品脫杯 - 連結
  • Hamilton The Revolution 精裝本 - 連結
  • Hamilton 帆布沙灘包 - 連結
  • Hamilton 海灘毛巾 - 連結
  • Hamilton 紀念節目冊 - 連結
  • Hamilton 胸針 - 連結

需要靈感?

需要 Hamilton 應用程式為您在 Flare 中創作提供靈感?嘗試以下一些重點領域:

  • 輸入彩票動畫
  • 「您中獎了!」動畫
  • 彩票旅遊位置選擇器
  • trivia 星星爆發動畫
  • 今天螢幕內容動畫

基本上任何按鈕、內容或互動都是可以的!或者,您也可以使用 Hamilton 及其角色為靈感創作一些有趣的作品 - 可以看作是互動式粉絲藝術!


Hamilton Flare 設計挑戰 最初發佈在 Flutter 上的 Medium,人們在那裡透過突出顯示和回應這個故事來繼續討論。

【文章翻譯】Material Range Slider in Flutter

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

Flutter 中的 Material RangeSlider

範圍滑桿是 Flutter 1.7 中釋出的高度自訂元件,用於選擇一組值。本文說明了範圍滑桿是什麼,為什麼您可能需要使用它,以及如何使用 Material 主題自訂 Flutter RangeSlider 的行為和外觀。

為什麼要使用範圍滑桿?

滑桿元件可以提供單一選取或多重選取,在離散或連續軌道上。與單一選取滑桿不同的是,單一選取滑桿預先確定最小值或最大值,並且可以在一個方向上調整選取,範圍滑桿具有兩個選取點,允許靈活調整最小值和最大值點。這種靈活性使其成為有用的元件,適用於使用者希望控制特定範圍的情況,例如指示價格點或時間長度。

結構和實作

RangeSlider 由 5 個部分組成:

  1. 一個軌道,拇指可以在上面滑動。
  2. 當 RangeSlider 為離散時,軌道上的刻度線。
  3. 2 個拇指(或旋鈕),表示範圍的最小值和最大值。
  4. 值指示器,在定義標籤且 showValueIndicator 與滑桿類型相符時,顯示拇指值的標籤。
  5. 當拇指被按下時,顯示在拇指上的覆蓋層。

我們需要 RangeSlider 具有豐富的動畫。這包括拇指位置的互動驅動動畫,以及覆蓋層和值指示器的內建動畫。在 Flutter 中,我們透過將 RangeSlider 元件設為 StatefulWidget 來做到這一點,它將動畫控制器作為狀態儲存。

實際的範圍滑桿值會儲存在父 Widget 中的狀態。透過在 RangeSlider 的 onChange() 回呼函數中呼叫 setState() 來更新值。換句話說,為了擁有互動式範圍滑桿,RangeSlider Widget 本身必須在 StatefulWidget 中建立。

RangeSlider 的 State 物件會構建 LeafRenderObjectWidget。所有內容都繪製在它的內部 RenderBox 中,它也處理觸控輸入。

處理觸控輸入

如果您好奇 RangeSlider 如何實作觸控輸入,請繼續閱讀!RangeSlider 的一個有趣之處在於,它是少數使用 GestureArenaTeam 的原生 Flutter Widget 之一。下一節將說明如何自訂觸控輸入。

如果您不感興趣,請跳過此節。

為了確保 RangeSlider 可以處理點擊和拖曳,同時在捲軸視圖、標籤列視圖和其他處理手勢的 Widget 中正常運作,會使用 GestureArenaTeam。GestureArenaTeam 允許透過「獲勝」來正確選擇一組手勢中的手勢。

首先,將拖曳辨識器加入到團隊中,然後加入點擊辨識器。沒有團隊隊長,因此一旦任何其他辨識器退出競技場,拖曳辨識器就會獲勝,因為它是第一個加入團隊的辨識器。另一方面,如果點擊可以直接獲勝,例如當滑桿在垂直捲軸列表中,使用者點擊然後立即鬆開時,則點擊辨識器會獲勝。

拖曳和點擊事件會解析為 3 種可能的互動之一:

  • 拖曳 onStart 或點擊 onTapDown → _startInteraction
  • 拖曳 onUpdate → _handleDragUpdate
  • 拖曳 onEnd 或 onCancel 以及點擊 onEnd 或 onCancel → _endInteraction

在互動開始時,必須確定的第一件事之一是哪個拇指應該被選取以進行移動。RangeSlider 透過使用可主題化函數來做到這一點,該函數會接收點擊值和拖曳位移等屬性,並返回拇指選擇:Thumb.start、Thumb.end 或 null(表示沒有選取)。

預設拇指選擇器首先嘗試在 _startInteraction 中找到最接近的拇指。如果選取了一個拇指,則拇指的位置會立即更新為點擊值。但是,如果點擊值位於拇指之間,但不在任何觸控目標中,則不會選取任何拇指。此外,如果拇指彼此足夠接近,並且點擊位於兩個觸控目標中,則不會選取任何拇指。在這種情況下,只有在存在非零移動(拖曳位移)時才會選取拇指。然後,對於負移動會選取左邊拇指,對於正移動會選取右邊拇指。這是唯一一種互動實際上在第一個 _handleDragUpdate 步驟中開始的情況。無論哪種情況,一個特殊的回呼函數 onChangeStart() 都會發出此互動的開始值。

當拇指分開較遠時,觸控內部軌道不會選取拇指:

當拇指更加靠近時,會使用拖曳位移來確定拇指選擇:

實作具有上述行為的預設拇指選擇器:

選取拇指後,所有未來的拖曳更新都用於確定拇指的新位置。覆蓋層動畫從選取的拇指開始,值指示器動畫從兩個拇指開始。當使用者拖曳選取的拇指時,範圍滑桿會發出一組帶有更新位置的新值,然後這些值會傳回範圍滑桿,以更新其對應的位置。

最後一步是 _endInteraction。一旦點擊或拖曳手勢抬起,在第一步中開始的覆蓋層和值指示器動畫就會反轉。一個特殊的回呼函數 onChangeEnd() 也會發出結束值。

自訂觸控輸入選取

在上一節中,您看到了 Material 的預設拇指選擇行為的程式碼。但是,如果您想要不同的東西呢?以下程式碼顯示了如何撰寫一個始終選取最接近拇指的拇指選擇器,無論觸控軌道的哪個部分。

實作始終找到最接近拇指的自訂拇指選擇器:

獲得此自訂拇指後,您可以在全域應用程式主題中設定它:

或者,可以使用 SliderTheme 在特定滑桿實例上設定它:

控制允許的拇指位置

在上面,您看到了如何使用 SliderThemeData 自訂拇指的選擇方式。本節將說明如何限制拇指可以拖曳或設定到的位置。有兩種方法可以控制拇指的允許位置。可以透過來完成,也可以透過空間來完成。透過值可能很有用,例如,如果您有一個價格選擇器。假設允許的價格可以在 0 美元和 100 美元之間,但您希望範圍至少相隔 20 美元。因此,[$30, $50] 的範圍是允許的,但 [$33, $34] 的範圍是不允許的。只需按照以下方式調整 onChanged 函數:

如果只需要限制拇指的出現,則可以使用 minThumbSeparation 屬性來限制分隔 2 個拇指的邏輯像素數。預設的頂部拇指會在其周圍繪製一個白色外框,以更好地區分拇指之間的對比。以下是一張比較預設值 8 與自訂值 24 的圖:

繪製形狀

除了處理觸控輸入之外,RenderBox 還負責繪製 RangeSlider。它會按照以下順序繪製 RangeSlider 的元件:

  1. 軌道
  2. 覆蓋層
  3. 刻度線(如果為離散)
  4. 值指示器(如果可見)
  5. 拇指

這對於繪製自訂形狀非常重要。所有形狀實作都透過 5 個獨立的抽象類別從 RenderBox.paint() 方法中抽象出來,這使得 RangeSlider 的繪製或渲染完全可自訂和可主題化,因為這些類別存在於 SliderThemeData 物件上。

在下一節中,我們將說明如何使用自訂形狀覆蓋預設形狀。

使用自訂形狀

就像單個 Slider 一樣,所有構成滑桿的形狀都可以針對 RangeSlider 自訂。查看 此片段 了解如何自訂 Material Slider 的範例。

這是透過將自訂抽象形狀類別的實作傳遞到 SliderThemeData 來完成的。這利用了 RangeSliderThumbShape 類別來提供自訂拇指,這些拇指根據它們所在的哪一側具有不同的外觀。

自訂範圍拇指形狀可以按以下方式實作:

然後,可以在 SliderThemeData 上設定自訂範圍拇指形狀:

結語

Material 範圍滑桿是社群要求的元件。它可以開箱即用,也可以自訂以符合您的應用程式需求。可以在全域層級的主題中,或在逐個實例的基礎上,變更行為和視覺外觀。

本文中包含的所有程式碼的完整程式碼,以及更多範例,可以在 github 上的 Material 範例庫github 上的 Material 函式庫 中找到。

特別感謝 Shams Zakhour、Liam Spradlin、Barbara Eldredge、Cortney Cassidy 和 Will Larche。


Flutter 中的 Material 範圍滑桿 最初發佈在 Flutter 上的 Medium,人們在那裡透過突出顯示和回應這個故事來繼續討論。

【文章翻譯】Announcing Flutter 1.7

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

宣布 Flutter 1.7

今天,我們很高興 宣布 Flutter 1.7 正式推出,這是繼 Google I/O 上重大功能發佈後,一個較小的版本。Flutter 1.7 包含對 AndroidX 和更新的 Play Store 要求的支援、許多新的和增強的元件,以及對客戶報告問題的錯誤修復。

如果您已經在您的系統上安裝了 Flutter,並且您使用的是預設的穩定頻道,您可以透過命令列執行 flutter upgrade 來升級到 1.7 版。更新的版本也包含在 新的 Flutter 安裝 中。

新增應用程式的 AndroidX 支援

AndroidX 是一個由 Jetpack 團隊提供的新開源支援函式庫,它有助於 Android 應用程式在不犧牲向後相容性的情況下,使用最新的元件保持更新。由於 AndroidX 自身已經穩定,並且許多 Flutter 套件已更新以支援它,Flutter 支援 使用 AndroidX 建立新的 Flutter 專案,這減少了整合到 Android 生態系統其他部分所需的工作。

在建立 Flutter 專案時,您可以加入 --androidx 旗標,以確保產生的專案以新的支援函式庫為目標。有關將現有專案遷移到 AndroidX 的資訊,請參閱 flutter.dev 上的資訊。我們正在積極努力為混合使用 AndroidX/Android 支援函式庫的應用程式(例如在「新增至應用程式」情況下)提供 AndroidX/Jetifier 支援,並將在接下來的文章中分享更多有關此方面的資訊。

支援 Android 應用程式套件和 64 位元 Android 應用程式

從 2019 年 8 月 1 日起,使用原生程式碼且以 Android 9 Pie 為目標的 Android 應用程式在發佈到 Google Play 商店時,需要提供 64 位元版本,除了 32 位元版本。雖然 Flutter 長期以來一直支援產生 64 位元 Android 應用程式,但 1.7 版新增了對建立 Android 應用程式套件 的支援,這些套件可以從單次提交中以 64 位元和 32 位元為目標。請參閱更新的 關於發佈基於 Flutter 的 Android 應用程式的文件,以了解如何執行此操作,以及如何為 32 位元和 64 位元設備建立獨立的 APK 檔案。

新的 Widget 和框架增強

我們希望您的應用程式看起來很棒,並且感覺很自然,無論您以哪個平台為目標。因此,我們將繼續更新和增強 Android 和 iOS 上可用的 Widget。

此版本具備新的 RangeSlider 控制項,讓您可以在單個滑桿上選擇一系列值(例如,最小和最大溫度值):

新的、可主題化的 RangeSlider Widget 支援連續或離散樣式

更新的 SnackBar Widget 支援 Material 規格中更新的外觀,並且 新增了許多 範例 到文件

對於 Cupertino,用於建立像素完美的 iOS 應用程式的 Flutter 函式庫,我們進行了許多更新。特別是,我們改進了 CupertinoPicker 和 CupertinoDateTimePicker Widget 的保真度,並加入了對非英語語言的本地化支援。

我們還對 iOS 上的文字選取和編輯體驗 進行了重大改進,無論您使用的是 Material 還是 Cupertino 設計語言。此外,新的範例 展示了如何在 iOS 和 Android 之間進行更重大的平台適應,同時保留相同的程式碼庫。

文字渲染得到了重大升級,支援豐富的 排版功能,包括表格數字和舊式數字、斜線零和風格集,如 此演示 所示:

使用 Flutter,您現在可以使用 OpenType 字體功能支援新增複雜的排版

最後,我們加入了對 遊戲控制器 的支援。這會導致一些有趣的 Flutter 應用程式嗎?您告訴我們吧!

關注基本面

Flutter 1.7 代表著團隊為回應客戶報告問題所做出的大量努力,自我們上次穩定版本發佈以來,在兩個月的時間裡,已解決了 1,250 多個問題

隨著 Flutter 的快速成長,我們看到越來越多新的問題被報告,為了透明起見,當我們的專案規模較小時運作良好的錯誤處理過程現在效果不佳。因此,儘管我們在解決已分類問題方面取得了進展,但我們的公開問題數量在過去幾個月顯著增加。我們正在努力增加這方面的員工,這將有助於更快地解決新錯誤,解決和合併重複問題,並將支援請求重新導向到 StackOverflow

在最近的調查中,許多人表示希望看到我們繼續投資於文件和錯誤訊息。這项工作的一個关键部分是为我们的错误提供更好的结构,以便像 VS Code 和 Android Studio 这样的工具将来可以利用它。您可以查看 問題 34684 中的示例。

我們還解決了最常發生的崩潰錯誤,即當 Flutter 工具無法寫入 Flutter 目錄時產生的錯誤。如果使用者沒有寫入權限,Flutter 現在會在無法寫入的情況下優雅地失敗,並提供更明確的指示說明如何修復問題。

在文件方面,我們有一個不斷增加的範例列表,可以直接從 flutter create 工具中建立。從命令列,您可以執行以下命令:

1
flutter create --sample=material.AppBar.1 mysample

如果範例可以透過這種方式建立,您會在文件中看到一個「應用程式中的範例」標籤,例如 此 AppBar Widget 的範例

我們還將繼續將熱門的 每週 Widget 影片直接嵌入到文件,作為一種簡單的方法來了解 Flutter 工具箱中各種 Widget。

在幕後,您會看到為在 macOS 和 Windows 上啟用 Flutter 而建立基礎架構的許多底層工作,以及對重要概念的進一步支援,例如右鍵點擊和獨特的平台基礎架構,例如 MSBuild。但是,穩定頻道中尚未提供對非行動平台的支援。

最後,當您在 Mac 上建立 Flutter 應用程式時,我們現在支援 新的 Xcode 建立系統。這是在新的專案中預設啟用的,並且 很容易為現有專案啟用

不斷成長的 Flutter 社群

與往常一樣,看到 Flutter 的普及程度和使用率持續增長令人興奮,我們也慶祝大大小小的客戶使用 Flutter 的方式。自 I/O 以來,團隊一直忙於世界各地的各項活動:從中國的 GMTC 到紐約和墨西哥的聚會和演講;很高兴能与你们中的许多人见面,并了解你们正在构建的一些应用。

之前我們已經討論過 Reflectly:一家小型丹麥公司,他們為 iOS 和 Android 建立了一個美麗的正念應用程式。他們的應用程式剛被評選為美國 iPhone 應用程式商店的「每日應用程式」,這證明了 Flutter 應用程式完全有能力提供參考品質的體驗:

在柏林的 WeAreDevelopers 會議上,BMW 宣布了他們新的基於 Flutter 的應用程式,該應用程式目前正在開發中。以下是 BMW 連接公司 CTO Guy Duncan 的說法:

“透過結合 Dart 和 Flutter,我們拥有第一个真正的跨平台移动工具包;我们认为它是一个改变游戏规则的工具,可以确保数字接触点和物联网的功能一致性。
透過採用世界一流的工具、自動化和現代化的函數式程式設計模式,我们可以缩短功能周期时间,提高安全性和降低业务功能的交付成本。”

當然,除了應用程式之外,開源社群是使 Flutter 成为一個如此有趣的工作場所的原因,它擁有許多 資源Plugin活动聚会。我們對您如何使用 Flutter 以及能夠與大家分享樂趣感到驚嘆不已!

圖片出處:[@damian2048](https://twitter.com/damian2048)


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