【文章翻譯】Getting ready for Dart 2, and making your packages look great on the Pub site!

發表於 更新於 分類於

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

原文：https://medium.com/dartlang/getting-ready-for-dart-2-and-making-your-packages-look-great-on-the-pub-site-118464d7f59d

準備迎接 Dart 2，並讓您的套件在 Pub 網站上看起來更棒！

我們發佈了 Dart 套件庫 Pub 的新版本！這次我們專注於為 Dart 2 穩定版發佈做準備。

將您的套件遷移到 Dart 2

我們預計 Dart 2 版本將在不久的將來升級到穩定版！因此，至關重要的是您要遷移您的程式碼——尤其是您已發佈的任何套件——以使其與 Dart 2 相容。這主要有三個方面：

  • 確保您的程式碼通過 Dart 2 分析（詳情）。我們建議您也要注意提示——例如，為棄用做準備。
  • 運行程式碼測試，以確保您的程式碼通過 Dart 2 運行程式碼檢查（詳情）。
  • 將套件的 SDK 約束上限更新為 <3.0.0（詳情）。

我們強烈建議所有套件作者完成這項工作，我們也將在接下來的幾天內努力完成我們擁有的套件。

Pub 網站上改進的分析介面

為了幫助您進行遷移，我們更新了 Pub 網站的分析標籤頁，使程式碼分析結果更易於閱讀。首先，在分析頁面的頂部，我們加入了進度條，讓您可以快速查看套件的狀態：

Pub 網站上顯示的套件評分

進度條下方是詳細的分析結果，按嚴重程度分組：錯誤（紅色圖示）、警告（黃色圖示）和建議問題（藍色圖示），如下圖所示：

Pub 網站上顯示的分析問題

更新的分析評分

我們還對分析評分進行了一些調整。如果符合以下任何條件，我們現在會降低套件的評分：

  • 套件未通過 Dart 2 分析。
  • SDK 約束上限不小於 <3.0.0。
  • API 參考生成（dartdoc）失敗。

對於我們的下一個 Pub 網站版本，我們預計將進一步完善評分，並加入一些關於評分計算方式的文件。

搜尋套件的 API 介面

搜尋是 Pub 網站上最受歡迎的功能——這並不奇怪。在過去的幾個季度中，我們在這一領域進行了許多改進，重點是加入平台過濾器和更好的排名。新版本擴展了搜尋功能，支援搜尋套件的 API 介面。除了目前對套件描述和 README.md 內容的搜尋索引外，搜尋現在還涵蓋了套件的所有公共 API 成員，以及這些成員的 API 文件！當您想要找到描述和 README.md 檔案中未提及的內容時，這非常棒。

例如，假設您正在尋找一個可以使用 ISO 4217 貨幣格式格式化字串的套件。在描述和 README.md 檔案中搜尋會給您一個結果，但包含 API 文件的搜尋會給您幾個結果：

1
2
3
4
5
6
7
8
9
10
11
12
13
4217 的 10 個結果

intl
包含處理國際化/本地化訊息、日期和數字格式化和解析、雙向文字和其他國際化問題的程式碼。
v 0.15.2 • 更新時間：2017 年 10 月 19 日 FLUTTER WEB OTHER
API 結果：
intl/NumberFormat-class.html

flutter_billing
一個 flutter plugin，用於與 iOS 和 Android 上的計費系統進行通訊。
v 0.1.2 • 更新時間：2018 年 2 月 10 日 FLUTTER
API 結果：
flutter_billing/BillingProduct-class.html

總結…

Dart 2 穩定頻道版本即將發佈，我們已經對 Pub 網站進行了一系列與 Dart 2、排名和搜尋相關的改進。

如果您已經發佈了套件，現在 是時候更新它們以適應 Dart 2 了：

  1. 確保您的套件通過 Dart 2 分析。
  2. 在 pubspec.yaml 中將 SDK 約束上限更新為 <3.0.0。
  3. 重新發佈您更新的套件。

然後前往您在 pub.dartlang.org 上的套件分析頁面，看看您還可以做些什麼來提高您的排名！

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