Files
Daz DeBoer ff9ae24c39 Add open-source 'basic' cache provider and revamp licensing documentation (#930)
## 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>
2026-04-02 21:36:01 -06:00

1.3 KiB

Workspace Instructions

Vendored Library Flow

This repository uses a proprietary caching library: 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:

source ~/.zshrc

To build this repository, run the build script at the root of that repository with no arguments:

./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.