Revert "Merge upstream master". DO NOT MERGE ANYWHERE.

The update of conscrypt changed APIs that affected tests covered by CTS.

This reverts commit e550f1a85730f12adee263689af2f47f2e913b63, reversing
changes made to d4695f2bf909c88216bbe23087eb167d1c68eede.

This is a clean revert. The upload hook to fix lint errors was not run
(this CL was uploaded with --no-verify).

Bug: 62424503
Test: make checkbuild
Test: cts-tradefed run singleCommand cts -a arm64-v8a -m CtsLibcoreTestCases

Change-Id: I54f055a2b50bcf45e78b490f7cd9258037ff408b
69 files changed
tree: e0dcf08fffd3b90666e337b0cbce9e528a4aa570
  1. android/
  2. android-stub/
  3. api-doclet/
  4. benchmark-graphs/
  5. common/
  6. constants/
  7. gradle/
  8. libcore-stub/
  9. licenses/
  10. openjdk/
  11. openjdk-benchmarks/
  12. openjdk-uber/
  13. platform/
  14. testing/
  15. .clang-format
  16. .gitignore
  17. .travis.yml
  18. Android.bp
  19. Android.mk
  20. appveyor.yml
  21. build.gradle
  22. BUILDING.md
  23. CONTRIBUTING.md
  24. Dockerfile
  25. gradlew
  26. gradlew.bat
  27. jarjar-rules.txt
  28. LICENSE
  29. MODULE_LICENSE_APACHE2
  30. NOTICE
  31. OWNERS
  32. PREUPLOAD.cfg
  33. README.md
  34. RELEASING.md
  35. settings.gradle
README.md

Conscrypt - A Java Security Provider

Conscrypt is a Java Security Provider (JSP) that implements parts of the Java Cryptography Extension (JCE) and Java Secure Socket Extension (JSSE). It uses BoringSSL to provide cryptograhpic primitives and Transport Layer Security (TLS) for Java applications on Android and OpenJDK.

The core SSL engine has borrowed liberally from the Netty project and their work on netty-tcnative, giving Conscrypt similar performance.

Download

NOTE: This section is under construction! Artifacts have not yet been published to the public Maven repositories.

Download JARs

You can download the JARs directly from the Maven repositories.

OpenJDK (i.e. non-Android)

Native Classifiers

The OpenJDK artifacts are platform-dependent, since each embeds a native library for a particular platform. We publish artifacts to Maven Central for the following platforms:

ClassifierDescription
windows-x86_64Windows distribution
osx-x86_64Mac distribution
linux-x86_64Used for Linux
Maven

Use the os-maven-plugin to add the dependency:

<build>
  <extensions>
    <extension>
      <groupId>kr.motd.maven</groupId>
      <artifactId>os-maven-plugin</artifactId>
      <version>1.4.1.Final</version>
    </extension>
  </extensions>
</build>

<dependency>
  <groupId>org.conscrypt</groupId>
  <artifactId>conscrypt-openjdk</artifactId>
  <version>1.1.0-SNAPSHOT</version>
  <classifier>${os.detected.classifier}</classifier>
</dependency>
Gradle

Use the osdetector-gradle-plugin (which is a wrapper around the os-maven-plugin) to add the dependency:

buildscript {
  repositories {
    mavenCentral()
  }
  dependencies {
    classpath 'com.google.gradle:osdetector-gradle-plugin:1.4.0'
  }
}

// Use the osdetector-gradle-plugin
apply plugin: "com.google.osdetector"

dependencies {
  compile 'org.conscrypt:conscrypt-jdk:1.1.0-SNAPSHOT:' + osdetector.classifier
}
Uber JAR

For convenience, we also publish an Uber JAR to Maven Central that contains the shared libraries for all of the published platforms. While the overall size of the JAR is larger than depending on a platform-specific artifact, it greatly simplifies the task of dependency management for most platforms.

To depend on the uber jar, simply use the conscrypt-openjdk-uber artifacts.

Maven
<dependency>
  <groupId>org.conscrypt</groupId>
  <artifactId>conscrypt-openjdk-uber</artifactId>
  <version>1.1.0-SNAPSHOT</version>
</dependency>
Gradle
dependencies {
  compile 'org.conscrypt:conscrypt-jdk-uber:1.1.0-SNAPSHOT'
}

How to Build

If you are making changes to Conscrypt, see the building instructions.

Source Overview

Here‘s a quick readers’ guide to the code to help folks get started. The high-level modules are Common, Android, OpenJDK, and Platform.

Common

This contains the bulk of the code for both Java and C. This isn't an actual module and builds no artifacts. Rather, the other modules just point to this directory as source.

Android

This module provides the Platform class for Android and also adds compatibility classes for supporting various versions of Android. This generates an aar library artifact.

OpenJDK

This modules provides the Platform class for non-Android (OpenJDK-based) systems. It also provides a native library loader supports bundling the shared library with the JAR.

Platform

This is not an actual module and is not part of the default build. This is used for building Conscrypt as an embedded component of the Android platform.