BoringSSL Android

boringssl static library prefab for android

This library is based on the boringssl AOSP repo.

Integration

Gradle:

implementation 'io.github.vvb2060.ndk:boringssl:3.0'

This library is Prefab, so you will need to enable it in your project (Android Gradle Plugin 4.1+):

android {
    ...
    buildFeatures {
        ...
        prefab true
    }
}

Usage

ndk-build

you can use crypto_static/ssl_static in your Android.mk. For example, if your application defines libapp.so and it uses ssl_static, your Android.mk file should include the following:

include $(CLEAR_VARS)
LOCAL_MODULE           := app
LOCAL_SRC_FILES        := app.cpp
LOCAL_STATIC_LIBRARIES := ssl_static
include $(BUILD_SHARED_LIBRARY)

# If you don't need your project to build with NDKs older than r21, you can omit
# this block.
ifneq ($(call ndk-major-at-least,21),true)
    $(call import-add-path,$(NDK_GRADLE_INJECTED_IMPORT_PATH))
endif

$(call import-module,prefab/boringssl)

CMake

you can use crypto_static/ssl_static in your CMakeLists.txt. For example, if your application defines libapp.so and it uses crypto_static, your CMakeLists.txt file should include the following:

add_library(app SHARED app.cpp)

# Add these two lines.
find_package(boringssl REQUIRED CONFIG)
target_link_libraries(app boringssl::crypto_static)

git submodule

If you don't want to use prefab and want to compile entirely from source code, for example to enable LTO, you can import this project as a git submodule.

include $(CLEAR_VARS)
LOCAL_MODULE           := app
LOCAL_SRC_FILES        := app.cpp
LOCAL_STATIC_LIBRARIES := ssl_static
include $(BUILD_SHARED_LIBRARY)

include [submodule path]/boringssl/src/main/native/BoringSSL.mk