夜雨聆风学习资料网

ARTICLE · 1394265

「小星星识字乐园」安卓 APP 版全面技术分析报告

「小星星识字乐园」安卓 APP 版全面技术分析报告

🌟「小星星识字乐园」安卓 APP 版全面技术分析报告 🌟

🔍 分析对象:SmallStarLiteracy-v5.0.0.apk(识字乐园主程序)+ SmallStarLicenseTool-v1.0.1.apk(移动端授权签发工具)
📋 分析范围:UI 设计、功能实现、架构与技术栈、授权与安全体系、工程化水平、亮点与改进建议


🧭 一、产品定位与总体架构

🎯 产品定位:面向学龄前儿童的汉字识字学习应用,从网页版 / Windows 桌面版(pywebview + Python 本地服务)平移到安卓端,保持“离线可用、家长可控、授权付费”三大核心特征。

🏗️ 总体架构:典型的“WebView 壳 + 原生桥”混合架构,可概括为“一个壳、一个桥、两把钥匙”。

  • 🐚 一个壳:MainActivity 承载全屏 WebView,前端沿用网页版原生 HTML/JS/CSS 代码,零框架、零编译,桌面与移动端共用一套前端资产;

  • 🌉 一个桥:SmallStarBridge 通过 addJavascriptInterface 注入 window.SmallStarAndroid,前端以 JSON 字符串往返调用原生能力(授权、语音、图片存储、备份导出、系统分享);

  • 🔑 两把钥匙:Ed25519 公钥验签授权 + Android 私有目录落盘的 license.lic,与桌面版授权体系完全同源兼容。

📦 版本信息:applicationId cn.smallstar.literacy,versionName 5.0.0,compileSdk 37 / targetSdk 37 / minSdk 24(覆盖 Android 7.0 及以上),Java 17,Gradle 9.6 构建,APK 体积约 4.3MB,属轻量级安装包。


🧰 二、技术栈清单

  • ☕ 壳层语言:纯 Java(非 Kotlin),6 个核心类:MainActivity、AssetServer、SmallStarBridge、LicenseVerifier、TtsEngine、Fingerprint,代码总量约 1000 行,短小精悍;

  • 🖥️ UI 方案:WebView 渲染网页前端,竖屏锁定(portrait),Theme.DeviceDefault.Light.NoActionBar 全屏无系统栏干扰;

  • 🔄 序列化:Gson 2.11.0;

  • 🔐 密码学:BouncyCastle bcprov-jdk18on 1.80.2(Ed25519 验签)+ 平台自带 SHA-256 / AES-GCM / PBKDF2;

  • 🔊 语音:android.speech.tts 系统级 TextToSpeech 引擎;

  • 🪶 依赖哲学:除 Gson 与 BouncyCastle 外零第三方依赖——无网络库、无图片库、无 UI 库、无权限申请,把“离线纯净”贯彻到依赖树层面。


🎨 三、UI 与设计分析

🌈 视觉语言:儿童插画风格的“天空草地”场景化设计,全部由 CSS 实现。

  • 🎨 背景:160° 四色渐变(天蓝 → 粉 → 奶黄 → 嫩绿)叠加 24 秒无限循环的 gradientShift 流动动画;

  • ☀️ 场景元素:径向渐变太阳(sunPulse 脉动呼吸)、四朵不同高度/速度/透明度的 CSS 云朵(55~92 秒错峰漂移)、三层半透明山丘、按屏宽自适应 30~55 颗的随机闪烁星星(twinkle 动画 + 随机延迟);

  • 🧩 组件体系:CSS 变量驱动的统一设计令牌(--primary 活力橙、--secondary 青绿、--pink 粉色,14/22/32px 三级圆角,双层阴影),大圆角卡片 + 大按钮 + emoji 图标,充分贴合学龄前用户的触控目标尺寸。

