知行网络学堂 Android

这是 https://www.jasonsome.cn 的 Capacitor Android 客户端。

当前版本：1.14.4（versionCode 19）。App 内“下载中心”可以查看下载任务，“我的 → App 设置”可以选择文件保存文件夹和界面配色， 文档预览与下载使用不同链路，预览不会自动触发下载。

QQ 登录

• 移动应用 APP ID：1904508499
• Android 包名：cn.bestijason.networkstudy
• QQ OpenSDK：3.5.19 Lite
• SDK SHA-256：9D57FE61FF9026D34AC84BC63DC719F61DA6AA40533A299CC6F73D4CE9DF7AF8

APP Key 属于服务端密钥，不写入 APK，也不会提交到公开仓库。原生客户端只把 QQ 授权返回的 access_token 和 openid 交给 www.jasonsome.cn 服务端校验。

1.14.4 更新

• 原生图谱入口现在直接进入教材知识图谱，避免增加底部按钮也能快速查看教材图谱。
• APK 发布资产统一命名为 network-study-android-v版本号.apk，并通过 www.jasonsome.cn/downloads 自有静态镜像分发，减少下载慢和失败。
• 非对话页右上角入口改为“下载中心”，集中展示下载进度、打开与删除任务。
• WebView User-Agent 和原生桥版本同步为 NetworkStudyAndroid/1.14.4。

1.14.2 更新

• App 下载改为应用内任务中心：显示进度、保留普通文件、支持打开/删除，更新包下载完成后自动打开安装器。
• 文件夹选择入口补充当前目录定位与现代化提示，上传入口同步优化触控样式。
• WebView User-Agent 和原生桥版本同步为 NetworkStudyAndroid/1.14.2。

1.14.1 更新

• QQ 原生授权回调会透传 SDK 可能返回的 QQ 号字段，配合 Web 后端统一 Web/APK 的 QQ 绑定标识。
• WebView User-Agent 和原生桥版本同步为 NetworkStudyAndroid/1.14.1。

1.14.0 更新

• 进入对话详情时原生层只触发一次滚到底部，避免后续生成时持续抢占用户滚动。
• WebView User-Agent 和原生桥版本同步为 NetworkStudyAndroid/1.14.0。

1.13.0 更新

• 后台生成稳定性继续增强：生成开始时提示系统允许后台运行，网页端同步走同源服务端流式中继，降低 WebView 切后台导致的 network error 和对话丢失。
• WebView User-Agent 和原生桥版本同步为 NetworkStudyAndroid/1.13.0。

1.12.0 更新

• 真正退出 App：一级页二次返回执行 finishAndRemoveTask/finishAffinity 并结束进程，不再只是退到后台。
• 后台生成保活：生成中启动前台服务和 WakeLock，降低切后台后的 network error 与对话丢失概率。
• 进入会话详情后多次触发网页滑底事件，确保 APK 进入对话自动定位到最新消息。
• 图片查看原图支持双指缩放，返回键可关闭预览，不再全屏卡住 WebView。
• App 下载更新改用 www.jasonsome.cn/downloads 自有域名镜像，减少 GitHub 原链下载失败。
• WebView User-Agent 和原生桥版本同步为 NetworkStudyAndroid/1.12.0。

1.11.0 更新

• 修复原生返回栈：会话详情返回到“对话”页，一级页连续返回才退出 App。
• 增加 App 前后台 lifecycle 事件，便于网页端恢复后台生成中的会话状态。
• WebView User-Agent 和原生桥版本同步为 NetworkStudyAndroid/1.11.0。

1.9 更新

• 原生 QQ 登录继续使用用户提供的 QQ OpenSDK 3.5.19 Lite，并保持移动应用 APP ID 1904508499。
• WebView User-Agent 和原生桥版本同步为 NetworkStudyAndroid/1.9。
• 输入框、对话发送、账户绑定与“我的”页设置跟随网页端安全策略同步优化。
• 修正 App 内版本说明、配色设置、文件下载命名与页面过渡说明。

1.8 更新

• QQ 登录回调增加 checkLogin 主动校验兜底，并在前端消费结果前同步尝试恢复 SDK 会话，降低授权后回到 App 无响应的概率。

1.7 更新

• QQ 登录使用用户提供的 open_sdk_3.5.19_r9483ffc7_lite.jar，授权结果由回调、SDK 会话恢复和持久化结果三重链路接收。
• 账号密码用户可在“我的”绑定 QQ；QQ 独立用户自动使用 QQ 昵称与头像。
• 进入具体会话后隐藏原生顶部栏和底部导航，上传按钮移入输入区域左侧，输入区改为紧凑布局。
• 引用详情使用真正的全屏层，PDF 预览返回、翻页与安全区域体验同步优化。
• 支持头像上传和账号密码修改。
• App 设置新增森林青、海洋蓝、星云紫、日落橙、深夜等多套配色，并与网页账号同步。
• 页面切换动画与“关于”页信息进一步完善。
• 继续使用永久发布证书签名，保持覆盖安装和后续版本升级兼容。

环境

• Node.js 20+
• JDK 21
• Android SDK 36

本机推荐：

$env:JAVA_HOME='C:\Program Files\Android\openjdk\jdk-21.0.8'
$env:ANDROID_HOME='C:\Users\ASUS\AppData\Local\Android\Sdk'
$env:ANDROID_SDK_ROOT=$env:ANDROID_HOME

开发与构建

推荐直接运行一键脚本：

.\build-apk.ps1

脚本会自动设置本机 JDK/Android SDK、同步 Capacitor、构建并复制 APK 到：

E:\vibecoding\network-study-android\知行网络学堂-debug.apk

也可以手动构建：

npm install
npx cap sync android
npm run build:debug

调试 APK：

android/app/build/outputs/apk/debug/app-debug.apk

连接开启 USB 调试的 Android 手机后，可安装：

adb install -r ".\知行网络学堂-debug.apk"

使用 Android Studio：

npm run open

发布签名

创建仅自己保存的签名文件：

keytool -genkeypair -v -keystore network-study-release.jks -alias network-study -keyalg RSA -keysize 2048 -validity 10000

不要把 .jks 和密码提交到 Git。

开源许可

项目自身源码使用 MIT License。QQ OpenSDK 的许可仍以腾讯条款为准，详见 THIRD_PARTY_NOTICES.md。