https://github.com/danweiyuancircle/ai-android
Android WebView 壳 + H5 模板一体化脚手架：create-android-shell
https://github.com/danweiyuancircle/ai-android
android cli scaffold vue webview
Last synced: 6 days ago
JSON representation
Android WebView 壳 + H5 模板一体化脚手架：create-android-shell
- Host: GitHub
- URL: https://github.com/danweiyuancircle/ai-android
- Owner: danweiyuancircle
- Created: 2026-06-11T01:45:03.000Z (10 days ago)
- Default Branch: master
- Last Pushed: 2026-06-11T02:11:45.000Z (10 days ago)
- Last Synced: 2026-06-11T03:20:00.066Z (10 days ago)
- Topics: android, cli, scaffold, vue, webview
- Language: Kotlin
- Homepage: https://www.npmjs.com/package/@chancestv/create-android-shell
- Size: 1.19 MB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: docs/README.md
- Agents: AGENTS.md
Awesome Lists containing this project
README
# ai-android 项目说明
本仓库是 Android WebView 壳 + H5 脚手架项目，包含：
- CLI 脚手架：`/Users/chances/StudioProjects/ai-android/cli`
- 模板集合：`/Users/chances/StudioProjects/ai-android/template`
- 工程约束与规则：`/Users/chances/StudioProjects/ai-android/claude`
- 发布与自动化：`.github/workflows`
## 一、项目目标
提供统一模板链路，快速生成 TV/OTT 场景可落地工程：
- Android 壳（Support 27.1.1 + AGP 3.6 + JDK 8）
- Vue3 H5 壳（`template/h5-vue`）
- 统一 JSBridge 契约（`template/bridge-contract.md`）
- 代码生成入口与参数（应用名、`applicationId`、图标、语音方案）
## 二、目录速览
- `/Users/chances/StudioProjects/ai-android/cli`
- 脚手架入口：`index.js`
- 规则与核心实现：`lib/`、`stacks.js`
- 发布说明：`cli/README.md`
- 版本记录：`cli/CHANGELOG.md`
- `/Users/chances/StudioProjects/ai-android/template`
- `template/android-shell`：Android 壳模板
- `template/h5-vue`：Vue3 H5 模板
- `template/README.md`：模板结构说明
- `/Users/chances/StudioProjects/ai-android/docs`
- 项目说明与扩展文档
- `/Users/chances/StudioProjects/ai-android/claude`
- 团队规则与技能说明（不在 template 中冗余）
- `/.github/workflows/cli-release.yml`
- GitHub Actions 触发发布配置（Tag 发布）
## 三、开发命令
CLI（本仓库核心脚手架模块）：
```bash
cd /Users/chances/StudioProjects/ai-android/cli
npm test
npm link
```
H5 模板：
```bash
cd /Users/chances/StudioProjects/ai-android/template/h5-vue
pnpm install
pnpm dev
pnpm build
pnpm lint
pnpm typecheck
pnpm --filter @shell/core test
```
Android 壳：
```bash
cd /Users/chances/StudioProjects/ai-android/template/android-shell
JAVA_HOME= ./gradlew :app:assembleStagingDebug
```
## 四、发布流程（CLI）
`cli/package.json` 的版本号与 `cli/package-lock.json` 版本必须同步。
```bash
cd /Users/chances/StudioProjects/ai-android
cd cli
npm version patch
cd /Users/chances/StudioProjects/ai-android
git add cli/package.json cli/package-lock.json cli/CHANGELOG.md cli/README.md
git commit -m "chore(cli): bump patch version for release"
git tag v0.X.Y
git push github master v0.X.Y
```
说明：
- 版本发布由 GitHub Actions 监听 `v*` 标签触发。
- 发布已切到 npm OIDC trusted publishing（免 `NPM_TOKEN`）。
## 五、注意事项
- 规则与仓库约束见：`/Users/chances/StudioProjects/ai-android/AGENTS.md` 与 `/Users/chances/StudioProjects/ai-android/CLAUDE.md`。
- 不要提交真实生产签名资产与线上密钥。
- 模板更新后优先先执行 `npm test` 与模板构建验证，再提 PR。