有什麼新功能

此頁面說明 Dart 網站和部落格上的新功能。如需查看 Flutter 的新功能，請前往 Flutter 新功能頁面。

如需查看每個 Dart SDK 中的 Dart 語言變更清單，請參閱 語言演進頁面。如需掌握最新公告，包括重大變更，請加入 Dart 公告 Google 群組 並追蹤 Dart 部落格。

本節列出從 2023 年 11 月 16 日到 2024 年 2 月 15 日之間進行的重大變更。如需 3.3 版本的詳細資訊，請查看 3.3 部落格文章 和 SDK 變更日誌。

除了修正錯誤和逐步改善之外，我們對此網站進行了以下變更

• 將網站基礎架構變更為 在 11ty 上執行，而非 Jekyll。
• 新增一頁，說明新的語言功能 擴充功能類型。
• 新增一組關於 JavaScript 互操作 的文件
  • 用法
  • JS 類型
  • 教學課程，第一個教學課程是關於 模擬
  • 過去的 JS 互操作
• 更新 並行處理 總覽，以及使用 隔離 的新實作頁面。
• 在 函式 頁面中新增關於 external 的區段。
• 從幾個頁面移除內嵌的 DartPad，以配合 DartPad 的新版本。
• 在 詞彙表 中新增「函式」的定義。
• 將 函式庫導覽 分解為每個函式庫的個別頁面。
• 更新 3.3 的 重大變更 頁面。
• 更新 常見問題 頁面中幾個過時的項目。
• 擴充關於 dart doc 的文件。
• 更新並簡化 支援的平台 內容。
• 合併多個 dart format 內容。
• 更新各個位置，建議使用 package:web，而非 dart:html。
• 不再建議使用 dart:html 和 dart:io 進行 HTTP 要求，而建議使用 package:http。
• 說明 在 pubspec 檔案中抑制診斷。
• 新增關於 建立 和 忽略 pubspec 檔案中安全性建議的內容。
• 已記錄如何從已撤回的套件版本中移轉。

此區段列出從 2023 年 8 月 17 日到 2023 年 11 月 15 日之間所做的重要變更。有關 3.2 版本的詳細資訊，請查看3.2 部落格文章和SDK 變更日誌。

除了修正錯誤和逐步改善之外，我們對此網站進行了以下變更

• 已更新修正類型提升失敗頁面，以新增類型提升功能：私有 final 欄位提升。
  • 已對類型提升的 Effective Dart 條目、了解 Null 安全性頁面以及網站上其他各處進行相關微調。
• 已在C 互通頁面中新增實驗性原生資產功能的文件。
• 已建立一個新頁面專門記錄重大變更。
• 已在各自的文件頁面中考量新的和已更新的程式碼檢查和診斷。
• 已在pub upgrade頁面中新增新的--tighten標記的文件。
• 已移除秘笈，改用語言概觀頁面。
• 已釐清防護子句和模式之間的關係。
• 已調整建構函式頁面，以更好地呈現最佳實務。
• 已改善套件依賴項頁面的內容，使其更具可操作性且易於遵循。
• 已在擴充方法頁面中詳細說明靜態成員。
• 已變更Objective-C多執行緒限制內容，以考量新的NativeCallableAPI。
• 已在元資料頁面中新增新的註解，並提及不建議使用的部分。
• 已透過調整網站中程式碼範例的文字顏色和重點顯示，來改善對比。
• 已全面重新組織和簡化網站基礎架構，以準備不再使用 Jekyll。

此區段列出從 2023 年 5 月 11 日到 2023 年 8 月 16 日之間所做的重要變更。有關 3.1 版本的詳細資訊，請查看Dart 3.1 和 Dart 3 中函式程式設計風格的回顧和SDK 變更日誌。

除了修正錯誤和逐步改善之外，我們對此網站進行了以下變更

