Gradle Common Dependencies Plugin

This plugin provides convenient opt-in/opt-outs for commonly used dependencies. Right now it's targeting Android only. Hopefully, we'll expand it over time.

Usage

1. Add the following to your build.gradle

   buildscript {
      repositories {
         mavenCentral()
      }
   
      dependencies {
         classpath 'com.github.saadfarooq:gradle-common-deps-plugin:{version}'
      }
   }
   
   repositories {
      mavenCentral()
   }
   
   apply plugin: 'com.android.application'
   apply plugin: 'com.github.saadfarooq.commondeps'

   alternatively, you can use the new plugin syntax for gradle 2.1+

   plugins {
      id "com.github.saadfarooq.commondeps" version "<latestVersion>"
   }

2. Define the dependencies in the commonDeps closure (Following is the complete listing and will serve as documentation of dependencies as they are added.

   // Enable a dependency by either specifying `true` to install the default version 
   // or a version string to include a particular version
   commonDeps {
       support {
           libsVersion '23.1.0`
           support true
           appcompat true
           cardview false
           design false
           palette false
       }
       gps {
            ads true
            analytics true
            base true
            cast true
            games true
            gcm true
            fitness true
            identity true
            location true
            maps true
            nearby true
            panorama true
            plus true
       }
       butterknife '7.0.1' // you can also specify true to use latest version
       picasso true
       timber true
       glide true
       jodatime true // installs joda-time Android
       testing {
           robolectric true
           junit true
       }
   }

The plugin adds the dependencies to the compile configuration

Contributing

The library is pretty simple and contributing should be relatively easy if you follow the steps below:

1. Think of a dependency you commonly use and that you think is popular enough to merit inclusion

2. Determine appropriate build.gradle closure level to use for said dependency. Most dependencies will go in the commonDeps top level closure. Others, such as Google support libraries go in sub-levels. Assume you decided to add xyz dependency to the commonDeps top level closure. (Follow the examples for new closure addition in CommonDepsPlugin if you need to create new sub-closure)

3. Add a method corresponding to the name you want to use in the build file. For xyz add a method named xyz that takes an argument version. This method is called during the build process when the closure is parsed.

4. Create string field corresponding to the property you want to add in the Extension object. My convention is to name this the same as the method name / build property name, in our assumption xyz.

5. Add the default version for that property to the DefaultVersions file.

6. Simply call the Util.setDepProperty with the group name, artifact id, version argument passed to the method and DefaultVersion reference. e.g. xyz = Util.setDepProperty('com.xyz', 'xyz', version, DefaultVersion.XYZ). This method add the appropriate dependency to the project depending on the argument passed.

7. Following a test pattern from CommonDepsPluginTest to add a test for your newly added dependency.

8. Add example usage in README.md. This is important so visitors know what dependencies are available. The gradle closure properties are not discoverable at this point.

9. Make a PR.

10. Go forth and prosper.

License

Copyright 2015 Saad Farooq

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

   http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.