GitHub Store

</div> </br> <p align="center"> </p> </br> </br> <a href="https://github.com/OpenHub-Store/GitHub-Store/stargazers"> </a> </br> </br> <a href="https://github.com/OpenHub-Store/GitHub-Store/releases/latest"> </a> <a href="https://f-droid.org/packages/zed.rainxch.githubstore"> </a> </br> </br> <p align="center"> <a href="https://trendshift.io/repositories/22313" target="_blank"></a> <a href="https://hellogithub.com/en/repository/OpenHub-Store/GitHub-Store" target="_blank"> </a> </p> </p> <div align="center">

🗺️ 项目概述

GitHub Store 是一款专为 GitHub Releases 设计的跨平台应用商店，旨在简化开源软件的发现与安装过程。它能自动检测可安装的二进制文件（APK、EXE、DMG、AppImage、DEB、RPM），提供一键安装、更新追踪，并以整洁的应用商店风格界面展示仓库信息。

基于 Kotlin Multiplatform 和 Compose Multiplatform 开发，支持 Android 和桌面平台。

</div>

[!CAUTION] 自由开源的 Android 正面临威胁。Google 将把 Android 变成一个封闭平台，限制你自由安装所选应用的基本权利。让你的声音被听到 – keepandroidopen.org.

📔 Wiki 与资源

请查阅 GitHub Store Wiki 获取常见问题解答和实用信息

🌐 官方网站： github-store.org 💬 Discord： 加入社区 📜 隐私政策： github-store.org/privacy-policy

</div>

📋 法律声明

GitHub Store 是一个独立的开源项目，与 GitHub, Inc. 无关。
该名称用于描述应用的功能（发现 GitHub Releases），不代表对商标的所有权主张。
GitHub® 是 GitHub, Inc. 的注册商标。

</div>

🔃 下载

</p> <p align="center"> <a href="https://github.com/OpenHub-Store/GitHub-Store/releases"> </a> <a href="https://f-droid.org/en/packages/zed.rainxch.githubstore/"> </a> </p> <p align="center"> <a href="https://apps.obtainium.imranr.dev/redirect.html?r=obtainium://add/https://github.com/OpenHub-Store/GitHub-Store/"> </a> <a href="https://github-store.org/app?repo=OpenHub-Store/GitHub-Store"> </a> </p>

[!IMPORTANT] macOS 用户： 你可能会看到 Apple 无法验证 GitHub Store 的警告。这是因为该应用在 App Store 之外分发，尚未经过公证。请通过「系统设置 → 隐私与安全性 → 仍然打开」来允许运行。

🏆 媒体报道

</p> <p align="center"> <a href="https://www.youtube.com/@howtomen"> </a> </br> <strong>HowToMen：</strong> <a href="https://www.youtube.com/watch?v=7favc9MDedQ">2026 年最佳 Android 应用 TOP 20</a> | <a href="https://www.youtube.com/watch?v=VR-MEwPDw4k">比 Google Play 商店更好的 12 个应用商店</a> </br> <strong>HelloGitHub：</strong> <a href="https://hellogithub.com/en/repository/OpenHub-Store/GitHub-Store">精选项目</a> </p>

🚀 功能特性

智能发现
- 首页分为「Trending（趋势）」「Hot Release（热门发布）」「Most Popular（最受欢迎）」三大版块，支持按时间筛选。
- 仅显示拥有有效可安装文件的仓库。
- 平台感知话题评分，让 Android/桌面用户优先看到相关应用。
- 全面升级的搜索功能，相关性排名和性能均有显著提升。
Release 浏览器与安装
- Release 选择器，可浏览并安装任意版本，而非仅限最新版。
- 获取每个仓库的全部 Release 记录。
- 一键「安装最新版」操作，以及所有可用 Release 及其安装包的展开列表。
- 手动安装选项，并附带自动兼容性检测。
丰富的详情页面
- 应用名称、版本号及分享功能。
- Star 数、Fork 数、未关闭的 Issue 数。
- 渲染后的 README 内容（「关于此应用」）。
- 所选 Release 的 Markdown 格式发行说明。
- 带平台标签和文件大小的安装包列表。
- 深度链接支持 — 通过 URL 直接打开仓库详情。
- 开发者主页，可浏览开发者的仓库和动态。
应用管理
- 直接在 GitHub Store 中打开、卸载及降级已安装的应用。
- Android：APK 架构匹配（armv7/armv8）、软件包监控及更新追踪。
- 桌面端（Windows/macOS/Linux）：将安装包下载到用户的「下载」文件夹，并以默认程序打开。
收藏的仓库
- 在应用内保存并浏览你在 GitHub 上收藏的仓库。
网络与性能
- 动态代理支持，可配置网络路由。
- 增强的缓存系统，加快加载速度，减少 API 用量。

