diff options
author | Eike Ziller <eike.ziller@qt.io> | 2020-10-21 09:31:01 +0200 |
---|---|---|
committer | Eike Ziller <eike.ziller@qt.io> | 2020-10-21 09:31:01 +0200 |
commit | dbb62016052ad70e8e3dffb60a419504c9eb6dac (patch) | |
tree | 7926ab117c9932be15b8886ba5230048da97bc07 /share/qtcreator/templates/wizards/qtcreatorplugin/github_workflows_README.md | |
parent | 526579b09d1be00ef2f0e371e0c57064777e6538 (diff) | |
parent | cc6f35016ab6f7a1ce82a39582141ab8a35b7bce (diff) |
Merge remote-tracking branch 'origin/4.14' into master
Change-Id: Id7ad82997873da828456a15c441620d93c6fc7e7
Diffstat (limited to 'share/qtcreator/templates/wizards/qtcreatorplugin/github_workflows_README.md')
-rw-r--r-- | share/qtcreator/templates/wizards/qtcreatorplugin/github_workflows_README.md | 41 |
1 files changed, 41 insertions, 0 deletions
diff --git a/share/qtcreator/templates/wizards/qtcreatorplugin/github_workflows_README.md b/share/qtcreator/templates/wizards/qtcreatorplugin/github_workflows_README.md new file mode 100644 index 0000000000..8481ed15ae --- /dev/null +++ b/share/qtcreator/templates/wizards/qtcreatorplugin/github_workflows_README.md @@ -0,0 +1,41 @@ +# GitHub Actions & Workflows + +The `build_qmake.yml` in this directory adds a [GitHub action][1] and workflow that builds +your plugin anytime you push commits to GitHub on Windows, Linux and macOS. + +The build artifacts can be downloaded from GitHub and be installed into an existing Qt Creator +installation. + +When you push a tag, the workflow also creates a new release on GitHub. + +## Keeping it up to date + +Near the top of the file you find a section starting with `env:`. + +The value for `QT_VERSION` specifies the Qt version to use for building the plugin. + +The value for `QT_CREATOR_VERSION` specifies the Qt Creator version to use for building the plugin. + +The value for `QT_CREATOR_SNAPSHOT` can either be `NO` or `latest` or the build ID of a specific +snapshot build for the Qt Creator version that you specified. + +You need to keep these values updated for different versions of your plugin, and take care +that the Qt version and Qt Creator version you specify are compatible. + +## What it does + +The build job consists of several steps: + +* Install required packages on the build host +* Download, unpack and install the binary for the Qt version +* Download and unpack the binary for the Qt Creator version +* Build the plugin and upload the plugin libraries to GitHub +* If a tag is pushed, create a release on GitHub for the tag, including zipped plugin libraries + for download + +## Limitations + +If your plugin requires additional resources besides the plugin library, you need to adapt the +script accordingly. + +[1]: https://help.github.com/en/actions/automating-your-workflow-with-github-actions/about-github-actions |