快速开始

本指南帮助您快速搭建 Mooting 开发环境并运行各个项目。

前置要求

通用要求

• Git
• Node.js 18+
• npm 或 yarn

后端开发

• JDK 17+
• Maven 3.6+
• SQL Server 2022 (或兼容版本)

移动应用开发

• React Native CLI
• Android Studio (Android 开发)
• Xcode (iOS 开发，需 macOS)

Android SDK 开发

• Android Studio Hedgehog 或更高版本
• Android SDK 34
• Kotlin 1.9.0

项目克隆

# 克隆所有项目
cd /path/to/workspace
git clone <repository-url> app-dev
cd app-dev

# 项目结构
├── MootingBackend/      # 后端服务
├── MootingAPP/          # React Native 应用
├── Mooting_android_demo/ # Android SDK 示例
└── mooting-docs/        # 本文档项目

后端服务启动

1. 数据库配置

-- 创建数据库
CREATE DATABASE user_system;
GO

-- 启用 sa 登录
ALTER LOGIN sa ENABLE;
ALTER LOGIN sa WITH PASSWORD = 'your_password';
GO

2. 配置文件

编辑 MootingBackend/src/main/resources/application.properties：

# 数据库连接
spring.datasource.url=jdbc:sqlserver://localhost:1433;databaseName=user_system;encrypt=true;trustServerCertificate=true;
spring.datasource.username=sa
spring.datasource.password=your_password

# JWT 密钥 (生产环境请更换)
app.jwt.secret=your-256-bit-secret-key
app.jwt.expiration-ms=86400000

3. 启动服务

cd MootingBackend
mvn clean compile
mvn spring-boot:run

# 服务启动于 http://localhost:8080

移动应用启动

1. 安装依赖

cd MootingAPP
npm install

2. 启动开发服务器

# Metro bundler
npm start

# Android
npm run android

# iOS (需 macOS)
npm run ios

# Web 预览
npm run web

Web 预览

Web 版本运行在 http://localhost:5173，方便快速调试 UI。

Android SDK 示例

1. 打开项目

使用 Android Studio 打开 Mooting_android_demo 目录。

2. 同步 Gradle

等待 Gradle 同步完成，自动下载依赖。

3. 运行应用

连接 Android 设备或启动模拟器，点击 Run 按钮。

蓝牙权限

真机测试需要授予蓝牙和位置权限才能扫描设备。

验证安装

后端 API 测试

# 健康检查
curl http://localhost:8080/api/auth/login

# 发送验证码
curl -X POST http://localhost:8080/api/verify-code/send \
  -H "Content-Type: application/json" \
  -d '{"type": "email", "target": "test@example.com"}'

应用连接测试

1. 确保后端服务运行中
2. 修改 MootingAPP/src/services/api.js 中的 BASE_URL
3. 启动应用并尝试登录

下一步

• 项目概览 - 了解各项目职责
• 架构设计 - 理解系统数据流
• API 接口 - 查看完整 API 文档