Android Emulator Runner 项目教程

1. 项目的目录结构及介绍

Android Emulator Runner 项目的目录结构如下：

android-emulator-runner/
├── .github/
│   └── workflows/
│       └── main.yml
├── .gitignore
├── LICENSE
├── README.md
├── action.yml
├── entrypoint.sh
├── scripts/
│   ├── create-avd.sh
│   ├── launch-emulator.sh
│   └── run-tests.sh
└── src/
    └── main.ts

目录结构介绍

• .github/workflows/main.yml: GitHub Actions 的工作流配置文件，定义了 CI/CD 流程。
• .gitignore: Git 忽略文件配置。
• LICENSE: 项目许可证文件。
• README.md: 项目说明文档。
• action.yml: GitHub Actions 的自定义动作配置文件。
• entrypoint.sh: 入口脚本文件。
• scripts/: 包含用于创建 AVD、启动模拟器和运行测试的脚本。
• src/: 包含项目的源代码文件。

2. 项目的启动文件介绍

项目的启动文件是 entrypoint.sh，它是一个 Bash 脚本，负责初始化和执行项目的核心任务。以下是 entrypoint.sh 的基本内容：

#!/bin/bash

# 设置工作目录
cd $GITHUB_WORKSPACE

# 执行创建 AVD 的脚本
./scripts/create-avd.sh

# 执行启动模拟器的脚本
./scripts/launch-emulator.sh

# 执行运行测试的脚本
./scripts/run-tests.sh

启动文件介绍

• entrypoint.sh: 负责调用其他脚本文件，依次执行创建 AVD、启动模拟器和运行测试的任务。

3. 项目的配置文件介绍

项目的配置文件主要包括 action.yml 和 .github/workflows/main.yml。

action.yml

action.yml 是 GitHub Actions 的自定义动作配置文件，定义了动作的输入、输出和运行环境。以下是 action.yml 的基本内容：

name: 'Android Emulator Runner'
description: 'Run Android tests on an emulator'
inputs:
  api-level:
    description: 'Android API level'
    required: true
  emulator-options:
    description: 'Command-line options for the emulator'
    required: false
  script:
    description: 'Custom script to run tests'
    required: true
runs:
  using: 'docker'
  image: 'Dockerfile'
  args:
    - ${{ inputs.api-level }}
    - ${{ inputs.emulator-options }}
    - ${{ inputs.script }}

.github/workflows/main.yml

.github/workflows/main.yml 是 GitHub Actions 的工作流配置文件，定义了 CI/CD 流程。以下是 main.yml 的基本内容：

name: Android CI

on: [push]

jobs:
  build:
    runs-on: ubuntu-latest

    steps:
    - uses: actions/checkout@v2
    - name: Set up JDK 1.8
      uses: actions/setup-java@v1
      with:
        java-version: 1.8
    - name: Run Android Emulator Runner
      uses: ReactiveCircus/android-emulator-runner@v2
      with:
        api-level: 29
        script: ./gradlew connectedCheck

配置文件介绍

• action.yml: 定义了自定义动作的输入、输出和运行环境。
• .github/workflows/main.yml: 定义了 CI/CD 流程，包括检出代码、设置 JDK 和运行 Android Emulator Runner 动作。

以上是 Android Emulator Runner 项目的目录结构、启动文件和配置文件的详细介绍。希望这份教程能帮助你更好地理解和使用该项目。