AESJniEncrypt 的安装和配置教程

项目基础介绍

AESJniEncrypt 是一个基于 Android 平台的加密解密开源项目，主要利用.libsodium 库实现了 CHACHA20 算法。该算法在移动设备上具有高性能，特别适用于 ARM 架构。项目的目标是提高 Android 应用程序的安全性，通过在 native 层面进行加密操作，增强数据保护。

主要编程语言

• C：用于实现加密算法和与 Java 代码的 JNI（Java Native Interface）交互。
• Java：Android 应用程序的主要开发语言，用于调用 native 层面的加密方法。

关键技术和框架

• libsodium：一个现代化的加密库，提供了多种加密算法，本项目使用其 CHACHA20 算法进行数据加密。
• JNI：允许 Java 代码调用其他语言的代码，本项目通过 JNI 调用 C 代码进行加密操作。
• Obfuscator-LLVM：一个用于混淆 native 代码的工具，可以提高代码的安全性，防止逆向工程。

准备工作

在开始安装之前，请确保您的开发环境满足以下要求：

• 安装有 Android Studio。
• 配置好 Android NDK。
• 确保您的系统中已安装 Python，因为构建过程中可能会用到。

安装步骤

1. 克隆项目仓库 打开命令行工具，执行以下命令克隆项目：

   git clone https://github.com/BruceWind/AESJniEncrypt.git
   cd AESJniEncrypt
   

2. 构建 libsodium 库 在项目目录下，运行以下脚本构建适用于所有 Android ABIs 的 libsodium 静态库：

   ./build_libsodium_for_all_android_abi.sh
   

   如果遇到错误，如缺少 Python 等问题，请根据错误提示解决。

3. 集成到 Android 项目 a. 在 Android Studio 中，将 aesjni 目录导入到您的项目中。 b. 在项目的 local.properties 文件中设置 ndk.dir 路径。 c. 修改 Java 类和方法的名称，不要直接暴露加密算法的名称，确保 C 函数中密钥的存储安全。 d. 生成并修改签名。如果您还没有 Keystore 文件，您需要创建一个。以下是创建 Keystore 的示例命令：

   keytool -genkey -alias client1 -keypass 123456 -keyalg RSA -keysize 1024 -validity 365 -storetype PKCS12 -keystore ./androidyuan.keystore
   

   e. 在 check_signature.h 文件中修改 Keystore 的哈希值和包名。

4. 配置 Obfuscator-LLVM（可选） 如果您需要混淆 native 代码以提高安全性，您需要在 aesjni/build.gradle 文件中配置 externalNativeBuild 和 Obfuscator-LLVM。有关配置的详细指南，请参考项目 README 文件。

完成以上步骤后，您就可以开始在 Android 项目中使用 AESJniEncrypt 进行加密和解密操作了。请确保仔细阅读项目文档，了解所有配置细节和使用方法。