• 已全面修改程式碼檢查規則文件，以取代舊的程式碼檢查網站
  • 將每個 linter 規則的文件移至其專屬頁面。例如：avoid_dynamic_calls。
  • 新增一個範例 analysis_options.yaml，用來啟用 所有 linter 規則，這些規則在最新的 Dart 版本中可用。
  • 更新 所有可用 linter 規則的索引，以利更輕鬆地找出 linter。
• 擴充 類別修飾詞 文件，新增 類別修飾詞參考，說明它們如何彼此互動。
• 推出 API 維護人員的類別修飾詞指南，協助開發人員最佳化使用類別修飾詞。
• 重新撰寫 switch 運算式 文件，更詳盡地說明它與 switch 陳述式的差異。
• 記錄支援在 pubspec 檔案中指定 主題，以在 pub.dev 網站上分類您的套件。
• 釐清 套件截圖是用來展示套件功能，而不是套件的標誌或圖示。
• 在 Dart 的 語言文件 中新增上一個和下一個按鈕，提供引導式學習體驗。
• 持續擴充新的全站 詞彙表。
• 新增遷移備註，說明 pub 快取移動 已在 Dart 3 中針對 Windows 完成。
• 簡化並更新較舊的文件，因為 Dart 的類型系統現在總是 null 安全。

我們在 Dart 部落格上發布了以下文章

• Dart DevTools：使用 CPU Profiler 分析應用程式效能

此區段列出從 2023 年 1 月 26 日到 2023 年 5 月 10 日之間進行的重大變更。如需 3.0 主要版本的詳細資訊，請查看 宣佈推出 Dart 3 和 SDK 變更記錄。

為了準備 Dart 3，我們將語言之旅拆分並重新組織成新的概念類別。您可以在側邊導覽選單中的語言底下存取已重新建構的語言文件，或透過造訪已更新的 Dart 簡介 來存取。

利用這個新結構，我們新增了 Dart 3 每個主要功能的文件

• 模式比對 和不同類型的 模式。
• Switch 運算式，支援模式和 窮盡性檢查。
• 包含 case 子句的 if 陳述式，以支援模式比對。
• 記錄，一種新的匿名、不可變且聚合的類型，可啟用多重傳回。
• 類別修飾詞，讓程式庫可以更控管匯出的類型。

為了協助您轉換至 Dart 3 強制執行的健全空安全和其他變更，我們也準備了以下更新

• 建立了全面的Dart 3 移轉指南。
• 將所有文件和程式碼範例移轉至 Dart 3、最新的工具版本和最新的相依性。
• 說明 Dart 的類型系統現在在 Dart 3 中總是空安全的。
• 更新並重新整理語言演進頁面及其語言版本控制討論。
• 移除 Dart 1 和早期 Dart 2 文件、注意事項和資源的殘留。

除了新的 Dart 3 內容和網站上對應的更新外，我們也進行了以下變更

• 新增關於設定編譯環境宣告的指南。
• 持續進行 Dart 的原生互通作業，新增關於Java 互通作業實驗性支援的指南。
• 說明未命名擴充的用法和限制。
• 新增一個頁面，說明新的dart info指令，可協助進行工具診斷。
• 全面修改dart pub add文件，涵蓋其新的來源描述符語法。
• 在SDK 檔案庫中，將預覽 Linux RISC-V (RV64GC) 建置浮出在 beta 通道上。
• 開始建立新的全站詞彙表，包含網站中使用的常見術語。
• 重點介紹 Dart 的JS 靜態互通作業支援的實驗性工作。
• 說明分析器外掛程式的存在和目前的限制。

我們在 Dart 部落格上發布了以下文章

• 介紹 Dart 和 Flutter 的 Realm

在 Google I/O 2023 期間，我們發布了以下影片

• Dart 和 Flutter 的新功能 (美國手語版本)
• 重新思考 Dart 與 Android 的互通作業
• 如何在 Dart 中建立套件

本節列出從 2022 年 8 月 31 日到 2023 年 1 月 25 日之間所做的顯著變更。有關 2.19 + 3.0 alpha 版本的詳細資訊，請參閱 介紹 Dart 3 alpha 和 SDK 變更記錄。

