dart pub token

dart pub token 子命令管理令牌存储。当发布包和检索依赖项时，dart pub 命令使用令牌向第三方服务器进行身份验证。

它将这些令牌存储在用户级配置目录中。dart pub token 子命令有三个子命令：add、list 和 remove。

dart pub 命令认为术语凭据、令牌、密钥和密钥令牌是可互换的。

考虑这样一种场景：您在私有仓库上托管了一个依赖项。当您使用 dart pub get 命令时，它可能会返回提示以提供凭据

$ dart pub get
Resolving dependencies... 
https://some-package-repo.com/my-org/my-repo package repository requested authentication!
You can provide credentials using:
    dart pub token add https://some-package-repo.com/my-org/my-repo

一些（但不是全部）服务器还会返回包含有关如何获取令牌的说明的消息。

要创建新凭据，请使用 dart pub token add 命令。

在提示符下，在命令行 (stdin) 上键入凭据。

$ dart pub token add https://some-package-repo.com/my-org/my-repo
Enter secret token: <Type token on stdin>
 Requests to "https://some-package-repo.com/my-org/my-repo" will now be 
 authenticated using the secret token.

要为任何和所有终端会话以及脚本使用相同的令牌，请将令牌存储在环境变量中。

1. 将您的令牌存储在环境变量中。

   确保从 shell 历史记录中隐藏令牌。要探索一种执行此操作的方法，请查阅 Medium 上的这篇文章。

2. 要启用您添加的任何环境变量，请重启任何打开的控制台。

3. 要使用环境变量作为令牌，请使用 dart pub token add 命令

   $ dart pub token add <hosted-url> --env-var <TOKEN_VAR>

   此命令读取存储在 $TOKEN_VAR 中的令牌，然后使用它向托管所需包的 hosted-url 进行身份验证。它应该在终端中打印以下响应。

   $ dart pub token add https://other-package-repo.com/ --env-var TOKEN_VAR
   Requests to "https://other-package-repo.com/" will now be authenticated using the secret token stored in the environment variable "TOKEN_VAR".

大多数 CI 环境可以将令牌注入到环境变量中。要了解如何操作，请查阅 GitHub Actions 或 GitLab 的文档作为示例。

要查看所有活动凭据的列表，请使用 dart pub token list 命令

$ dart pub token list
You have secret tokens for 2 package repositories:
https://some-package-repo.com/my-org/my-repo
https://other-package-repo.com/

要删除单个令牌，请使用 dart pub token remove 命令

$ dart pub token remove https://other-package-repo.com
Removed secret token for package repository: https://other-package-repo.com

要删除所有令牌，请将前面的命令与 remove --all 选项一起使用

$ dart pub token remove --all
pub-tokens.json is deleted.
Removed 1 secret tokens.

除非另有说明，否则本网站上的文档反映了 Dart 3.7.1 版本。页面上次更新于 2024-05-21。 查看源代码 或 报告问题。