The-Beike

The Integrated Campus Assistant for USTB | 大贝壳：北京科技大学校园助手 (The-Beike)

---

🔗官方网站 | Official Website

_{This project only supports Chinese docs. If you are an English user, feel free to contact us.}

介 绍 _Intro

实现的功能

1. 📚支持北科教务系统相关功能。
   可以登录北科本研一体教务账号；可以查课表、选课、查考场和查成绩。
2. 📶支持北科校园网自助服务系统相关功能。
   可以登录北科校园网自助服务账号；可以查询流量使用情况和每月账单详情；可以管理入网设备、修改密码和修改限额。
3. 💰支持北科校园缴费系统相关功能。
   可以登录北科校园缴费系统账号；可以查询和充值校园卡余额和网费余额；可以缴纳学费。
4. 🔁支持跨设备同步配置数据。
   可以通过配对码来为不同设备上的软件实现配置数据的同步。
5. ⬆️支持软件内下载更新。
   可以在软件内直接下载最新版本的安装包来更新（仅限 Android 和 Windows 版本）。

支持的平台

Android	Windows	Linux	MacOS	iOS
✅支持	✅支持	✅支持	❌不支持	⏰计划中

常用文档

• 更新日志 > 点击查看

使用方法 _Usage

1. 请前往此页面下载适合你的操作系统的程序文件。
2. 安装或解压下载的文件，并运行程序即可。

开发指南 _Development

本项目基于 Flutter 框架编写，使用 Dart 语言。

开发环境准备

1. 安装 Git 和 VS Code；
2. 参考《Flutter 快速开始》文档来安装 Flutter SDK；
3. 安装 VS Code 的 Flutter 插件；
4. 使用 Git 克隆本仓库到本地；
5. 在项目文件夹中运行 flutter pub get 来下载依赖。

运行与调试

1. 在 VS Code 的右下角状态栏（或者打开“命令面板”进入 Flutter: Select Device）来选择要调试的设备或模拟器；
2. 在 VS Code 的“运行”菜单栏中（或者在左侧的“🐞运行与调试”视图中）点击启动调试按钮，即可开始调试程序。

Tip

如需在 Android 模拟器上调试，需配置 Android 相关开发环境并使用 ADB 事先连接模拟器端口。如遇设备连接问题，可以运行命令 flutter doctor 来执行故障排除。

Tip

在调试过程中，修改代码后手动保存或在调试工具栏单击“⚡热重载”按钮，即可在不重启程序的情况下预览代码更改。但发生未捕获的错误时，无法热重载，需重启程序。

构建与打包

本仓库配置有持续集成（CI）工作流，可以自动构建发行文件。如需本地构建，请参考以下指引：

💡本地构建指引（展开详情）

• Android 通用安装包构建：
  执行命令行

  flutter build apk --release --obfuscate --split-debug-info=build/symbols

  输出文件位于 build/app/outputs/flutter-apk。

• Windows 发行文件构建：
  执行命令行

  flutter build windows --release --obfuscate --split-debug-info=build/symbols

  输出文件位于 build/windows/x64/runner/Release 文件夹中。

• Windows 安装程序打包：
  安装 Inno Setup 并构建发行文件后，执行命令行

  iscc windows/packaging/packaging.iss

  输出文件位于 dist 文件夹中。

• Linux 发行文件构建：
  执行命令行

  flutter build linux --release --obfuscate --split-debug-info=build/symbols

  输出文件位于 build/linux/x64/release/bundle 文件夹中。

对于 Android 安装包，默认情况下会使用设备上的 ~/.android/debug.keystore 作为签名证书。这意味着不同设备（例如不同轮次的远程 CI 构建）所打包的安装包之间无法进行覆盖更新。建议按照下述方式手动生成和配置签名证书：

💡签名证书配置指引（展开详情）

1. 执行命令行

   keytool -genkey -v -keystore my-key.jks -keyalg RSA -keysize 2048 -validity 10000 -alias my-alias

   来生成别名为 my-alias 的签名证书文件 my-key.jks，期间会要求输入一个密码，需要记住。

2. 在本仓库创建文件 android/key.properties，内容如下：

   storeFile=<你生成的jks文件的路径>
   storePassword=<先前设置的密码>
   keyPassword=<先前设置的密码>
   keyAlias=my-alias

   构建脚本 android/app/build.gradle.kts 会自动读取该文件来进行签名。注意，该文件不应被提交到 Git 仓库中。

3. 如需在 CI 中配置签名证书，请将 my-key.jks 文件的内容进行 Base64 编码，并将编码后的字符串配置为 CI 的环境变量 KEYSTORE_BASE64、将签名的密码配置为环境变量 KEYSTORE_PASSWORD 和 KEY_PASSWORD、将别名配置为环境变量 KEY_ALIAS。CI 会自动使用这些环境变量来生成 android/key.properties 文件以进行签名。

关 于 _About

许可证

本项目基于 GPL3协议。任何人都可以自由地使用和修改项目内的源代码，前提是要在源代码或版权声明中保留作者说明和原有协议，且使用相同的许可证进行开源。

参与贡献

欢迎任何形式的贡献！如果你有任何想法或建议，或者发现了任何问题，请随时在 GitHub 上提交 Issue 或 Pull Request。

---

GitHub Star History