# base_app

**Repository Path**: duanzhao0265/base_app

## Basic Information

- **Project Name**: base_app
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-03-24
- **Last Updated**: 2026-05-11

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# HeartSpace Base App

Flutter client baseline for HeartSpace.

## Environment

- Flutter: `3.22.x`
- Dart: `3.4.x`
- Android Gradle Plugin: `8.6.0`
- Gradle: `8.7`
- JDK: `17` (required)

## Quick Start

```bash
flutter pub get
flutter analyze
flutter test
flutter run
```

默认联调配置（无需额外参数）：

- iOS 模拟器 / macOS / Windows：`http://127.0.0.1:8080`
- Android 模拟器：`http://10.0.2.2:8080`
- 默认 `ENABLE_MOCK_API=false`，直接走后端真实接口

如需手动指定后端地址（推荐）：

```bash
flutter run \
  --dart-define=API_BASE_URL=http://127.0.0.1:8080 \
  --dart-define=ENABLE_MOCK_API=false \
  --dart-define=ENABLE_MOCK_FALLBACK=false \
  --dart-define=ENABLE_HTTP_LOG=true
```

如果你要切回 Mock 调试：

```bash
flutter run \
  --dart-define=ENABLE_MOCK_API=true \
  --dart-define=ENABLE_MOCK_FALLBACK=true
```

## Android / iOS 打包命令

默认情况下，`release` 会使用生产环境地址（腾讯云服务器），`debug` 走本地联调地址。

### Android

```bash
# APK（通用）
flutter build apk --release

# App Bundle（上架 Google Play 推荐）
flutter build appbundle --release
```

产物路径：

- APK：`build/app/outputs/flutter-apk/app-release.apk`
- AAB：`build/app/outputs/bundle/release/app-release.aab`

### iOS

```bash
# iOS Release（用于真机/归档前构建）
flutter build ios --release

# iOS Debug（本地调试）
flutter build ios --debug
```

产物目录：`build/ios/iphoneos/`

如需手动覆盖接口地址：

```bash
flutter build apk --release \
  --dart-define=API_BASE_URL=http://110.40.183.42
```

## Android Notes

AGP `8.x` requires Java 17.  
Project-level Gradle already pins Java 17 in:

- `android/gradle.properties`
  `org.gradle.java.home=/opt/homebrew/opt/openjdk@17/libexec/openjdk.jdk/Contents/Home`

If you still see Java version errors, check:

```bash
/usr/libexec/java_home -V
java -version
```

## Project Docs

- PRD: `docs/产品需求文档_PRD.md`
- App design: `docs/App端功能设计与实现方案.md`
- Dev status and plan: `docs/开发状态与计划.md`

## API Contract Notes

Current client parser is aligned with common Java backend envelopes:

- success style: `{ "success": true, "data": ... }`
- code style: `{ "code": 0|200|1000, "message": "...", "data": ... }`

The parser and endpoint constants are centralized in:

- `lib/core/network/java_api_parser.dart`
- `lib/core/network/value_reader.dart`
- `lib/core/network/api_endpoints.dart`