# Android 项目生成器

> 基于模板快速生成新的 Android 项目

## 📁 目录结构

```
dplus_demo/                    # 根目录（原始项目）
│
├── gentool/                   # 🛠️ 生成器工具目录（所有工具和模板都在这里）
│   ├── project_generator.py   # 核心脚本
│   ├── generate.sh            # 交互式脚本
│   ├── templates.json         # 模板配置
│   ├── test_generator.sh      # 测试脚本
│   │
│   ├── 📖 文档
│   │   ├── README_CN.md       # 中文主文档
│   │   ├── QUICKSTART.md      # 快速入门
│   │   └── ...                # 其他文档
│   │
│   └── model/                 # 模板目录
│       ├── README.md          # 模板说明
│       └── default/           # 默认模板（完整的 Android 项目）
│
├── README_GENTOOL.md          # 本文件
└── ...                        # 原始项目文件
```

## 🚀 快速开始

### 进入工具目录

```bash
cd gentool
```

### 使用交互式脚本（推荐）

```bash
./generate.sh new
```

### 使用命令行

```bash
python3 project_generator.py generate \
  -t default \
  -p com.mycompany.myapp \
  -n MyApp \
  -o ../MyApp
```

## 📚 完整文档

所有文档都在 `gentool/` 目录下：

- **[gentool/README_CN.md](gentool/README_CN.md)** - 中文主文档（推荐从这里开始）
- **[gentool/QUICKSTART.md](gentool/QUICKSTART.md)** - 5分钟快速入门
- **[gentool/PROJECT_GENERATOR_README.md](gentool/PROJECT_GENERATOR_README.md)** - 功能概览
- **[gentool/README_GENERATOR.md](gentool/README_GENERATOR.md)** - 详细使用文档
- **[gentool/STRUCTURE.md](gentool/STRUCTURE.md)** - 项目结构说明
- **[gentool/model/README.md](gentool/model/README.md)** - 模板管理说明

## 🎯 主要功能

- ✅ 基于模板生成新项目
- ✅ 自动替换包名和应用名
- ✅ 自动重构目录结构
- ✅ 支持多模板管理
- ✅ 智能跳过构建产物
- ✅ 交互式和命令行两种使用方式

## 💡 常用命令

```bash
# 进入工具目录
cd gentool

# 查看所有模板
./generate.sh list
# 或
python3 project_generator.py list-templates

# 生成新项目（交互式）
./generate.sh new

# 添加新模板
./generate.sh add

# 测试工具
./test_generator.sh
```

## 📝 添加新模板

```bash
# 1. 进入 gentool 目录
cd gentool

# 2. 将项目复制到 model 目录
cp -r ~/MyTemplate model/my_template

# 3. 注册模板
python3 project_generator.py add-template \
  -n my_template \
  -p model/my_template \
  -d "我的自定义模板"

# 4. 使用新模板
./generate.sh new
```

## 🔧 系统要求

- Python 3.6+
- Linux/macOS/Windows

## 📖 详细文档

查看 [gentool/README_CN.md](gentool/README_CN.md) 了解更多信息。

## 🎓 使用示例

```bash
cd gentool

# 示例 1: 创建电商应用
python3 project_generator.py generate \
  -t default \
  -p com.myshop.android \
  -n MyShop \
  -o ../MyShop

# 示例 2: 创建游戏应用
python3 project_generator.py generate \
  -t default \
  -p com.games.puzzle \
  -n PuzzleGame \
  -o ~/projects/PuzzleGame
```

## 🌟 特点

### 完全独立
所有工具和模板都在 `gentool/` 目录下，不影响原始项目。

### 易于管理
- 工具脚本和文档在 `gentool/` 根目录
- 模板项目在 `gentool/model/` 目录
- 配置文件 `templates.json` 统一管理

### 团队友好
```bash
# 提交整个 gentool 目录到版本控制
git add gentool/
git commit -m "添加项目生成器工具"

# 团队成员拉取后直接使用
cd gentool
./generate.sh new
```

---

**开始使用**: `cd gentool && ./generate.sh new`

**查看文档**: [gentool/README_CN.md](gentool/README_CN.md)