除了修正錯誤和逐步改善之外，我們對此網站進行了以下變更

• 推出了 從網際網路擷取資料 教學課程，說明如何使用 package:http。
• 新增一頁說明 在 pub.dev 中自動發佈套件。
• 在我們的 社群資源區段 中加入兩個新網站翻譯的連結
  • 本網站的韓文版本（한국어）
  • 本網站的繁體中文版本（正體中文版）
• 更新 null 安全性內容，以準備 Dart 3
  • 變更 移轉指南 中的版本限制，以符合 Dart 3 相容性。
  • 在 健全的 null 安全性 頁面中加入 Dart 3 完整的健全 null 安全性概觀。
  • 在備註中強調 Dart 3 與 不健全的 null 安全性 不相容。
• 推出了新的 Swift 開發人員學習 Dart 指南。
• 用更通用的 布林值和相等性運算子 指南取代了 Effective Dart 區段。
• 在整個 pub 文件中記錄 內容雜湊。
• 開始著手修改 區域 頁面，將範例改為使用 runZonedGuarded，而不是 onError。
• 更新程式庫內容，涵蓋新的無名稱宣告開發
  • Effective Dart：文件、樣式 和 用法
  • 在 語言導覽 中新增程式庫指令區段
• 改善有關 Dart 單執行緒或多執行緒狀態的清晰度
  • 移除過時的 dart:io 頁面。
  • 擴充 Dart 的網頁並行處理功能。
• 重新整理並釐清 討論 選擇性參數和位置參數的預設值。
• 更新 Dart 中的並行處理 以預設為新的 Isolate.run() 函式。
• 記錄在 pub global 頁面 上啟動套件時指定檔案路徑。
• 重寫 JavaScript 開發人員學習 Dart。
• 在 dart run 頁面 中加入 Dart DevTools 的簡要概觀。
• 在語言導覽中提供有關 運算子優先順序和結合性 的更多說明。
• 擴充函式庫導覽中關於 建立 URI 的部分，加入 URI http 和工廠建構函式資訊。
• 考量 pub 從 pub.dartlang.org 轉移到 pub.dev。
• 加入 套件截圖 的文件。
• 改善 Dart 型別系統頁面中 明確向下轉型部分。
• 增加 分析器 和 程式碼檢查 涵蓋範圍
  • 納入程式碼檢查規則的 SDK 版本支援資訊。
  • 加入 2.19 變更的診斷和程式碼檢查訊息。

我們在 Dart 部落格上發布了以下文章

• 使用 Isolate.run() 更佳地管理 Isolate
• pub.dev 的截圖和自動發布
• 邁向 Dart 3：一個完全健全、無 Null 安全的語言
• Google Summer of Code 2022 結果
• 與 GitHub 合作，確保 Dart 套件的供應鏈安全性

此部分列出 2022 年 5 月 12 日至 2022 年 8 月 30 日之間的重大變更。有關 2.18 版本的詳細資訊，請參閱 Dart 2.18：Objective-C 和 Swift 互操作，以及 SDK 變更日誌。

除了修正錯誤和逐步改善之外，我們對此網站進行了以下變更

• 推出 Objective-C 和 Swift 互操作 頁面，說明如何使用 Dart 套件呼叫這些語言的 API。
• 在 修正常見型別問題 中加入一個解決方法，以應對型別推論可能錯誤地推論參數型別為 Null 的罕見情況。
• 已從 不應提交的內容 中移除所有提及已停用的 .packages 檔案。如果您仍需要因第三方舊有相依性而產生 .packages 檔案，請參閱 dart pub get 選項。
• 已移除專用頁面和任何其他提及已停用的 dart2js 和 dartdevc 命令列工具。
  • 已將先前與 dart2js 相關的命令列選項和已知問題新增至 dart compile 頁面。
  • 已將生產程式碼的除錯資訊新增至 除錯 Dart 網路應用程式。
