FLUTTER ECOSYSTEM

CarGuo/gsy_github_app_flutter

Flutter 超完整的開源專案，功能豐富，適合學習和日常使用。GSYGithubApp 系列的優勢：我們目前已擁有 Flutter、Weex、ReactNative、Kotlin View、Kotlin Jetpack Compose，Compose MultiPlatform，Harmony ArkUI 七個版本，功能齊全，項目框架內技術涵蓋面廣，完成度高，持續維護，搭配文章，適合全面學習，對比參考。

在 GitHub 查看 ↗

Stars: 1.5萬
Forks: 2627
最近推送（UTC）: 2026年9月14日
專案狀態: 未封存

GITHUB User

Shuyu Guo ↗

Flutter & Dart GDE, Mobile Application Developer, Love cat but named car

公众号 GSYTechUS

語言DartHTMLPowerShellCSSKotlinRubyPythonSwiftMATLABObjective-C

技術主題

# flutter # flutter-ui # flutter-app # flutter-demo # flutter-widget # github-app # dart # cross-platform # android # ios # mobile-app # dartlang

使用的依賴

依賴清單 57 項

flutter{"sdk":"flutter"}
intlany
cupertino_icons^1.0.4
fluttertoast10.0.0
share_plus13.3.0
flutter_spinkit5.2.1
sqflite2.4.3
pub_semver2.2.1
flutter_svg2.3.0
flutter_slidable3.1.2
dio5.11.0
path_provider2.1.6
webview_flutter4.14.1
flutter_inappwebview6.2.0-beta.3
rive0.14.11
easy_refresh3.4.0
signals6.3.0
flutter_redux0.10.0
rxdart0.28.0
graphql5.2.2
provider6.1.5+1
permission_handler11.3.1
json_annotation4.12.0
package_info_plus10.2.1
connectivity_plus7.3.1
flutter_markdown_plus1.0.6
markdown^7.3.0
html0.15.5
device_info_plus13.2.0
url_launcher6.3.2
google_fonts6.2.1
android_intent_plus5.1.0
shared_preferences2.5.5
built_value8.12.6
simple_animations5.2.0
supercharged2.1.1
animations2.1.1
lottie3.3.2
auto_size_text3.0.0
flutter_localizations{"sdk":"flutter"}
photo_view0.15.0
reduxany
webview_flutter_androidany
webview_flutter_wkwebviewany
string_scannerany
metaany
flutter_riverpod3.4.2
riverpod_annotation4.0.6
talker_flutter5.1.20
talker_dio_logger5.1.20
riverpod_generator開發依賴4.0.8
built_value_generator開發依賴8.13.0
build_runner開發依賴^2.4.14
json_serializable開發依賴6.14.1
flutter_lints開發依賴5.0.0
patrol開發依賴^4.7.0
flutter_test開發依賴{"sdk":"flutter"}

App 分類

開發者工具

所在榜單

Production#7 Popular#15

原始 README

以下為英文專案原文快照，最新內容請造訪 GitHub。

展開 / 收合專案 README

https://raw.githubusercontent.com/CarGuo/gsy_github_app_flutter/HEAD/logo.png

Github Actions GitHub stars GitHub forks GitHub issues GitHub license star

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系列文章专栏

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";
 }

4、如果使用安全登录（授权登录），那么在上述注册 Github App 的 Authorization callback URL 一栏必须填入 `gsygithubapp://authed`

http://img.cdn.guoshuyu.cn/register0.png http://img.cdn.guoshuyu.cn/register1.jpg

5、运行之前请注意下

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

下载

Apk下载链接： Apk下载链接1

Apk下载链接： Apk下载链接2

openapk

类型	二维码
Apk二维码	https://raw.githubusercontent.com/CarGuo/gsy_github_app_flutter/HEAD/download.png
iOS暂无下载

项目结构图

https://raw.githubusercontent.com/CarGuo/gsy_github_app_flutter/HEAD/framework2.png

常见问题

如果包同步失败，一般都是因为没设置包代理，可以参考：环境变量问题
如果克隆太慢，可尝试码云地址下载

示例图片

https://raw.githubusercontent.com/CarGuo/gsy_github_app_flutter/HEAD/ios.gif

https://raw.githubusercontent.com/CarGuo/gsy_github_app_flutter/HEAD/theme.gif

http://img.cdn.guoshuyu.cn/showapp1.jpg http://img.cdn.guoshuyu.cn/showapp2.jpg http://img.cdn.guoshuyu.cn/showapp3.jpg

框架

当前 Flutter SDK 版本 3.47.2

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

