WinBoLL 源生态计划项目说明书
 
一、项目概述
 
1. 核心定位
 
【OriginMaster】WinBoLL 源生态计划，旨在通过核心项目 WinBoLL 联动系列开发库，构建手机端 Android 项目开发与多端编译同步的完整生态，实现手机与电脑的源码同步开发。
 
2. 仓库架构
 
仓库类型 包含仓库 功能说明 
开发库 WinBoLL、APPBase、AES、PowerBell、Positions 核心开发依赖库，其中 WinBoLL 可作为应用开发的基础继承模板 
分支汇总存档库 OriginMaster 仅用于汇总各开发库分支，不适宜作为开发库克隆使用，非应用开发基础库 
 
3. 源码推送路径
 
- WinBoLL → APPBase → OriginMaster
- WinBoLL → AES → OriginMaster
- WinBoLL → PowerBell → OriginMaster
- WinBoLL → Positions → OriginMaster
 
二、WinBoLL APP 核心信息
 
1. 项目简介
 
WinBoLL Studio Android 应用开源项目，专注于手机端 Android 开发与多端编译同步。
 
2. 官方资源
 
- 官方网站：https://www.winboll.cc/
- 源码地址：
- Gitea：https://gitea.winboll.cc/Studio/WinBoLL.git
- GitHub：https://github.com/ZhanGSKen/WinBoLL.git
- 码云：https://gitee.com/zhangsken/winboll.git
- 托管类库源码：
- APPBase（jitpack.io）：https://github.com/ZhanGSKen/APPBase.git
- AES（jitpack.io）：https://github.com/ZhanGSKen/AES.git
 
三、通用特征文件夹前置（/sdcard）
 
- Linux 系统文件夹直接使用  /sdcard 。
- 手机 SD 卡存储（ /storage/emulated/0 ）挂载的别名也可为  /sdcard 。
 
四、前置条件
 
1. WinBoLL-APP 配置
 
- APK 编译输出目录： /sdcard/WinBoLLStudio/APKs/ ，以及  /sdcard/AppProjects/ （命名为  app.apk ）
- 签名与命名空间：支持应用签名验证定制化，与衍生 APP 共享  cc.winboll.studio  命名空间
 
五、核心需求规划
 
1. 主机端需求
 
- 支持  winboll.cc  域名的用户注册登录服务
- 支持  https://console.winboll.cc/api  访问
 
2. APP 端需求
 
- 实现手机端 Android 应用开发与管理功能
 
六、编译与使用指南
 
1. 项目初始化（必须）
 
1. 复制  settings.gradle-demo  为  settings.gradle ，取消对应项目模块注释
2. 复制  gradle.properties-androidx-demo  或  gradle.properties-android-demo  为  gradle.properties 
3. （可选）复制  local.properties-demo  为  local.properties ，配置 Android SDK 目录
4. 签名设置：
- 调试编译：进入 GenKeyStore 目录执行  bash gen_debug_keystore.sh 
- 非必须：clone keystore 模块，拷贝  appkey.jks  与  appkey.keystore  到项目根目录
 
2. 编译命令
 
（1）类库型项目
 
1. 修改测试项目  build.properties ，设置  libraryProject=<类库项目模块名> 
2. 编译测试项目： bash .winboll/bashPublishAPKAddTag.sh <应用项目模块名> 
3. 编译类库项目： bash .winboll/bashPublishLIBAddTag.sh <类库项目模块名> （发布至 WinBoLL Nexus Maven 库）
 
（2）应用型项目
 
- 编译命令： bash .winboll/bashPublishAPKAddTag.sh <应用项目模块名> 
 
（3）调试编译
 
- Beta 调试： bash gradlew assembleBetaDebug 
- Stage 调试： bash gradlew assembleStageDebug
 
（4）发布编译
 
- Stage 发布：bash .winboll/bashPublishAPKAddTag.sh <应用项目模块名> 
             或者执行  bash gradlew assembleStageRelease
 
3. 编译输出路径
 
- 默认路径(assembleBetaDebug任务)： /sdcard/WinBoLLStudio/APKs/<项目根目录名称>/debug/ 
- 默认路径(assembleStageRelease任务)： /sdcard/WinBoLLStudio/APKs/<项目根目录名称>/tag/ 
- 额外路径：若  winboll.properties  配置  ExtraAPKOutputPath ，APK 同步拷贝至该ExtraAPKOutputPath路径
 
4. 版本号命名规则
 
- Stage 渠道： V<应用开发环境编号><应用功能变更号><应用调试阶段号> （示例： APPBase_15.7.0 ）
- Beta 渠道： V<应用开发环境编号><应用功能变更号><应用调试阶段号>-beta<调试编译计数>_<调试编译时间(分钟+秒钟)> （示例： APPBase_15.9.6-beta8_5413 ）