• 已將支援下載實驗性 Windows ARM 組建新增至 Dart SDK 檔案。
• 已更新 函式庫導覽 以納入有關弱參考和終結器的資訊。
• 已新增自訂 dart fix 的區段。

此區段列出從 2022 年 2 月 4 日到 2022 年 5 月 11 日所做的顯著變更。有關 2.17 版的詳細資訊，請參閱 Dart 2.17：生產力和整合。

除了修正錯誤和逐步改善之外，我們對此網站進行了以下變更

• 已推出 JavaScript 開發人員學習 Dart 指南，旨在於學習 Dart 時利用您的 JavaScript 程式設計知識。
• 已記錄 Dart 2.17 中推出的功能和變更
  • 已更新語言導覽的 命名參數 區段，以反映支援在任何地方指定命名引數。
  • 已新增 super-initializer 參數 的文件。
  • 已擴充語言導覽的 列舉類型 區段，並記錄 增強列舉。
  • 已記錄支援使用 dart compile exe 編譯的 macOS 和 Windows 可執行檔的 簽署。
  • 已將 dart create 支援的範本更新為其新的標準化名稱。
• 已考量 pub.dev 網站 和 pub 工具 的變更。
  • 已列出提供 Dart 套件存放庫作為服務 的供應商。
  • 已移除現已停用的 dart pub uploader 命令的文件。
  • 已擴充管理 pub 專案 上傳器 的文件。
  • 已移除對已棄用的 .packages 檔案的大部分提及，並改指向其 .dart_tool/package_config.json 替換檔。
• 已更新更新和安裝 Dart 的文件
  • 在 macOS 安裝說明 中記錄了如何使用 Homebrew 切換 Dart 版本。
  • 更新 Linux 安裝說明 以使用 SecureApt 並遵循最新的最佳實務。
  • 新增支援從 Dart SDK 檔案庫 下載實驗性質的 Linux RISC-V (RV64GC) 版本。
• 持續改進和更新 統一的 dart 工具 的文件。
  • 擴充 dart fix 工具功能的文件。
  • 調整 dart doc 工具的準則和文件，以符合其功能和基礎行為。
  • 新增 dart compile js 的更多文件和範例。
  • 移除已移除的獨立工具的說明。
• 更新分析器和 linter 的文件和用法
  • 記錄分析器新的 嚴格語言模式。
  • 納入 診斷訊息 和 linter 規則 頁面的變更。
  • 更新文件和範例以使用 lints 套件的 2.0.0 版本。
• 開始全面檢修網路編譯的文件
  • 記錄 dart2js 和 dartdevc 獨立工具的棄用和計畫移除。
  • 整合和釐清 dart2js 和 dartdevc 的文件，作為 dart compile js 和 webdev 等工具的基礎編譯器。
• 增加空安全的文件涵蓋範圍
  • 記錄非空斷言運算子 (!) 作為語言導覽 其他運算子 區段的一部分。
  • 將 低階 HTML 教學課程 遷移到支援空安全，並討論在使用空安全時如何與網路 API 互動。
• 進行其他雜項更新
  • 記錄 dart:ffi 在 C 互通中使用的 原生類型。
  • 在語言導覽中新增一個區段，記錄 初始化形式參數。
  • 記錄 DartPad 的 套件支援。
  • 修正 非同步程式設計 codelab 中的格式，並詳細說明 非同步程式碼為何重要。
  • 更新 安全性 頁面以符合我們目前的安全性實務。
  • 新增一個按鍵繫結 (/) 以自動將焦點移至搜尋欄。

我們在 Dart 部落格上發布了以下文章

• 大量套用修正
• Dart 非同步程式設計：串流
• 2022 年 Google Summer of Code 貢獻者
• 針對大型 Dart 專案進行漸進式 Null 安全性移轉
• 主控私人 Dart 套件存放庫
• 針對分析問題的快速修正

