From 0e9243dd4330a64a8ee67087771b8f95b658ba89 Mon Sep 17 00:00:00 2001 From: Yang Chen Date: Thu, 7 Nov 2019 01:36:59 +1100 Subject: [PATCH] README.md skeleton. --- README.md | 120 ++++++++---------------------------------------------- 1 file changed, 16 insertions(+), 104 deletions(-) diff --git a/README.md b/README.md index 792067e1..43e253de 100644 --- a/README.md +++ b/README.md @@ -1,113 +1,25 @@ -# Create a JavaScript Action using TypeScript +# GitHub Action - Android Emulator Runner -Use this template to bootstrap the creation of a JavaScript action.:rocket: +A GitHub Action for installing, configuring and running Android Emulators on macOS virtual machines. -This template includes compilication support, tests, a validation workflow, publishing, and versioning guidance. +TODO -If you are new, there's also a simpler introduction. See the [Hello World JavaScript Action](https://github.com/actions/hello-world-javascript-action) +This action must be run on a **macOS** VM, e.g. `macOS-latest` or `macOS-10.14`. -## Create an action from this template +## Inputs -Click the `Use this Template` and provide the new repo details for your action +### `api-level` -## Code in Master +**Required** + +The API level of the system image to be used for the emulator. E.g. `23` for Android 6.0 Marshmallow, `29` for Android 10. + +**Minimum API level supported is 21**. + +TODO + +## Example usage -Install the dependencies -```bash -$ npm install ``` - -Build the typescript -```bash -$ npm run build -``` - -Run the tests :heavy_check_mark: -```bash -$ npm test - - PASS ./index.test.js - ✓ throws invalid number (3ms) - ✓ wait 500 ms (504ms) - ✓ test runs (95ms) - -... -``` - -## Change action.yml - -The action.yml contains defines the inputs and output for your action. - -Update the action.yml with your name, description, inputs and outputs for your action. - -See the [documentation](https://help.github.com/en/articles/metadata-syntax-for-github-actions) - -## Change the Code - -Most toolkit and CI/CD operations involve async operations so the action is run in an async function. - -```javascript -import * as core from '@actions/core'; -... - -async function run() { - try { - ... - } - catch (error) { - core.setFailed(error.message); - } -} - -run() -``` - -See the [toolkit documentation](https://github.com/actions/toolkit/blob/master/README.md#packages) for the various packages. - -## Publish to a distribution branch - -Actions are run from GitHub repos. We will create a releases branch and only checkin production modules (core in this case). - -Comment out node_modules in .gitignore and create a releases/v1 branch -```bash -# comment out in distribution branches -# node_modules/ -``` - -```bash -$ git checkout -b releases/v1 -$ git commit -a -m "prod dependencies" -``` - -```bash -$ npm prune --production -$ git add node_modules -$ git commit -a -m "prod dependencies" -$ git push origin releases/v1 -``` - -Your action is now published! :rocket: - -See the [versioning documentation](https://github.com/actions/toolkit/blob/master/docs/action-versioning.md) - -## Validate - -You can now validate the action by referencing the releases/v1 branch - -```yaml -uses: actions/typescript-action@releases/v1 -with: - milliseconds: 1000 -``` - -See the [actions tab](https://github.com/actions/javascript-action/actions) for runs of this action! :rocket: - -## Usage: - -After testing you can [create a v1 tag](https://github.com/actions/toolkit/blob/master/docs/action-versioning.md) to reference the stable and tested action - -```yaml -uses: actions/typescript-action@v1 -with: - milliseconds: 1000 +TODO ```