Fastlane-Action 使用教程

Fastlane-Action 使用教程

fastlane-action A GitHub action for executing fastlane lanes. 项目地址: https://gitcode.com/gh_mirrors/fa/fastlane-action

1. 项目介绍

fastlane-action 是一个用于在 GitHub Actions 中执行 fastlane 车道的 GitHub Action。fastlane 是一个用于自动化 iOS 和 Android 应用程序发布流程的工具，而 fastlane-action 则使得在 CI/CD 流程中集成 fastlane 变得更加简单。

该项目的主要功能包括：

• 在 GitHub Actions 中执行指定的 fastlane 车道。
• 支持传递参数给 fastlane 车道。
• 支持在子目录中执行 fastlane 车道。
• 支持详细的日志输出。

2. 项目快速启动

2.1 安装依赖

首先，确保你已经在项目中安装了 fastlane。如果还没有安装，可以通过以下命令进行安装：

sudo gem install fastlane

2.2 配置 GitHub Actions

在你的 GitHub 仓库中，创建一个新的 GitHub Actions 工作流文件（例如 .github/workflows/fastlane.yml），并添加以下内容：

name: Fastlane CI

on: [push]

jobs:
  build:
    runs-on: ubuntu-latest

    steps:
    - uses: actions/checkout@v3
    - uses: ruby/setup-ruby@v1
      with:
        ruby-version: '3.0'
        bundler-cache: true
    - uses: maierj/fastlane-action@v3.1.0
      with:
        lane: 'beta'

2.3 运行工作流

提交并推送你的更改，GitHub Actions 将自动触发并执行 fastlane beta 车道。

3. 应用案例和最佳实践

3.1 基本使用

在根目录中执行一个没有参数的车道：

- uses: actions/checkout@v3
- uses: ruby/setup-ruby@v1
  with:
    ruby-version: '3.0'
    bundler-cache: true
- uses: maierj/fastlane-action@v3.1.0
  with:
    lane: 'beta'

3.2 传递参数

在根目录中执行一个带有参数的车道：

- uses: actions/checkout@v3
- uses: ruby/setup-ruby@v1
  with:
    ruby-version: '3.0'
    bundler-cache: true
- uses: maierj/fastlane-action@v3.1.0
  with:
    lane: 'beta'
    options: '[ "option1": "value1", "option2": "value2" ]'

3.3 子目录中的车道

在子目录中执行车道：

- uses: actions/checkout@v2
- uses: ruby/setup-ruby@v1
  with:
    ruby-version: '3.0'
    bundler-cache: true
    working-directory: 'ios'
- uses: maierj/fastlane-action@v3.1.0
  with:
    lane: 'beta'
    subdirectory: 'ios'

4. 典型生态项目

4.1 Fastlane

fastlane 是一个用于自动化 iOS 和 Android 应用程序发布流程的工具。它提供了许多插件和工具，帮助开发者简化发布流程。

4.2 Ruby/Setup-Ruby

ruby/setup-ruby 是一个用于在 GitHub Actions 中设置 Ruby 环境的 Action。它可以帮助你在 CI/CD 流程中快速配置 Ruby 环境。

4.3 Actions/Checkout

actions/checkout 是一个用于在 GitHub Actions 中签出代码的 Action。它是 GitHub Actions 中最常用的 Action 之一，用于获取仓库的代码。

通过这些工具和 Action 的结合，你可以轻松地在 GitHub Actions 中实现自动化构建、测试和发布流程。

fastlane-action A GitHub action for executing fastlane lanes. 项目地址: https://gitcode.com/gh_mirrors/fa/fastlane-action