┌─────────────────────────────────────────────────────────────────┐
│                         GSY GitHub App                          │
├─────────────┬───────────────┬────────────────┬─────────────────┤
│   UI Layer  │  State Layer  │  Service Layer │     Data Layer  │
├─────────────┼───────────────┼────────────────┼─────────────────┤
│             │               │                │                 │
│  ┌─────────┐│  ┌─────────┐  │  ┌─────────┐   │   ┌─────────┐   │
│  │ Pages   ││  │ Redux   │  │  │Repositories│  │   │ Models │   │
│  └─────────┘│  └─────────┘  │  └─────────┘   │   └─────────┘   │
│             │               │                │                 │
│  ┌─────────┐│  ┌─────────┐  │  ┌─────────┐   │   ┌─────────┐   │
│  │ Widgets ││  │ Provider│  │  │Network API│  │   │Database │   │
│  └─────────┘│  └─────────┘  │  └─────────┘   │   └─────────┘   │
│             │               │                │                 │
│  ┌─────────┐│  ┌─────────┐  │                │                 │
│  │Common UI││  │Riverpod │  │                │                 │
│  └─────────┘│  └─────────┘  │                │                 │
│             │               │                │                 │
│             │  ┌─────────┐  │                │                 │
│             │  │ Signals │  │                │                 │
│             │  └─────────┘  │                │                 │
│             │               │                │                 │
└─────────────┴───────────────┴────────────────┴─────────────────┘

lib/
├── main.dart              # 应用入口点
├── main_prod.dart         # 生产环境入口点
├── app.dart               # 应用配置与路由
├── common/                # 公共功能模块
│   ├── config/            # 应用配置
│   ├── event/             # 事件总线
│   ├── local/             # 本地化
│   ├── localization/      # 多语言支持
│   ├── net/               # 网络请求
│   ├── repositories/      # 数据仓库
│   ├── router/            # 路由配置
│   ├── style/             # 样式配置
│   └── utils/             # 工具类
├── db/                    # 数据库相关
│   ├── provider/          # 数据库提供者
│   ├── sql_manager.dart   # SQL管理器
│   └── sql_provider.dart  # SQL提供者
├── env/                   # 环境配置
├── model/                 # 数据模型
├── page/                  # 页面
│   ├── debug/             # 调试页面
│   ├── dynamic/           # 动态页面
│   ├── home/              # 主页
│   ├── issue/             # Issue相关页面
│   ├── login/             # 登录页面
│   ├── push/              # 推送相关页面
│   ├── release/           # 发布相关页面
│   ├── repos/             # 仓库相关页面
│   ├── search/            # 搜索页面
│   ├── trend/             # 趋势页面
│   └── user/              # 用户相关页面
├── provider/              # Provider状态管理
├── redux/                 # Redux状态管理
│   ├── middleware/        # Redux中间件
│   ├── gsy_state.dart     # Redux状态定义
│   ├── login_redux.dart   # 登录状态管理
│   └── user_redux.dart    # 用户状态管理
├── test/                  # 测试相关
└── widget/                # 自定义组件
    ├── anima/             # 动画组件
    ├── markdown/          # Markdown渲染组件
    ├── menu/              # 菜单组件
    ├── particle/          # 粒子效果组件
    ├── pull/              # 下拉刷新组件
    └── state/             # 状态相关组件

riverpod 页面内状态管理：

┌───────────────────────────────────────────────────────────────────────────┐
│                         Page Architecture Overview                         │
└───────────────────────────────────────────────────────────────────────────┘
                                      │
                                      ▼
┌───────────────────────────────────────────────────────────────────────────┐
│                              Global State                                  │
│  ┌───────────────────┐   ┌────────────────────┐   ┌────────────────────┐  │
│  │ appThemeProvider  │   │ appLocalProvider   │   │ appGrepProvider    │  │
│  │ (Theme Data)      │   │ (Localization)     │   │ (Grayscale Mode)   │  │
│  └───────────────────┘   └────────────────────┘   └────────────────────┘  │
└───────────────────────────────────────────────────────────────────────────┘
                                      │
                     ┌────────────────┴────────────────┐
                     ▼                                 ▼
┌─────────────────────────────────┐  ┌─────────────────────────────────────┐
│     TrendPage (Riverpod)        │  │       NotifyPage (Signals)          │
├─────────────────────────────────┤  ├─────────────────────────────────────┤
│                                 │  │                                     │
│┌─────────────────────────────┐  │  │┌───────────────────────────────────┐│
││      Riverpod Providers     │  │  ││         Signals State             ││
││┌───────────────────────────┐│  │  ││┌─────────────────────────────────┐││
│││    trendFirstProvider     ││  │  │││   notifySignal (List)           │││
│││    trendSecondProvider    ││  │  │││   notifyIndexSignal (int)       │││
││└───────────────────────────┘│  │  │││   signalPage (int)              │││
│└─────────────────────────────┘  │  ││└─────────────────────────────────┘││
│                                 │  │└───────────────────────────────────┘│
│┌─────────────────────────────┐  │  │┌───────────────────────────────────┐│
││  Local State (StatefulWidget)│  │  ││     SignalsMixin Processing      ││
││  - UI Controls              │  │  ││  - createEffect() for reactions   ││
││  - Filter Parameters        │  │  ││  - Manages data loading           ││
│└─────────────────────────────┘  │  ││  - Updates UI based on signals    ││
│                                 │  │└───────────────────────────────────┘│
└─────────────────────────────────┘  └─────────────────────────────────────┘
                     │                                 │
                     └────────────────┬────────────────┘
                                      ▼
