Clone this repo:
  1. cf98c77 Allow "$ravenwood" to be a method name suffix am: 7071470e06 am: 42ef477f7b by Makoto Onuki · 5 months ago android15-tests-dev androidx-constraintlayout-release main master ub-automotive-master-20240924
  2. 42ef477 Allow "$ravenwood" to be a method name suffix am: 7071470e06 by Makoto Onuki · 5 months ago androidx-androidx-tv-material-release ub-automotive-master-20240731
  3. 7071470 Allow "$ravenwood" to be a method name suffix by Makoto Onuki · 5 months ago
  4. c354fa6 [automerger skipped] Empty merge of Android 24Q2 Release (ab/11526283) to aosp-main-future am: 0cb2b61e50 -s ours by Xin Li · 5 months ago
  5. 0cb2b61 Empty merge of Android 24Q2 Release (ab/11526283) to aosp-main-future by Xin Li · 6 months ago

Checkstyle

Checkstyle is used by developers to validate Java code style and formatting, and can be run as part of the pre-upload hooks.

Running it

It can be invoked in two ways.

  1. To check style of entire specific files: checkstyle.py -f FILE [FILE ...]
  2. To check style of the lines modified in the latest commit: checkstyle.py

Projects used

Checkstyle

A development tool to help programmers write Java code that adheres to a coding standard.

Git-Lint

Git-lint is a tool to run lint checks on only files changed in the latest commit.

  • URL: https://github.com/sk-/git-lint/
  • Version: 0.0.8
  • License: Apache 2.0
  • License File: gitlint/LICENSE
  • Local Modifications:
    • Downloaded gitlint/git.py and git/utils.py files individually.

Pre-upload linting

To run checkstyle as part of the pre-upload hooks, add the following line to your PREUPLOAD.cfg:

checkstyle_hook = ${REPO_ROOT}/prebuilts/checkstyle/checkstyle.py --sha ${PREUPLOAD_COMMIT}

Note that checkstyle does not always agree with clang-format, and so it's best to only have one enabled for Java.

Disabling Clang Format for Java

In .clang-format add the following to disable format checking and correcting for Java:

---
Language: Java
DisableFormat: true
SortIncludes: false
---

In some versions of clang-format, DisableFormat doesn't stop the sorting of includes. So to fully disable clang-format from doing anything for Java files, both options are needed.