HKBitex OTC Flutter 应用

项目概述

HKBitex OTC Flutter 是一个基于 Flutter 开发的加密货币场外交易应用模块。该项目主要实现了资金划转功能，支持多语言和主题切换，可以作为独立模块集成到原生应用中。

技术栈

• Flutter SDK: >=3.3.0 <4.0.0
• 状态管理: Provider
• 网络请求: Dio
• 国际化: Easy Localization
• 主题切换: Adaptive Theme
• 路由管理: Flutter Boost (用于原生集成)
• UI 组件: 自定义组件、Flutter SVG
• 存储: Shared Preferences、Flutter Secure Storage

项目结构

lib/
├── app.config.dart          # 应用配置管理
├── common/                  # 通用组件和样式
│   ├── loading_widget/      # 加载组件
│   ├── style/               # 主题和样式
│   └── widgets/             # 通用小组件
├── components/              # 业务组件
│   ├── keyBoard/            # 自定义键盘
│   ├── numberKeypan/        # 数字键盘
│   └── sheetAlertPage/      # 底部弹出框
├── helpers/                 # 工具类
│   ├── app_version.dart     # 版本管理
│   └── request.dart         # 网络请求封装
├── main.dart                # 应用入口
└── pages/                   # 页面
    └── transferPage/        # 资金划转页面
        ├── sections/        # 页面组件
        ├── transferPage.dart # 页面主文件
        └── widgets/         # 页面专用组件

主要功能

1. 资金划转: 支持不同账户间的资金划转操作
2. 多语言支持: 支持英文、简体中文和繁体中文
3. 主题切换: 支持浅色和深色主题
4. 原生集成: 通过 Flutter Boost 支持与原生应用的无缝集成

开发环境设置

前提条件

• Flutter SDK >=3.3.0 <4.0.0
• Dart SDK 与 Flutter 兼容的版本
• Android Studio / VS Code
• iOS 开发需要 Xcode 和 CocoaPods

安装步骤

1. 克隆仓库

git clone https://gitlab.atom8.io/hkbitex/exchange-hkbitex-otc-flutter.git
cd exchange-hkbitex-otc-flutter

2. 安装依赖

flutter pub get

3. 运行应用

flutter run

集成到原生应用

本项目设计为可以作为模块集成到原生 Android 和 iOS 应用中。集成过程主要通过 Flutter Boost 实现，具体步骤请参考 Flutter 官方文档和 Flutter Boost 文档。

注意：作为模块集成到原生应用中，必须将两个项目放在同一个文件夹下。

配置说明

应用配置通过 AppConfig 类管理，包括：

• baseUrl: API 基础 URL
• token: 用户认证令牌
• isInNative: 是否在原生应用中运行
• theme: 主题设置 (0: 浅色, 1: 深色)
• language: 语言设置 (en-US, zh-CN, zh-HK)

网络请求

网络请求通过 RequestHelper 类封装，基于 Dio 实现，支持：

• GET/POST 请求
• 错误处理和状态码验证
• 加载状态管理
• 认证令牌管理

贡献指南

1. Fork 项目
2. 创建功能分支 (git checkout -b feature/amazing-feature)
3. 提交更改 (git commit -m 'Add some amazing feature')
4. 推送到分支 (git push origin feature/amazing-feature)
5. 创建 Pull Request