【文章內容使用 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 網站的分析標籤頁,使程式碼分析結果更易於閱讀。首先,在分析頁面的頂部,我們加入了進度條,讓您可以快速查看套件的狀態:
進度條下方是詳細的分析結果,按嚴重程度分組:錯誤(紅色圖示)、警告(黃色圖示)和建議問題(藍色圖示),如下圖所示:
更新的分析評分
我們還對分析評分進行了一些調整。如果符合以下任何條件,我們現在會降低套件的評分:
- 套件未通過 Dart 2 分析。
- SDK 約束上限不小於 <3.0.0。
- API 參考生成(dartdoc)失敗。
對於我們的下一個 Pub 網站版本,我們預計將進一步完善評分,並加入一些關於評分計算方式的文件。
搜尋套件的 API 介面
搜尋是 Pub 網站上最受歡迎的功能——這並不奇怪。在過去的幾個季度中,我們在這一領域進行了許多改進,重點是加入平台過濾器和更好的排名。新版本擴展了搜尋功能,支援搜尋套件的 API 介面。除了目前對套件描述和 README.md 內容的搜尋索引外,搜尋現在還涵蓋了套件的所有公共 API 成員,以及這些成員的 API 文件!當您想要找到描述和 README.md 檔案中未提及的內容時,這非常棒。
例如,假設您正在尋找一個可以使用 ISO 4217 貨幣格式格式化字串的套件。在描述和 README.md 檔案中搜尋會給您一個結果,但包含 API 文件的搜尋會給您幾個結果:
1 | 4217 的 10 個結果 |
總結…
Dart 2 穩定頻道版本即將發佈,我們已經對 Pub 網站進行了一系列與 Dart 2、排名和搜尋相關的改進。
如果您已經發佈了套件,現在 是時候更新它們以適應 Dart 2 了:
- 確保您的套件通過 Dart 2 分析。
- 在 pubspec.yaml 中將 SDK 約束上限更新為 <3.0.0。
- 重新發佈您更新的套件。
然後前往您在 pub.dartlang.org 上的套件分析頁面,看看您還可以做些什麼來提高您的排名!
準備迎接 Dart 2,並讓您的套件在 Pub 網站上看起來更棒! 最初發佈在 Dart 上的 Medium,人們在那裡透過突出顯示和回應這個故事來繼續討論。