# chromium-net

**Repository Path**: wolfcs/chromium-net

## Basic Information

- **Project Name**: chromium-net
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2020-09-11
- **Last Updated**: 2025-04-14

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

chromium-net
==========

chromium-net 是一个独立的网络库，它包含了著名的开源浏览器 Chromium 项目中网络相关的代码，包括 net 库，url 库，SSL 库，以及 Android 平台的 Java 封装等。它同时还是一个跨平台库，可以应用于 Android 等移动平台。

chromium-net 库的优势：
 * 全平台支持最新版TLS。不像 OkHttp 这样依赖系统提供 SSL/TLS 加解密功能的网络库，chromium-net 自身包含 SSL 库，因而可以全平台支持安全性更高的最新版 TLS。
 * 全平台支持 HTTP/2。HTTP/2 的协议协商，需要用到 TLS 较新的扩展 ALPN，同时 HTTP/2 对 TLS 加密套件也有一定的要求，由于自身包含 SSL 库，使得 HTTP/2 的这些要求在任何平台都变得易于满足。
* 全平台支持 QUIC 协议。chromium-net 目前是 Android 平台支持 QUIC 协议仅有的选择。

在Linux平台上构建
-----------------

1. 克隆本仓库
   ```
   $ git clone https://github.com/hanpfei/chromium-net.git
   $ cd chromium-net
   ```

2. 如果你是第一次构建，则安装依赖
   ```
   $ ./build/install-build-deps.sh
   ```

3. 配置编译环境

   本repo包含两个branch，分别为master和cronet。master branch的代码可以分别编译出net等独立的共享库。cornet branch的代码则可以用于编译    chromium net android 平台的封装cronet。
   要想编译cronet，则首先切换至cronet branch。然后编辑out/Default/args.gn文件，依据自己本地的环境，修改android_sdk_root指向自己本地Android SDK的安装目录；修改android_ndk_root指向自己本地的NDK目录（要求NDK版本为R10）；可以根据需要配置target_cpu。

4. 构建Cronet
   ```
   $ gn gen out/Default/
   $ ninja -C out/Default/ cronet
   $ ninja -C out/Default/ cronet_java
   ```
5. 导入二进制文件

   像通常使用第三方Java库那样，将如下的jar文件导入Android工程：
   ```
   out/Default/lib.java/base/base_java.jar
   out/Default/lib.java/components/cronet/android/cronet_api.jar
   out/Default/lib.java/components/cronet/android/cronet_java.jar
   out/Default/lib.java/net/android/net_java.jar
   out/Default/lib.java/url/url_java.jar
   ```

   像通常使用第三方共享库文件那样，导入如下共享库文件：

   ```
   out/Default/libcronet.so
   ```

在Android工程的Java代码中使用Chromium net库。