# appserver

**Repository Path**: yos/appserver

## Basic Information

- **Project Name**: appserver
- **Description**: APK 上传、版本管理、下载分发与更新检查的 Web 管理平台。
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-08-05
- **Last Updated**: 2026-08-05

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# ApkUpdate 内部应用中心

APK 上传、版本管理、下载分发与更新检查的 Web 管理平台。

配套安卓lib:[https://gitee.com/yos/appUpdate](https://gitee.com/yos/appUpdate)

## 功能说明

- **APK 管理**：上传 APK、版本列表、下载、删除
- **更新检查**：移动端通过 API 检查版本更新
- **用户管理**：登录认证，默认管理员 `admin` / `123456`（上线后请立即修改）
- **站点设置**：站点标题等
- **亮/暗主题**：支持主题切换
- **请求日志**：控制台打印每次 HTTP 请求（方法、URI、状态码、耗时）

## 技术栈

| 模块 | 技术 |
|------|------|
| 前端 | Vue 3 + Vite + Ant Design Vue |
| 后端 | Spring Boot 3.4 + Java 17 |
| 数据库 | SQLite |

## 环境要求

- **Node.js** 18+（前端）
- **JDK 17**（后端）
- **Maven** 3.6+（可选，也可用项目自带的 Maven Wrapper）

---

## 前端编译

### 1. 安装依赖

```bash
cd frontend
npm install
```

### 2. 开发模式

```bash
npm run dev
```

- 开发服务器：http://localhost:5173
- 已将 `/appserver` 代理到后端 `http://localhost:9999`

### 3. 生产构建

```bash
npm run build
```

构建产物输出到项目根目录的 `web/`，由 Spring Boot 直接提供静态资源。

---

## 后端编译

### 1. 使用 Maven

```bash
# 在项目根目录执行
mvn clean package -DskipTests
```

生成的 JAR：`target/ApkUpdate-0.0.1.jar`

### 2. 使用 Maven Wrapper（无需本地安装 Maven）

**Windows：**

```bash
mvnw.cmd clean package -DskipTests
```

**Linux / macOS：**

```bash
./mvnw clean package -DskipTests
```

---

## 运行方式

### 本地运行

1. **先编译前端**（首次或前端有改动时）：

   ```bash
   cd frontend && npm install && npm run build && cd ..
   ```

2. **启动后端**：

   ```bash
   java -jar target/ApkUpdate-0.0.1.jar
   ```

3. **访问**：http://localhost:9999/appserver

### 配置说明（`application.properties`）

| 配置项 | 默认值 | 说明 |
|--------|--------|------|
| `server.port` | `9999` | 服务端口 |
| `server.servlet.context-path` | `/appserver` | 统一上下文路径（前端与 API 均在此下） |
| `apk.storage.path` | `apks` | APK / 图标存储目录 |
| `web.path` | `web` | 前端静态资源目录（勿加前导空格） |
| `apk.api.key` | （空） | 可选；配置后移动端需在请求头 `X-API-Key` 中携带 |

- **数据库**：SQLite，文件 `apk_update.db` 位于项目根目录
- **日志格式**：`yyyy-MM-dd HH:mm:ss.SSS`，并打印每次网络请求

### 常用地址

| 用途 | 地址 |
|------|------|
| 前端入口 | http://localhost:9999/appserver |
| Swagger UI | http://localhost:9999/appserver/swagger-ui.html |
| OpenAPI JSON | http://localhost:9999/appserver/v3/api-docs |
| 检查更新 API | `GET /appserver/apk/latest?packageName=包名` |

---

## 其他文档

- [Docker 部署](doc/说明.md)：Docker 镜像构建与容器运行说明
- [前端说明](frontend/README.md)：前端开发与构建简要说明