## ${project.name} ${project.version}

### Overview

High-level details about this library can be found at https://github.com/googleapis/google-http-java-client

- Release Notes
- JavaDoc
- Support

### Dependencies and Licenses

The license can be found here.
Dependency jars can be found in the libs folder and the corresponding source jars can be found in the libs-sources folder.
The dependency structure and licenses for the different libraries can be found here:

- google-http-client: google-http-client-dependencies.html
- google-http-client-android: google-http-client-android-dependencies.html
- google-http-client-appengine: google-http-client-appengine-dependencies.html
- google-http-client-protobuf: google-http-client-protobuf-dependencies.html
- google-http-client-gson: google-http-client-gson-dependencies.html
- google-http-client-jackson: google-http-client-jackson-dependencies.html
- google-http-client-jackson2: google-http-client-jackson2-dependencies.html
- google-http-client-xml: google-http-client-xml-dependencies.html

### Maven Usage

For information on how to add these libraries to your Maven project please see https://developers.google.com/api-client-library/java/google-http-java-client/setup#maven.

### ProGuard

A ProGuard configuration file proguard-google-http-client.txt is included for common settings for using the library. On Android projects, you may want to add a reference to `proguard-google-http-client.txt` in the `project.properties` file under the `proguard.config` property.

Please read Setup ProGuard for more details.

### Dependencies for all Platforms

The following are the jars from the libs folder needed for applications on all platform:

- google-http-client-${project.version}.jar
- jsr305-${project.jsr305.version}.jar
- google-http-client-protobuf-${project.version}.jar (when using protobuf-java)
  - protobuf-java-${project.protobuf-java.version}.jar
- google-http-client-gson-${project.version}.jar (when using GSON)
  - gson-${project.gson.version}.jar
- google-http-client-jackson2-${project.version}.jar (when using Jackson 2)
  - jackson-core-${project.jackson-core2.version}.jar
- google-http-client-jackson-${project.version}.jar (for backwards compatability when using Jackson 1)
  - jackson-core-asl-${project.jackson-core-asl.version}.jar
- google-http-client-xml-${project.version}.jar (when using XML)
  - xpp3-${project.xpp3.version}.jar (when NOT on Android)

### Android Dependencies

The following jars from the libs folder or newer compatible versions are required for Android applications:

- google-http-client-android-${project.version}.jar

The libs folder also contains properties files that specify the location of source jars for Android projects in Eclipse.
Please see the Android wiki for the Android Developer's Guide.

### Google App Engine Dependencies

The following jars from the libs folder or newer compatible versions are required for Google App Engine applications.

- google-http-client-appengine-${project.version}.jar

Please see the GoogleAppEngine wiki for the Google App Engine Developer's Guide.

### General Purpose Java Environment Dependencies

The following jars from the libs folder or newer compatible versions are required for general purpose Java applications :

- commons-logging-${project.commons-logging.version}.jar
- httpclient-${project.httpclient.version}.jar
- httpcore-${project.httpcore.version}.jar