• Home
Name Date Size #Lines LOC

..--

android/03-May-2024-2,4821,832

android-stub/03-May-2024-1,063594

apex/03-May-2024-862730

api/03-May-2024-330267

api-doclet/03-May-2024-161104

benchmark-android/03-May-2024-788540

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-83,98064,148

constants/03-May-2024-203153

gradle/03-May-2024-7968

libcore-stub/03-May-2024-256123

licenses/03-May-2024-404338

openjdk/03-May-2024-10,7498,412

openjdk-uber/03-May-2024-10088

platform/03-May-2024-3,8712,805

publicapi/src/03-May-2024-472276

release/03-May-2024-508364

repackaged/03-May-2024-81,60557,704

srcgen/03-May-2024-555524

test-support/03-May-2024-382246

testing/03-May-2024-8,3546,003

.clang-formatD03-May-2024268 1715

.gitignoreD03-May-2024231 3123

.lgtm.ymlD03-May-2024866 2219

.travis.ymlD03-May-20244.6 KiB11888

Android.bpD03-May-202418.8 KiB701624

BUILDING.mdD03-May-20243.7 KiB131102

CAPABILITIES.mdD03-May-20245.8 KiB236191

CONTRIBUTING.mdD03-May-20242.3 KiB6140

CPPLINT.cfgD03-May-202483 54

IMPLEMENTATION_NOTES.mdD03-May-20242.6 KiB5240

LICENSED03-May-202411.1 KiB203169

METADATAD03-May-202439 43

MODULE_LICENSE_APACHE2D03-May-20240

NOTICED03-May-20241.1 KiB3123

OWNERSD03-May-2024136 87

PREUPLOAD.cfgD03-May-2024226 96

README.androidD03-May-2024283 1311

README.mdD03-May-20243.7 KiB142112

build.gradleD03-May-20249 KiB248215

gradle.propertiesD03-May-202425 21

gradlewD03-May-20245.6 KiB186125

gradlew.batD03-May-20243 KiB10578

lint-baseline.xmlD03-May-2024637 1613

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.5.2</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.5.2:' + 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.5.2</version>
113</dependency>
114```
115
116##### Gradle
117```gradle
118dependencies {
119  compile 'org.conscrypt:conscrypt-openjdk-uber:2.5.2'
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.5.2'
133}
134```
135
136
137How to Build
138------------
139
140If you are making changes to Conscrypt, see the [building
141instructions](BUILDING.md).
142