Merge "docs: studio 1.3 revisions - android plugin for gradle" into mnc-preview-docs

<div class="toggle-content opened">

  <p><a href="#" onclick="return toggleContent(this)">

    <img src="{@docRoot}assets/images/triangle-opened.png" class="toggle-content-img"

      alt=""/>Android Plugin for Gradle, Revision 1.3.0</a> <em>(July 2015)</em>

  </p>

  <div class="toggle-content-toggleme">

    <dl>

    <dt>Dependencies:</dt>

    <dd>

      <ul>

        <li>Gradle 2.2.1 or higher.</li>

        <li>Build Tools 21.1.1 or higher.</li>

      </ul>

    </dd>

    <dt>General Notes:</dt>

    <dd>

      <ul>

      <li>Added support for the <code>com.android.build.threadPoolSize</code> property to control

         the <code>Android</code> task thread pool size from the <code>build.gradle</code> file or

         the command line. The following example sets this property to 4.

<pre>

-Pcom.android.build.threadPoolSize=4

</pre>

      </li>

      <li>Set the default build behavior to exclude <code>LICENSE</code> and <code>LICENSE.txt</code>

        files from APKs. To include these files in an APK, remove these files from the

        <code>packagingOptions.excludes</code> property in the <code>build.gradle</code> file.

        For example:

<pre>

android {

      packagingOptions.excludes = []

    }

</pre>

      </li>

      <li>Added the <code>sourceSets</code> task to inspect the set of all available source sets. </li>

      <li>Enhanced unit test support to recognize multi-flavor and

        <a href="{@docRoot}tools/building/configuring-gradle.html#workBuildVariants">

        build variant</a>  source folders. For example, to test an app with multi-flavors

        <code>flavor1</code> and <code>flavorA</code> with the <code>Debug</code> build type,

        the test source sets are:

        <ul>

          <li>test </li>

          <li>testFlavor1 </li>

          <li>testFlavorA </li>

          <li>testFlavor1FlavorA </li>

          <li>testFlavor1FlavorADebug </li>

        </ul>

        <p>Android tests already recognized multi-flavor source folders. </p> </li>

      <li>Improved unit test support to:</p>

        <ul>

          <li>Run <code>javac</code> on main and test sources, even if the <code>useJack</code>

            property is set to <code>true</code> in your build file. </li>

          <li>Correctly recognize dependencies for each build type. </li>

        </ul>

      </li>

      <li>Added support for specifying instrumentation test-runner arguments from the command line.

        For example:

<pre>

./gradlew connectedCheck \

   -Pandroid.testInstrumentationRunnerArguments.size=medium \

   -Pandroid.testInstrumentationRunnerArguments.class=TestA,TestB

</pre>

      </li>

      <li>Added support for arbitrary additional Android Asset Packaging Tool (AAPT) parameters

        in the <code>build.gradle</code> file. For example:

<pre>

android {

    aaptOptions {

      additionalParameters "--custom_option", "value"

    }

}

</pre>

      </li>

      <li>Added support for a <a href="{@docRoot}tools/studio/studio-features.html#test-module">

        test APK module</a> as a separate test module, using the

        <code>targetProjectPath</code> and <code>targetVariant</code> properties to set the APK

        path and target variant.

         <p class="note"><strong>Note:</strong> A test APK module does not support product

          flavors and can only target a single variant. Also, Jacoco is not supported yet.</p>

      </li>

      <li>Added resource name validation before merging resources. </li>

      <li>When building an AAR (Android ARchive) package for library modules, do not provide an

        automatic <code>&#64;{applicationId}</code> placeholder in the

        <a href="{@docRoot}tools/building/manifest-merge.html">manifest merger</a> settings.

        Instead, use a different placeholder, such as <code>&#64;{libApplicationId}</code> and

        provide a value for it if you want to include application Ids in the archive library.  </li>

     </ul>

    </dd>

  </div>

</div>

<div class="toggle-content closed">

  <p><a href="#" onclick="return toggleContent(this)">

    <img src="{@docRoot}assets/images/triangle-closed.png" class="toggle-content-img"

      alt=""/>Android Plugin for Gradle, Revision 1.2.0</a> <em>(April 2015)</em>

  </p>