GitHub Store最新版

一个跨平台的 GitHub 发布版“应用商店”

GitHub Store 是一个 Kotlin Multiplatform（KMP） 应用，将 GitHub 上提供可安装二进制文件的项目，转化为类似应用商店的体验：自动发现、平台适配、一键安装最新版。

它只展示那些真正为你平台提供可安装文件（如 APK、EXE、DMG）的仓库，并呈现整洁的详情页、更新日志与开发者信息——无需在 Releases 页面中手动翻找。

你可以把它理解为：GitHub Releases 的“应用商店”前端。

核心特性

智能发现

• 主页分区：热门 / 最近更新 / 新项目
• 自动过滤：仅显示含有有效安装包的公开仓库
• 平台感知：Android 用户优先看到 .apk 项目，桌面用户看到 .exe/.dmg/.deb 等
• 基于主题排名：仓库若带 android、desktop、compose-desktop 等主题，更易被发现

一键安装最新版

• 自动获取 /releases/latest
• 仅展示最新正式版（非草稿、非预发布）中的安装资源
• 点击“安装最新版” → 自动下载并触发系统安装流程

丰富的详情页

• 项目名称、版本、安装按钮
• 星标、复刻、议题数等关键指标
• 渲染后的 README（“关于此应用”）
• 带 Markdown 格式的 最新发布说明（含更新日志）
• 安装包列表（带平台标签与文件大小）

跨平台原生体验

GitHub 登录 & 速率限制友好

• 支持 GitHub OAuth 登录
• 使用你自己的 API 配额（5000 次/小时），避免匿名请求限流

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

无需手动提交！ 只要你的仓库满足以下条件，就会被自动发现：

必要条件

1. 公开仓库（Private 仓库不可见）
2. 至少有一个正式发布版（通过 GitHub Releases 创建，非仅 Git Tag）
3. 最新发布版包含可安装资源，且扩展名匹配平台：
   • Android：.apk
   • Windows：.exe, .msi
   • macOS：.dmg, .pkg
   • Linux：.deb, .rpm
     

     ⚠️ 自动忽略 Source code (zip/tar.gz) 这类源码包

提升曝光建议

• 添加相关 GitHub Topics：
  • Android 项目：android, mobile, apk, kotlin
  • 桌面项目：desktop, windows, macos, linux, compose-desktop, electron
• 获得星标（⭐）有助于进入“热门”或“最近更新”分区

只要满足条件，GitHub Store 会通过 GitHub Search API 自动索引你的项目。

技术原理（简要）

1. 搜索阶段
   • 调用 GitHub /search/repositories
   • 使用平台感知查询（如 topic:android + 扩展名关键词）
   • 过滤已归档或信号不足的仓库
2. 发布版验证
   • 获取 /releases/latest
   • 检查 assets 中是否存在目标平台的有效安装包
3. 详情加载
   • 仓库元数据（星标、描述等）
   • 最新 Release 的正文与资源
   • 从默认分支加载并渲染 README.md
4. 安装流程
   • 为当前平台选择最佳匹配资源
   • 流式下载文件
   • 委托操作系统处理安装（Android 调用 PackageInstaller，桌面调用默认程序）

✅ 为什么选择 GitHub Store？

• 省去手动查找：不再在 Releases 里翻找 .exe 或 .apk
• 保证最新版：始终安装最新正式发布，更新日志即所见即所得
• 统一跨平台体验：同一套 UI 逻辑，适配各平台原生行为
• 完全开源可扩展：基于 KMP 架构，网络、业务、UI 分层清晰，便于 Fork 或二次开发

macOS 安全提示说明

由于 GitHub Store 未通过 Apple 公证（Notarization），首次打开时可能提示：

“Apple 无法验证此应用是否包含恶意软件。”

这是正常现象。您可手动允许运行：系统设置 → 隐私与安全性 → 仍要打开