fir-cli 使用指南

fir-cli 使用指南

fir-clifir.im(betaqr.com) command-line interface项目地址:https://gitcode.com/gh_mirrors/fi/fir-cli

---

项目介绍

fir-cli 是一个便捷的命令行工具，用于帮助开发者快速地将 iOS 应用上传到 FIRe 平台进行内测分发。该工具简化了上传流程，使得开发团队能够高效地分享应用的测试版本给测试者，无需频繁地操作网页端。它由 PGYER 开源维护，支持自动化集成到持续集成/持续部署（CI/CD）中，是 iOS 开发者的得力助手。

项目快速启动

安装 fir-cli

首先，确保你的系统已经安装了 Node.js。然后，可以通过 npm 全局安装 fir-cli：

npm install -g fir-cli

使用 fir-cli 上传应用

在成功安装 fir-cli 后，你需要准备你的 .ipa 文件。接着，使用以下命令上传应用至 FIRe 平台：

fir upload your-app.ipa -T "你的API Token"

替换 your-app.ipa 为你的 IPA 文件路径，以及 -T 后的字符串为你的 FIRe API Token，该Token可以在FIRe的个人设置中获取。

应用案例和最佳实践

自动化测试包发布

在CI/CD流水线中集成 fir-cli 可以实现自动化发布。例如，在 Jenkins 或 GitHub Actions 中，你可以编写脚本，在每次构建成功后自动上传最新版的 .ipa 文件，这样每次提交都能自动触发新版本的测试包分发。

# 示例 Jenkinsfile 片段
script {
    def ipAddress = sh(script: 'fir upload app.ipa -T YOUR_TOKEN', returnStdout: true)
    echo "App uploaded to FIR: ${ipAddress}"
}

集成到开发工作流

开发团队可以设定规则，每当有新的分支合并到主分支时自动触发上传过程，确保测试人员总是能立即获得最新的测试版本，加速迭代周期。

典型生态项目

虽然 fir-cli 主要作为独立工具服务于 iOS 应用的发布，但在更广泛的iOS开发生态中，它常与其他工具如 fastlane 结合使用，增强自动化能力。Fastlane 是一套工具集，用于自动化 iOS 和 Android 的部署和测试流程。通过配置 fastlane，你可以让 fir-cli 的上传操作融入更加复杂的发布工作流程，比如自动生成截图、管理App Store Connect等任务。

例如，在fastlane的Gym之后直接调用fir-cli上传：

gym(scheme: "YourScheme") do |gym|
  # gym configurations here...
end

fir_cli(api_token: "YOUR_FIR_API_TOKEN", ipa: "#{lane_context[SharedValues::GYM_IPA_PATH]}")

以上就是 fir-cli 的基本使用指南，希望能帮助你在iOS应用的内测分发上提高效率。记得查看 fir-cli 的官方GitHub页面获取最新信息和更多高级用法。

fir-clifir.im(betaqr.com) command-line interface项目地址:https://gitcode.com/gh_mirrors/fi/fir-cli