<br />

# Android Gradle Plugin 3.4.0 (April 2019)

This version of the Android plugin requires the following:

|                 | Minimum version | Default version |                                                                                                                                                                                                          Notes                                                                                                                                                                                                          |
|----------------:|:---------------:|:---------------:|:-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------:|
|          Gradle |      5.1.1      |      5.1.1      | To learn more, see[updating Gradle](https://developer.android.com/build/releases/gradle-plugin?buildsystem=ndk-build#updating-gradle). When using Gradle 5.0 and higher, the default Gradle daemon memory heap size decreases from 1 GB to 512 MB. This might result in a build performance regression. To override this default setting, specify the Gradle daemon heap size in your project's gradle.properties file. |
| SDK Build Tools |     28.0.3      |     28.0.3      |                                                                                                                             [Install](https://developer.android.com/studio/intro/update#sdk-manager)or[configure](https://developer.android.com/tools/releases/build-tools)SDK Build Tools.                                                                                                                             |

**3.4.3 (July 2020)**

This minor update supports compatibility with new default settings and features for[package visibility in Android 11](https://developer.android.com/about/versions/11/privacy/package-visibility).

See the[4.0.1 release notes](https://developer.android.com/build/releases/past-releases/agp-3-4-0-release-notes#4.0.1)for details.

**3.4.2 (July 2019)**

This minor update supports Android Studio 3.4.2 and includes various bug fixes and performance improvements. To see a list of noteable bug fixes, read the related post on the[Release Updates blog](https://androidstudio.googleblog.com/2019/07/android-studio-342-available.html).

**3.4.1 (May 2019)**

This minor update supports Android Studio 3.4.1 and includes various bug fixes and performance improvements. To see a list of noteable bug fixes, read the related post on the[Release Updates blog](https://androidstudio.googleblog.com/2019/05/android-studio-341-available.html).

<br />

<br />

## New features

- **New lint check dependency configurations:** The behavior of`lintChecks`has changed and a new dependency configuration,`lintPublish`, has been introduced to give you more control over which lint checks are packaged in your Android libraries.

  - `lintChecks`: This is an existing configuration that you should use for lint checks you want to only run when building your project locally. If you were previously using the`lintChecks`dependency configuration to include lint checks in the published AAR, you need to migrate those dependencies to instead use the new`lintPublish`configuration described below.
  - `lintPublish`: Use this new configuration in library projects for lint checks you want to include in the published AAR, as shown below. This means that projects that consume your library also apply those lint checks.

  The following code sample uses both dependency configurations in a local Android library project.  

  ```groovy
  dependencies {
    // Executes lint checks from the ':lint' project at build time.
    lintChecks project(':lint')
    // Packages lint checks from the ':lintpublish' in the published AAR.
    lintPublish project(':lintpublish')
  }
          
  ```  

  ```kotlin
  dependencies {
    // Executes lint checks from the ':lint' project at build time.
    lintChecks(project(":lint"))
    // Packages lint checks from the ':lintpublish' in the published AAR.
    lintPublish(project(":lintpublish"))
      }
          
  ```
  - In general, packaging and signing tasks should see an overall build speed improvement. If you notice a performance regression related to these tasks, please[report a bug](https://developer.android.com/studio/report-bugs).

<br />

<br />

## Behavior changes

- **Android Instant Apps Feature plugin deprecation warning:** If you're still using the`com.android.feature`plugin to build your instant app, Android Gradle plugin 3.4.0 will give throw you a deprecation warning. To make sure you can still build you instant app on future versions of the plugin, migrate your instant app to using[the dynamic feature plugin](https://developer.android.com/studio/projects/dynamic-delivery), which also allows you to publish both your installed and instant app experiences from a single Android App Bundle.

- **R8 enabled by default:** R8 integrates desugaring, shrinking, obfuscating, optimizing, and dexing all in one step---resulting in[noticeable build performance improvements](https://www.google.com/url?q=https://android-developers.googleblog.com/2018/11/r8-new-code-shrinker-from-google-is.html&sa=D&ust=1551922493258000&usg=AFQjCNH0N1wuMX645n7giw0wjikzjm3WCA). R8 was introduced in Android Gradle plugin 3.3.0 and is now enabled by default for both app and Android library projects using plugin 3.4.0 and higher.

The image below provides a high-level overview of the compile process before R8 was introduced.
![Before R8, ProGuard was a different compile step from dexing and desugaring.](https://developer.android.com/static/studio/images/build/r8/compile_with_d8_proguard.png)

Now, with R8, desugaring, shrinking, obfuscating, optimizing, and dexing (D8) are all completed in one step, as illustrated below.
![With R8, desugaring, shrinking, obfuscating, optimizing, and dexing are all performed in a single compile step.](https://developer.android.com/static/studio/images/build/r8/compile_with_r8.png)

Keep in mind, R8 is designed to work with your existing ProGuard rules, so you'll likely not need to take any actions to benefit from R8. However, because it's a different technology to ProGuard that's designed specifically for Android projects, shrinking and optimization may result in removing code that ProGuard may have not. So, in this unlikely situation, you might need to add additional rules to keep that code in your build output.

If you experience issues using R8, read the[R8 compatibility FAQ](https://r8.googlesource.com/r8/+/refs/heads/master/compatibility-faq.md)to check if there's a solution to your issue. If a solution isn't documented, please[report a bug](https://issuetracker.google.com/issues/new?component=326788&template=1025938). You can disable R8 by adding one of the following lines to your project's`gradle.properties`file:  

          # Disables R8 for Android Library modules only.
          android.enableR8.libraries = false
          # Disables R8 for all modules.
          android.enableR8 = false
          
        
**Note:** For a given build type, if you set`useProguard`to`false`in your app module's`build.gradle`file, the Android Gradle plugin uses R8 to shrink your app's code for that build type, regardless of whether you disable R8 in your project's`gradle.properties`file.

- **`ndkCompile`is deprecated:** You now get a build error if you try to use`ndkBuild`to compile your native libraries. You should instead use either CMake or ndk-build to[Add C and C++ code to your project](https://developer.android.com/studio/projects/add-native-code).

<br />

<br />

## Known issues

- The correct usage of unique package names are currently not enforced but will become more strict on later versions of the plugin. On Android Gradle plugin version 3.4.0, you can opt-in to check whether your project declares acceptable package names by adding the line below to your`gradle.properties`file.

                android.uniquePackageNames = true
                
              
  To learn more about setting a package name through the Android Gradle plugin, see[Set the application ID](https://developer.android.com/studio/build/configure-app-module#set_the_application_id).

<br />