• Home
Name Date Size #Lines LOC

..--

android/03-May-2024-2,4181,798

android-stub/03-May-2024-938511

apex/03-May-2024-418315

api/03-May-2024-344276

api-doclet/03-May-2024-159102

benchmark-android/03-May-2024-784536

benchmark-base/03-May-2024-1,331846

benchmark-graphs/03-May-2024-259204

benchmark-jmh/03-May-2024-1,210815

common/src/03-May-2024-79,32260,869

constants/03-May-2024-203153

gradle/03-May-2024-7867

libcore-stub/03-May-2024-256123

licenses/03-May-2024-404338

openjdk/03-May-2024-10,6078,287

openjdk-uber/03-May-2024-9179

platform/03-May-2024-3,7492,725

publicapi/src/03-May-2024-365223

release/03-May-2024-508364

repackaged/03-May-2024-76,70754,268

srcgen/03-May-2024-516485

test-support/03-May-2024-373238

testing/03-May-2024-8,2105,882

.clang-formatD03-May-2024268 1715

.gitignoreD03-May-2024249 3224

.lgtm.ymlD03-May-2024866 2219

.travis.ymlD03-May-20245.1 KiB12898

Android.bpD03-May-202414.7 KiB586513

BUILDING.mdD03-May-20243.7 KiB131102

CAPABILITIES.mdD03-May-20245.7 KiB233188

CONTRIBUTING.mdD03-May-20242.3 KiB6140

CPPLINT.cfgD03-May-202483 54

IMPLEMENTATION_NOTES.mdD03-May-20242.3 KiB4636

LICENSED03-May-202411.1 KiB203169

MODULE_LICENSE_APACHE2D03-May-20240

NOTICED03-May-20241.1 KiB3123

OWNERSD03-May-2024132 87

PREUPLOAD.cfgD03-May-202478 54

README.androidD03-May-2024283 1311

README.mdD03-May-20243.7 KiB142112

build.gradleD03-May-20248.8 KiB244211

gradlewD03-May-20245.8 KiB189128

gradlew.batD03-May-20242.9 KiB10176

settings.gradleD03-May-20241.5 KiB2927

test_logging.propertiesD03-May-2024421 1410

README.android

1Conscrypt in Android is made up of the contents of the Conscrypt
2GitHub repo (https://github.com/google/conscrypt) plus some
3Android-specific additions.  Specifically, the following are
4Android-only:
5
6Android.bp
7OWNERS
8README.android
9apex/...
10publicapi/...
11repackaged/...
12srcgen/...
13

README.md

1Conscrypt - A Java Security Provider
2========================================
3
4Conscrypt is a Java Security Provider (JSP) that implements parts of the Java
5Cryptography Extension (JCE) and Java Secure Socket Extension (JSSE).  It uses
6BoringSSL to provide cryptographic primitives and Transport Layer Security (TLS)
7for Java applications on Android and OpenJDK.  See [the capabilities
8documentation](CAPABILITIES.md) for detailed information on what is provided.
9
10The core SSL engine has borrowed liberally from the [Netty](http://netty.io/) project and their
11work on [netty-tcnative](http://netty.io/wiki/forked-tomcat-native.html), giving `Conscrypt`
12similar performance.
13
14<table>
15  <tr>
16    <td><b>Homepage:</b></td>
17    <td>
18      <a href="https://conscrypt.org/">conscrypt.org</a>
19    </td>
20  </tr>
21  <tr>
22    <td><b>Mailing List:</b></td>
23    <td>
24      <a href="https://groups.google.com/forum/#!forum/conscrypt">conscrypt@googlegroups.com</a>
25    </td>
26  </tr>
27</table>
28
29Download
30-------------
31Conscrypt supports **Java 7** or later on OpenJDK and **Gingerbread (API Level
329)** or later on Android.  The build artifacts are available on Maven Central.
33
34### Download JARs
35You can download
36[the JARs](http://search.maven.org/#search%7Cga%7C1%7Cg:%22org.conscrypt%22)
37directly from the Maven repositories.
38
39### OpenJDK (i.e. non-Android)
40
41#### Native Classifiers
42
43The OpenJDK artifacts are platform-dependent since each embeds a native library for a particular
44platform. We publish artifacts to Maven Central for the following platforms:
45
46Classifier | OS | Architecture
47-----------| ------- | ---------------- |
48linux-x86_64 | Linux | x86_64 (64-bit)
49osx-x86_64 | Mac | x86_64 (64-bit)
50windows-x86 | Windows | x86 (32-bit)
51windows-x86_64 | Windows | x86_64 (64-bit)
52
53#### Maven
54
55Use the [os-maven-plugin](https://github.com/trustin/os-maven-plugin) to add the dependency:
56
57```xml
58<build>
59  <extensions>
60    <extension>
61      <groupId>kr.motd.maven</groupId>
62      <artifactId>os-maven-plugin</artifactId>
63      <version>1.4.1.Final</version>
64    </extension>
65  </extensions>
66</build>
67
68<dependency>
69  <groupId>org.conscrypt</groupId>
70  <artifactId>conscrypt-openjdk</artifactId>
71  <version>2.4.0</version>
72  <classifier>${os.detected.classifier}</classifier>
73</dependency>
74```
75
76#### Gradle
77Use the [osdetector-gradle-plugin](https://github.com/google/osdetector-gradle-plugin)
78(which is a wrapper around the os-maven-plugin) to add the dependency:
79
80```gradle
81buildscript {
82  repositories {
83    mavenCentral()
84  }
85  dependencies {
86    classpath 'com.google.gradle:osdetector-gradle-plugin:1.4.0'
87  }
88}
89
90// Use the osdetector-gradle-plugin
91apply plugin: "com.google.osdetector"
92
93dependencies {
94  compile 'org.conscrypt:conscrypt-openjdk:2.4.0:' + osdetector.classifier
95}
96```
97
98#### Uber JAR
99
100For convenience, we also publish an Uber JAR to Maven Central that contains the shared
101libraries for all of the published platforms. While the overall size of the JAR is
102larger than depending on a platform-specific artifact, it greatly simplifies the task of
103dependency management for most platforms.
104
105To depend on the uber jar, simply use the `conscrypt-openjdk-uber` artifacts.
106
107##### Maven
108```xml
109<dependency>
110  <groupId>org.conscrypt</groupId>
111  <artifactId>conscrypt-openjdk-uber</artifactId>
112  <version>2.4.0</version>
113</dependency>
114```
115
116##### Gradle
117```gradle
118dependencies {
119  compile 'org.conscrypt:conscrypt-openjdk-uber:2.4.0'
120}
121```
122
123### Android
124
125The Android AAR file contains native libraries for x86, x86_64, armeabi-v7a, and
126arm64-v8a.
127
128#### Gradle
129
130```gradle
131dependencies {
132  implementation 'org.conscrypt:conscrypt-android:2.4.0'
133}
134```
135
136
137How to Build
138------------
139
140If you are making changes to Conscrypt, see the [building
141instructions](BUILDING.md).
142