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 提供許多子命令,用於管理您的程式碼所相依的套件。
在此群組中,最常用的子命令是 get
和 upgrade
,它們會擷取或升級套件使用的相依性。每次修改 pubspec 檔案時,請執行 dart pub get
或 flutter 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
在所有環境中停用色彩。
除非另有說明,否則本網站上的文件反映的是 Dart 3.6.0。頁面上次更新時間為 2024-11-18。 檢視原始碼 或 回報問題。