0%

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

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

準備迎接 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 上的套件分析頁面,看看您還可以做些什麼來提高您的排名!


準備迎接 Dart 2,並讓您的套件在 Pub 網站上看起來更棒! 最初發佈在 Dart 上的 Medium,人們在那裡透過突出顯示和回應這個故事來繼續討論。

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