一套代码，真正的商店应用
Android 应用在原生 WebView 中加载您已发布的 GitHub Copilot URL。没有第二个项目需要维护，也不需要导出代码。
对 GitHub Copilot 应用而言，为什么封装胜过重写
Copilot 就在您的仓库里：issue、pull request、Actions，以及负责部署 main 的托管服务。WebViewGold 正好契合这个循环，因为原生应用加载的就是 main 分支部署到的 URL，所以合并一个 Copilot pull request 就能更新已安装的应用，无需发布商店新版本。单独的 Swift 和 Kotlin 项目会让代理多出两套需要保持同步的代码库，而 JavaScript 桥接让 Copilot 能在它已经熟悉的代码中加入推送、触觉反馈、分享或生物识别登录。
继续从 GitHub Copilot 发布更新
合并到 main 后部署随即运行，应用在下次启动时就会显示更改。 只有原生外壳本身的变更（图标、新增原生功能）才需要提交商店更新。
叠加原生功能
推送通知、离线页面、原生分享、生物识别登录、二维码扫描、应用内购买和深度链接，都只是单个设置或一行 JavaScript 调用。
Google Play 审核通过保证
Google Play Store 审核通过保证 – 否则 14 天内退款. 96.4% 的 WebViewGold 应用在首次提交时即通过审核团队的审核。
您需要准备什么
- 一个已发布在公开 HTTPS URL 上的 GitHub Copilot 应用（username.github.io/repo 或 yourproject.vercel.app，最好是您自己的域名）
- 向 Google Play Store 提交所需的 Google Play Console 开发者账号（一次性 $25）
- Windows、macOS 或 Linux 上的 Android Studio，或者浏览器中的 WebViewGold Cloud Builder
- WebViewGold for Android（$109 一次性付费，免费更新）
- 一个隐私政策页面、一个 1024 × 1024 px 的图标，以及 30 到 60 分钟
出色的工作！无需任何编码就能轻松完成。简单快捷！创作者也提供了大力帮助！
GitHub Copilot 到 Google Play：完整演练
八个步骤，无需编程。大多数人不到一小时就能完成原生部分。
将您的 GitHub Copilot 应用发布到生产环境 URL
把 pull request 合并到 main 分支，交给托管服务部署：Vercel、Netlify 或 Azure Static Web Apps 会构建每一次推送，或者用 GitHub Actions 工作流把静态构建发布到 GitHub Pages。将生产环境 URL 或您的域名填入 WebViewGold。 Codespaces 转发端口（app.github.dev）、pull request 预览部署和 localhost 都是临时的。请使用 main 分支的生产部署。 自定义域名： 在仓库的 Pages 设置（或托管服务的域名设置）中添加域名，设置 DNS 记录，并开启 Enforce HTTPS。 参见为什么值得在提交前使用自定义域名。
让它达到上架要求
添加隐私政策页面和账号删除选项（如果用户可以注册），并移除构建工具徽标或“下载我们的应用”横幅。在您的 URL 上运行免费的Google Play 上架就绪检查：它能在几秒内标出混合内容、缺失的 viewport 标签、构建工具预览域名和其他阻碍项。
获取 WebViewGold for Android
一次性付费，免费更新。您会收到现成的 Android Studio 项目，或者激活 WebViewGold Cloud Builder，完全跳过 IDE。
填入您的 URL 并设置品牌
打开 Config.java（或 Cloud Builder 表单），粘贴您已发布的 URL，设置应用名称，选择包名，上传图标并选择启动画面。无需编程。
开启原生功能
用单个设置启用推送通知、离线页面、下拉刷新、生物识别登录、二维码扫描器或 App Links。一切皆可选。
构建已签名的 App Bundle
在 Android Studio 中：Build → Generate Signed Bundle。在 Cloud Builder 中：点击 Build，已签名的 .aab 会为您准备并上传。
创建 Play Console 详情页
在 Play Console 中创建应用，填写商店详情，上传图标、置顶大图和截图，完成数据安全、内容分级和应用访问权限部分。
先测试，再提交
新的个人账号需先进行 14 天、12 名测试人员的封闭测试。然后将版本提升到正式发布轨道并提交审核。我们的审核通过保证为您兜底。
提交前针对 GitHub Copilot 的专项检查
这些是 GitHub Copilot 项目（您 GitHub 仓库中的任意 Web 技术栈：Next.js、React + Vite、Astro、Vue、Rails、Django 或 ASP.NET）最常遇到的问题。
- GitHub Pages 只提供静态文件，而且项目站点位于 /repo-name/ 之下。请设置 base 路径，为单页应用添加 404.html 回退（或使用 hash 路由），并优先使用自定义域名，否则深层链接和刷新在应用内会返回 404。
- 把 WebViewGold 规则写进 .github/copilot-instructions.md（或 AGENTS.md），让代理模式和云端代理不再添加“下载我们的应用”横幅、仅适用于桌面的悬停菜单或仅限浏览器的 API。
- 合并之前，在手机宽度下检查每个 Copilot pull request（用它的预览部署或 Codespace）：320px 下的横向溢出和过小的点按区域，正是让封装应用在审核人员眼中像网站的原因。
- 如果应用提供 Sign in with GitHub、Google 或其他第三方登录，Apple 审核指南 4.8 要求同时提供一个同等的、注重隐私的选项，例如 Sign in with Apple，WebViewGold 会自动处理它；Google 和 Facebook 登录则通过 Social Login Helper 完成。
让 GitHub Copilot 来完成上架准备工作
把这段粘贴到 GitHub Copilot 中，让它应用审核人员关注的那些修改。检查结果，然后发布。
给 Copilot 云端代理（或代理模式）的 issue
标题：为 App Store 和 Google Play 准备 Web 应用（WebViewGold 封装） 这个应用将作为原生 iOS 和 Android 应用发布，在 WebViewGold WebView 封装壳中加载生产环境 URL。不要添加 Capacitor、React Native 或原生 SDK；原生功能来自 WebViewGold 的 JavaScript 桥接，文档见 https://www.webviewgold.com/llms-full.txt。请提交一个满足以下验收标准的 pull request： - [ ] 有 meta viewport 标签，320px 到 1024px 之间没有横向溢出，点按区域为 44px，固定的页眉和页脚使用 safe-area-inset 内边距 - [ ] 在页脚中链接 /privacy 和 /terms 页面 - [ ] 设置中有“删除账号”操作，经用户确认后删除其数据和认证记录 - [ ] 主导航中没有“下载我们的应用”横幅或外部推广链接 - [ ] 失败的请求有错误和重试状态；没有占位内容 - [ ] 单页路由在刷新和深层链接时正常工作（如果站点托管在 GitHub Pages 上，需提供 404 回退） - [ ] 在 .github/copilot-instructions.md 中加入写明这些规则的“原生应用封装”章节 如果能运行应用，请在 pull request 描述中附上主要界面在手机宽度下的截图。
Google Play 审核：对 GitHub Copilot 应用重要的规则
Google 审核的是应用行为，而不是所用工具。没有人因为使用 GitHub Copilot 而被拒；应用被拒是因为下面这些问题。
- 最低功能要求
垃圾内容和最低功能要求政策
Google 会拒绝未经网站所有者许可仅封装网站的应用，或没有任何实际功能的应用。封装您自己的产品并加入原生功能是没有问题的。
- 数据安全
用户数据政策
每个应用都需要一个隐私政策 URL，以及一份填写完整的数据安全表单，列出应用及其 SDK 收集的内容。
- 账号删除
用户数据政策
允许用户创建账号的应用必须在应用内提供账号删除功能，并通过您在 Play Console 中提供的网页链接提供删除途径。
- 测试要求
个人开发者账号
2023 年 11 月之后创建的个人账号必须先进行一次至少 12 名测试人员、连续 14 天的封闭测试，才能申请正式发布权限。
- 目标 API 级别
目标 API 要求
新应用必须以较新的 Android 版本为目标。WebViewGold 的更新会保持模板最新；只需使用最新版本构建即可。
- 支付
Google Play 结算
在应用内销售的数字商品和订阅通常必须使用 Google Play 结算（WebViewGold 支持 RevenueCat）。实体商品和服务可以使用其他支付方式。
Android 应用为您的 GitHub Copilot 应用带来的原生功能
每项功能都是可选的，并在WebViewGold for Android 文档中逐步说明。
推送通知
通过 OneSignal 或 Pushwoosh 的远程推送，以及通过 JavaScript 调用的本地定时推送。
文档App Links 和深度链接
指向您域名的 https 链接和自定义 scheme 直接在应用中打开。
文档应用内购买
通过 RevenueCat 实现 Google Play 订阅和一次性购买，由您的 Web 应用触发。
文档离线页面和回退
用户离线时显示原生的“重试”页面，或使用本地 HTML 回退。
文档启动画面和加载指示器
可设置启动画面的最短和最长时长并带淡出效果，或在加载时显示原生加载动画。
文档生物识别登录
通过 JavaScript 调用触发指纹 / 面部解锁验证。
文档二维码和条形码扫描器
原生扫描器，将结果返回给您的 Web 应用。
文档原生分享和触感反馈
从您的 Web 应用调出分享 intent 和触感反馈。
文档自定义 CSS 和 JavaScript
在应用内加载时隐藏仅网站需要的元素并注入代码。
文档文件和相机上传
为您的上传表单提供原生文件选择器和相机。
文档Google Play 提交前检查清单
逐项勾选后，审核就只是走个流程。免费就绪检查会自动验证其中的技术部分。
- 全站 HTTPS：当前版本的 Android 默认阻止明文 http:// 流量。
- 从 320 px 到平板宽度的响应式布局，返回键行为可预期（WebViewGold 将返回键映射到网页历史记录）。
- 准备好隐私政策 URL，并如实填写数据安全表单。
- 如果用户可以注册，应用内须提供账号删除功能，并附一个网页删除链接。
- 如果内容需要登录才能查看，为审核人员提供应用访问凭据。
- 在首次上传前设置好唯一的包名（例如 com.yourcompany.yourapp）：之后永远无法更改。
- 一个 512 × 512 px 的图标和一个 1024 × 500 px 的置顶大图。
- 至少两张从真实应用截取的手机截图（建议也提供平板截图）。
- 新的个人账号：为 14 天封闭测试安排好 12 名测试人员。
- 使用最新 WebViewGold 版本构建的已签名 Android App Bundle（.aab）。
示例：从 GitHub Copilot 项目到审核通过的应用
假设您用 Copilot 在一个 Next.js 仓库中为社区食物银行构建了一个排班工具：志愿者查看空缺班次，一键报名，并在前一天收到提醒。您把上架就绪清单写成一个 issue，分配给 Copilot 云端代理，在手机宽度下审查它的 pull request，然后合并。Vercel 把 main 部署到 shifts.yourfoodbank.org，您用 WebViewGold 封装它，每当有紧急班次空出，OneSignal 推送就会通知志愿者。由于登录提供了 Google，代理在第二个 pull request 中加入了 Sign in with Apple。审核备注中的演示志愿者已经预订了两个班次，两个商店都批准了应用，此后每个合并的 pull request 都会在下次启动时到达应用。
上线后的第一周
- 给与商店相关的 issue 加上标签（例如 app-store），并分配给 Copilot 云端代理；合并之前在手机宽度下审查每个 pull request。
- 用一个必须通过的构建状态检查来保护 main，因为一次出错的合并会直接进入每一份已安装的应用。
- 让 .github/copilot-instructions.md 与您使用的 WebViewGold 桥接调用保持同步，以免代理在重构时把它们删掉。
- 登录后用 getonesignalplayerid:// 读取 OneSignal player ID 并与用户一起保存，这样推送就能只发给某一位志愿者，而不是所有人。
- 在志愿者完成第一个班次之后，用 rateapp:// 请求评分。
WebViewGold 为您提供
完整的原生应用项目，而不是订阅。以下所有功能都包含在授权中，只需一个设置即可开启。
- 完整的 Android Studio 项目
- 推送通知
- 离线页面
- 应用图标与启动画面
- 原生分享与触感反馈
- 深层链接与通用链接
- 应用内购买
- 免费更新，白标
常见问题
如何把用 GitHub Copilot 构建的 Web 应用发布到 App Store？
把 main 分支部署到公开的 HTTPS URL（Vercel、Netlify、Azure Static Web Apps 或 GitHub Pages），将该 URL 填入 WebViewGold for iOS，用 Xcode 或 Cloud Builder 构建，然后通过 App Store Connect 提交。同一个 URL 也驱动 Android 应用。
Copilot 云端代理能帮我的应用做好审核准备吗？
能。给它分配一个包含上架就绪清单的 issue，在手机宽度下审查它提交的 pull request，然后合并。由于商店应用加载的是您的部署，合并后的更改无需发布新的商店版本就能到达已安装的应用。
GitHub Pages 足以支撑商店应用吗？
对于静态或客户端渲染的应用来说足够，前提是使用自定义域名、强制 HTTPS，并为单页路由提供回退。如果应用需要服务器代码、API 路由或密钥，请改为部署到 Vercel、Netlify 或 Azure。
我需要 Android Studio 吗？
使用 Android Studio（免费，可在 Windows、macOS 和 Linux 上运行），或使用 WebViewGold Cloud Builder，它能在浏览器中构建并上传已签名的 App Bundle。
什么是 12 名测试人员规则？
Google 要求 2023 年 11 月之后创建的个人开发者账号在首次正式发布前，先进行一次至少 12 名已选择加入的测试人员、连续 14 天的封闭测试。朋友、同事或一个 Discord 社区就足够了；组织账号不受此限制。
如果 Google 拒绝了应用怎么办？
Google 会注明涉及的政策，您可以修复后重新提交。WebViewGold 附带 Google Play 审核通过保证：如果 Google 因非内容原因拒绝应用，您可在购买后 14 天内获得退款。
我的应用可以只用 Sign in with GitHub 作为唯一的登录方式吗？
只有当应用是 GitHub 本身的客户端时才可以，例如展示用户自己仓库的仪表盘，因为审核指南 4.8 豁免了用户必须登录特定第三方服务才能访问其在该服务中内容的应用。对于其他任何产品，请在 GitHub 按钮旁加上 Sign in with Apple，或其他满足该指南隐私条件的登录方式。Google Play 没有这样的规定，但它的“应用访问权限”部分仍需要提供能让审核人员进入应用的凭据。
如果应用运行在 GitHub Pages 上，我需要自定义域名吗？
强烈建议使用。项目站点位于 username.github.io/repo-name/ 之下，因此必须位于域名根目录的文件（例如用于 Universal Links 和 App Links 的 apple-app-site-association 和 assetlinks.json）无法为它提供，而且以后迁移站点会改变应用内的 URL。有了您自己的域名、强制 HTTPS，再加上为单页路由准备的 404.html 回退，GitHub Pages 就能胜任静态商店应用的托管。
每次在 GitHub Copilot 中修改内容后，都必须重新提交应用吗？
不需要。应用加载的是您已发布的 URL，因此您在 GitHub Copilot 中发布的内容和功能变更会立即在应用中生效。只有原生外壳发生变化时才需要新的商店版本，例如更换应用图标或新增原生功能。
总共需要多少费用？
WebViewGold for Android 一次性付费 $109（免费更新），加上 Google Play Console 开发者账号（一次性 $25）。可选：Cloud Builder 附加组件（每个许可证 $349，一次性付费），让您无需 Mac 即可在浏览器中构建；或 Full Service 套餐（每个平台 $698 起），由我们的团队为您配置、构建并提交应用。
让您的应用上架商店的三种方式
结果相同，只是您需要投入的工作量不同。三种方式都附带审核通过保证和 7×24 小时人工支持。
自己动手
$109 每个平台，一次性付费
WebViewGold 许可证：一个现成的 Xcode 或 Android Studio 项目。粘贴您的 URL，设置名称和图标，开启所需功能，构建并提交。永久免费更新。
在主页查看方案Cloud Builder
$349 每个许可证，一次性附加购买
无需 Mac、Xcode 或 Android Studio：在浏览器中完成配置，我们在云端构建两个应用，并将其交付到 App Store Connect 和 Play Console。
Cloud Builder 如何运作 试用免费演示Full Service
$698 每个平台 $798
把您的 URL 和图标发给我们。我们的团队在 72 小时内完成配置、构建并交付您的应用，白标，附源码项目。两个平台共 $1,158。
Full Service 详情 服务提供方：
冬季特惠价格有效期至 2026年12月31日。