# LFramework_CC3.x

**Repository Path**: ideawedo/lframeworkcc3

## Basic Information

- **Project Name**: LFramework_CC3.x
- **Description**: CocosCreator 3.X开发框架
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2024-10-30
- **Last Updated**: 2025-12-22

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# LFramework - Cocos Creator 游戏开发框架

LFramework 是一个基于 Cocos Creator 的游戏开发框架，提供完整的模块化架构和多平台支持，特别适合移动端小游戏和H5游戏开发。

## 🚀 框架特性

- **多平台适配**: 支持微信、字节跳动、快手、Web等主流平台
- **模块化设计**: 清晰的模块划分，便于维护和扩展
- **UI管理系统**: 完整的界面层级管理和视图加载机制
- **数据持久化**: 用户数据存储和管理系统
- **工具函数库**: 丰富的游戏开发工具函数

## 📁 项目结构

```
assets/LFramework/
├── Channel/          # 渠道适配模块
├── Data/             # 数据管理模块
├── Demo/             # 示例代码
├── Prefabs/          # 预制体资源
├── Tools/            # 工具类
└── UI/               # UI管理系统
```

## 🔧 核心模块接口

### Channel 模块 - 渠道适配

#### ChannelManager (渠道管理器)
- `init()`: 初始化渠道SDK
- `login()`: 用户登录
- `pay()`: 支付接口
- `share()`: 分享功能
- `getUserInfo()`: 获取用户信息

#### 支持的渠道
- WeixinChannel: 微信小游戏
- BytedanceChannel: 字节跳动小游戏
- KuaishouChannel: 快手小游戏
- WebChannel: Web平台

### Data 模块 - 数据管理

#### DataManager (数据管理器)
- `saveData(key, value)`: 保存数据
- `getData(key)`: 获取数据
- `removeData(key)`: 删除数据
- `clearAll()`: 清空所有数据

#### UserDataHelper (用户数据助手)
- `saveUserData()`: 保存用户数据
- `loadUserData()`: 加载用户数据
- `resetUserData()`: 重置用户数据

### UI 模块 - 界面管理

#### UIManager (UI管理器)
- `showPanel(panelName)`: 显示面板
- `hidePanel(panelName)`: 隐藏面板
- `getPanel(panelName)`: 获取面板实例
- `closeAll()`: 关闭所有面板

#### UIPanel (面板基类)
- `onShow()`: 面板显示时调用
- `onHide()`: 面板隐藏时调用
- `onClose()`: 面板关闭时调用
- `updateView()`: 更新面板视图

#### ViewLoaderBase (视图加载器基类)
- `loadView(viewPath)`: 加载视图
- `unloadView()`: 卸载视图
- `showView()`: 显示视图
- `hideView()`: 隐藏视图

### Tools 模块 - 工具函数

#### RandomTools (随机工具)
- `randomInt(min, max)`: 生成随机整数
- `randomFloat(min, max)`: 生成随机浮点数
- `randomArrayItem(array)`: 随机获取数组元素

#### TimeTools (时间工具)
- `formatTime(seconds)`: 格式化时间显示
- `getTimestamp()`: 获取时间戳
- `isSameDay(timestamp1, timestamp2)`: 判断是否同一天

#### UrlTools (URL工具)
- `parseUrl(url)`: 解析URL参数
- `buildUrl(baseUrl, params)`: 构建URL
- `encodeParams(params)`: 编码参数

## 🎯 快速开始

### 1. 环境要求
- Cocos Creator 3.x
- TypeScript 支持

### 2. 基础使用

```typescript
// 初始化框架
import { UIManager } from './LFramework/UI/UIManager';
import { DataManager } from './LFramework/Data/DataManager';

// 显示面板
UIManager.instance.showPanel('MainPanel');

// 保存数据
DataManager.instance.saveData('userLevel', 5);
```

### 3. 渠道适配示例

```typescript
import { ChannelManager } from './LFramework/Channel/ChannelManager';

// 初始化渠道
ChannelManager.instance.init();

// 用户登录
ChannelManager.instance.login().then(userInfo => {
    console.log('登录成功:', userInfo);
});
```

## 📖 示例代码

项目包含完整的示例场景和代码，位于 `assets/LFramework/Demo/` 目录：

- `LFrameworkDemo.scene`: 主演示场景
- `DemoPanel.ts`: 演示面板
- `TestPanel.ts`: 测试面板

## 🔄 更新日志

### v1.0.0
- 初始版本发布
- 基础框架架构
- 多平台渠道支持
- UI管理系统
- 数据持久化

## 🤝 贡献指南

欢迎提交 Issue 和 Pull Request 来改进框架。

## 📄 许可证

本项目采用 MIT 许可证，详见 LICENSE 文件。

## 📞 技术支持

如有问题或建议，请通过以下方式联系：
- 提交 GitHub Issue
- 查看示例代码和文档

---

**LFramework** - 让游戏开发更简单！