🗺️ 信息架构:四入口主菜单(认字卡片 / 听音选字 / 字库总览 / 家长设置)+ 顶栏星星计数与设置按钮 + 首页学习进度条,层级浅、路径短,符合儿童“一次点击直达”的使用习惯。

💳 授权页设计:三步引导式付费转化页——「第一步 扫码付款(内嵌微信收款二维码 + 金额徽章)→ 第二步 一键生成/分享设备信息 → 第三步 选文件或粘贴导入授权」,每步配 step-badge 步骤圆标与 auth-hint 提示文案,成功/失败状态用绿色/红色 auth-status 明确反馈,导购逻辑清晰完整。

🎁 细节彩蛋:in-app class 检测(有原生桥时附加样式)、浏览器调试兜底桥(无原生环境时注入模拟数据,方便前端独立开发预览)。


🧩 四、功能全景

📚 学习模块(认字卡片):emoji 配图/自定义图片大卡 + 汉字 + 拼音 + 词语,点击朗读(语速 0.75 放慢适合儿童),支持上一个/下一个、随机打乱、家长逐字删除(🚫 删除此字,删除后可恢复)。

🎮 游戏模块(三种题型):

  • 👂 听音选字:播放汉字读音,四选一;

  • 🔤 看字选拼音:给汉字选正确拼音;

  • 🈶 看拼音选字:给拼音选正确汉字;

  • 🏁 每轮 10 题、实时计数、答对答错均有语音反馈(原生桥播「答对啦!」「再试一次哦」)、结束页星星奖励与再来一轮。

📖 字库总览:内置《通用规范汉字表》一级字表 3500 字(少儿不宜内容净化后 3488 字),支持按汉字/拼音/词语搜索、全部/内置/自定义/按类别筛选,字卡带播放按钮。

👨‍👩‍👧 家长面板(PIN 门禁保护):

  • ✏️ 添加汉字(拼音支持数字标调 ri4 → rì)+ emoji 配图 + 图片上传 + 推荐表情;

  • 📥 批量导入(每行“汉字,拼音,词语,表情,类别”);

  • 🔄 JSON 导入导出、自定义字管理;

  • 🗂️ 内置字管理:搜索删除、已删除列表单字恢复与全部恢复,删除记录持久化;

  • 🔒 家长密码(4-6 位,SHA-256 + 随机 salt 存储)、危险操作区(清空自定义字/重置星星/重置进度)。

💾 数据持久化:localStorage 封装(字库 v2、星星、进度、PIN v2、内置字覆盖、删除记录共 6 个命名空间),安卓端无 Python 后端时同步请求静默失败、本地照常可用,降级策略成熟。


🔊 五、语音引擎分析(TtsEngine)

  • 📴 离线优先:调用系统 TextToSpeech 引擎朗读中文,替代桌面版 edge-tts(需联网)与浏览器 speechSynthesis,真机完全离线可用;

  • 🎙️ 音色优选算法:遍历系统语音包,优先选 zh-CN / zh-Hans 简体中文语音,退而求其次接受任意 zh 系语音,最后兜底 Locale.CHINA / Locale.CHINESE;

  • ⏳ 异步初始化队列:TTS 引擎初始化是异步的,初始化完成前的朗读请求进入 pendingText 挂起队列,初始化成功后自动补播,不丢首字;

  • 💡 失败引导:检测不到中文语音引擎时主线程 Toast 提示“请在系统设置中安装或启用文字转语音服务”,只警告一次不重复打扰;

  • 🎚️ 参数钳制:rate/pitch 强制限制在 0.1~2.0 区间,防止前端传入异常值导致引擎报错;

  • 🧹 资源清理:bridge.destroy() → tts.shutdown(),配合 MainActivity.onDestroy 的 removeJavascriptInterface + webView.destroy,生命周期管理闭环。


🔐 六、授权体系分析(核心亮点)

