Firebase-Distribution-Github-Action 使用教程
项目介绍
Firebase-Distribution-Github-Action 是一个用于自动化将应用二进制文件(如 IPA 或 APK)分发到 Firebase App Distribution 的 GitHub Action。通过这个 Action,开发者可以轻松地将应用分发给测试人员,并自动发送电子邮件通知。
项目快速启动
步骤 1:设置 Firebase
- 在 Firebase 控制台中创建一个项目。
- 生成 Firebase 访问令牌:在本地机器上运行
firebase login:ci
。
步骤 2:配置 GitHub Secrets
- 在 GitHub 仓库中,进入
Settings
->Secrets
。 - 添加以下 Secrets:
FIREBASE_APP_ID
:Firebase 应用 ID。FIREBASE_TOKEN
:Firebase 访问令牌。
步骤 3:创建 GitHub Actions 工作流
在仓库的 .github/workflows
目录下创建一个 YAML 文件(例如 firebase-distribution.yml
),内容如下:
name: Firebase App Distribution
on:
push:
branches: [ main ]
pull_request:
branches: [ main ]
jobs:
build:
runs-on: ubuntu-latest
steps:
- name: Checkout code
uses: actions/checkout@v2
- name: Firebase App Distribution
uses: wzieba/Firebase-Distribution-Github-Action@v1
with:
app_id: ${{ secrets.FIREBASE_APP_ID }}
firebase_token: ${{ secrets.FIREBASE_TOKEN }}
app_file: path/to/your/app-release.apk
tester_groups: android-team,ios-team,qa-team
release_notes: |
Release notes for this build
Commit short hash and commit message
应用案例和最佳实践
应用案例
假设你是一个移动应用开发者,希望在每次代码推送时自动将应用分发给测试团队。通过使用 Firebase-Distribution-Github-Action,你可以实现以下流程:
- 开发者在本地完成功能开发并提交代码到 GitHub。
- GitHub Actions 自动触发构建流程。
- 构建完成后,应用二进制文件自动上传到 Firebase App Distribution。
- 测试团队收到电子邮件通知,并可以下载最新版本的应用进行测试。
最佳实践
- 版本控制:确保每次分发的应用都有唯一的版本号,便于追踪和回溯。
- 测试团队管理:合理划分测试团队,如按平台(Android、iOS)或按功能(QA 团队、功能测试团队)。
- 发布说明:每次分发时提供详细的发布说明,包括变更内容、已知问题等。
典型生态项目
Firebase-Distribution-Github-Action 可以与其他 Firebase 服务和 GitHub Actions 结合使用,构建完整的自动化工作流。以下是一些典型的生态项目:
- Firebase Crashlytics:集成 Crashlytics 可以自动收集应用崩溃报告,帮助开发者快速定位和修复问题。
- GitHub Actions for CI/CD:结合其他 GitHub Actions,如
actions/setup-java
或actions/setup-node
,实现完整的 CI/CD 流程。 - Firebase Performance Monitoring:监控应用性能,确保分发的应用在各种设备上都能稳定运行。
通过这些生态项目的结合,开发者可以构建一个高效、自动化的移动应用开发和分发流程。