QzoneArchive Android构建指南Tauri移动开发完整上手教程【免费下载链接】QzoneArchive将 QQ 空间历史动态、照片、视频与互动记录安全归档到本地的桌面 / 移动端工具。项目地址: https://gitcode.com/gh_mirrors/qz/QzoneArchiveQzoneArchive 是一款将 QQ 空间动态、照片、视频与互动记录安全归档到本地的桌面/移动端工具。本文是一份面向新手的Tauri 2 Android 构建完整教程从环境安装、一键编译到模拟器运行再到打包签名发布版 APK带你 30 分钟把 QQ 空间归档工具装进自己的手机 为什么值得自建 QzoneArchive 的 Android 版QQ 空间的资料会随时间流失而 QzoneArchive 的核心能力全部可以在手机上使用完整归档还原原始动态正文、图片、视频和评论按「本人动态 / 好友动态 / 留言」分类断点续传网络中断后自动从上次位置继续已归档内容不丢失频率保护每 10 分钟最多请求 300 页触发限流后安全暂停本地存储所有数据以 SQLite 保存在本机不上传任何服务器Android 端使用移动端二维码扫码登录全程不接触账号密码。下面这张图就是归档完成后手机里可以看到的应用主界面Android 构建环境前置要求清单动手前先对照检查环境这是 Tauri 移动开发最常见的卡点来源组件版本要求用途Node.js20前端 Vite 构建与 Tauri CLI 调用Rust1.77编译 Rust 后端含 src-tauri/src/qzone.rs 归档引擎Android Studio最新版图形化配置 SDK/NDKAndroid SDK平台 34打包 APK 系统依赖Android NDK25 及以上交叉编译 Rust 为.so动态库JDK17Gradle 构建 建议用 Android Studio 的 SDK Manager 一次性装齐NDK和CMake否则后续编译会在 NDK 检测阶段失败。克隆仓库并安装前端依赖打开终端执行git clone https://gitcode.com/gh_mirrors/qz/QzoneArchive cd QzoneArchive npm installnpm install会安装 package.json 中声明的 Vue 3、PrimeVue、Pinia 以及tauri-apps/cliTauri 命令行工具Android 构建全靠它驱动。一条命令把 QzoneArchive 编译到 Android 模拟器启动一个 Android 模拟器或在真机上开启 USB 调试然后执行npm run tauri android dev这条命令背后的完整流程是Tauri CLI 校验 src-tauri/tauri.android.conf.json 中的 Android 专属配置如移动端产品名QArchive为 4 种 CPU 架构目标aarch64 / armv7 / i686 / x86_64交叉编译 Rust 代码生成.so库Gradle 把 Rust 产物与前端打包成 debug APK自动安装并启动。首次运行时如果提示配置按引导在 Android Studio 中确认 SDK 目录即可。看到模拟器中打开的应用说明整条 Tauri 移动端构建链路已经通了 ✅构建签名后的发布版 APKdebug 包只适合开发验证发给别人安装需要 release 包npm run tauri android build --apk产物位置src-tauri/gen/android/app/build/outputs/apk/universal/release/默认生成覆盖全部 ABI 的 APK签名构建产出的是未签名 APK需用apksigner配合 keystore 签名后才能分发。仓库根目录自带发布签名密钥文件 release.jks可自行用于签名。提速技巧默认会为 4 种 ABI 各编译一遍 Rust非常耗时。如果只装手机基本是 arm64可以在 src-tauri/gen/android/gradle.properties 中加一行abiListarm64-v8a构建时间能缩短大半。归档任务界面同样完整移植到了移动端长任务可随时挂起继续Android 侧关键文件速览生成工程位于src-tauri/gen/android/理解这几个文件即可掌握 Tauri 的移动端结构AndroidManifest.xml声明INTERNET权限归档必须联网拉取数据、singleTask启动模式和 FileProviderMainActivity.kt应用唯一入口 Activity启用全屏边缘到边缘显示RustPlugin.kt核心构建插件为每种 ABI 生成 productFlavor 和rustBuild*任务并支持abiList/archList/targetList属性裁剪目标BuildTask.kt实际执行npm run tauri android android-studio-script --target 目标完成单个架构的 Rust 编译src-tauri/src/qlogin.rsQQ 登录模块移动端走二维码扫码流程。权限配置在 src-tauri/capabilities/default.json 中统一管理桌面与 Android 共用同一套前端能力声明。常见构建报错与解决方法报错现象原因解决方法Android SDK not found未设置 SDK 路径在 Android Studio 中完成 SDK 授权或配置ANDROID_HOME与local.properties的sdk.dirNDK not configured缺 NDKSDK Manager 中安装 NDKSide by side25构建极慢默认编译 4 种 ABIgradle.properties中设abiListarm64-v8a收窄目标cargo找不到目标Rust 交叉目标未安装Tauri CLI 会自动rustup target add手动场景可先执行对应命令应用无法联网拉取数据未授予 INTERNET 权限检查 AndroidManifest.xml 权限声明是否被改动小结至此你已经完整走通了QzoneArchive 的 Tauri Android 构建流程环境装齐 →npm run tauri android dev调试 →npm run tauri android build --apk出包 → 签名安装。Tauri 2 的移动端方案本质上就是Rust 交叉编译 Gradle 组装掌握了这条链路后续改前端src/views/或 Rust 后端src-tauri/src/都能用同一套命令快速验证。更多开发细节可参考 website/development/index.md 与 CONTRIBUTING.md 贡献指南。【免费下载链接】QzoneArchive将 QQ 空间历史动态、照片、视频与互动记录安全归档到本地的桌面 / 移动端工具。项目地址: https://gitcode.com/gh_mirrors/qz/QzoneArchive创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考