# android-cloud-gaming-client

**Repository Path**: iakuf/android-cloud-gaming-client

## Basic Information

- **Project Name**: android-cloud-gaming-client
- **Description**: 安通云游戏开源客户端
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: dev_open_source
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-12-25
- **Last Updated**: 2026-02-02

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 安通游戏平台

一个基于 Android 的云游戏平台应用，支持云游戏 SDK 接入，提供游戏浏览、详情查看、云游戏体验等功能。

注意：本项目仅限于演示，不可用于商业运营，如寻求合作请查看官网。

**官网：** https://everylinks.com/

## 项目简介

安通游戏平台是一个模块化的 Android 应用，采用 MVVM 架构设计，支持多渠道打包。应用集成自研云游戏 SDK，为用户提供流畅的云游戏体验。

## 代码分支

最新代码提交在分支 dev_open_source。

## 主要功能

-  **游戏浏览** - 游戏列表展示、分类浏览、搜索功能
-  **游戏详情** - 游戏信息展示、截图预览、游戏启动
-  **游戏体验** - 支持SDK，提供远程控制功能
-  **用户系统** - 登录注册、微信登录、个人中心
-  **游戏商城** - 游戏购买、兑换码、渠道绑定
-  **系统设置** - 个性化设置、系统配置

## 项目架构

项目采用模块化架构，主要分为以下几个模块：

### Core 模块
- `core-base` - 基础组件、工具类、Application
- `core-common` - 公共常量、工具类
- `core-data` - 数据层、Repository 实现
- `core-database` - Room 数据库
- `core-model` - 数据模型
- `core-network` - 网络请求封装
- `core-res` - 公共资源文件
- `core-channel` - 渠道相关配置

### Features 模块
- `features/main` - 主页模块（首页、商城、个人中心）
- `features/login` - 登录注册模块
- `features/game_detail` - 游戏详情模块
- `features/control` - 远程控制模块

### 其他模块
- `app` - 应用主模块
- `keyboard` - 键盘模块（可选）
- `LocalAAR` - 本地 AAR 依赖（云游戏 SDK 等）

##  技术栈

- **开发语言**: Kotlin
- **架构模式**: MVVM (Model-View-ViewModel)
- **依赖注入**: Hilt
- **路由框架**: ARouter
- **网络请求**: Retrofit + OkHttp
- **数据解析**: Moshi
- **数据库**: Room
- **图片加载**: Coil
- **异步处理**: Kotlin Coroutines
- **UI 组件**: Material Design Components
- **多渠道打包**: VasDolly

## 环境要求

- Android Studio Hedgehog | 2023.1.1 或更高版本
- JDK 11
- Android SDK 33
- Gradle 8.0+
- Kotlin 1.8.21

## 快速开始

### 1. 克隆项目

```bash
git clone <repository-url>
```

### 2. 配置签名

在 `app/build.gradle.kts` 中配置签名信息，或使用项目中的签名文件：
- 签名文件位置：`key/` 目录
- 默认签名配置在 `app/build.gradle.kts` 的 `signingConfigs` 中

### 3. 配置渠道信息

在 `app/build.gradle.kts` 的 `productFlavors` 中配置各渠道信息：
- 应用包名
- 应用名称
- API 地址
- 微信配置等

### 4. 同步项目

在 Android Studio 中打开项目，等待 Gradle 同步完成。

### 5. 运行项目

选择对应的渠道和构建类型，运行项目：
- 渠道：`at` (安通云游) 等
- 构建类型：`debug` 或 `release`

## 构建 APK

### 使用脚本构建

```bash
# 构建 Release APK
./buildapk.sh

# 构建 Test APK
./buildTestApk.sh
```

### 使用 Gradle 命令

```bash
# Windows
gradlew assembleAtRelease

# Linux/Mac
./gradlew assembleAtRelease
```

构建产物会输出到 `app/build/outputs/apk/` 目录，文件名格式：`{flavor}_v{version}_{buildType}_{timestamp}.apk`

## 🔧 配置说明

### 版本号配置

版本号在 `buildSrc/src/main/kotlin/com/gamexigua/watermelon/Configuration.kt` 中统一管理：

```kotlin
const val majorVersion = 1
const val minorVersion = 0
const val patchVersion = 15
```

### 渠道配置

渠道配置在 `app/build.gradle.kts` 的 `productFlavors` 中，每个渠道可以配置：
- `applicationId` - 应用包名
- `resValue` - 应用名称
- `buildConfigField` - API 地址、密钥等配置

### 依赖管理

项目使用 Version Catalog 管理依赖，配置文件：`gradle/libs.versions.toml`

## 支持的渠道

- **at** - 安通云游 (`com.gamexigua.open.at`)

更多渠道可根据需要添加。

## 集成的 SDK

- **云游戏 SDK**
  - 安通云游 SDK

- **第三方 SDK**
  - 微信 SDK (登录、支付)

## 项目结构

```
3a-watermelon/
├── app/                    # 应用主模块
├── core/                   # 核心模块
│   ├── core-base/         # 基础组件
│   ├── core-common/       # 公共工具
│   ├── core-data/         # 数据层
│   ├── core-database/     # 数据库
│   ├── core-model/        # 数据模型
│   ├── core-network/      # 网络层
│   ├── core-res/          # 公共资源
│   └── core-channel/      # 渠道配置
├── features/              # 功能模块
│   ├── main/             # 主页模块
│   ├── login/            # 登录模块
│   ├── game_detail/      # 游戏详情
│   └── control/          # 远程控制
├── LocalAAR/             # 本地 AAR 依赖
├── channel/              # 渠道配置文件
├── key/                  # 签名文件
└── buildSrc/             # 构建脚本
```

##  问题反馈

如有问题或建议，请通过以下方式反馈：
- 提交 Issue
- 联系开发团队


**注意**: 本项目包含敏感配置信息（如签名密钥、API 密钥等），请勿将敏感信息提交到公共仓库。