click-toolbelt 0.5.1

登录

上传click包需要开发者提交一个经过oauth签名的请求。为此，click-toolbelt需要首先获取一个oauth令牌。为此，用户可以运行以下命令（注意：请确保在命令前加上空格，以便您的命令历史记录不会保存敏感命令）。

$   click-toolbelt login <email> <password> [otp]

执行成功后，此命令将存储oauth凭据在$HOME/.config/click-toolbelt/click.cfg，并在上传步骤中使用它。

上传

一旦用户成功登录，他就可以上传click包。为此，用户可以运行以下命令

$ click-toolbelt upload <binary_file> [--metadata <metadata_file>]

为了使此命令成功，必须满足某些条件

• 用户必须已经登录（见登录）

• 二进制文件必须是一个有效的click包

• 用户拥有他上传click包的应用程序（如果该应用程序已存在）

“metadata_file”参数应指向一个包含json文档的文件。如果提供了此文件，它将用于提取click包的manifest中没有提供的信息。

在上传初始包时，以下字段可能从“metadata_file”中提取

• 标语：应用的一行总结

• 部门：应用的类别名称（见部门）

• 频道：上传目标频道名称（见频道）。如果省略，则假定是“stable”。

• 支持_url：用户可以访问以获取此应用支持的一个URL。允许http(s):和mailto:方案

• 许可证：应用将发布的许可证（见许可证）

• icon_256（或icon）：上传为应用图标的本地图标文件的路径；图标大小必须是256x256 px

• 名称：应用名称（覆盖click包manifest中定义的内容）

• 描述：应用描述（覆盖click包manifest中定义的内容）

• 更改日志：自上次上传以来包含的更改的描述

• 截图：上传为应用截图的本地图标文件路径列表

• blacklist_ids：阻止应用分发的国家代码列表（见国家）

• whitelist_ids：限制应用分发的国家代码列表（见国家）

• auto_publish：自动提交审核

• reviewer_notes：审核人员审核应用提交时使用的注释

对于新版本上传，只有以下字段会被“metadata_file”文件扫描

• 频道：上传目标频道名称（见频道）。如果省略，则假定是“stable”。

• 更改日志：自上次上传以来包含的更改的描述

信息

“info”命令将返回有关当前可用API的元数据。要检索此数据，用户可以运行以下命令

$ click-toolbelt info

这将显示有关API的所有可用信息。或者，用户可以仅检索数据子集。

获取当前API版本

$ click-toolbelt info version

获取有效许可证值的列表

$ click-toolbelt info license

获取有效国家的列表

$ click-toolbelt info country

获取有效频道的列表

$ click-toolbelt info channel

获取有效部门的列表

$ click-toolbelt info department

部门

可以通过“info”命令（或其等效的API调用）获取有效值。

许可证

可以通过“info”命令（或其等效的API调用）获取有效值。

国家

可以通过“info”命令（或其等效的API调用）获取有效值。

频道

可以通过“info”命令（或其等效的API调用）获取有效值。