Android Code Style

Code formatting rules for Android Studio

Features

• Based on googles java code style (https://git.io/v5XuB)
• Hungarian Notation (m-Prefix)
• No star imports except for testing libraries
• Increase the line length to 118 (default 100)
• android:id after xmlns declaration in XML layouts
• Keep lifecycle methods together
• Keep getters and setters together
• Advanced code Arrangement rules for Java (Sort methods alphabetically (a-z) and by visibility (public-private))
  • Inner classes (classes, interfaces, enums)
  • Fields (grouped by visibility, a-z)
  • public static methods (a-z)
  • Constructors
  • Android Lifecycle methods in correct order
  • Methods (grouped by visibility, a-z)
  • static methods (grouped by visibility (except public), a-z)
• Official Kotlin Code Style

Installation on your local machine

Automatically (the easiest way)

Just run the install script. It will automatically copy the latest Code Style to each existing AndroidStudio and AndroidStudioPreview version you have installed.

Manually (the hard way)

1. Copy the grandcentrix.xml into (MacOS) ~/Library/Preferences/AndroidStudio{VERSION}/codestyles/ or (Linux) ~/.AndroidStudio{VERSION}/config/codestyles/
2. Restart AndroidStudio
3. Select the codestyle scheme via Preferences --> Editor --> Code Style.

The codestyle will be enabled/used for all projects that are used with AndroidStudio!

Enabling project specific code styles for a project

If the codestyle is added to the git repository and IntelliJ is configured accordingly each project can have it's own style.

1. Install the grandcentrix.xml locally (see above)
2. Restart AndroidStudio
3. In AndroidStudio, go to Preferences --> Editor --> Code style
4. Open the scheme list by clicking on the Scheme: drop down
5. From the Stored in the IDE section select grandcentrix
6. Click the cogwheel just on the right and select Copy to project
7. Confirm overwriting project settings with the new scheme

Finally add the code style to the git repository:

git add -f .idea/codestyles/Project.xml .idea/codestyles/codeStyleConfig.xml

Contributing

To contribute just change the code style locally to your needs. Then you can create a PR to this repository.

The PR should always contain:

• Some information what have changed.
• A updated grandcentrix.xml.

License

CC0 1.0 Universal