# app-versionlab

**Repository Path**: deoli/app-versionlab

## Basic Information

- **Project Name**: app-versionlab
- **Description**: sdsasdasdasdasdasd
- **Primary Language**: Unknown
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-07-10
- **Last Updated**: 2025-07-16

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

ifndef::imagesdir[:imagesdir: src/main/resources/images/]

image::logo.png[logo,200,200,align="center"]

== APP版本管理系统

[[License]]
image::https://img.shields.io/badge/License-Apache%202.0-blue.svg[link="https://opensource.org/licenses/Apache-2.0"] 
image::https://img.shields.io/badge/Release-1.1.0-blue.svg?style=flat-square&logo=appveyor[]
image::https://api.codacy.com/project/badge/Grade/2f50f68e20d64479b5d8b79112d9b341["Codacy code quality", link="https://www.codacy.com/app/lzx2005/app-version?utm_source=github.com&utm_medium=referral&utm_content=xtTech/app-version&utm_campaign=Badge_Grade"]


APP版本管理是一套多应用更新发版的管理平台。 +
通过部署本管理系统，以实现对多APP的多平台多渠道上的版本管理。

=== 项目结构

```
app-version
│   README.adoc
└───modules
│   └───app-version-common (公共代码 实体类 工具类等)
│   └───app-version-manager (后台管理模块)
│   └───app-version-rest (与APP交互的 Rest 接口模块)
└───web
│   └───dashboard (前端)
└───src
│   └───main
│       └───asciidoc 相关文档
└───bin 脚本文件
```
=== 功能概览

本系统的主要功能有 IOS/Android 版本管理，RN（React Native）包和RN路由管理，自定义接口以及管理员管理。 +

* `版本管理` 是本系统的基础功能，可以帮您实现自己的应用在安卓各应用商店或IOS的App Store上各个版本的管理。 +
* `RN 管理` 可以来便携管理您应用的RN包和RN路由。 +
* `自定义接口` 可以自定义您期望获得的数据信息。 +
* `管理员` 模块可以让您方便的实现多管理、多应用的操作。此外，`操作日志` 可以方便您监管其他应用管理员对各个应用的操作情况。 +
* `操作手册` 可以帮你查找操作方法。


=== 相关文档

link:src/main/asciidoc/_chapter/get-started.adoc[开发/部署手册]

link:src/main/asciidoc/_chapter/user-manual.adoc[使用手册]

link:src/main/asciidoc/_chapter/rest-manual.adoc[版本查询 API 接口]

link:src/main/asciidoc/_chapter/docker-manual.adoc[Docker 使用手册]


=== 设备版本规则管理

==== 使用方法

1. 在侧边栏菜单中点击"设备版本规则"进入列表页面
2. 点击"添加设备版本规则"按钮创建新规则
3. 点击"编辑"按钮修改现有规则
4. 点击"启用/禁用"按钮更改规则状态
5. 点击"删除"按钮删除规则
6. 点击"测试规则匹配"按钮进入测试页面，输入设备信息进行测试

==== 通过规则进行版本升级

设备版本规则功能允许您根据设备特定信息（如MAC地址、IMEI或IP地址）为特定设备推送指定版本的应用。这对于以下场景特别有用：

1. 灰度发布：向特定设备组推送新版本进行测试
2. 问题修复：为特定设备推送修复特定问题的版本
3. 特殊功能：为特定设备提供特殊功能版本
4. 版本控制：强制特定设备升级到指定版本

===== 创建规则步骤

1. 设置规则名称和目标平台（iOS/Android）
2. 指定目标版本号和更新类型（强制/非强制）
3. 添加匹配条件（MAC地址/IMEI/IP地址）
4. 设置条件匹配方式（等于/包含/开始于/结束于）
5. 设置规则优先级和状态（启用/禁用）

===== 规则匹配逻辑

当移动设备请求版本信息时，系统会按以下逻辑处理：

1. 检查设备信息（MAC地址/IMEI/IP地址）是否与任何启用状态的规则匹配
2. 如果匹配多条规则，选择优先级最高的规则
3. 返回匹配规则中指定的目标版本信息
4. 如果没有匹配规则，返回常规版本更新信息

设备版本规则管理功能现已完成，可以通过这些页面对设备版本规则进行全面管理和测试。

=== 设备信息管理

==== 功能概述

设备信息管理功能允许您查看和管理所有连接到系统的移动设备信息。通过此功能，您可以：

1. 查看所有设备的列表信息，包括设备ID、应用ID、MAC地址、IMEI、IP地址和在线状态等
2. 按应用ID、MAC地址、IMEI、IP地址和在线状态进行筛选查询
3. 查看设备的详细信息，包括操作系统信息、固件版本、最后启动时间、最后心跳时间等

==== 使用方法

1. 在侧边栏菜单中点击"设备信息"进入列表页面
2. 使用筛选条件查找特定设备
3. 点击"详情"按钮查看设备的详细信息
4. 通过分页控件浏览大量设备记录

==== 应用场景

设备信息管理功能在以下场景中特别有用：

1. 设备监控：实时监控设备的在线状态和活动情况
2. 问题排查：当用户报告问题时，可以查看其设备详情进行分析
3. 用户行为分析：了解用户设备的分布情况和使用模式
4. 版本部署决策：根据设备信息制定更精准的版本发布策略


=== 项目预览
本项目使用iView框架搭建，简洁美观。

image::show1.png[]
image::show2.png[]


=== 合作项目

==== iOS 前端Swift一键使用

image::https://raw.githubusercontent.com/birdmichael/app-version-swift/master/show.png[]

* 一键配置
* 全截面自定义
* 自动版本比较
* 自动限制最低版本
* 自动维护每次弹出，弹出一次逻辑
* 配置文本框最大高度（默认不可滚动，不显示滚动条）

项目地址：https://github.com/birdmichael/app-version-swift


=== 答疑帮助

* 链接地址对的，但是请求返回 <没有权限访问该地址，请先登录> 提示信息？

这个问题可能原因：

1、地址本身就需要登录之后才可以使用

2、地址存在有误，可以确认一下

3、数据库表没有成功初始化

* OSS 跨域问题

https://help.aliyun.com/video_detail/39695.html?spm=5176.10695662.1996646101.searchclickresult.791c4a496p15UY

NOTE: 有时候邮件回复的不是那么及时，推荐微信。

微信: zoeminghong （备注：APP 管理系统）

=== License

Apache Licensed. 具体查看 `License`