mirror of
https://github.com/Detanup01/gbe_fork.git
synced 2024-11-27 05:04:01 +08:00
update front readme + deprecate ci-build-*
branches
This commit is contained in:
parent
9d8ecfdb60
commit
2322e14248
62
README.md
62
README.md
@ -300,13 +300,21 @@ In your fork, open the `Settings` tab from the top, then:
|
||||
* *(Optional)* In the section `Artifact and log retention`, you can specify the amount of days to keep the build artifacts/archives.
|
||||
It is recommended to set a reasonable number like 3-4 days, otherwise you may consume your packages storage if you use Github as a builder frequently, more details here: https://docs.github.com/en/get-started/learning-about-github/githubs-plans
|
||||
|
||||
### Manual trigger
|
||||
1. Go to the `Actions` tab in your fork
|
||||
2. Select the emu dependencies Workflow (ex: `Emu third-party dependencies (Windows) `) and run it on the **main** branch (ex: `dev`).
|
||||
Dependencies not created on the main branch won't be recognized by other branches or subsequent runs
|
||||
3. Select one of the Workflow scripts from the left side panel, for example `Build all emu variants (Windows)`
|
||||
3. On the top-right, select `Run workflow` -> select the desired branch (for example `dev`) -> press the button `Run workflow`
|
||||
4. When it's done, many packages (called build artifacts) will be created for that workflow.
|
||||
Make sure to select the workflow again to view its history, then select the last run at the very top to view its artifacts
|
||||
|
||||
<br/>
|
||||
|
||||
Important note:
|
||||
---
|
||||
|
||||
In any of the following trigger methods, when you run a workflow (build script), the dependencies will be cached to decrease the build times of the next triggers, and avoid unnecessary/wasteful build process.
|
||||
|
||||
When you build the dependencies workflows, they will be cached to decrease the build times of the next triggers and avoid unnecessary/wasteful build process.
|
||||
This will cause a problem if at any time the third-party dependencies were updated, in that case you need to manually delete the cache, in your fork:
|
||||
1. Go to the `Actions` tab at the top
|
||||
2. Select `Caches` from the left side panel
|
||||
@ -314,56 +322,6 @@ This will cause a problem if at any time the third-party dependencies were updat
|
||||
|
||||
<br/>
|
||||
|
||||
### Manual trigger
|
||||
1. Go to the `Actions` tab in your fork
|
||||
2. Select one of the Workflow scripts from the left side panel, for example `Emu build (Windows)`
|
||||
3. On the top-right, select `Run workflow` -> select the desired branch (for example `dev`) -> press the button `Run workflow`
|
||||
4. When it's done, a package (called build artifact) will be created for that workflow.
|
||||
Make sure to select the workflow again to view its history, then select the last run at the very top to view its artifacts
|
||||
|
||||
### Automatic triggers
|
||||
The following are special branches, pushing any code to them will trigger the build Workflow scripts:
|
||||
* `ci-build-emu-linux*`: any branch matching this pattern will trigger the **Linux** build of the emu
|
||||
Example of a valid branch name:
|
||||
- `ci-build-emu-linux`
|
||||
- `ci-build-emu-linux-test1`
|
||||
- `ci-build-emu-linux_trial`
|
||||
* `ci-build-emu-win*`: any branch matching this pattern will trigger the **Windows** build of the emu
|
||||
Example of a valid branch name:
|
||||
- `ci-build-emu-win`
|
||||
- `ci-build-emu-win-test_x`
|
||||
- `ci-build-emu-win_feature_y`
|
||||
|
||||
>>>>>>>>> ___
|
||||
|
||||
* `ci-build-gen-linux*`: any branch matching this pattern will trigger the **Linux** build of the script `generate_emu_config`
|
||||
Example of a valid branch name:
|
||||
- `ci-build-gen-linux`
|
||||
- `ci-build-gen-linux-test1`
|
||||
- `ci-build-gen-linux_trial`
|
||||
* `ci-build-gen-win*`: any branch matching this pattern will trigger the **Windows** build of the script `generate_emu_config`
|
||||
Example of a valid branch name:
|
||||
- `ci-build-gen-win`
|
||||
- `ci-build-gen-win-test1`
|
||||
- `ci-build-gen-win_trial`
|
||||
|
||||
>>>>>>>>> ___
|
||||
|
||||
* `ci-build-migrate-linux*`: any branch matching this pattern will trigger the **Linux** build of the script `migrate_gse`
|
||||
Example of a valid branch name:
|
||||
- `ci-build-migrate-linux`
|
||||
- `ci-build-migrate-linux-test1`
|
||||
- `ci-build-migrate-linux_trial`
|
||||
* `ci-build-migrate-win*`: any branch matching this pattern will trigger the **Windows** build of the script `migrate_gse`
|
||||
Example of a valid branch name:
|
||||
- `ci-build-migrate-win`
|
||||
- `ci-build-migrate-win-test1`
|
||||
- `ci-build-migrate-win_trial`
|
||||
|
||||
>>>>>>>>> ___
|
||||
|
||||
* `ci-build-all`: pushing code to this exact branch will trigger all builds
|
||||
|
||||
---
|
||||
|
||||
## ***(Optional)* Packaging**
|
||||
|
Loading…
Reference in New Issue
Block a user