🔍 我的应用如何出现在 GitHub Store 中？

GitHub Store 不使用任何私有索引或手动策划规则。
只要满足以下条件，你的项目便可自动显示：

GitHub 上的公开仓库
- 可见性必须设置为 public。
最新 Release 中包含可安装文件
- 最新 Release 中至少包含一个受支持扩展名的文件：
  - Android：.apk
  - Windows：.exe、.msi
  - macOS：.dmg、.pkg
  - Linux：.deb、.rpm、.AppImage
- GitHub Store 会忽略 GitHub 自动生成的源码压缩包（Source code (zip) / Source code (tar.gz)）。
可通过搜索 / 话题被发现
- 仓库通过 GitHub 公开搜索 API 获取。
- 话题、编程语言和描述影响排名：
  - Android 应用：android、mobile、apk 等话题。
  - 桌面应用：desktop、windows、linux、macos、compose-desktop、electron 等话题。
- 拥有至少几个 Star 可以提高出现在 Trending/Hot Release/Most Popular 版块的概率。

只要你的仓库满足这些条件，GitHub Store 便可通过搜索自动找到并展示它 — 无需手动提交。

✅ 优势 / 为什么使用 GitHub Store？

无需再手动翻找 GitHub Releases 只看那些真正为你的平台提供二进制文件的仓库。
了解你安装了什么 追踪通过 GitHub Store 安装的应用（Android），并在有新版本时高亮提示，让你无需再回 GitHub 搜索即可完成更新。
始终保持最新 安装默认使用最新发布的 Release，也可通过 Release 选择器浏览并安装任意历史版本。
开源且可扩展
使用 KMP 编写，网络层、业务逻辑层与 UI 层清晰分离 — 易于 Fork、扩展或定制。

🔐 GitHub Store APK 签名证书

所有官方 GitHub Store Release 均使用以下证书指纹签名：

SHA-256： B7:F2:8E:19:8E:48:C1:93:B0:38:C6:5D:92:DD:F7:BC:07:7B:0D:B5:9E:BC:9B:25:0A:6D:AC:48:C1:18:03:CA

🔑 GitHub OAuth 配置

简要步骤

创建一个 GitHub OAuth App
复制 Client ID
填入 local.properties

<details> <summary><strong>查看完整配置指南</strong></summary>

1 - 创建 GitHub OAuth App

前往： GitHub → Settings → Developer settings → OAuth Apps → New OAuth App

字段	值
Application name	任意名称（例如 GitHub Store Dev）
Homepage URL	`https://github.com/username/repo_name`
Authorization callback URL	`githubstore://callback`

然后点击 Create application。

2 - 复制 Client ID

创建完成后，GitHub 将显示：

Client ID ← 这是你需要的
Client Secret ← ❗ 本项目不需要

3 - 添加到项目

打开项目根目录下的 local.properties 文件，添加：

properties

GITHUB_CLIENT_ID=YOUR_CLIENT_ID_HERE

4 - 同步并运行

同步项目并运行应用。现在你应该可以使用 GitHub 账号登录了。

❗ 重要说明

local.properties 不会提交到 Git，因此你的 Client ID 只保留在本地。
本项目只需要 Client ID（不需要 Client Secret）。
每位开发者应为自己的开发环境创建独立的 OAuth App。

</details>

☕ 支持项目

GitHub Store 由一名高中生开发和维护。你的支持能帮助他：

✅ 保持应用无 Bug — 响应 Issue 并快速发布修复
✅ 添加社区请求的功能 — 实现用户真正需要的内容

💖 支持方式

暂时无法赞助？ 没关系！你仍可以通过以下方式提供帮助：

⭐ 给这个仓库点个 Star — 帮助更多人发现 GitHub Store
🐛 反馈 Bug — 让应用对所有人都更好用
📢 分享给朋友 — 向其他开发者和朋友安利！
💬 加入我们的 Discord — 你的反馈将影响开发路线图

无论是金钱还是其他形式的支持，都意义重大，让这个项目得以延续。谢谢！

⚠️ 免责声明

GitHub Store 仅帮助你发现和下载由第三方开发者已在 GitHub 上发布的 Release 文件。
这些下载内容的安全性、行为及合规性由其各自的作者和分发者负责，与本项目无关。

使用 GitHub Store 即表示你理解并同意：安装和运行任何已下载的软件均需自行承担风险。
本项目不对任何安装包的安全性、是否包含恶意软件或是否适用于特定用途作出审查、验证或保证。

Star 历史

📄 许可证

GitHub Store 将在 Apache License, Version 2.0 下发布。

Copyright 2025 rainxchzed

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this project 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.