lock_folder/androidApp/README.md

LockX - Android 文件加密浏览器

基于 fast_media_lock.py 加密算法的 Android 文件加密/解密浏览器应用。

功能

• 本机文件浏览: 浏览本地文件系统，支持媒体文件过滤
• SFTP 远程浏览: 连接远程 SSH 服务器，浏览远程文件
• 加密: 点击文件后选择"加密"，输入密码（需确认），对文件前 N MB 进行加密
• 解密: 点击文件后选择"解密"，输入密码，解密文件
• 互通: 加密解密算法与 Python 脚本完全兼容

加密算法

• 使用 BouncyCastle SCrypt (N=16384, r=8, p=1, dklen=64)
• HMAC-SHA256 密钥流 + XOR 加密前 N MB
• 元数据嵌入文件尾部（magic + version + chunk_size + original_size + salt + nonce + verifier + crc32）
• 加密后文件名追加 .lockx 后缀

构建

需要 Android Studio (Arctic Fox 或更高版本) 打开此项目。

# 或者使用命令行（需安装 Android SDK）
./gradlew assembleDebug

依赖

• AndroidX Compose (Material3)
• BouncyCastle (bcprov-jdk18on:1.77)
• SSHJ (0.36.0)

权限

• INTERNET - SFTP 连接
• READ/WRITE_EXTERNAL_STORAGE - 文件浏览（Android 12 及以下）

兼容性

• minSdk: 24 (Android 7.0)
• targetSdk: 34 (Android 14)