| Bouncy Castle on the Android platform. |
| --- |
| |
| The code in this directory is based on $BOUNCYCASTLE_VERSION in the |
| file bouncycastle.version. See patches/README for more information on |
| how the code differs from $BOUNCYCASTLE_VERSION. |
| |
| Porting New Versions of Bouncy Castle. |
| -- |
| |
| The following steps are recommended for porting new Bouncy Castle versions. |
| |
| 1) Retrieve the appropriate version of the Bouncy Castle source from |
| www.bouncycastle.org/latest_releases.html (in bcprov-jdk*-*.tar.gz |
| file). Check the checksum (found at http://bouncycastle.org/checksums.html) with: |
| |
| md5sum bcprov-jdk*-*.tar.gz |
| sha1sum bcprov-jdk*-*.tar.gz |
| |
| 2) Update the variables in bouncycastle.config and bouncycastle.version as appropriate. |
| At the very least you will need to update the bouncycastle.version. |
| Similarly update ThirdPartyProject.prop. |
| |
| 3) Run: |
| |
| ./import_bouncycastle.sh import bcprov-jdk*-*.tar.gz |
| |
| 4) If there are any errors, then modify bouncycastle.config, bouncycastle.version |
| and patches in patches/ as appropriate. You might want to use: |
| |
| ./import_bouncycastle.sh regenerate patches/*.patch |
| |
| Repeat step 3. |
| |
| 5) Cleanup before building with: |
| |
| m -j16 clean-bouncycastle |
| |
| 6) Build the bouncycastle target from the external/bouncycastle directory with: |
| |
| mm -j16 snod && adb sync system |
| |
| If there are build errors, then patches/*.mk or bouncycastle.config |
| may need updating. |
| |
| 7) Run tests to make sure things are working: |
| |
| Some suggested tests by area: |
| - java.security.Provider |
| libcore/luni/src/test/java/libcore/java/security/ProviderTest.java |
| libcore/luni/src/test/java/org/apache/harmony/security/tests/java/security/ProviderTest.java |
| - java.security.AlgorithmParameterGenerator |
| libcore/luni/src/test/java/libcore/java/security/OldAlgorithmParameterGeneratorTest.java |
| libcore/luni/src/test/java/libcore/javax/crypto/spec/AlgorithmParameterGeneratorTestDH.java |
| libcore/luni/src/test/java/libcore/javax/crypto/spec/AlgorithmParameterGeneratorTestDSA.java |
| - java.security.AlgorithmParameters |
| libcore/luni/src/test/java/libcore/javax/crypto/spec/AlgorithmParametersTestDSA.java |
| libcore/luni/src/test/java/libcore/javax/crypto/spec/AlgorithmParametersTestAES.java |
| libcore/luni/src/test/java/libcore/javax/crypto/spec/AlgorithmParametersTestDH.java |
| libcore/luni/src/test/java/libcore/javax/crypto/spec/AlgorithmParametersTestDESede.java |
| libcore/luni/src/test/java/libcore/javax/crypto/spec/AlgorithmParametersTestDES.java |
| libcore/luni/src/test/java/libcore/javax/crypto/spec/AlgorithmParametersTestOAEP.java |
| libcore/luni/src/test/java/org/apache/harmony/security/tests/java/security/AlgorithmParametersTest.java |
| - java.security.cert.CertPathBuilder |
| libcore/luni/src/test/java/tests/targets/security/cert/CertPathBuilderTestPKIX.java |
| - java.security.cert.CertPathValidator |
| libcore/luni/src/test/java/tests/targets/security/cert/CertPathValidatorTestPKIX.java |
| - java.security.cert.CertStore |
| libcore/luni/src/test/java/tests/security/cert/CertStoreSpiTest.java |
| libcore/luni/src/test/java/tests/security/cert/CertStore2Test.java |
| libcore/luni/src/test/java/tests/security/cert/CertStore1Test.java |
| libcore/luni/src/test/java/tests/security/cert/CertStoreExceptionTest.java |
| - java.security.cert.CertificateFactory |
| libcore/luni/src/test/java/libcore/java/security/cert/CertificateFactoryTest.java |
| libcore/luni/src/test/java/tests/targets/security/cert/CertificateFactoryTestX509.java |
| - javax.crypto.Cipher |
| libcore/luni/src/test/java/libcore/javax/crypto/CipherTest.java |
| libcore/luni/src/test/java/org/apache/harmony/crypto/tests/javax/crypto/CipherTest.java |
| libcore/luni/src/test/java/org/apache/harmony/crypto/tests/javax/crypto/NullCipherTest.java |
| - javax.crypto.KeyAgreement |
| libcore/luni/src/test/java/org/apache/harmony/crypto/tests/javax/crypto/KeyAgreementTest.java |
| - java.security.KeyFactory |
| libcore/luni/src/test/java/libcore/javax/crypto/spec/KeyFactoryTestDH.java |
| libcore/luni/src/test/java/libcore/javax/crypto/spec/KeyFactoryTestDSA.java |
| libcore/luni/src/test/java/libcore/javax/crypto/spec/KeyFactoryTestRSA.java |
| libcore/luni/src/test/java/org/apache/harmony/security/tests/java/security/KeyFactoryTest.java |
| - javax.crypto.KeyGenerator |
| libcore/luni/src/test/java/libcore/javax/crypto/KeyGeneratorTest.java |
| libcore/luni/src/test/java/org/apache/harmony/crypto/tests/javax/crypto/KeyGeneratorTest.java |
| - javax.net.ssl.KeyManagerFactory |
| libcore/luni/src/test/java/libcore/javax/net/ssl/KeyManagerFactoryTest.java |
| - java.security.KeyPairGenerator |
| libcore/luni/src/test/java/libcore/java/security/KeyPairGeneratorTest.java |
| libcore/luni/src/test/java/libcore/java/security/OldKeyPairGeneratorTestDH.java |
| libcore/luni/src/test/java/libcore/javax/crypto/spec/KeyPairGeneratorTestRSA.java |
| libcore/luni/src/test/java/libcore/javax/crypto/spec/KeyPairGeneratorTestDSA.java |
| libcore/luni/src/test/java/libcore/javax/crypto/spec/KeyPairGeneratorTestDH.java |
| libcore/luni/src/test/java/tests/security/interfaces/DSAKeyPairGeneratorTest.java |
| - java.security.KeyStore |
| libcore/luni/src/test/java/libcore/java/security/KeyStoreTest.java |
| libcore/luni/src/test/java/org/apache/harmony/security/tests/java/security/KeyStoreTest.java |
| libcore/luni/src/test/java/org/apache/harmony/security/tests/java/security/KeyStore2Test.java |
| - javax.crypto.Mac |
| libcore/luni/src/test/java/org/apache/harmony/crypto/tests/javax/crypto/MacTest.java |
| - java.security.MessageDigest |
| libcore/luni/src/test/java/libcore/java/security/MessageDigestTest.java |
| libcore/luni/src/test/java/tests/targets/security/MessageDigestTestMD2.java |
| libcore/luni/src/test/java/tests/targets/security/MessageDigestTestMD5.java |
| libcore/luni/src/test/java/tests/targets/security/MessageDigestTestSHA256.java |
| libcore/luni/src/test/java/tests/targets/security/MessageDigestTestSHA1.java |
| libcore/luni/src/test/java/tests/targets/security/MessageDigestTestSHA512.java |
| libcore/luni/src/test/java/tests/targets/security/MessageDigestTestSHA384.java |
| - javax.net.ssl.SSLContext |
| libcore/luni/src/test/java/libcore/javax/net/ssl/SSLContextTest.java |
| - javax.crypto.SecretKeyFactory |
| libcore/luni/src/test/java/libcore/javax/crypto/SecretKeyFactoryTest.java |
| libcore/luni/src/test/java/org/apache/harmony/crypto/tests/javax/crypto/SecretKeyFactoryTest.java |
| - java.security.SecureRandom |
| libcore/luni/src/test/java/libcore/java/security/SecureRandomTest.java |
| libcore/luni/src/test/java/tests/java/security/SecureRandomTest.java |
| libcore/luni/src/test/java/tests/targets/security/SecureRandomTestSHA1PRNG.java |
| - java.security.Signature |
| libcore/luni/src/test/java/libcore/java/security/SignatureTest.java |
| libcore/luni/src/test/java/org/apache/harmony/xnet/provider/jsse/OpenSSLSignatureTest.java |
| libcore/luni/src/test/java/org/apache/harmony/security/tests/java/security/SignatureTest.java |
| libcore/luni/src/test/java/tests/targets/security/SignatureTestMD2withRSA.java |
| - javax.net.ssl.TrustManagerFactory |
| libcore/luni/src/test/java/libcore/javax/net/ssl/TrustManagerFactoryTest.java |
| - javax.net.ssl.SSLSocket and javax.net.ssl.SSLEngine (which touch on Cipher, MessageDigest, Signature) |
| libcore/luni/src/test/java/libcore/javax/net/ssl/ |
| - Test Android additions to bouncycastle such as org.bouncycastle.crypto.digests.OpenSSLDigest and org.bouncycastle.jce.provider.CertBlacklist |
| libcore/luni/src/test/java/com/android/org/bouncycastle/ |
| |
| 8) Do a full build before checking in: |
| |
| m -j16 |
