Safe Haven 在线商店前端和开发者徽章嵌入

在线商店前端是什么

Safe Haven 除了手机客户端还有一个浏览器可访问的 Web 前端。功能上和客户端类似：

• Top Charts 榜单
• 分类浏览（十个固定分类）
• 搜索
• 应用详情页（所有信任标志、扫描结果、版本历史都有）
• 新上架列表

它是静态渲染的页面（服务端渲染全量索引），不是客户端动态加载。所以搜索引擎可以直接抓取页面内容，SEO 友好。

每个应用的公开页面格式

每个进了 Safe Haven 目录的应用，都有一个唯一的公开页面。页面格式为：

在线商店域名 + /app/ + 包名

比如 Safe Haven 客户端本身的公开页面就是把它的包名（com.colourswift.safehaven）拼到上面的格式里。

这个页面可以作为开发者在 GitHub README、博客、社交媒体上宣传自己应用的链接。用户在浏览器里点开就能看到该应用的详情页。

开发者徽章（Badge）

Safe Haven 提供了一套 "Get it on Safe Haven Store" 徽章图片，开发者可以把它嵌入到自己应用的 README 或网站里。两种格式：SVG 和 PNG，分别在：

在线商店域名/badge.svg
在线商店域名/badge.png

在 GitHub README 里嵌入徽章：

用 Markdown 的图片链接语法，左边放徽章图片地址，右边放应用的公开页面地址。徽章点一下就跳到 Safe Haven 里的应用详情页。具体的 Markdown 写法是一行代码：方括号里写徽章名和图片地址、圆括号里写应用页面地址。如果你不太熟悉 Markdown 嵌入图片链接，直接参考 Safe Haven 自己的 GitHub README 就行。

Deep Link 深链接

v2.0.8 版本加入了深度链接（deep link）支持。开发者把应用的公开页面链接放到任何地方，用户在手机上点开这个链接时：

1. 系统检测到 Safe Haven 客户端已经安装
2. 自动唤起 Safe Haven 客户端
3. 客户端直接跳到对应包名的应用详情页

这和通用网页跳转的区别：

• 不需要用户手动切到 Safe Haven → 搜索 → 找应用
• 点击即直达详情页，体验无缝
• 未安装 Safe Haven 时，链接默认落到 Web 前端的该应用页面

Web 前端能做什么、不能做什么

能做：

• 浏览榜单、分类、搜索
• 查看应用详情、信任标志、扫描结果、版本历史
• 开发者登录管理后台、注册应用、上传 APK

不能做：

• 安装应用（没有 APK 安装器，只能下载后手动装）
• 设备管理功能（我的应用列表、自动更新等）——这些只在客户端

Web 前端本质上是一个信息展示层 + 开发者管理入口，真正的安装、更新、同步都在客户端完成。

开发者后台

Web 前端有登录入口，是开发者的管理中心：

• 管理自己已注册的应用
• 上传新版本 APK
• 切换自动 / 手动提交模式
• 编辑应用描述、截图、标签
• 查看版本历史和扫描状态
• 认领社区贡献的条目
• 设置头像和展示名

v2.0.9-beta.1 重构了开发者界面（提升可读性），并支持设置头像和展示名（当前是本地保存，后续版本计划持久化到开发者 profile）。

为什么要有 Web 前端

Flutter 客户端的功能更强，但 Web 前端有几个客户端做不了的事：

1. 搜索可发现性：搜索引擎能直接抓取 Web 页面的内容（客户端不行），让应用被更多人搜到
2. 开发者管理：注册应用、上传 APK 等操作在手机上不方便做，Web 界面体验好得多
3. 深链接入口：任何地方放一个 URL，手机用户就能直达客户端对应页面
4. 跨平台：没有安卓设备的人也能浏览 Safe Haven 的目录（虽然装不了）