|
1 | | -<p align="center"> |
2 | | - <a href="https://github.com/actions/typescript-action/actions"><img alt="typescript-action status" src="https://github.com/actions/typescript-action/workflows/build-test/badge.svg"></a> |
3 | | -</p> |
4 | | - |
5 | | -# Create a JavaScript Action using TypeScript |
6 | | - |
7 | | -Use this template to bootstrap the creation of a TypeScript action.:rocket: |
8 | | - |
9 | | -This template includes compilation support, tests, a validation workflow, publishing, and versioning guidance. |
10 | | - |
11 | | -If you are new, there's also a simpler introduction. See the [Hello World JavaScript Action](https://github.com/actions/hello-world-javascript-action) |
12 | | - |
13 | | -## Create an action from this template |
14 | | - |
15 | | -Click the `Use this Template` and provide the new repo details for your action |
16 | | - |
17 | | -## Code in Main |
18 | | - |
19 | | -> First, you'll need to have a reasonably modern version of `node` handy. This won't work with versions older than 9, for instance. |
20 | | -
|
21 | | -Install the dependencies |
22 | | -```bash |
23 | | -$ npm install |
| 1 | +# Github action for bundle taro react native project |
| 2 | + |
| 3 | +Use this action to package your [Taro React Native](https://docs.taro.zone/) project and generate bundles for Android and iOS. Others can use [Taro Playground APP](https://github.com/wuba/taro-playground) to load the bundle for project preview. |
| 4 | + |
| 5 | +Make it easier to share your ideas. |
| 6 | + |
| 7 | +**Note:** Your React Native version and dependencies must be compatible with the [Taro Playground APP](https://github.com/wuba/taro-playground/blob/main/package.json). |
| 8 | +## Workflow |
| 9 | + |
| 10 | +1. Execute `yarn build:rn` to build the bundle. |
| 11 | +2. Generate a [Taro Playground APP](https://github.com/wuba/taro-playground) protocol, including platform, name, logo and bundle url. |
| 12 | +3. Export the protocol to a file with a QR code. |
| 13 | +4. Commit the changes. |
| 14 | +5. If `GITHUB_REF_NAME` is tag |
| 15 | + 1. Delete the original tag and re-tag it. |
| 16 | + 2. Generate a release, including the QR code and other information. |
| 17 | +6. If `GITHUB_REF_NAME` is branch |
| 18 | + 1. Push the changes to the branch. |
| 19 | + |
| 20 | +## Usage |
| 21 | + |
| 22 | +### Basic Config |
| 23 | + |
| 24 | +```yml |
| 25 | +on: |
| 26 | + push: |
| 27 | + tags: [ v* ] |
| 28 | + workflow_dispatch: |
| 29 | + |
| 30 | +jobs: |
| 31 | + taro_release_job: |
| 32 | + runs-on: ubuntu-latest |
| 33 | + name: Taro Bundle Release |
| 34 | + steps: |
| 35 | + - name: Release Taro React Native bundle |
| 36 | + uses: zhiqingchen/taro-react-native-release@v1 |
| 37 | + with: |
| 38 | + token: ${{ secrets.GITHUB_TOKEN }} |
| 39 | + appname: Taro-Mortgage-calculator |
| 40 | + logo: https://pic3.58cdn.com.cn/nowater/fangfe/n_v25b1523466b894881b9bdeda7618a8af2.png |
24 | 41 | ``` |
25 | 42 |
|
26 | | -Build the typescript and package it for distribution |
27 | | -```bash |
28 | | -$ npm run build && npm run package |
29 | | -``` |
30 | | - |
31 | | -Run the tests :heavy_check_mark: |
32 | | -```bash |
33 | | -$ npm test |
34 | | - |
35 | | - PASS ./index.test.js |
36 | | - ✓ throws invalid number (3ms) |
37 | | - ✓ wait 500 ms (504ms) |
38 | | - ✓ test runs (95ms) |
39 | | - |
40 | | -... |
41 | | -``` |
42 | | - |
43 | | -## Change action.yml |
44 | | - |
45 | | -The action.yml defines the inputs and output for your action. |
46 | | - |
47 | | -Update the action.yml with your name, description, inputs and outputs for your action. |
| 43 | +### Options |
48 | 44 |
|
49 | | -See the [documentation](https://help.github.com/en/articles/metadata-syntax-for-github-actions) |
| 45 | +see [action.yml](./action.yml) for details. |
50 | 46 |
|
51 | | -## Change the Code |
| 47 | +### Examples |
52 | 48 |
|
53 | | -Most toolkit and CI/CD operations involve async operations so the action is run in an async function. |
54 | | - |
55 | | -```javascript |
56 | | -import * as core from '@actions/core'; |
57 | | -... |
58 | | - |
59 | | -async function run() { |
60 | | - try { |
61 | | - ... |
62 | | - } |
63 | | - catch (error) { |
64 | | - core.setFailed(error.message); |
65 | | - } |
66 | | -} |
67 | | - |
68 | | -run() |
69 | | -``` |
70 | | - |
71 | | -See the [toolkit documentation](https://github.com/actions/toolkit/blob/master/README.md#packages) for the various packages. |
72 | | - |
73 | | -## Publish to a distribution branch |
74 | | - |
75 | | -Actions are run from GitHub repos so we will checkin the packed dist folder. |
76 | | - |
77 | | -Then run [ncc](https://github.com/zeit/ncc) and push the results: |
78 | | -```bash |
79 | | -$ npm run package |
80 | | -$ git add dist |
81 | | -$ git commit -a -m "prod dependencies" |
82 | | -$ git push origin releases/v1 |
83 | | -``` |
84 | | - |
85 | | -Note: We recommend using the `--license` option for ncc, which will create a license file for all of the production node modules used in your project. |
86 | | - |
87 | | -Your action is now published! :rocket: |
88 | | - |
89 | | -See the [versioning documentation](https://github.com/actions/toolkit/blob/master/docs/action-versioning.md) |
90 | | - |
91 | | -## Validate |
92 | | - |
93 | | -You can now validate the action by referencing `./` in a workflow in your repo (see [test.yml](.github/workflows/test.yml)) |
94 | | - |
95 | | -```yaml |
96 | | -uses: ./ |
97 | | -with: |
98 | | - milliseconds: 1000 |
99 | | -``` |
| 49 | +0. [wuba/Taro-Mortgage-Calculator](https://github.com/wuba/Taro-Mortgage-Calculator/tree/master/.github/workflows/main.yml) |
100 | 50 |
|
101 | | -See the [actions tab](https://github.com/actions/typescript-action/actions) for runs of this action! :rocket: |
| 51 | +## Acknowledgements |
102 | 52 |
|
103 | | -## Usage: |
| 53 | +We use [jsDelivr](https://www.jsdelivr.com/?docs=gh) as the cdn service. |
| 54 | +## LICENSE |
104 | 55 |
|
105 | | -After testing you can [create a v1 tag](https://github.com/actions/toolkit/blob/master/docs/action-versioning.md) to reference the stable and latest V1 action |
| 56 | +The MIT License (MIT) |
0 commit comments