# 星网java安卓应用
**Repository Path**: WuHuiSai/starnet-java-android-app
## Basic Information
- **Project Name**: 星网java安卓应用
- **Description**: No description available
- **Primary Language**: Java
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No
## Statistics
- **Stars**: 0
- **Forks**: 1
- **Created**: 2026-05-25
- **Last Updated**: 2026-05-25
## Categories & Tags
**Categories**: Uncategorized
**Tags**: None
## README
# 星网 (XW App) — Android 客户端
> **星网** 是一个综合社交平台,融合论坛/BBS、商城、笔记、头像框与称号系统。
> 基于纯 Java 原生 Android 构建,无 XML 布局,支持多主题切换。
---
## 📦 版本历史
| 版本 | 日期 | 更新内容 |
|------|------|----------|
| **v1.6.0** | 2026-05 | ✨ 我的帖子独立页面(编辑/删除/下拉刷新/加载更多)
🎨 帖子详情按钮美化(❤️🤍⭐💰🚩)
🌓 6种主题切换(经典紫/星夜紫/海洋蓝/深海蓝/薄荷绿/日落橙)
🔄 SwipeRefreshLayout 下拉刷新(首页 + 板块帖子)
📱 透明返回按钮 + 标题居中布局
🖼 帖子卡片样式优化(16dp内边距、24dp圆角、Elevation阴影)
📊 Emoji 统计图标 + 分隔线
🗂 版本号提升至 v1.6.0 |
| **v1.5.0** | 2026-05 | 💬 评论回复(楼中楼楼)
🏷 置顶/热门标签(红/橙角标)
🎨 白色-紫色双主题(浅灰底/白卡/深紫文字)
☀ 沉浸式状态栏(lightStatusBar
📎 头像/背景上传修复
🔄 统一卡片间距 6dp
🔘 弹窗风格统一(Dialog 主题) |
| **v1.4.0** | 2026-05 | 🖼 头像框系统(领取/装备/卸下)
🏆 排行榜
⭐ 收藏/点赞记录
📖 浏览历史
🧾 账单流水 |
| **v1.3.0** | 2026-05 | 🛒 商品详情 + 购买/支付
📦 订单记录
🏪 应用商店 |
| **v1.2.0** | 2026-05 | ✏️ 帖子编辑(长按编辑)
📝 笔记功能(CRUD)
🔔 消息通知 + 已读 |
| **v1.1.0** | 2026-05 | 🔁 关注/粉丝列表
📩 私信聊天
📎 图片上传(头像/背景) |
| **v1.0.0** | 2026-05 | 🚀 初始发布:首页/板块/发布/消息/我的五栏导航
🔐 登录/注册/找回密码
📋 帖子列表 + 详情
❤️ 点赞/收藏/打赏/举报
💬 评论
🎨 深色炫紫主题 |
---
## 🧩 功能清单
### 首页
- 推荐帖子流(`api/get_recommended_posts`)
- 板块快捷入口
- 下拉刷新 / 上拉加载更多
### 板块
- 板块列表(`api/get_section_list` / `api/get_plate_list`)
- 板块内帖子列表 + 排序
- 下拉刷新 / 上拉加载更多
### 发布
- 发帖(`api/post`)
- 编辑帖子(`api/edit_post`)
- 笔记发布(`api/add_notes` / `api/update_notes`)
- 选择板块
### 消息
- 通知列表(`api/get_message_notifications`)
- 标记已读(`api/mark_all_read`)
### 我的(用户中心)
- 用户信息展示/编辑(`api/get_user_information` / `api/modify_user_information`)
- 头像/背景上传(`api/upload_avatar` / `api/upload_background`)
- 我的帖子(`api/get_posts_list` 附加 user_id)
- 我的收藏(`api/get_collection_records`)
- 点赞记录(`api/get_likes_records`)
- 浏览历史(`api/browse_history`)
- 账单流水(`api/get_user_billing`)
- 我的订单(`api/get_order_record`)
- 头像框(`api/get_avatar_frame_list` / `api/claim_avatar_frame` / `api/equip_avatar_frame` / `api/unequip_avatar_frame`)
- 排行榜(`api/ranking_list` / `api/invitation_ranking`)
- 私信聊天
- 主题切换(6种配色)
- 设置/关于
### 帖子详情
- 内容展示 + 富文本渲染
- 点赞 / 取消点赞(`api/like_posts`)
- 收藏 / 取消收藏(`api/collection_posts`)
- 打赏(`api/reward_posts`)
- 举报(`api/reporting`)
- 评论 + 楼中楼回复(`api/post_comment` / `api/get_comment_list`)
- 购买付费帖子(`api/pay_post`)
- 编辑/删除(仅作者)
---
## 🌐 API 接口清单
所有接口基于 `http://zmkjqqbot.mzfk.cn/api/`,请求方式绝大部分为 GET/POST,参数通过 HashMap 传递。
| 方法 | 接口 | 用途 |
|------|------|------|
| POST | `api/login` | 账号密码登录 |
| POST | `api/mobile_login` | 手机号登录 |
| POST | `api/register` | 注册 |
| POST | `api/reset_password` | 重置密码 |
| POST | `api/change_password` | 修改密码 |
| POST | `api/send_code` | 发送邮箱验证码 |
| POST | `api/send_sms_code` | 发送短信验证码 |
| POST | `api/fill_invitation_code` | 填写邀请码 |
| GET | `api/get_user_information` | 获取用户信息 |
| POST | `api/modify_user_information` | 修改用户信息 |
| POST | `api/modify_user_email` | 修改邮箱 |
| POST | `api/modify_user_phone` | 修改手机号 |
| POST | `api/upload_avatar` | 上传头像 |
| POST | `api/upload_background` | 上传背景图 |
| GET | `api/get_section_list` | 获取板块列表 |
| GET | `api/get_plate_list` | 获取板块详情 |
| GET | `api/get_recommended_posts` | 推荐帖子列表 |
| GET | `api/get_posts_list` | 帖子列表(支持 page/user_id) |
| GET | `api/get_post_information` | 帖子详情 |
| POST | `api/post` | 发布帖子 |
| POST | `api/edit_post` | 编辑帖子 |
| POST | `api/delete_post` | 删除帖子 |
| POST | `api/like_posts` | 点赞/取消点赞 |
| POST | `api/collection_posts` | 收藏/取消收藏 |
| POST | `api/reward_posts` | 打赏帖子 |
| POST | `api/pay_post` | 购买付费帖子 |
| POST | `api/reporting` | 举报内容 |
| POST | `api/post_comment` | 发表评论/回复 |
| GET | `api/get_comment_list` | 获取评论列表 |
| GET | `api/get_follow_posts` | 关注动态 |
| POST | `api/follow_users` | 关注/取消关注用户 |
| GET | `api/get_follow_list` | 关注列表 |
| GET | `api/get_fan_list` | 粉丝列表 |
| GET | `api/get_collection_records` | 收藏记录 |
| GET | `api/get_likes_records` | 点赞记录 |
| GET | `api/browse_history` | 浏览历史 |
| GET | `api/get_user_billing` | 账单流水 |
| GET | `api/get_order_record` | 订单记录 |
| GET | `api/get_product_information` | 商品信息 |
| POST | `api/buy_goods` | 购买商品 |
| POST | `api/pay_order` | 支付订单 |
| GET | `api/get_avatar_frame_list` | 头像框列表 |
| POST | `api/claim_avatar_frame` | 领取头像框 |
| POST | `api/equip_avatar_frame` | 装备头像框 |
| POST | `api/unequip_avatar_frame` | 卸下头像框 |
| GET | `api/ranking_list` | 排行榜 |
| GET | `api/invitation_ranking` | 邀请排行 |
| GET | `api/get_message_notifications` | 消息通知列表 |
| POST | `api/mark_all_read` | 标记全部已读 |
| POST | `api/send_message` | 发送私信 |
| GET | `api/get_notes_list` | 笔记列表 |
| POST | `api/add_notes` | 添加笔记 |
| POST | `api/update_notes` | 更新笔记 |
| POST | `api/delete_notes` | 删除笔记 |
| POST | `api/user_sign_in` | 每日签到 |
| GET | `api/get_app_list` | 应用商店列表 |
| GET | `api/download_app` | 应用下载 |
---
## 🔧 编译打包教程
### 环境要求
| 工具 | 版本 |
|------|------|
| Android Studio | 最新稳定版(推荐 Ladybug 或更高) |
| JDK | 17+(openjdk-17-jdk) |
| Android SDK | compileSdk = 36(Android 16) |
| Gradle | 项目内置 wrapper |
| 测试设备 | Android 16 (API 36) |
### 编译步骤
#### 1️⃣ 克隆项目
```bash
git clone https://gitee.com/eilti/starnet-java-android-app.git
cd starnet-java-android-app
```
#### 2️⃣ 打开项目
用 **Android Studio** → File → Open → 选择项目目录
> ⚠️ 首次打开等待 Gradle 同步完成,自动下载依赖
#### 3️⃣ 配置本地 SDK
项目不提交 `local.properties`,Android Studio 会自动生成。
若编译报 SDK 找不到,手动创建:
```
sdk.dir=C\:\\Users\\你的用户名\\AppData\\Local\\Android\\Sdk
```
#### 4️⃣ Debug 编译(快速测试)
```
Android Studio → Build → Build Bundle(s) / APK(s) → Build APK(s)
```
APK 生成位置:`app/build/outputs/apk/debug/app-debug.apk`
#### 5️⃣ Release 编译(正式发布)
```
Android Studio → Build → Generate Signed Bundle / APK
→ APK → 选择或新建 Keystore → Release → V1+V2 签名
```
APK 生成位置:`app/release/app-release.apk`
### 常见问题
**Q: 编译报错找不到类?**
A: Build → Clean Project → Build → Rebuild Project
**Q: API 地址怎么改?**
A: 修改 `Helper.java` 中的 `API_BASE` 常量(或 `ApiClient.java` 的 BASE_URL)
**Q: 如何修改应用图标?**
A: 替换 `app/src/main/res/mipmap-*/ic_launcher.png`
---
## 📁 项目结构
```
app/src/main/java/com/xwapp/
├── XWApp.java # Application 入口
├── ApiClient.java # 网络请求封装
├── Helper.java # 工具类(主题/卡片/按钮/弹窗/状态栏等)
├── JsonKit.java # JSON 解析工具
├── ui/
│ ├── main/
│ │ ├── MainActivity.java # 主界面(5栏导航)
│ │ └── SplashActivity.java # 启动图
│ ├── login/
│ │ ├── LoginActivity.java # 登录
│ │ ├── RegisterActivity.java # 注册
│ │ └── ForgetPasswordActivity.java # 找回密码
│ ├── forum/
│ │ ├── PlatePostsActivity.java # 板块帖子列表
│ │ ├── PostDetailActivity.java # 帖子详情
│ │ └── PublishActivity.java # 发布/编辑帖子
│ ├── profile/
│ │ ├── EditProfileActivity.java # 编辑资料
│ │ ├── MyPostsActivity.java # 我的帖子
│ │ ├── AvatarFrameActivity.java # 头像框
│ │ ├── RankingActivity.java # 排行榜
│ │ ├── SettingsActivity.java # 设置
│ │ └── ... # 其他资料页
│ ├── chat/
│ │ └── ChatActivity.java # 私信聊天
│ ├── notes/
│ │ └── NotesActivity.java # 笔记
│ ├── store/
│ │ ├── AppStoreActivity.java # 应用商店
│ │ └── ... # 商品/订单
│ └── message/
│ └── MessageCenterActivity.java # 消息中心
└── res/
└── values/
└── styles.xml # 主题样式
```
---
## 🧑💻 作者信息
- **作者**:星网开发团队
- **Gitee**:[@eilti](https://gitee.com/eilti)
- **仓库**:[starnet-java-android-app](https://gitee.com/eilti/starnet-java-android-app)
- **技术栈**:Java 原生 + Glide + Retrofit + 纯代码 UI(无 XML 布局)
- **开源协议**:MIT License
---
> ⭐ 如果这个项目对你有帮助,欢迎在 Gitee 上给个 Star!