点击应用工具带
click-toolbelt的Python项目详细描述
可用命令
登录
上传点击包需要开发者提交 非统组织签署的请求。为此,请先单击“工具带需要” 获取OAuth令牌。为此,用户可以运行 下面(注意:请确保在命令前面加上一个空格,以便 您的命令历史记录不会保存敏感命令)。
$ click-toolbelt login <email> <password> [otp]
成功执行时,此命令将存储OAuth凭据 在$HOME/.config/click-toolbelt/click.cfg中,并将在 上传步骤。
上传
一旦用户成功登录,他就可以上传 点击包。为此,用户可以运行
$ click-toolbelt upload <binary_file> [--metadata <metadata_file>]
要使此命令成功,必须满足某些条件:
- 用户必须已经登录(请参见Login)
- 二进制文件必须是有效的单击包
metadata_file参数应该引用包含json文档的文件。如果提供了这个文件, 它将用于提取未在click包的清单中提供的额外信息。
上载初始包时,可以从metadata_file中提取以下字段:
- 标语:应用程序的单行摘要
- 部门:应用程序的类别名称(请参见Department)
- 频道:上传目标频道名称(参见Channel)。如果省略,则假定“稳定”。
- 支持URL:用户可以转到的URL来支持此应用程序。允许http(s):和mailto:schemes
- 许可证:发布应用程序的许可证(请参见License)
- icon_256(或icon):要作为应用程序图标上载的本地文件的路径;图标的大小必须为256x256 px
- name:application name(覆盖click package manifest中定义的内容)
- description:应用程序说明(覆盖click package manifest中定义的内容)
- changelog:自上次上载以来包含的更改的说明
- 屏幕截图:要作为应用程序屏幕截图上载到本地文件的路径列表
- 黑名单id:防止应用程序分发到的国家代码列表(请参见Country)
- 白名单id:限制应用程序分发到的国家代码列表(请参见Country)
- 自动发布:自动提交以供审阅
- 审阅者注释:审阅者在审阅应用程序提交时使用的注释
对于新版本的上载,将只扫描metadata_file文件的以下字段:
- 频道:上传目标频道名称(参见Channel)。如果省略,则假定“稳定”。
- changelog:自上次上载以来包含的更改的说明
信息
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调用)获得有效值。
示例
- “Accessories”
- “Games”
- “Card Games”
许可证
可以通过info命令(或其等效的api调用)获得有效值。
示例
- “Proprietary”
- “GNU GPL v3”
- “BSD License (Simplified)”
国家
可以通过info命令(或其等效的api调用)获得有效值。
示例
- “AR” (Argentina)
- “BR” (Brazil)
- “GB” (United Kingdom)
- “US” (United States)
- “UY” (Uruguay)
通道
可以通过info命令(或其等效的api调用)获得有效值。
示例
- “stable”
- “proposed”
- “alpha”