# openfwm_android

**Repository Path**: sgyang/openfwm_android

## Basic Information

- **Project Name**: openfwm_android
- **Description**: 这是“一起钓鱼”Android端，开箱即用。
- **Primary Language**: Unknown
- **License**: GPL-3.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-10-28
- **Last Updated**: 2025-11-04

## Categories & Tags

**Categories**: Uncategorized

**Tags**: 户外钓鱼, Android

## README

# openfwm_android

#### 介绍
OpenFWM Android 是一款专为钓鱼爱好者设计的Android应用，作为「一起钓鱼」开源项目的移动端实现。该应用提供钓点查询、钓鱼情况实时分享、社交互动、渔获记录等功能，帮助钓鱼爱好者更好地享受钓鱼乐趣。

#### 功能特性

- **钓点库**：浏览、搜索和发现附近的钓鱼地点
- **有口么**：实时查看和分享各钓点的钓鱼情况
- **钓鱼圈**：创建和管理钓鱼圈，发布动态，组织活动
- **渔获记录**：记录和分享钓鱼收获
- **个人中心**：管理个人信息、查看积分记录等
- **位置服务**：基于位置的钓点推荐和导航

#### 技术架构

- **开发语言**：Kotlin
- **架构模式**：MVVM (Model-View-ViewModel)
- **UI组件**：Jetpack Compose
- **依赖注入**：Hilt
- **网络请求**：Retrofit
- **数据存储**：Room, DataStore
- **导航**：Jetpack Navigation
- **地图服务**：集成地图SDK实现钓点定位和导航

#### 安装教程

1. 克隆本仓库：
   ```bash
   git clone https://gitee.com/sgyang/openfwm_android.git
   ```

2. 使用Android Studio导入项目

3. 配置API后台接口：
   在 `NetworkModule.kt` 中修改API基础地址

4. 构建并运行项目

#### 使用说明

1. **权限说明**：
   - 位置权限：用于提供基于位置的钓点推荐和定位功能
   - 存储权限：用于图片上传和缓存

2. **主要功能使用**：
   - 首次使用需要注册/登录账号
   - 在首页可以查看附近钓点和钓鱼动态
   - 通过底部导航栏访问各个功能模块
   - 在钓点详情页可以查看钓点信息并导航
   - 在「有口么」页面分享钓鱼情况

#### 线上项目
请 **微信小程序搜索"圣刚钓鱼"** 查看线上已部署项目。

#### 相关项目链接

- [微信小程序端](https://gitee.com/sgyang/openfwm_mini) 
- [后端服务](https://gitee.com/sgyang/openfwm_backend) 
- [管理后台](https://gitee.com/sgyang/openfwm_mgr) 

#### 赞助支持

各位钓友！
作为免费开源的钓鱼平台，「一起钓鱼」从 0 到 1 全靠个人利用业余时间开发 —— 我们使用原生小程序 + Java 后端，和安卓端以及后台管理端，后续还会开发鸿蒙和IOS端，平台集成腾讯地图精准标钓点，只为让大家出钓少踩坑。

但服务器维护、新功能迭代（比如离线钓点缓存、渔获数据统计）需要更多时间精力，现诚邀大家小额赞助！
<img src="https://gitee.com/sgyang/openfwm_mini/raw/master/demo/sponsors.jpg" width="200" alt="赞助收款码" style="display: block; margin: 10px 0; border: 1px solid #eee; padding: 5px;" />
#### 参与贡献

1. Fork 本仓库
2. 新建 Feat_xxx 分支
3. 提交代码
4. 新建 Pull Request

#### 许可证

本项目采用 GNU GPLv3 开源许可证 - 查看 LICENSE 文件了解详情

## 联系方式
如有问题,建议或者软件开发合作，请通过Issues或邮件联系项目维护者
email: answerme0918@foxmail.com
qq:314343793