此區段列出從 2021 年 12 月 8 日到 2022 年 2 月 3 日之間進行的顯著變更。如需 2.16 版本的詳細資訊，請參閱 Dart 2.16：改善工具和平台處理。

我們 更新網站基礎架構 至基於 Docker 的設定，以利 更輕鬆地進行貢獻，並更緊密地與 docs.flutter.dev 的設定保持一致。

除了其他錯誤修正和逐步改善之外，我們對此網站進行了以下變更

• 切換至記錄新的 dart doc 工具，取代 dartdoc。
• 記錄新的 platform 項目，以指定套件 pubspec.yaml 中支援的平台。
• 更新 診斷訊息 和 linter 規則 頁面。
• 記錄如何 忽略檔案中的所有 linter 規則。
• 從 Dart SDK 概觀 中移除對舊獨立工具的提及。
• 將舊獨立工具的剩餘提及更新為其 dart 工具等效項。
• 針對 優先使用內插來組合字串和值 Effective Dart 指南加入說明。

此區段列出從 2021 年 9 月 9 日到 2021 年 12 月 8 日之間進行的顯著變更。如需 2.15 版本的詳細資訊，請參閱 宣布 Dart 2.15。

除了修正錯誤和逐步改善之外，我們對此網站進行了以下變更

• 加入 Dart 中的並行處理，討論可讓 Dart 程式碼平行執行的功能，例如 isolate。
• 記錄 2.15 中加入或改善的 pub 功能
  • 加入一個新的 pub 子指令 dart pub token 的頁面，以及一個關於 自訂套件存放庫 的頁面
  • 新增關於 套件收回 的資訊
  • 在 pubspec 頁面新增 false_secrets 欄位
  • 更新 託管相依項 的語法
• 移除所有 Dart 1 書籍 的項目
• 擴充 DartPad 疑難排解提示
• 更新 診斷訊息 頁面
• 更新 linter 規則 頁面；移除對已棄用規則集（例如 effective_dart）的參照
• 更新安裝和使用 Dart DevTools 的說明
• 新增關於 Dart 執行時期 提供的資訊，並釐清 編譯格式

此區段列出 2021 年 5 月 20 日至 2021 年 9 月 8 日期間進行的重大變更。有關 2.14 版的詳細資訊，請參閱 宣布 Dart 2.14。

除了修正錯誤和逐步改善之外，我們對此網站進行了以下變更

• 充實 修正型別提升失敗 的頁面。
• 記錄如何使用 .pubignore 檔案，這是 Dart 2.14 中引入的功能。
• 新增 無符號位移運算子 (>>>) 的說明，這是 Dart 2.14 中引入的。
• 建立 linter 規則頁面；更新 Effective Dart 以連結到該頁面。
• 新增 dart create 和 dart test 指令的頁面。
• 完成將範例從使用舊命令列工具（例如 dartfmt）轉換為使用 統一的 dart 工具（例如 dart format）的作業。
• 更新網站程式碼以使用 建議的 linter 規則，而非 pedantic。
• 更新 核心函式庫 和 常用套件 的清單。
• 新增從 dart.dev/jobs 到 flutter.dev/jobs 的重新導向，以方便在 Dart 和 Flutter 團隊中尋找職缺。
• 完成將所有分析或測試的程式碼移轉到 null 安全，並更新文字以符合。找到更多尚未分析的網站程式碼；已修正。

我們在 Dart 部落格上發布了以下文章

• 嘗試使用 Dart 和 Wasm
• Dart 的 null 安全如何幫助我擴充專案
• 在 Dart FFI 中以值實作結構

本節列出 2021 年 3 月 4 日至 2021 年 5 月 19 日期間所做的重大變更。有關 2.13 版本的詳細資訊，請參閱 宣布 Dart 2.13。

除了修正錯誤和逐步改善之外，我們對此網站進行了以下變更