✍️ 验签算法:LicenseVerifier 使用 Ed25519(BouncyCastle),最难得的是用 Java 手工复刻了 Python json.dumps(sort_keys=True, ensure_ascii=False) 的规范化序列化——键排序、, 与 : 分隔符、控制字符小写十六进制转义、BigDecimal 数字格式对齐,逐条对齐桌面版 developer/crypto_utils.py 的签名字节流,实现跨语言(Python 签发 ↔ Java 验证)字节级兼容,这是整套授权体系的地基。

🔗 校验链条(顺序与桌面版一致):验签先行 → 版本门禁(低于 1 提示过旧、高于当前支持版本提示升级客户端,双向防护)→ 有效期校验(支持 never 永久与带时区 ISO 时间)→ CRL 吊销检查 → 设备指纹匹配(主指纹 + aux_fingerprints 辅助指纹双通道)。

🚫 CRL 双通道吊销:内置种子 seed_crl.json(随 APK 打包,新版本强制生效)+ 用户侧 crl.json(filesDir 私有目录,可热更新);且只采信签名有效的 CRL——被篡改或损坏的吊销列表直接忽略,防止攻击者伪造 CRL 误伤正常授权,也防止删除 CRL 绕过吊销。

📱 设备指纹:Build.FINGERPRINT + MODEL + MANUFACTURER + DEVICE + ANDROID_ID 五要素拼接后 SHA-256,与桌面版语义一致(恢复出厂/刷机后指纹变化需重新授权)。

📥 导入体验:支持系统文件选择器导入 .lic(含多选处理)与文本框粘贴 JSON 双通道;导入前完整验签、验签通过才写入 filesDir/licenses/license.lic。

🛡️ 防绕过:授权页与主页均检测启动环境,file:// 协议直接清空 DOM 并提示“请通过应用启动”;授权入口由原生侧控制——hasValidLicense() 决定加载 index.html 还是 android_login.html,前端无法自行跳过。

💼 移动端商业闭环(SmallStarLicenseTool v1.0.1):这是整套体系最亮眼的设计——开发者签发授权不再需要回到 PC 端 GUI,一部手机完成全流程:

  • 🔑 私钥导入:从 developer/keys 加密私钥文件解出种子,导入前先验证“由该私钥推导的公钥 = 乐园 APP 内置公钥”,指纹不符拒绝导入,防止拿错钥匙;

  • 🔒 私钥保险库(KeyVault):私钥种子用 Android Keystore 硬件级 AES-256-GCM 加密落盘,密钥本身不出安全芯片;PIN 采用 PBKDF2(120000 次迭代 + 16 字节随机盐)哈希校验,解锁状态可手动锁定、销毁时内存清零(Arrays.fill 覆写);

  • 📝 签发:输入客户设备信息 JSON,可选客户名/版本/订单号/有效天数/功能列表,本地 Ed25519 签名生成 license,签发历史留存最近 100 条(含完整内容,可随时重发);

  • 📤 分发:通过 FileProvider 以 content:// 安全 URI 分享 .lic 文件,配合系统分享面板直达微信,客户收到文件导入 APP 即完成交付。

“孩子家长在微信付款 → 家长侧 APP 一键生成设备信息分享 → 开发者手机签发工具秒出 .lic → 微信发回 → 客户导入永久使用”,整条商业链路两端都是手机,全程无需电脑。📲