┌───────────────────────────────────────────────────────────────────────────┐
│                            Data Layer                                      │
│  ┌───────────────────────────────────────────────────────────────────────┐ │
│  │                  ReposRepository / UserRepository                     │ │
│  │  ┌────────────────────────┐       ┌─────────────────────────────────┐ │ │
│  │  │ Network Request        │───┬──▶│ Database Providers              │ │ │
│  │  │ - API calls            │   │   │ - Data caching                  │ │ │
│  │  └────────────────────────┘   │   └─────────────────────────────────┘ │ │
│  │                               │                                       │ │
│  │                               │   ┌─────────────────────────────────┐ │ │
│  │                               └──▶│ Data Models                     │ │ │
│  │                                   │ - Structure definitions         │ │ │
│  │                                   └─────────────────────────────────┘ │ │
│  └───────────────────────────────────────────────────────────────────────┘ │
└───────────────────────────────────────────────────────────────────────────┘
                                      │
                                      ▼
┌───────────────────────────────────────────────────────────────────────────┐
│                              UI Components                                 │
│  ┌────────────────────┐  ┌────────────────────┐  ┌────────────────────┐   │
│  │ View Models        │  │ List Items         │  │ Interactive UI     │   │
│  │ - Data Formatting  │  │ - Item Rendering   │  │ - User Actions     │   │
│  └────────────────────┘  └────────────────────┘  └────────────────────┘   │
└───────────────────────────────────────────────────────────────────────────┘

provider 页面内状态管理：

+-----------------------------------------------------+
|                   App User Interface                 |
+-----------------------------------------------------+
                          |
                          v
+-----------------------------------------------------+
|              RepositoryDetailPage (StatefulWidget)  |
|            with SingleTickerProviderStateMixin      |
+-----------------------------------------------------+
                          |
                          v
+-----------------------------------------------------+
|                   MultiProvider                      |
+-----------------------------------------------------+
        |                                 |
        v                                 v
+------------------+           +-----------------------+
| ReposNetWork     |<----------|  ReposDetailProvider  |
| Provider         |           |                       |
+---------+--------+           +-----------------------+
          |                                |
          |                                |
          v                                v
+-----------------------------------------------------+
|              Repository Data Services               |
| (ReposRepository, IssueRepository)                  |
+-----------------------------------------------------+
          |
          v
+-----------------------------------------------------+
|                Four Tab Pages (Consumers)           |
+-----------------------------------------------------+
    |           |           |           |
    v           v           v           v
+----------+ +----------+ +----------+ +----------+
| Info     | | Readme   | | Issues   | | Files    |
| Page     | | Page     | | Page     | | Page     |
+----------+ +----------+ +----------+ +----------+
    |           |           |           |
    |           |           |           |
    v           v           v           v
+-----------------------------------------------------+
|                GlobalKeys for Tab Access             |
| (infoListKey, readmeKey, issueListKey, fileListKey) |
+-----------------------------------------------------+

https://raw.githubusercontent.com/CarGuo/gsy_github_app_flutter/HEAD/p1.png https://raw.githubusercontent.com/CarGuo/gsy_github_app_flutter/HEAD/p2.png https://raw.githubusercontent.com/CarGuo/gsy_github_app_flutter/HEAD/p3.png https://raw.githubusercontent.com/CarGuo/gsy_github_app_flutter/HEAD/p4.png

更多可见：https://codewiki.google/github.com/carguo/gsy_github_app_flutter

Star History Chart

http://img.cdn.guoshuyu.cn/thanks.jpg

http://img.cdn.guoshuyu.cn/wechat_qq.png

LICENSE

CarGuo/gsy_github_app_flutter is licensed under the
Apache License 2.0

A permissive license whose main conditions require preservation of copyright and license notices. 
Contributors provide an express grant of patent rights. 
Licensed works, modifications, and larger works may be distributed under different terms and without source code.

Shuyu Guo ↗

技術主題

相關套件與範例

dio

meta

flutter_riverpod

riverpod_annotation

riverpod_generator

provider

animations

cupertino_icons

flutter_lints

flutter_svg

google_fonts

path_provider

使用的依賴

App 分類

所在榜單

原始 README

English Readme

同款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 )

相关文章

Flutter系列文章专栏

Flutter 独立简单学习演示项目

Flutter 完整开发实战详解 Gitbook 预览下载

所有运行问题请点击这里

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

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

须知

编译运行流程

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

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

项目结构图

常见问题

示例图片

示例图片

框架

Star History Chart

LICENSE

同款Weex版（ https://github.com/CarGuo/GSYGithubAppWeex ）

同款ReactNative版（ https://github.com/CarGuo/GSYGithubApp ）

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

4、如果使用安全登录（授权登录），那么在上述注册 Github App 的 Authorization callback URL 一栏必须填入 `gsygithubapp://authed`

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