源码系统概览
文章正文
这是一套面向学习打印场景的 Android 原生客户端源码，项目名为 SmartPrinter，中文名为千智智慧打印。
客户端采用 Kotlin 语言编写，界面结构对齐 Figma 原型，主体由四个底部 Tab 页与一个打印中心构成。
源码包内保留了完整的 Gradle 工程，包名 com.smartprinter.app，可直接导入 Android Studio 编译调试。
源码简介
工程共 278 个文件，其中 Kotlin 源码 97 个，布局与配置类的 XML 文件 166 个。
编译配置中 compileSdk 与 targetSdk 均为 34，最低支持到 Android 7.0 对应的 API 24，版本号为 1.0.0。
首屏四个 Tab 分别对应 FeedFragment 短视频流、PrintHubFragment 打印入口、PlaygroundFragment 游乐场与 MineFragment 个人中心。
界面右下角提供了一个全局悬浮的 AI 导师按钮，点击后唤起 AiTutorBottomSheet 以原生聊天界面承接问答。
网络层统一走后端网关，网关地址通过构建配置注入，默认端口为 9000。
适用场景
教育类硬件厂商可以用它作为配套 App 的起点，把打印能力与自有设备对接。
做学习工具产品的团队可以复用错题本与题库模块，减少从零搭建的成本。
想研究 Kotlin 原生工程结构的开发者，可以把它当作一套结构清晰的参考样例。
需要接入大模型的场景，AI 导师模块展示了如何把对话能力嵌进现有 App。
功能亮点
打印中心是核心入口，聚合了打印机连接与各项打印功能。
错题本模块对应 WrongQuestionActivity，用于整理与打印错题内容。
拍照解题模块对应 PhotoSolveActivity，调用相机权限完成题目识别。
题库模块对应 QuestionBankActivity，提供题目检索与组卷能力。
真人导师模块对应 HumanTutorActivity，承担人工辅导的入口职责。
AI 导师通过流式接口调用 deepseek-chat 模型，对话体验接近常见聊天应用。
网关地址支持在 App 内的个人中心页面直接修改，调试时不必重新打包。
下表把它与另外两类常见打印方案放在一起比较，便于判断定位差异。
| 方案 | 技术形态 | 部署复杂度 | 功能侧重 |
|---|---|---|---|
| SmartPrinter | Kotlin 原生 App | 需自建后端网关与模型接口 | 学习场景打印与 AI 辅导 |
| Mopria Print Service | 系统级打印插件 | 安装即用，无需后端 | 通用文档无线打印 |
| PrinterShare | 闭源商业应用 | 安装即用 | 多平台远程打印 |
若目标是打通打印与学习辅导的完整链路，这套源码的模块划分参考价值更高。
技术架构与部署指南
技术栈与运行环境
前端：Kotlin 原生界面与 XML 布局
后端：api-gateway 网关服务
数据库：由后端网关负责持久化
运行环境：Android Studio 与 JDK 17
其他依赖：OkHttp 网络库与相机权限组件
安装与部署提示
先把仓库根目录下的 local.properties.example 复制为 local.properties，并填入网关地址。
后端网关需要监听 0.0.0.0 的 9000 端口，Windows 环境记得在防火墙中放行该端口。
真机调试时开启 USB 调试，用数据线连接后执行安装命令即可。
只走 USB 通道时可用端口转发命令把手机 9000 端口映射到电脑，再把网关地址改成 127.0.0.1。
模拟器环境则把网关地址设为 10.0.2.2 即可访问宿主机服务。
截图与演示说明
仓库文档给出了完整的界面说明，首屏为四个 Tab 页，底部导航栏承担切换。
主页 Tab 对应 FeedFragment，以短视频信息流形式呈现内容。
打印 Tab 对应 PrintHubFragment，页面内排列打印机状态与各个功能入口。
AI 导师以右下角悬浮按钮形式常驻，点击后从底部弹出聊天面板。
布局文件集中在 app/src/main/res/layout 目录，可按文件名对照查看各页面结构。
常见问题
问：这套源码是免费开源的吗？
源码以项目形式提供，可用于学习研究与二次开发，商用前请自行确认授权情况。
问：没有后端服务能不能先跑起来？
可以编译安装，但涉及网络的模块会因为网关不可达而返回空数据。
问：AI 导师模块怎么换模型？
模型名称写在构建配置中，替换成接口兼容的模型名并重新编译即可。
问：支持哪些 Android 版本？
最低支持 API 24，也就是 Android 7.0 及以上系统。
安全风险提示
特别提示：本源码未检测安全风险文件，下载后请务必进行安全审计，删除恶意代码后再部署使用！
清单文件中声明了允许明文流量，正式上线前应改为强制 HTTPS 通信。
构建配置里写死了默认网关地址，发布前请改为自己的正式服务域名。
部分密钥字段默认留空，接入真实服务后不要把它们提交到公开仓库。
应用申请了相机与定位权限，上架前请确认已补充完整的隐私说明。
上图：智慧打印 Android 应用插图
这张是同一组应用资源的 JPG 备份版本，在不同渲染管线下与 PNG 版本表现一致，可作为演示图在低带宽环境下使用。
下载说明
源码仅供学习研究、测试部署和二次开发参考，商用前请自行确认授权、版权和安全风险。
涉及拍照解题与真人导师等模块，上线前请确认符合相关业务合规要求。
最后更新：2026-09-01