• 更新語言導覽的 typedef 區段，以反映在 Dart 2.13 中導入的非函式類型別名。
• 發布或更新與命令列和伺服器相關的文件
  • 使用 Google Cloud 說明 Dart 伺服器可以使用（通常透過預先封裝的 Docker 映像）的 Google Cloud 產品。
  • HTTP 伺服器教學課程（特色為已停用的 http_server 套件）已暫時替換為「施工中」頁面，該頁面會連結到有用的文件和範例。
  • 命令列教學課程 已完全更新。
• 發布一些其他新頁面
  • Null 安全程式碼實驗室，教導您有關 Dart 在 Dart 2.12 中導入的 Null 安全類型系統的知識。
  • Dart 中的數字 詳細說明原生和網路數字實作之間的差異。
  • 使用 Google API 指出資源，以協助您從 Dart 應用程式使用 Firebase 和 Google 客戶端 API。
  • 撰寫套件頁面 提供撰寫在 pub.dev 上運作良好的套件 README 的秘訣。
  • 修正類型提升失敗 提供資訊，以協助您了解類型提升失敗發生的原因，並提供修正方法的秘訣。
  • 新的 dart run 頁面 說明如何從命令列執行 Dart 程式。
• 持續進行將程式碼移轉至 Null 安全的工作，特別是 串流教學課程。
• 進行其他雜項更新
  • 移除 Stagehand 的參考，改用 dart create。
  • 將 dart.dev 範例程式碼的分析選項從使用 pedantic 變更為使用 lints 中建議的規則。
  • 新增 Docker 作為 取得 Dart 的方式。
  • 更新 語言演進頁面，以反映 Dart 2.13。

我們在 Dart 部落格上發布了以下文章

• AngularDart、Flutter 和網路：春季更新
• 宣布 Dart 支援 GitHub Actions
• Dart 在 2021 年 Google Summer of Code

此區段列出從 2020 年 10 月 2 日到 2021 年 3 月 3 日之間所做的重大變更。有關 2.12 版本的詳細資訊，請參閱 宣佈 Dart 2.12。

除了修正錯誤和逐步改善之外，我們對此網站進行了以下變更

• 更新並充實 null 安全文件。特別是
  • 提供 遷移指南。
  • 新增 常見問題。
  • 建立 不健全的 null 安全性。
  • 簡化 null 安全性首頁。
• 更新 有效的 Dart，將程式碼更新為 null 安全，並變更規則以反映新的指南。
• 更新 語言導覽，將程式碼更新為 null 安全，並新增有關新功能的資訊，例如 late 變數。
• 更新 語言演進頁面，以新增有關語言版本控制的資訊，並反映 Dart 2.12。
• 更新 函式庫導覽 和 程式碼實驗室，以反映健全的 null 安全性。
• 更新網站上的頁面，使用 dart 工具，而不是已棄用的命令。開始新增各種 dart 命令的頁面，包括 dart analyze、dart compile、dart fix 和 dart format。
• 建立一個頁面，說明 Dart 團隊套件 的品質和支援。
• 用新的 概觀頁面 取代平台頁面。
• 建立此頁面（「新增功能」）。

我們也從 Travis CI 切換到 GitHub Actions，並進行多項 CSS 變更，以改善網站的可讀性。

我們在 Dart 部落格上發布了以下文章

• 為 Dart 和 Flutter 生態系準備 null 安全性 宣佈 null 安全性 API 穩定性，並邀請開發人員發佈套件的穩定 null 安全版本。
• Dart 和健全類型的效能優勢 說明健全性和 null 安全性如何讓 Dart 編譯器產生更快速、更小的程式碼。
• 為什麼會有可為 null 的類型？ 擴充了 /r/dart_lang 子版塊上的討論，回答「為什麼不完全移除 null？」的問題。
• 宣佈 Dart null 安全性 beta 版 邀請開發人員開始規劃他們對 null 安全性的遷移。

此區段列出從 2020 年 7 月 1 日到 10 月 1 日之間所做的重大變更。有關 2.10 版本的詳細資訊，請參閱 宣佈 Dart 2.10。