Skip to content

Latest commit

 

History

History
54 lines (34 loc) · 1.74 KB

CONTRIBUTING.md

File metadata and controls

54 lines (34 loc) · 1.74 KB
Raw

Contributing

If you would like to contribute code to this project you can do so through GitHub by forking the repository and sending a pull request.

When submitting code, please make every effort to follow existing conventions and style in order to keep the code as readable as possible.

Before your code can be accepted into the project you must also sign the Individual Contributor License Agreement (CLA).

Building

Install Hermit, see instructions at https://cashapp.github.io/hermit/

Use gradle to run all Kotlin tests locally:

gradle build

Breaking changes

We use the Kotlin binary compatibility validator to check for API changes. If a change contains an API change and breaks the build, run the :apiDump task and commit the resulting changes to the .api files. .api files should not have removals and additions in the same change so that downstream apps do not immediately run into backwards-compatibility issues.

Upgrading dependencies

Dependency versions are listed in the Gradle catalog file: gradle/libs.versions.toml.

To check for dependencies to update:

 gradle dependencyUpdates -Drevision=release

Dependencies can be updated by editing the catalog file.

The version catalog update plugin can also format and update the catalog file. See the documentation for more detail.

Updating all available dependencies:

gradle versionCatalogUpdate

Gradle Versions Plugin: https://github.com/ben-manes/gradle-versions-plugin Version Catalog Update Plugin: https://github.com/littlerobots/version-catalog-update-plugin