Initial import

Author: Jens Driller

.gitignore

@@ -0,0 +1,11 @@
+# Gradle
+.gradle
+local.properties
+build
+
+# Android Studio
+.idea
+*.iml
+
+# Mac OSX
+.DS_Store

CHANGELOG.md

@@ -0,0 +1,6 @@
+Change Log
+==========
+
+Version 1.0.0 *(2016/02/15)*
+--------------------------
+* Initial release

LICENSE

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2016 Jens Driller
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

README.md

@@ -0,0 +1,123 @@
+Android Build Constants Plugin
+==============================
+A Gradle plugin for Android which generates both Java and XML constants as part of the build process.
+
+Why do I need this?
+===================
+In short: To define constants that are accessible from everywhere in your Android app and/or library.
+
+In long: There are two ways to define constants in Android. Both have their limitations.
+* Creating constants using `buildConfigField` only adds entries to `BuildConfig.java` which means you cannot access them via XML.
+* Creating a custom `constants.xml` resource file with entries like `<string name="constant">constant_value</string>`
+lets you easily reference the constant via `@string/constant` in XML, but requires you to have a `Context` object on the Java side
+to get the value using `getResources().getString(R.string.constant)`.
+
+None of the above solutions is ideal. This plugin lets you specify constants in your `build.gradle` file
+that will be translated into both a Java and an XML-based version with the same constant value.
+
+How does it work?
+=================
+The plugin creates a new task per build type, e.g. *generateDebugBuildConstants*.
+It hooks into the build process ahead of the *processDebugResources* task so it will be executed every time you assemble your project.
+It supports incremental builds, i.e. if none of the inputs or outputs have changed, Gradle can skip the task (up-to-date).
+
+Usage
+-----
+The plugin currently supports **Integer**, **Boolean** and **String** data types.
+
+You can specify the constants using a closure in your `build.gradle` file like this:
+
+```groovy
+buildConstants {
+  constants {
+    aBoolean = true
+    aString = 'string'
+    aNumber = 123
+  }
+}
+```
+
+The plugin will then generate both a Java and an XML version of the constants like so:
+
+**Java:**
+```java
+public final class BuildConstants {
+  public static final boolean ABOOLEAN = true;
+  public static final String ASTRING = "string";
+  public static final int ANUMBER = 123;
+}
+```
+
+**XML:**
+```xml
+<resources>
+	<bool name="aboolean">true</bool>
+	<string name="astring">string</string>
+	<integer name="anumber">123</integer>
+</resources>
+```
+
+Alternatively, you can define the constants using a map:
+
+```groovy
+buildConstants {
+  constants = [
+    aBoolean : true,
+    aString : 'string',
+    aNumber : 123
+  ]
+}
+```
+
+Or specify just a single constant (similar to `buildConfigField`):
+
+```groovy
+buildConstants {
+  constant 'single_constant', 'single_string'
+}
+```
+
+The default generated file names are `BuildConstants.java` and `build_constants.xml`.
+You can change them like this:
+
+```groovy
+buildConstants {
+  javaFileName 'SampleBuildConstants'
+  xmlFileName 'sample_build_constants'
+}
+```
+
+Example
+-------
+Check out the [sample project](https://github.com/jenzz/gradle-android-buildconstants-plugin/tree/master/sample) for an example implementation.
+
+Download
+--------
+Build script snippet for use in all Gradle versions:
+
+```groovy
+buildscript {
+  repositories {
+    maven {
+      url "https://plugins.gradle.org/m2/"
+    }
+  }
+  dependencies {
+    classpath "gradle.plugin.com.jenzz:plugin:1.0.0"
+  }
+}
+
+apply plugin: "com.jenzz.buildconstants"
+```
+
+Build script snippet for new, incubating, plugin mechanism introduced in Gradle 2.1:
+
+```groovy
+plugins {
+  id "com.jenzz.buildconstants" version "1.0.0"
+}
+```
+
+License
+-------
+This project is licensed under the [MIT License](https://raw.githubusercontent.com/jenzz/gradle-android-buildconstants-plugin/master/LICENSE).

build.gradle

@@ -0,0 +1,18 @@
+buildscript {
+  repositories {
+    jcenter()
+  }
+  dependencies {
+    classpath 'com.android.tools.build:gradle:2.0.0-beta4'
+  }
+}
+
+allprojects {
+  repositories {
+    jcenter()
+  }
+}
+
+ext {
+  versionNumber = '1.0.0'
+}

gradle.properties

@@ -0,0 +1,18 @@
+# Project-wide Gradle settings.
+
+# IDE (e.g. Android Studio) users:
+# Gradle settings configured through the IDE *will override*
+# any settings specified in this file.
+
+# For more details on how to configure your build environment visit
+# http://www.gradle.org/docs/current/userguide/build_environment.html
+
+# Specifies the JVM arguments used for the daemon process.
+# The setting is particularly useful for tweaking memory settings.
+# Default value: -Xmx10248m -XX:MaxPermSize=256m
+# org.gradle.jvmargs=-Xmx2048m -XX:MaxPermSize=512m -XX:+HeapDumpOnOutOfMemoryError -Dfile.encoding=UTF-8
+
+# When configured, Gradle will run in incubating parallel mode.
+# This option should only be used with decoupled projects. More details, visit
+# http://www.gradle.org/docs/current/userguide/multi_project_builds.html#sec:decoupled_projects
+# org.gradle.parallel=true

gradle/wrapper/gradle-wrapper.jar

@@ -0,0 +1,6 @@
+#Mon Dec 28 10:00:20 PST 2015
+distributionBase=GRADLE_USER_HOME
+distributionPath=wrapper/dists
+zipStoreBase=GRADLE_USER_HOME
+zipStorePath=wrapper/dists
+distributionUrl=https\://services.gradle.org/distributions/gradle-2.10-all.zip