內容

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 <subcommand>,但如果您的目前目錄包含 Flutter 應用程式或其他 Flutter 專屬程式碼,請改用 flutter pub <subcommand>。如需詳細資訊,請參閱 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 在所有環境中停用顏色。