mirror of
https://github.com/gradle/actions.git
synced 2026-04-19 18:12:58 +08:00
ff9ae24c39
## Summary
- **New `basic` cache provider**: Adds an open-source (MIT-licensed)
caching implementation built on `@actions/cache` as an alternative to
the proprietary Enhanced Caching. Users can opt in with `cache-provider:
basic` on both `setup-gradle` and `dependency-submission` actions.
- **Revamped licensing & distribution docs**: Replaces the verbose
licensing notice block (previously shown in README, docs, and logs) with
a friendlier callout and a new dedicated
[DISTRIBUTION.md](./DISTRIBUTION.md) covering component licensing, usage
tiers, data privacy ("Safe Harbor"), and opt-out instructions.
- **Improved messaging**: Enhanced Caching and Basic Caching each
display concise, informative log messages and job summary notes instead
of the previous wall-of-text license warning.
- **New integration tests**: Adds `integ-test-basic-cache-provider.yml`
workflow that seeds and verifies the basic cache provider across
platforms, plus unit tests for `BasicCacheService` and `getCacheService`
selection logic.
- **CI workflow reorganization**: Dependency-submission integration
tests extracted into their own reusable suite
(`suite-integ-test-dependency-submission.yml`); sample project tests
moved into the caching suite.
🤖 Generated with [Claude Code](https://claude.com/claude-code)
---------
Co-authored-by: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
35 lines
1.3 KiB
Markdown
35 lines
1.3 KiB
Markdown
# Workspace Instructions
|
|
|
|
## Vendored Library Flow
|
|
|
|
This repository uses a proprietary caching library: `gradle-actions-caching`.
|
|
|
|
- The vendored copy lives at `sources/vendor/gradle-actions-caching`
|
|
- The source code is at `../actions-caching` and https://github.com/gradle/actions-caching
|
|
|
|
When a task involves building, updating, validating, or testing the vendored `gradle-actions-caching` library, use this sequence:
|
|
|
|
1. Run `npm run build` in `actions-caching`.
|
|
2. Copy (overwrite) the contents of `actions-caching/dist/` onto `sources/vendor/gradle-actions-caching/`. (No need to rm the existing contents)
|
|
3. Then continue with any build, test, or validation steps in this repository.
|
|
|
|
Do not treat `actions/sources/vendor/gradle-actions-caching` as the source of truth. The source of truth is `actions-caching`, and the vendor directory must be refreshed from its `dist/` output after rebuilding.
|
|
|
|
## Building
|
|
|
|
Before running any build or npm commands, initialize the PATH:
|
|
|
|
```sh
|
|
source ~/.zshrc
|
|
```
|
|
|
|
To build this repository, run the `build` script at the root of that repository with no arguments:
|
|
|
|
```sh
|
|
./build
|
|
```
|
|
|
|
## dist directory
|
|
|
|
Never make direct changes to the 'dist' directory. Building with npm will populate 'sources/dist' which is enough. There is a CI workflow that will update the 'dist' directory when required.
|