ruki
139 lines
2.5 KiB
Markdown
139 lines
2.5 KiB
Markdown
# GitHub Action - Setup xmake
|
|
|
|
[](https://github.com/xmake-io/github-action-setup-xmake/actions)
|
|
[](https://github.com/marketplace/actions/setup-xmake)
|
|
|
|
Set up your GitHub Actions workflow with a specific version of xmake
|
|
|
|
## Usage
|
|
|
|
See [action.yml](./action.yml).
|
|
|
|
## Example
|
|
|
|
### Use latest version
|
|
|
|
```yml
|
|
uses: xmake-io/github-action-setup-xmake@v1
|
|
with:
|
|
xmake-version: latest
|
|
```
|
|
|
|
### Use specified version
|
|
|
|
```yml
|
|
uses: xmake-io/github-action-setup-xmake@v1
|
|
with:
|
|
xmake-version: '2.5.3'
|
|
```
|
|
|
|
### Use specified branch
|
|
|
|
```yml
|
|
uses: xmake-io/github-action-setup-xmake@v1
|
|
with:
|
|
xmake-version: branch@master
|
|
```
|
|
|
|
### Use semver
|
|
|
|
```yml
|
|
uses: xmake-io/github-action-setup-xmake@v1
|
|
with:
|
|
xmake-version: '>=2.2.6 <=2.5.3'
|
|
```
|
|
|
|
### Cache xmake
|
|
|
|
```yml
|
|
uses: xmake-io/github-action-setup-xmake@v1
|
|
with:
|
|
xmake-version: '2.9.7'
|
|
actions-cache-folder: '.xmake-cache'
|
|
```
|
|
|
|
### Cache xmake with cachekey
|
|
|
|
```yml
|
|
uses: xmake-io/github-action-setup-xmake@v1
|
|
with:
|
|
xmake-version: '2.9.7'
|
|
actions-cache-folder: '.xmake-cache'
|
|
actions-cache-key: 'archlinux-ci'
|
|
```
|
|
|
|
### Cache packages
|
|
|
|
```yml
|
|
uses: xmake-io/github-action-setup-xmake@v1
|
|
with:
|
|
xmake-version: '2.9.7'
|
|
package-cache-folder: '.xmake-package-cache'
|
|
package-cache-key: 'archlinux-ci'
|
|
package-cache-status: 'load'
|
|
|
|
- install packages
|
|
...
|
|
|
|
uses: xmake-io/github-action-setup-xmake@v1
|
|
with:
|
|
package-cache-folder: '.xmake-package-cache'
|
|
package-cache-key: 'archlinux-ci'
|
|
package-cache-status: 'save'
|
|
```
|
|
|
|
### Cache build
|
|
|
|
```yml
|
|
uses: xmake-io/github-action-setup-xmake@v1
|
|
with:
|
|
xmake-version: '2.9.7'
|
|
build-cache-folder: '.xmake-build-cache'
|
|
build-cache-key: 'archlinux-ci'
|
|
build-cache-status: 'load'
|
|
|
|
- build project
|
|
...
|
|
|
|
uses: xmake-io/github-action-setup-xmake@v1
|
|
with:
|
|
build-cache-folder: '.xmake-build-cache'
|
|
build-cache-key: 'archlinux-ci'
|
|
build-cache-status: 'save'
|
|
```
|
|
|
|
## Contributing
|
|
|
|
### Prepare development environment
|
|
|
|
```bash
|
|
pnpm install
|
|
```
|
|
|
|
### Draft a new release
|
|
|
|
```bash
|
|
pnpm release
|
|
git add .
|
|
git commit -m "build: release"
|
|
pnpm version [new-version]
|
|
|
|
# for a minor version or patch of v1
|
|
git tag --delete v1
|
|
git tag v1
|
|
|
|
git push origin master
|
|
git push --tags --force
|
|
```
|
|
|
|
### Development and debug
|
|
|
|
```bash
|
|
git branch test
|
|
git checkout test
|
|
pnpm build
|
|
pnpm release
|
|
git-commit -a -m "..."
|
|
git push origin test
|
|
```
|