FIR.im 命令行工具

FIR.im CLI

FIR.im CLI 可以通过指令查看、上传、编译应用。

使用说明

从安装入手

FIR.im CLI 使用 ruby 构建，只要安装相应 ruby gem 即可：

$ gem install fir-cli


安装后，你可以在命令行执行指令

$ fir
> 欢迎使用 FIR.im 命令行工具，如需帮助请输入: fir help
Commands:
  fir batpub FOLDER_1, FOLDER_2, ...    # 批量上传指定文件夹中的全部文件
  fir batres FOLDER_1, FOLDER_2, ...    # 批量上传指定文件夹中的全部文件
  fir config                            # 配置全局设置
  fir help [COMMAND]                    # Describe available commands or one specific command
  fir info APP_FILE_PATH                # 获取应用文件的信息（支持 ipa 文件和 apk 文件）
  fir login                             # 登录
  fir publish APP_FILE_PATH             # 将应用文件发布至 FIR.im（支持 ipa 文件和 apk 文件）
  fir upgrade all fir-cli toolbelts     # 更新 fir-cli 的所有组件

发布一个应用

输入下面的指令便可轻松发布应用

$ fir publish 应用路径

这时系统会提示输入用户 token

> 欢迎使用 FIR.im 命令行工具，如需帮助请输入: fir help
> 正在解析 ipa 文件...
> 正在获取 [email protected] 的应用信息...
请输入用户 token：

输入用户 token 后，系统会自动上传

请输入用户 token：xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
> 上传应用...
> 上传应用成功
> 正在更新 fir 的应用信息...
> 更新成功
> 正在更新 fir 的应用版本信息...
> 更新成功
> http://fir.im/xxxxx

用户 token 可在这里查看

方便一点

如果觉得每次都输入用户 token 很不方便，那么可使用登录命令

$ fir login

这时系统会提示输入用户 token

> 欢迎使用 FIR.im 命令行工具，如需帮助请输入: fir help
输入你的用户 token：

输入用户 token，系统会自动获取你的用户 email

输入你的用户 token：xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
> 设置用户邮件地址为: [email protected]
> 当前登陆用户为：xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

需要帮助？

输入以下指令获取全面功能介绍

$ fir help

如果还有疑问随时发邮件至fir-cli

永远使用最新功能

下面的指令会自动更新 fir-cli 及所有扩展命令至最新状态

$ fir upgrade

随时更新以使用最新功能

指令文档

帮助

以下指令用于获取帮助

fir help

以下指令用于获取更具体的帮助

• COMMAND：具体的一个指令，如publish，update

fir help COMMAND

登录

以下指令用于登录，登录后系统会从 FIR.im 自动获取你的邮件等信息。已登录用户在这里可以找到自己的用户 token。

fir login

获取应用文件的信息

以下指令用于显示应用信息，支持 ipa 和 apk 文件。

• -a：可选，现实全部信息
• -f：可选，显示托管在 FIR.im 的信息
• -v：可选，设置输出级别，级别分为三个：v、vv、vvv，默认为vv
• -q：可选，安静模式，不输出任何信息 fir info APP_FILE_PATH [-a] [-f] [-v v|vv|vvv] [-q]

设置全局信息

以下指令用于全局设置。执行指令时如果不指明相应选项，会读取全局设置。

• -v：可选，如果设置了全局输出级别，各指令都采用该级别输出
• -q：可选，如果设置了全局静默模式，各指令均不输出辅助信息
• -t TOKEN：可选，设置登录用户的令牌（作用和fir loging USER_TOKEN一样） fir config [-v v|vv|vvv] [-q] [-t TOKEN]

发布应用至 FIR.im

以下指令用于发布应用到 FIR.im，支持 ipa 和 apk 文件。

• -s SHORT：可选，指定发布应用的短地址
• -t USER_TOKEN：可选，设定发布应用的帐号，未设置则使用全局设置
• -c CHANGE_LOG：可选，设置更新日志 fir publish APP_FILE_PATH [-s SHORT] [-t USER_TOKEN] [-c CHANGE_LOG]

更新全部指令

以下指令用于更新已安装的 fir-cli 指令集

fir upgrade