企业官网建设流程全解析

RepoStore 是一款开源的 Android 应用商店，它能帮你发现发布在 GitHub Releases 上、带有可直接安装的 APK 文件的开源应用，并用类似 Play Store 的界面完成浏览、下载、安装和更新。下文将带你走完「获取 RepoStore → 浏览首页 → 安装第一个开源应用」的完整流程。

1. 为什么选择 RepoStore？

很多开源作者只在 GitHub Releases 发布 APK，普通用户很难发现、也很难追踪更新。RepoStore 解决了这个问题：

• 只展示"能装"的项目：自动过滤掉没有 APK 资产的仓库，看到的基本都可以安装（逻辑见 AppInstaller.kt）
• 始终来自最新 Release：安装动作取自每个仓库的/releases/latest，并附带更新日志
• 记住你装过什么：本地数据库跟踪已安装应用，发现新版本会提醒更新
• 零门槛：不需要注册，打开即可浏览；纯 Kotlin 开发，支持 Android 8.0 及以上

2. 获取并安装 RepoStore 本体

RepoStore 本身也是开源应用，你可以从 F-Droid、IzzyOnDroid 仓库或项目的 GitHub Releases 页面下载它的 APK，安装方式与安装任何 APK 相同。

⚠️ 第一次安装时，Android 会提示「不允许安装未知应用」，请按照系统引导为下载来源授予「安装未知应用」权限（对应 AndroidManifest.xml 中的REQUEST_INSTALL_PACKAGES声明）。这是 Android 的标准安全机制，属正常现象。

首次启动后，系统可能请求通知权限——这是为了让「应用可更新」的提醒能通知到你，见 MainActivity.kt。

3. 认识界面：5 个底部标签带你逛

启动后你会看到底部导航（定义在 bottom_nav_menu.xml）：

4. 完整流程：安装你的第一个开源应用

整个流程只需 4 步，大约 1 分钟：

第 1 步：搜索或浏览在 Search 标签输入关键词，或在 Apps 标签按分类翻找。列表只会出现带有效 APK 资产的项目。

第 2 步：查看详情页点击任一应用，详情页会展示：⭐ Stars、Forks 数、开发语言、渲染后的 README（"About this app"）、最新 Release 的更新日志，以及截图画廊。

第 3 步：点击 Install绿色的Install按钮开始下载 APK，按钮上会实时显示下载进度（核心实现在 AppInstaller.kt）。下载完成后自动调起系统安装器，确认安装即可。

第 4 步：安装完成该应用的按钮会变成Open，表示已安装并可用；RepoStore 会在本地记录这次安装，为后续更新检测做准备。

5. 进阶技巧：不迷路的小建议

• 追踪更新：通过「我的应用 / Updates」入口可集中管理已装应用，新 Release 发布时会显示在 AppUpdatesActivity.kt 对应的更新列表中
• 登录 GitHub 提升体验：未登录时 API 限速为 60 次/小时，通过 OAuth 设备码流程登录后提升至 5,000 次/小时（见 GitHubAuth.kt）
• 调整下载行为：Settings 中的下载设置支持多线程加速等选项，相关配置在 DownloadPreferences.kt

6. 常见问题与注意事项

• 应用会自己出现吗？会。只要项目是公开仓库、有已发布的 Release、且最新 Release 带有.apk文件，就可能被搜索到，无需手动提交
• 安全提示：APK 由第三方开发者发布，RepoStore 只负责发现与下载，安装前请自行确认来源可信（免责声明见 README.md）
• 更多资料：更新日志见 CHANGELOG.md，参与贡献请阅读 CONTRIBUTING.md，项目截图集合在 screenshots/ 目录

至此，你已经在 5 分钟内完成了 RepoStore 的安装和第一个开源应用的部署。祝你使用愉快！