# 享+社区_Flutter版---支持_鸿蒙_安卓_苹果_H5_共四端

**Repository Path**: Megasu/enjoy_plus_ohos

## Basic Information

- **Project Name**: 享+社区_Flutter版---支持_鸿蒙_安卓_苹果_H5_共四端
- **Description**: 享+社区是一个适配 HarmonyOS 和 Flutter 的多平台社区服务应用，为用户提供房屋租赁、维修服务、公告查看等核心功能。通过多端统一的用户体验满足社区生活的各项需求，共支持 HarmonyOS、Android、iOS、Web 四个端。


- **Primary Language**: Dart
- **License**: Apache-2.0
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 2
- **Forks**: 0
- **Created**: 2025-04-04
- **Last Updated**: 2025-08-23

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 享+社区

## 项目介绍

享+社区是一个适配 HarmonyOS 和 Flutter 的多平台社区服务应用，为用户提供房屋租赁、维修服务、公告查看等核心功能，通过多端统一的用户体验满足社区生活的各项需求，共支持 HarmonyOS、Android、iOS、Web 四个端。

## 开发环境

### 开发工具

- 操作系统：MacOS 15.0
- AI编辑器：Cursor 0.48.9
- 鸿蒙开发环境：DevEco Studio 5.0.4 Release
- 安卓开发环境：Android Studio (version 2024.2)
- 苹果开发环境：Xcode Version 16.1 (16B40)
- 浏览器：Chrome 135.0.7049.85

### Flutter 环境

- Flutter: [3.22.1-ohos](https://gitcode.com/openharmony-sig/flutter_flutter)
- Dart: 3.4.0

### JAVA、Gradle、AGP 环境

- Java: 21.0.3
- Gradle: 8.5
- Android Gradle Plugin(AGP): 8.2.0

## 环境检查

### flutter doctor

检查

```sh
# 输入
flutter doctor -v

# 输出(参考)
[!] Flutter (Channel [user-branch], 3.22.1-ohos-0.1.1, on macOS 15.0 24A335 darwin-arm64, locale zh-Hans-CN)
    • FLUTTER_GIT_URL = git@gitee.com:openharmony-sig/flutter_flutter.git
    • Framework revision ff3e031966 (8 days ago), 2025-04-07 10:25:16+0800
    • Engine revision f6344b75dc
    • Dart version 3.4.0
    • DevTools version 2.34.1
    • Pub download mirror https://pub.flutter-io.cn
    • Flutter download mirror https://storage.flutter-io.cn

[✓] HarmonyOS toolchain - develop for HarmonyOS devices
    • OpenHarmony Sdk at /Applications/DevEco-Studio.app/Contents/sdk,available api versions has [16:default]
    • Ohpm version 5.0.13
    • Node version v18.20.8
    • Hvigorw binary at /Applications/DevEco-Studio.app/Contents/tools/hvigor/bin/hvigorw

[✓] Android toolchain - develop for Android devices (Android SDK version
    35.0.0)
    • Android SDK at /Users/megasu/Library/Android/sdk
    • Platform android-35, build-tools 35.0.0
    • Java binary at: /Applications/Android Studio.app/Contents/jbr/Contents/Home/bin/java
    • Java version OpenJDK Runtime Environment (build 21.0.3+-79915917-b509.11)
    • All Android licenses accepted.

[✓] Xcode - develop for iOS and macOS (Xcode 16.1)
    • Xcode at /Applications/Xcode.app/Contents/Developer
    • Build 16B40
    • CocoaPods version 1.16.2

[✓] Chrome - develop for the web
    • Chrome at /Applications/Google Chrome.app/Contents/MacOS/Google Chrome

[✓] Android Studio (version 2024.2)
    • Android Studio at /Applications/Android Studio.app/Contents
    • Flutter plugin can be installed from:
      🔨 https://plugins.jetbrains.com/plugin/9212-flutter
    • Dart plugin can be installed from:
      🔨 https://plugins.jetbrains.com/plugin/6351-dart
    • Java version OpenJDK Runtime Environment (build 21.0.3+-79915917-b509.11)
```

### flutter analyze

```sh
# 输入
flutter analyze --suggestions

# 输出(参考)
Newer than known valid Java version (21.0.3), gradle (8.5).
 Treating as valid configuration.

┌───────────────────────────────────────────────────────────────────┐
│ General Info                                                      │
│ [✓] App Name: enjoy_plus_ohos                                     │
│ [✓] Supported Platforms: android, ios, web, ohos                  │
│ [✓] Is Flutter Package: yes                                       │
│ [✓] Uses Material Design: yes                                     │
│ [✓] Is Plugin: no                                                 │
│ [✓] Java/Gradle/Android Gradle Plugin: compatible java/gradle/agp │
└───────────────────────────────────────────────────────────────────┘
```

### HarmonyOS 环境

- DevEco Studio: 5.0 或更高版本
- HarmonyOS SDK: API 12 或更高版本
- Node.js: 18.0 或更高版本

## 启动命令

### Flutter 端启动

```bash
# 开发模式启动
flutter run

# 打包 HarmonyOS 应用
flutter build app

# 打包 Android 应用
flutter build apk

# 打包 iOS 应用
flutter build ios

# 打包 Web 应用
flutter build web
```

## 目录结构

```sh
enjoy_plus_ohos/
├── ohos/                     # 鸿蒙端 特定代码
├── android/                  # 安卓端 特定代码
├── ios/                      # 苹果端 特定代码
├── web/                      # 浏览器端 特定代码
├── lib/                      # Flutter 主要代码
│   ├── main.dart             # 应用入口
│   ├── pages/                # 页面组件
│   │   ├── home/             # 首页相关组件
│   │   ├── login/            # 登录页面
│   │   └── mine/             # 个人中心页面
│   ├── router/               # 路由管理
│   ├── utils/                # 工具类
│   └── widgets/              # 公共组件
├── assets/                   # 静态资源
│   ├── tabs/                 # 底部标签图标
│   └── images/               # 应用图片资源
├── pubspec.yaml              # Flutter 项目配置
├── pubspec.lock              # Flutter 依赖锁定
└── README.md                 # 项目说明文档
```

## 功能特性

- 用户认证：登录、注册、密码找回
- 房屋管理：房屋列表、添加房屋、编辑房屋信息
- 社区服务：报修、投诉建议、访客登记
- 社区公告：公告列表、公告详情、消息通知
- 个人中心：用户信息、设置、意见反馈
- 等

## 技术栈

### Flutter 端

- Dart 语言
- Flutter 框架
- Dio 网络请求
- Provider 状态管理
- SharedPreferences 本地存储

## 运行说明

1. 确保已安装所需的开发环境
2. 克隆项目仓库
3. 运行 `flutter pub get` 安装依赖
4. 启动模拟器或连接真机
5. 运行 `flutter run` 启动应用

## 贡献指南

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

## 许可证

本项目采用 MIT 许可证 - 详情请查看 LICENSE 文件