目錄

dart pub

pub 套件管理器具有命令列介面,可與 flutter 工具dart 工具搭配使用。使用任一工具時,請新增 pub 命令,後接 get 等子命令。

$ dart pub get    # Gets dependencies for a non-Flutter package
$ flutter pub get # Gets dependencies for a Flutter package

本網站的範例使用 dart pub <子命令>,但如果目前的目錄包含 Flutter 應用程式或其他 Flutter 特定程式碼,請改用 flutter pub <子命令>。如需詳細資訊,請參閱 Flutter 網站上的使用套件

如果您在使用 pub 工具時遇到問題,請參閱Pub 除錯

子命令清單

#

以下每個 pub 子命令都有詳細的文件

子命令概觀

#

Pub 的子命令可分為以下幾類

管理套件相依性

#

Pub 提供許多子命令,用於管理您的程式碼所相依的套件

在此群組中,最常用的子命令是 getupgrade,它們會擷取或升級套件使用的相依性。每次修改 pubspec 檔案時,請執行 dart pub getflutter pub get,以確保相依性為最新版本。某些 IDE 會在建立專案或修改 pubspec 時自動執行此步驟。

cache
管理 pub 的本機套件快取。使用此子命令將套件新增至快取,或對快取中的所有套件執行清除重新安裝。
deps
列出目前套件使用的所有相依性。
downgrade
擷取目前套件使用的相依性中列出的所有套件的最低版本。用於測試套件相依性的下限範圍。
get
擷取目前套件的相依性中列出的套件。如果已存在 pubspec.lock 檔案,則會擷取鎖定檔案中列出的每個相依性版本(如果可以)。視需要建立或更新鎖定檔案。
outdated
檢查目前套件相依的所有套件,判斷哪些套件相依性已過期,並提供如何更新這些套件的建議。當您想要更新套件相依性時,請使用此子命令。
upgrade
擷取目前套件使用的相依性中列出的每個套件的最新版本。如果存在 pubspec.lock 檔案,則會忽略鎖定檔案中列出的版本,並擷取符合 pubspec 中條件約束的最新版本。視需要建立或更新鎖定檔案。

執行命令列應用程式

#

global 子命令可讓您讓套件全域可用,因此您可以從該套件的 bin 目錄執行指令碼。若要執行全域可用的指令碼,您必須將系統快取 bin 目錄新增至您的路徑

部署套件和應用程式

#

使用 pub,您可以發布套件和命令列應用程式。

套件

#

若要與全世界分享您的 Dart 套件,您可以使用publish 子命令將套件上傳至 pub.dev 網站。如需允許其他使用者修改和上傳新版本套件的資訊,請參閱上傳者

命令列應用程式

#

對於包含指令碼的任何套件(bin/ 目錄下的所有內容),請考慮將 executables 標籤新增至 pubspec 檔案。當指令碼列在 executables 下時,使用者可以執行 dart pub global activate,使其可直接從命令列使用。

全域選項

#

數個命令列選項適用於所有 pub 子命令。其中包括

--help-h

#

列印使用資訊。

--trace

#

發生錯誤時列印偵錯資訊。

--verbose-v

#

相當於 --verbosity=all

--directory=<dir>-C <dir>

#

在指定的目錄中執行命令。

--[no-]color

#

為輸出新增色彩以強調 (--color)。預設值取決於您是否在終端機中使用此命令。在終端機中,--color 為預設值,否則 --no-color 為預設值。使用 --no-color 在所有環境中停用色彩。