首先打开终端:(红色字体为输入字体,蓝色字体为系统输出字体)
Last login: Mon Jun 8 10:40:28 on ttys000
houjianengdeMBP:~ houjianpeng$ sudo gem install fir-cli --no-ri --no-rdoc
接着输入电脑密码:Password:
Fetching: thor-0.19.1.gem (100%)
Successfully installed thor-0.19.1
Fetching: CFPropertyList-2.3.1.gem (100%)
Successfully installed CFPropertyList-2.3.1
Fetching: unf_ext-0.0.7.1.gem (100%)
Building native extensions. This could take a while...
Successfully installed unf_ext-0.0.7.1
Fetching: unf-0.1.4.gem (100%)
Successfully installed unf-0.1.4
Fetching: domain_name-0.5.24.gem (100%)
Successfully installed domain_name-0.5.24
Fetching: http-cookie-1.0.2.gem (100%)
Successfully installed http-cookie-1.0.2
Fetching: mime-types-2.6.1.gem (100%)
Successfully installed mime-types-2.6.1
Fetching: rest-client-1.8.0.gem (100%)
Successfully installed rest-client-1.8.0
Fetching: rubyzip-1.1.7.gem (100%)
Successfully installed rubyzip-1.1.7
Fetching: ruby_android-0.7.7.gem (100%)
Successfully installed ruby_android-0.7.7
Fetching: fir-cli-1.0.8.gem (100%)
______________ ________ ____
/ ____/ _/ __ \ / ____/ / / _/
/ /_ / // /_/ /_____/ / / / / /
/ __/ _/ // _, _/_____/ /___/ /____/ /
/_/ /___/_/ |_| \____/_____/___/
## 更新记录
### FIR-CLI 1.0
- 重大重构
- 优化启动及运行速度
- 增加各指令的 alias
- 增加全局参数, -T, -L, -V, -q, -h, 分别为 token, log, verbose, quite, help 参数
- 增加输出 log
- 修正部分系统安装失败问题
- 修正部分服务器安装出现编码失败问题
- 修正 ipa 路径带有空格解析失败的 bug
- 重写 ipa 解析器, 去除 `miniz.c`, 增加 pngcrash
- 上传 ipa 时, 优先取 `display_name` 作为应用名称
- build_ipa 增加默认 build 路径, `fir b` 则默认 build 当前路径
- build_ipa 增加输出 dSYM 符号表文件
- build_ipa 增加输出指定 ipa 名称
- build_ipa 增加输出 xcodebuild 的信息
- 去掉输出信息颜色, 方便查看 log
- 简化 --verbose 参数, 简化为 `--verbose --no-verbose`, 默认输出为 INFO
- https://github.com/FIRHQ/fir-cli
Successfully installed fir-cli-1.0.8
11 gems installed
然后输入 fir
houjianengdeMBP:~ houjianpeng$ fir
Commands:
fir build_ipa BUILD_DIR [options] [settings] # Build iOS app (alias: 'b').
fir help # Describe available commands...
fir info APP_FILE_PATH # Show iOS/Android app's info...
fir login # Login FIR.im (aliases: 'l').
fir publish APP_FILE_PATH # Publish iOS/Android app to ...
fir upgrade # Upgrade FIR-CLI and quit (a...
fir version # Show FIR-CLI version number...
Options:
-T, [--token=TOKEN] # User's token at FIR.im
-L, [--logfile=LOGFILE] # Path to writable logfile
-V, [--verbose], [--no-verbose] # Show verbose
# Default: true
-q, [--quiet], [--no-quiet] # Silence commands
-h, [--help], [--no-help] # Show this help message and quit
houjianengdeMBP:~ houjianpeng$
参数说明
alias <short command> 意味着可以用 alias 别名来代替该指令, 例如 fir b
-T 用户在 FIR.im 上的 token, publish 需要使用此参数
-L 指定 FIR-CLI 的输出 log, 默认为 STDOUT
-V Verbose, 默认为输出所有信息( INFO 和 ERROR), 如果设置 --no-verbose, 则只输出 ERROR 信息
-q 静默模式, 默认关闭
-h 查看帮助
发布一个应用
输入下面的指令便可轻松发布应用, 支持 ipa 和 apk 文件
houjianengdeMBP:~ houjianpeng$ fir p path/to/application -T YOUR_FIR_TOKEN(需要修改自己的TOKEN)
如果在此之前, 已经使用 fir login 命令登录过, 则可省略 -T 参数
> I, [2015-02-28T23:14:40.312010 #36861] INFO -- : Publishing app.......
> I, [2015-02-28T23:14:45.312000 #36861] INFO -- : ✈ -------------------------------------------- ✈
> I, [2015-02-28T23:14:48.311900 #36861] INFO -- : Converting app's icon......
> I, [2015-02-28T23:14:48.311900 #36861] INFO -- : Uploading app's icon......
> I, [2015-02-28T23:14:48.311900 #36861] INFO -- : Uploading app......
> ..........
> I, [2015-02-28T23:14:46.312000 #36861] INFO -- : ✈ -------------------------------------------- ✈
> I, [2015-02-28T23:14:48.311900 #36861] INFO -- : Published succeed: http://fir.im/xxx
方便一点
如果觉得每次都输入 -T 很不方便, 那么可使用 login 命令
$ fir l
这时系统会提示输入用户 token, 用户 token 可在这里查看
> Please enter your FIR.im token: > I, [2015-03-01T18:26:42.718715 #38624] INFO -- : Login succeed, current user's email: xxx@fir.im
编译并获得 ipa
该指令 build_ipa 对 xcodebuild 原生指令进行了封装, 将常用的参数名简化, 支持全部的自带参数及设置, 同时输出符号表 .dSYM 文件.
$ fir build_ipa path/to/project -o path/to/output
> I, [2015-02-28T23:14:33.501293 #36861] INFO -- : Building......
> I, [2015-02-28T23:14:33.501400 #36861] INFO -- : ✈ -------------------------------------------- ✈
> I, [2015-02-28T23:14:38.311632 #36861] INFO -- : Build settings from command line:
> ..........
> I, [2015-02-28T23:14:38.312012 #36861] INFO -- : Build Success
复杂一点
$ fir b path/to/workspace -o path/to/output -w -C Release -t allTargets GCC_PREPROCESSOR_DEFINITIONS="FOO=bar"
该指令在指向的目录中,找到第一个 workspace 文件,对其进行编译。使用 Release 设置,编译策略为 allTargets,同时设置了预编译参数 FOO。
一步, 从源代码到 FIR.im
只需要输入 -p -T
$ fir build_ipa path/to/project -o path/to/output -p -T YOUR_FIR_TOKEN
> I, [2015-02-28T23:14:33.501293 #36861] INFO -- : Building......
> I, [2015-02-28T23:14:33.501400 #36861] INFO -- : ✈ -------------------------------------------- ✈
> I, [2015-02-28T23:14:38.311632 #36861] INFO -- : Build settings from command line:
> ..........
> I, [2015-02-28T23:14:38.312012 #36861] INFO -- : Build Success
> I, [2015-02-28T23:14:40.312010 #36861] INFO -- : Publishing app.......
> I, [2015-02-28T23:14:45.312000 #36861] INFO -- : ✈ -------------------------------------------- ✈
> ..........
> I, [2015-02-28T23:14:46.312000 #36861] INFO -- : ✈ -------------------------------------------- ✈
> I, [2015-02-28T23:14:48.311900 #36861] INFO -- : Published succeed: http://fir.im/xxx
需要帮助?
输入以下指令获取全面功能介绍
$ fir -h
$ fir publish -h
下面的指令会自动更新 FIR-CLI
$ fir upgrade
随时更新以使用最新功能