WinBoLL 源生态计划项目说明书
 
一、项目概述
 
1. 核心定位
 
WinBoLL 手机源码计划，旨在通过核心项目 WinBoLL 构建手机端与服务器端的 Android 项目的开发源码生态。实现手机与服务器的源码的联合开发。
 
2. 仓库架构
 
仓库类型：功能说明 
基础项目分支 WinBoLL：手机端安卓应用开发基础模板。
应用项目分支 APPBase、AES、PowerBell、Positions：安卓应用单一管理系列项目。
各类分支源码合并存档 OriginMaster： 源码汇总管理，不适宜作为开发库使用。 
 
3. 源码合并管理推送路线图。（仅仅展示不同应用模块源码的综合管理路线。分支合并操作时，必须具备Git管理经验。）
 
- WinBoLL → APPBase → OriginMaster
- WinBoLL → AES → OriginMaster
- WinBoLL → PowerBell → OriginMaster
- WinBoLL → Positions → OriginMaster
 
二、WinBoLL 项目核心信息
 
1. 项目简介
 
WinBoLL 项目是为手机端开发 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
 
三、通用特征文件夹前置（/sdcard）
 
- Linux 服务器端系统需要建立 /sdcard/WinBoLLStudio/APKs 目录。
- 手机开发端需要建立 /storage/emulated/0/WinBoLLStudio/APKs 。
 
四、前置条件
 
1. WinBoLL APP 开发环境配置介绍
 
- WinBoLL APK 编译输出内容包括：
  "/sdcard/WinBoLLStudio/APKs" 目录内的所有应用分支的 APK 文件，
  与 "/sdcard/AppProjects/app.apk"文件。
- WinBoLL APK 使用 "cc.winboll.studio"  命名空间。
 
五、核心需求规划
 
1. WinBoLL 应用安全验证需求

- 支持  https://console.winboll.cc/  访问服务器以校验应用包签名与版本。
 
2. 手机端源码开发管理需求
 
- 支持切换不同 WinBoLL 分支，以开发不同安卓应用。
 
六、编译与使用指南
 
1. 项目初始化（必须）
 
1. 复制  settings.gradle-demo  为  settings.gradle 。编辑 settings.gradle 文件内容，取消对应项目模块注释。
2. 复制  gradle.properties-androidx-demo(Android X 项目)  或  gradle.properties-android-demo(基本 Android 项目)  为  gradle.properties。
3. 复制（可选）local.properties-demo  为  local.properties ，编辑 local.properties 文件内容，配置 Android SDK 目录。
4. 签名设置：
- 调试编译秘钥制作：使用 Termux 应用终端 cd 进入 GenKeyStore 目录，运行  bash gen_debug_keystore.sh 脚本即可生成应用调试秘钥。
- 应用秘钥配置方法：拷贝调试编译秘钥制作生成的  appkey.jks  与  appkey.keystore  文件到项目根目录即可。
 
七、应用编译命令介绍
 
（1）类库型模块配置要点
 
1. 优先修改应用测试项目（目录为"<WinBoLl根目录>/<类库测试应用>/"）内 build.properties 文件，设置对应的类库项目名称：libraryProject=<类库项目模块名> 。
2. 编译优先启动步骤：使用 Termux 应用，进入"<WinBoLl根目录>"，运行 $bash .winboll/bashPublishAPKAddTag.sh <类库测试项目模块名> 命令，运行后可生成测试项目与类库项目的编译参数文件 build.properties 。生成的 build.properties 文件有两份，一份在测试项目模块的文件夹内，一份在类库项目本身的模块文件夹内。
3. 类库编译发布步骤：使用 Termux 应用，进入"<WinBoLl根目录>"，运行 $bash .winboll/bashPublishLIBAddTag.sh <类库项目模块名> 命令，运行后可发布至 WinBoLL Nexus Maven 库、本地maven目录或者是通用默认的 Gradle Maven 库。
 
（2）单一应用型模块与类库测试型模块配置要点
 
- 编译方法：使用 Termux 应用，进入"<WinBoLl根目录>"，运行 $bash .winboll/bashPublishAPKAddTag.sh <应用项目模块名> ，运行后
- 编译输出路径：
  默认路径(assembleBetaDebug任务)： /sdcard/WinBoLLStudio/APKs/<项目根目录名称>/debug/ 
  默认路径(assembleStageRelease任务)： /sdcard/WinBoLLStudio/APKs/<项目根目录名称>/tag/ 
  额外路径：若  winboll.properties  配置  ExtraAPKOutputPath ，APK 同步拷贝至该ExtraAPKOutputPath路径
 
（3）手机端应用调试命令介绍
 
- Beta 渠道调试命令：$bash gradlew assembleBetaDebug 
- Stage 渠道调试命令：$bash gradlew assembleStageDebug
 
（4）服务器端应用发布命令介绍

- Stage 渠道应用发布命令为（"<WinBoLl根目录>/settings.gradle"文件需要配置编译模块开启参数，拷贝 settings.gradle-demo 为 settings.gradle 文件取消对应的分支配置部分即可。）：
$bash .winboll/bashPublishAPKAddTag.sh <应用项目模块名> 
或者
$bash gradlew assembleStageRelease
 

八、WinBoLL 应用 APK 版本号命名规则
- Stage 渠道： V<应用开发环境编号><应用功能变更号><应用调试阶段号> （示例： APPBase_15.7.0 ）
- Beta 渠道： V<应用开发环境编号><应用功能变更号><应用调试阶段号>-beta<调试编译计数>_<调试编译时间(分钟+秒钟)> （示例： APPBase_15.9.6-beta8_5413 ）