🛡️ 七、安全设计分析

  • 🚫 零权限清单:AndroidManifest 未声明任何 uses-permission——不联网、不读通讯录、不定位、不存储敏感区,仅 queries 声明 TTS 服务发现;配合 usesCleartextTraffic="false" 禁明文流量,隐私合规属于“天然白名单”级;

  • 🌐 虚拟域名资源服务器(AssetServer):以 https://appassets.smallstar 虚拟主机拦截 WebView 全部请求——/web/* 映射 assets、/local/images/* 映射私有图片目录;非本主机名请求一律 403、路径穿越(..)直接拒绝、MIME 按扩展名白名单返回,比高危的 file:// 或 setJavaScriptEnabled + loadDataWithBaseURL 方案安全一个量级;

  • 🔧 WebView 加固:setAllowFileAccess(false) 禁文件协议、LOAD_NO_CACHE 禁缓存、DOM Storage 仅用于学习数据;

  • 🖼️ 图片上传防线:前端 dataURL → 正则校验格式白名单(png/jpg/webp/gif/bmp)→ Base64 解码 → 4MB 上限 → SecureRandom 12 字节随机文件名 → 落盘私有目录,杜绝路径注入与任意文件覆盖;

  • 💾 备份导出:写入 getExternalFilesDir(DOCUMENTS) 应用专属外部目录(无需存储权限),文件名带时间戳,失败自动降级私有目录;

  • 🧼 JS 桥卫生:所有 @JavascriptInterface 方法返回结构化 JSON、异常不外抛、返回值全部为业务数据,无字符串拼接执行风险;

  • 🔏 授权防篡改:签名失败、缺签名、CRL 无效、版本异常、设备不匹配等十余种失败分支全部返回中文原因,用户体验与安全并重。


⚙️ 八、工程化水平

  • 🏗️ 构建管线:三个 Copy 任务(syncWebAssets / syncAndroidExtras / syncAuth)在构建期把 web/ 前端、androidextra 安卓专属页、公钥与种子 CRL 汇入 assets——桌面版与安卓版前端“单一事实源”,改一处双端同步,并修复了 Gradle 9 对隐式资产依赖的 lintVital 判错问题;

  • 🧪 单元测试:LicenseVerifierTest 配备 14 个边界测试资源(篡改签名、缺签名、坏签名 CRL、吊销命中、过期(本地/时区两种)、未来时间、版本缺失、控制字符、中文转义等),签名兼容性这种跨语言最易翻车的点被测试钉死;

  • 📦 发布配置:release.jks 正式签名,注释中明确说明关闭 release lint 的原因(验证靠单测 + 真机冒烟),工程决策透明;

  • 📄 文档配套:CHANGELOG / SECURITY / REFACTOR-NOTES / MIGRATION 四份文档随库维护,版本语义(5.0.0)三端统一。


✨ 九、亮点总结

  1. 🔏 跨语言签名字节级兼容:Java 手写复刻 Python json.dumps 规范化序列化,桌面/安卓双端共用一套 Ed25519 授权体系,且以 14 项边界单测兜底——小体量项目里罕见的严谨度;

  2. 🚫 零权限 + 零联网:整包无任何 uses-permission,儿童应用隐私合规天花板,家长可以放心安装;

  3. 🌐 虚拟域名本地资源服务器:以 WebViewClient 拦截实现“伪 https 本地站”,路径穿越防护 + MIME 白名单 + 403/404/500 分级响应,替代高危 file:// 的标准答案级实现;

  4. 📲 移动端授权签发闭环:LicenseTool 用 Android Keystore 硬件加密私钥 + PBKDF2 PIN 门禁 + 公钥指纹预校验,把“收款→核设备→签发→微信交付”全流程装进手机,商业交付效率极高;

  5. 🔁 前端资产单一事实源:构建期 Copy 任务让桌面版与安卓版共用同一套无框架前端,一次修改双端生效,维护成本大幅降低;

  6. 🎨 儿童向 UI 完成度高:纯 CSS 场景动画(太阳呼吸/云朵漂移/星星闪烁)、设计令牌体系、三步式付费引导页,视觉效果与转化逻辑俱佳;

  7. 🔊 离线 TTS 语音链路:系统引擎 + 音色优选 + 初始化挂起队列 + 失败一次性引导,彻底摆脱桌面版对 edge-tts 联网的依赖。


📌 报告基于对 V5.0 安卓工程源码(android/app + android/licensetool)的逐文件分析生成。

回首页,搜索你想要的文档

在首页搜索框输入关键词,快速定位资料

文库首页搜索指引 立即搜索

相关学习资料