跳到主內容

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 <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=<目錄>-C <目錄>

#

在指定目錄中執行命令。

--[no-]color

#

為輸出新增顏色以突出顯示 (--color)。預設設定取決於您是否在終端中使用此命令。在終端中,預設值為 --color,否則,預設值為 --no-color。使用 --no-color 可在所有環境中停用顏色。