This commit is contained in:
Ubuntu
2026-07-03 16:58:28 +08:00
commit 32b43f85bd
6240 changed files with 1987678 additions and 0 deletions
+511
View File
@@ -0,0 +1,511 @@
# 玩Android API 测试记录 - 项目相关
## 测试信息
- **测试时间**: 2026-03-17 20:47
- **测试环境**: Ubuntu Linux
- **Base URL**: https://www.wanandroid.com
- **测试状态**: 进行中
---
## 1. 项目分类 API
### API基本信息
- **接口名称**: 项目分类
- **接口地址**: `/project/tree/json`
- **请求方式**: GET
- **是否需要登录**: 否
### 请求参数
无
### 请求示例
```bash
curl -s "https://www.wanandroid.com/project/tree/json"
```
### 响应数据
```json
{
"data": [
{
"articleList": [],
"author": "",
"children": [],
"courseId": 13,
"cover": "",
"desc": "",
"id": 294,
"lisense": "",
"lisenseLink": "",
"name": "完整项目",
"order": 145000,
"parentChapterId": 293,
"type": 0,
"userControlSetTop": false,
"visible": 0
},
{
"articleList": [],
"author": "",
"children": [],
"courseId": 13,
"cover": "",
"desc": "",
"id": 402,
"lisense": "",
"lisenseLink": "",
"name": "跨平台应用",
"order": 145001,
"parentChapterId": 293,
"type": 0,
"userControlSetTop": false,
"visible": 1
},
{
"articleList": [],
"author": "",
"children": [],
"courseId": 13,
"cover": "",
"desc": "",
"id": 367,
"lisense": "",
"lisenseLink": "",
"name": "资源聚合类",
"order": 145002,
"parentChapterId": 293,
"type": 0,
"userControlSetTop": false,
"visible": 1
},
// ... 更多分类
],
"errorCode": 0,
"errorMsg": ""
}
```
### 响应解析
- **data**: 项目分类数组
- 每个分类对象包含:
- `id`: 分类唯一标识(用于查询项目列表)
- `name`: 分类名称
- `order`: 显示顺序
- `parentChapterId`: 父分类ID(固定为293)
- `visible`: 是否可见(1=可见,0=隐藏)
- `type`: 类型(0=普通)
- `userControlSetTop`: 用户是否可以置顶
- 其他字段通常为空
### 分类统计
```bash
# 统计分类数量
curl -s "https://www.wanandroid.com/project/tree/json" | python3 -c "
import json, sys
data = json.load(sys.stdin)
visible_categories = [c for c in data['data'] if c['visible'] == 1]
print(f'总分类数: {len(data[\"data\"])}')
print(f'可见分类数: {len(visible_categories)}')
print('\\n可见分类列表:')
for i, category in enumerate(visible_categories[:10], 1):
print(f'{i}. {category[\"name\"]} (id: {category[\"id\"]})')
"
```
输出:
```
总分类数: 28
可见分类数: 27
可见分类列表:
1. 跨平台应用 (id: 402)
2. 资源聚合类 (id: 367)
3. 动画 (id: 323)
4. RV列表动效 (id: 314)
5. 项目基础功能 (id: 358)
6. 网络&文件下载 (id: 328)
7. TextView (id: 331)
8. 键盘 (id: 336)
9. 快应用 (id: 337)
10. 日历&时钟 (id: 338)
```
### 完整分类列表
根据数据分析,项目分类包含:
1. 完整项目 (id: 294, visible: 0) - 隐藏
2. 跨平台应用 (id: 402) - Flutter、React Native等
3. 资源聚合类 (id: 367) - 资源整理类项目
4. 动画 (id: 323) - 动画效果相关
5. RV列表动效 (id: 314) - RecyclerView动画
6. 项目基础功能 (id: 358) - 基础功能模块
7. 网络&文件下载 (id: 328) - 网络请求相关
8. TextView (id: 331) - 文本控件相关
9. 键盘 (id: 336) - 输入法相关
10. 快应用 (id: 337) - 快应用开发
11. 日历&时钟 (id: 338) - 时间相关
12. K线图 (id: 339) - 图表相关
13. 硬件相关 (id: 340) - 硬件交互
14. 表格类 (id: 357) - 表格控件
15. 创意汇 (id: 363) - 创意项目
16. ImageView (id: 380) - 图片控件
17. 音视频&相机 (id: 382) - 多媒体相关
18. 相机 (id: 383) - 相机功能
19. 下拉刷新 (id: 310) - 刷新控件
20. 架构 (id: 385) - 项目架构
21. 对话框 (id: 387) - 弹窗控件
22. 数据库 (id: 388) - 数据存储
23. AS插件 (id: 391) - Android Studio插件
24. ViewPager (id: 400) - 翻页控件
25. 二维码 (id: 401) - 二维码相关
26. 富文本编辑器 (id: 312) - 文本编辑
27. IM (id: 526) - 即时通讯
28. 未分类 (id: 539) - 其他项目
### 注意事项
1. **visible字段**: 只有visible=1的分类才显示给用户
2. **id用途**: 分类id用于查询该分类下的项目列表
3. **分类稳定**: 项目分类相对稳定,新增较少
4. **排序**: order字段决定显示顺序
---
## 2. 项目列表 API
### API基本信息
- **接口名称**: 项目列表
- **接口地址**: `/project/list/{页码}/json`
- **请求方式**: GET
- **是否需要登录**: 否
- **页码规则**: 从1开始(重要!与文章列表不同)
### 请求参数
- **路径参数**: 页码(从1开始)
- **查询参数**: cid=分类id
- **可选参数**: page_size=1-40
### 测试用例:查询"跨平台应用"分类的项目
分类id: 402,查询第1页
```bash
curl -s "https://www.wanandroid.com/project/list/1/json?cid=402"
```
### 响应数据(部分)
```json
{
"data": {
"curPage": 1,
"datas": [
{
"adminAdd": false,
"apkLink": "",
"audit": 1,
"author": "ZuYun",
"canEdit": false,
"chapterId": 402,
"chapterName": "跨平台应用",
"collect": false,
"courseId": 13,
"desc": "在线体验地址\r\nhttps://zuyun.github.io/loginj/#/",
"descMd": "",
"envelopePic": "https://www.wanandroid.com/blogimgs/f711266f-566d-4db9-9a42-d62a05afafe2.png",
"fresh": false,
"host": "",
"id": 22584,
"isAdminAdd": false,
"link": "https://www.wanandroid.com/blog/show/3360",
"niceDate": "2022-05-03 21:07",
"niceShareDate": "2022-05-03 21:07",
"origin": "",
"prefix": "",
"projectLink": "https://github.com/ZuYun/loginj",
"publishTime": 1651583227000,
"realSuperChapterId": 293,
"selfVisible": 0,
"shareDate": 1651583227000,
"shareUser": "",
"superChapterId": 294,
"superChapterName": "开源项目主Tab",
"tags": [
{
"name": "项目",
"url": "/project/list/1?cid=402"
}
],
"title": "dribbble上一个有意思的登录页面交互的flutter實現",
"type": 0,
"userId": -1,
"visible": 1,
"zan": 0
},
// ... 更多项目
],
"offset": 0,
"over": false,
"pageCount": 14,
"size": 20,
"total": 280
},
"errorCode": 0,
"errorMsg": ""
}
```
### 响应解析
- **data**: 分页数据对象
- `curPage`: 当前页码(从1开始)
- `datas`: 项目数组
- `offset`: 偏移量
- `over`: 是否结束
- `pageCount`: 总页数
- `size`: 每页大小
- `total`: 项目总数
- **项目对象字段**:
- `id`: 项目唯一标识
- `title`: 项目标题
- `desc`: 项目描述
- `envelopePic`: 项目封面图
- `projectLink`: 项目源码链接(通常是GitHub)
- `link`: 项目介绍文章链接
- `author`: 作者
- `chapterName`: 分类名称
- `niceDate`: 格式化日期
- `publishTime`: 发布时间戳
- `collect`: 是否收藏
- `zan`: 点赞数
- `tags`: 标签数组
### 项目特点字段
与普通文章相比,项目有特殊字段:
1. **projectLink**: 项目源码地址(GitHub等)
2. **envelopePic**: 项目封面图(通常有值)
3. **desc**: 项目详细描述(通常较长)
4. **tags**: 项目标签(通常包含"项目"标签)
### 测试用例2:自定义分页大小
```bash
# 第1页,每页5条
curl -s "https://www.wanandroid.com/project/list/1/json?cid=402&page_size=5"
```
### 响应验证
```json
{
"data": {
"curPage": 1,
"datas": [
// 5个项目
],
"offset": 0,
"over": false,
"pageCount": 56,
"size": 5,
"total": 280
},
"errorCode": 0,
"errorMsg": ""
}
```
### 测试用例3:测试页码边界
```bash
# 测试第0页(应该返回错误或第一页)
curl -s "https://www.wanandroid.com/project/list/0/json?cid=402"
```
### 响应数据
```json
{
"data": {
"curPage": 0,
"datas": [],
"offset": 0,
"over": true,
"pageCount": 0,
"size": 20,
"total": 0
},
"errorCode": 0,
"errorMsg": ""
}
```
### 注意事项
1. **页码从1开始**: 这是与文章列表API最重要的区别
2. **分页参数**: page_size一旦传入,后续分页必须携带相同值
3. **封面图**: envelopePic字段通常有值,需要加载显示
4. **项目链接**: projectLink是源码地址,link是介绍文章地址
5. **空结果**: 如果分类下没有项目,datas为空数组
---
## 3. 最新项目列表 API
### API基本信息
- **接口名称**: 最新项目列表
- **接口地址**: `/article/listproject/{页码}/json`
- **请求方式**: GET
- **是否需要登录**: 否
- **页码规则**: 从0开始
### 请求参数
- **路径参数**: 页码(从0开始)
- **可选参数**: page_size=1-40
### 测试用例:查询最新项目第0页
```bash
curl -s "https://www.wanandroid.com/article/listproject/0/json"
```
### 响应数据
```json
{
"data": {
"curPage": 0,
"datas": [
{
"adminAdd": false,
"apkLink": "",
"audit": 1,
"author": "ZuYun",
"canEdit": false,
"chapterId": 402,
"chapterName": "跨平台应用",
"collect": false,
"courseId": 13,
"desc": "在线体验地址\r\nhttps://zuyun.github.io/loginj/#/",
"descMd": "",
"envelopePic": "https://www.wanandroid.com/blogimgs/f711266f-566d-4db9-9a42-d62a05afafe2.png",
"fresh": false,
"host": "",
"id": 22584,
"isAdminAdd": false,
"link": "https://www.wanandroid.com/blog/show/3360",
"niceDate": "2022-05-03 21:07",
"niceShareDate": "2022-05-03 21:07",
"origin": "",
"prefix": "",
"projectLink": "https://github.com/ZuYun/loginj",
"publishTime": 1651583227000,
"realSuperChapterId": 293,
"selfVisible": 0,
"shareDate": 1651583227000,
"shareUser": "",
"superChapterId": 294,
"superChapterName": "开源项目主Tab",
"tags": [
{
"name": "项目",
"url": "/project/list/1?cid=402"
}
],
"title": "dribbble上一个有意思的登录页面交互的flutter實現",
"type": 0,
"userId": -1,
"visible": 1,
"zan": 0
},
// ... 更多最新项目
],
"offset": 0,
"over": false,
"pageCount": 14,
"size": 20,
"total": 280
},
"errorCode": 0,
"errorMsg": ""
}
```
### 响应解析
- **数据结构**: 与项目列表API完全相同
- **数据内容**: 所有分类的最新项目,按时间倒序排列
- **分页规则**: 页码从0开始,与文章列表一致
### 注意事项
1. **混合数据**: 包含所有分类的最新项目
2. **时间排序**: 按发布时间倒序排列
3. **分页规则**: 从0开始,与文章列表一致
4. **首页使用**: 通常用于首页的"最新项目"Tab
---
## 测试总结
### ✅ 已测试API
1. 项目分类 ✅
2. 项目列表 ✅
3. 最新项目列表 ✅
### 📊 数据统计
- 总测试API:3个
- 成功:3个
- 失败:0个
- 分类数量:28个(27个可见)
- 项目示例:跨平台应用分类有280个项目
### 🔧 技术要点
1. **页码差异**: 项目列表从1开始,文章列表从0开始
2. **项目字段**: 有projectLink和envelopePic特殊字段
3. **分类结构**: 扁平结构,没有子分类
4. **最新项目**: 混合所有分类的最新项目
### 📝 移动端开发建议
1. **统一分页处理**: 需要区分文章和项目的分页逻辑
2. **项目卡片设计**: 需要显示封面图、标题、描述、作者等信息
3. **分类导航**: 使用TabLayout展示项目分类
4. **源码跳转**: 正确处理projectLink的打开
5. **图片加载**: 优化封面图加载和缓存
### 🧪 边界测试建议
1. **页码边界**: 测试第0页、第1页、超出范围页
2. **空分类**: 测试没有项目的分类
3. **分页一致性**: 测试page_size参数的一致性要求
4. **网络错误**: 测试网络异常时的处理
### ⚠️ 重要区别
| 特性 | 文章列表 | 项目列表 |
|------|----------|----------|
| 页码起始 | 0 | 1 |
| 接口地址 | `/article/list/{页码}/json` | `/project/list/{页码}/json` |
| 分类参数 | cid | cid |
| 特殊字段 | 无 | projectLink, envelopePic |
| 数据用途 | 技术文章 | 开源项目 |
---
**测试时间**: 2026-03-17 20:50
**测试人员**: nanobot
**下一阶段**: 搜索API测试
## 附录:常用项目分类ID
```
跨平台应用: 402
资源聚合类: 367
动画: 323
RV列表动效: 314
项目基础功能: 358
网络&文件下载: 328
TextView: 331
键盘: 336
快应用: 337
日历&时钟: 338
K线图: 339
硬件相关: 340
表格类: 357
创意汇: 363
ImageView: 380
音视频&相机: 382
相机: 383
下拉刷新: 310
架构: 385
对话框: 387
数据库: 388
AS插件: 391
ViewPager: 400
二维码: 401
富文本编辑器: 312
IM: 526
未分类: 539
```