SunnyBeach 是基于 阳光沙滩社区开放 API 开发的非官方/社区开源 Android 客户端。项目贯彻 Kotlin First 原则，遵循现代 Android 应用架构（Modern Android Architecture）最佳实践。
本项目采用模块化工程设计与经典的 MVVM 架构体系。
:app- 应用主入口与宿主业务层。:library- 通用能力的模块聚合（并非单一模块），旗下包含多个子模块：:library:base- 基类封装（BaseActivity / Fragment / Adapter 等）。:library:widget- 自定义 UI 控件与组件。:library:network- 网络层。:library:umeng- 友盟（Umeng）集成。
build-logic- (included build) 统一的构建逻辑与插件管理，其convention子工程存放 Gradle 约定插件与ProjectConfig.kt。
- 语言：Kotlin (100% Kotlin First)
- 架构组件：Google Jetpack (ViewModel, LiveData 等)
- UI / 基础组件：BRVAH (列表适配器)、XXPermissions (权限管理)、AndroidUtilCode
- 网络与通信：Retrofit、OkHttp、EasyHttp
- 持久化：Room
- 图像加载：Glide
- 集成服务：UmengSDK (友盟统计)
- JDK 21+（项目在
settings.gradle.kts中强制校验，低于 21 将直接构建失败）。 - 推荐使用最新稳定版 Android Studio。
- Git clone 本仓库后，请将 IDE 视图切换为 Project 模式。
为保障编译通过及核心服务运行，您需要配置签名文件与第三方开放凭证。
创建/修改项目根目录的配置文件：
app/gradle.properties：配置 App 签名信息。（项目中已内置测试用的AppSignature.jks，可直接填入如下默认配置，且不会被提交到 Git）：StoreFile=AppSignature.jks StorePassword=AndroidProject KeyAlias=AndroidProject KeyPassword=AndroidProject
ProjectConfig.kt：配置第三方 SDK 的专属参数（如UMENG_APP_KEY,WX_APP_ID,WX_APP_SECRET,BUGLY_ID等）。
配置完成后，点击 Sync Now，即可编译运行 :app。
预发布/测试版本的体验下载方式：
| 蒲公英下载 (扫码或点击) | 蓝奏云下载 |
|---|---|
点击下载 |
密码：5qlt 点击下载 |
完整的应用界面运行截图，请查阅 SCREENSHOTS.md。
关于阳光沙滩的创立故事、使命愿景以及作者赞赏打赏信息，请阅读 👉 ABOUT.md。
Copyright 2021 He XiaoFeng (anjiemo)
Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.