sanjiu-apk-builder

一键生成三元九维诗词分类 APK 的开源脚手架 + 构建器。把"制作 APK"的整套方法（Android 工程脚手架、三元诗卦引擎、图文界面、图标接入、JDK17/SDK 检测、签名 keystore、release 构建、APK 校验）沉淀为一条命令。

功能

• scaffold：从内置模板生成完整可运行的 Android 工程
  • 三元诗卦引擎 SanjiuEngine（9 维诗卦 + 错/综/互/变算子 + 年龄段分类 + 逆向检索）
  • 图文并茂界面 MainActivity（卦象图画、年龄段 chip、三元推演、经典/原创双模式）
  • 九爻卦画 App 图标（5 密度 mipmap）+ 语料资源
• build：自动检测 JDK17 / Android SDK，生成签名 release.jks，跑 assembleRelease，apksigner 校验，产出签名 APK
• 数据驱动：poems.json（经典语料）+ original.json（三元原创）可直接替换

安装

pip install sanjiu-apk-builder
# 或本地：pip install -e .

用法

# 1) 从模板生成工程（可选 --poems/--original/--icon）
sanjiu-apk scaffold --out ./my-poem-app \
    --package com.myname.poetry --name "我的诗库" \
    --poems poems.json --original original.json \
    --icon my_icon.png        # 自定义 App 图标（自动生成 5 密度 mipmap）

# 2) 构建（自动检测 JDK17 与 SDK，缺则用 --jdk/--sdk 指定）
sanjiu-apk build --dir ./my-poem-app \
    --jdk /path/to/jdk-17 --sdk /path/to/android-sdk

构建产物：app/build/outputs/apk/release/app-release.apk（release 签名，apksigner 校验通过）。

不传 --icon 时使用内置的九爻卦画默认图标；传了则用你的图片（居中裁剪正方形后缩放为 48/72/96/144/192 px）。

发布到 PyPI

• 已发布：PyPI · sanjiu-apk-builder（pip install sanjiu-apk-builder）
• 打 v* 标签自动触发 publish-pypi.yml 发布：
  • Trusted Publishing（推荐）：在 PyPI 项目设置 把仓库 q1z2q3-debug/sanjiu-apk-builder 与 publish-pypi.yml 绑定为发布者，无需存密码；
  • 或配置仓库 Secrets PYPI_TOKEN（PyPI __token__ 密码）。
• CI build-apk 保证每次提交可构建出签名 APK；Release 由 release.yml 在打标签时自动创建并附 APK。

前置要求

• JDK 17（AGP 8.9 要求），经 JAVA_HOME 或 --jdk 提供
• Android SDK（含 cmdline-tools、build-tools、platforms/android-36、licenses），经 ANDROID_HOME 或 --sdk 提供

语料格式

poems.json：[{"title","author","text","topic","age","gua":[9 维]}] original.json：[{"age","op","gua","title","text","oracle"}]

age 用数字索引：0=儿童 1=少年 2=青年 3=中年 4=老年。示例见 templates/poems.json。

安全说明

插件自动生成的 keystore 与密码仅用于本地 demo 构建；发布正式应用请自行更换 keystore 与强密码，且勿把 keystore/、gradle.properties、local.properties 提交进仓库（见模板 .gitignore 思路）。

License

MIT