CarGuo /gsy_github_app_flutter

Flutter 超完整的开源项目,功能丰富,适合学习和日常使用。GSYGithubApp 系列的优势:我们目前已经拥有 Flutter、Weex、ReactNative、Kotlin View、Kotlin Jetpack Compose ,Compose MultiPlatform,Harmony ArkUI 七个版本,功能齐全,项目框架内技术涉及面广,完成度高,持续维护,配套文章,适合全面学习,对比参考。

★ 15,514⑂ 2,619👁 331⑃ 33● 886▤ 59
DartApache-2.0Created 2018-07-25juejin.im/user/582aca2ba22b9d006b59ae68/posts
下载:8.1.18.1.1 ↓8.1.12026-08-04
+0
日增长
15,514
stars
2,619
forks
331
watchers
33
prs
886
issues
59
releases

README

!









 English Readme


 一款跨平台的开源Github客户端App,提供更丰富的功能,更好体验,旨在更好的日常管理和维护个人Github,提供更好更方便的驾车体验~~Σ( ̄。 ̄ノ)ノ。项目涉及各种常用控件、网络、数据库、设计模式、主题切换、多语言、状态管理(Redux、Riverpod、Provider)等。在开发学习过程中,提供丰富的同款对比:


  同款Weex版 ( https://github.com/CarGuo/GSYGithubAppWeex )
  同款ReactNative版 ( https://github.com/CarGuo/GSYGithubApp )
  同款Android Kotlin View版本( https://github.com/CarGuo/GSYGithubAppKotlin )
  同款Android Compose版本( https://github.com/CarGuo/GSYGithubAppCompose )
  同款Compose Multiplatform版本( https://github.com/CarGuo/GSYGithubAppCMP )
  同款HarmonyOS ArkUI版本( https://github.com/CarGuo/GSYGithubAppOH )

  简单 Flutter 独立学习项目 ( https://github.com/CarGuo/gsy_flutter_demo )



 相关文章

| 公众号   | 掘金     |  知乎    |  CSDN   |   简书   
|---------|---------|--------- |---------|---------|
| GSYTech  |  点我    |   点我       |   点我  |   点我  

-  Flutter系列文章专栏

----
-  Flutter 独立简单学习演示项目
-  Flutter 完整开发实战详解 Gitbook 预览下载
-  所有运行问题请点击这里

  GSY老书:《Flutter开发实战详解》上架啦:京东 / 当当 / 电子版京东读书和Kindle

-  如果克隆太慢或者图片看不到,可尝试从码云地址下载



-----

 须知

 因为是偏学习展示项目,所以项目里会有各式各样的模式、库、UI等,请不要介意
 
 0、 全局状态管理目前有多种模式,包括 Provider、Redux、Riverpod 等
 
 1、 TrendPage : 目前采用纯  riverpod  状态管理,演示

 2、 Provider:目前在 RepositoryDetailPage 出使用

 3、 Redux:目前展示了全局登陆和用户信息等上面使用。
 
 4、 riverpod:目前用于管理全局灰度,多语言。

 5、 Repos 等请求展示了 graphQL
 
 6、 Redux:目前展示了全局登陆和用户信息等上面使用。
 
 7、 Signals:目前用于 NotifyPage、RepositoryDetailFileListPage 页面内状态管理
 
 列表显示有多个,其中:
 
 1、gsy_pull_load_widget.dart.dart
 common_list_page.dart 等使用,搭配 gsy_list_state.dart 使用

 2、gsy_pull_new_load_widget.dart.dart
 dynamic_page.dart 等使用,搭配 gsy_bloc_list_state.dart 使用
 有 iOS 和 Android 两种风格下拉风格支持
 
 3、gsy_nested_pull_load_widget.dart
 trend_page.dart 等使用,配置sliver 效果


 编译运行流程

1、配置好Flutter开发环境(目前Flutter SDK 版本 3.47.2,仓库已在 .fvmrc 里锁定该版本,推荐使用 FVM 一键切换:fvm install 3.47.2 && fvm use 3.47.2),可参阅 【搭建环境】。

2、clone代码,执行Packages get安装第三方包。(因为某些不可抗力原因,国内可能需要设置代理: 代理环境变量)

 3、重点:你需要自己在lib/common/config/目录下 创建一个ignoreConfig.dart文件,然后输入你申请的Github client_id 和 client_secret。

     class NetConfig {
       static const CLIENT_ID = "xxxx";
     
       static const CLIENT_SECRET = "xxxxxxxxxxx";
     }


         注册 Github APP 传送门,当然,前提是你现有一个github账号(~ ̄▽ ̄)~ 。
 
 4、如果使用安全登录(授权登录),那么在上述注册 Github App 的 Authorization callback URL 一栏必须填入 gsygithubapp://authed






 5、运行之前请注意下

 1、本地 Flutter SDK 版本 3.47.2(.fvmrc 已锁定,可用 fvm use 切换); 2、是否执行过 flutter pub get;3、 网络等问题参考: 如果出现登陆失败或者请求失败 


 下载

 Apk下载链接: Apk下载链接1 
 Apk下载链接: Apk下载链接2 
!openapk

| 类型          | 二维码                                      |
| ----------- | ---------------------------------------- |
| Apk二维码  | ! |
| iOS暂无下载 | |



 项目结构图

!




 常见问题

 如果包同步失败,一般都是因为没设置包代理,可以参考:环境变量问题

 如果克隆太慢,可尝试码云地址下载

 示例图片
 示例图片

!

!








 框架

当前 Flutter SDK 版本 3.47.2


用户交互 → UI层(Widget/Page) → 状态层(Redux/Provider/Riverpod) → 服务层(Repositories) 
       → 网络层(Net) → GitHub API → 数据模型(Model) → 本地存储(DB) → UI更新



┌─────────────────────────────────────────────────────────────────┐
│                         GSY GitHub App                          │

Top issues

Latest release

8.1.1 8.1.1 2026-08-04

Snapshot: 2026-11-16T09:23:14Z · Data license Apache-2.0 · JSON