一套代码，真正的商店应用
iOS 应用在原生 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 调用。
App Store 审核通过保证
Apple App Store 审核通过保证 – 否则 14 天内退款. 96.4% 的 WebViewGold 应用在首次提交时即通过审核团队的审核。
您需要准备什么
- 一个已发布在公开 HTTPS URL 上的 GitHub Copilot 应用（username.github.io/repo 或 yourproject.vercel.app，最好是您自己的域名）
- 向 Apple App Store 提交所需的 Apple Developer Program 账号（每年 $99）
- Mac 上的 Xcode，或者浏览器中的 WebViewGold Cloud Builder（无需 Mac）
- WebViewGold for iOS（$109 一次性付费，免费更新）
- 一个隐私政策页面、一个 1024 × 1024 px 的图标，以及 30 到 60 分钟
只要有一个优化良好的Web应用版本，几分钟内您就能拥有一个出色的移动应用。除此之外，客户服务非常友好且乐于助人！我只能说：推荐WebViewGold :-)
GitHub Copilot 到 App Store：完整演练
八个步骤，无需编程。大多数人不到一小时就能完成原生部分。
将您的 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 上运行免费的App Store 上架就绪检查：它能在几秒内标出混合内容、缺失的 viewport 标签、构建工具预览域名和其他阻碍项。
获取 WebViewGold for iOS
一次性付费，免费更新。您会收到现成的 Xcode 项目。如果您没有 Mac，激活 WebViewGold Cloud Builder，在浏览器中完成一切。
填入您的 URL 并设置品牌
打开 Config.swift（或 Cloud Builder 表单），粘贴您已发布的 URL。设置应用名称，上传图标，选择启动画面和状态栏颜色。无需编程。
开启原生功能
用单个设置启用推送通知、离线页面、社交登录处理、下拉刷新、生物识别登录或二维码扫描器。一切皆可选。
构建并上传
在 Xcode 中：Product → Archive → Distribute 到 App Store Connect。在 Cloud Builder 中：点击 Build，上传到 App Store Connect 的工作会为您完成。
创建 App Store 详情页
在 App Store Connect 中添加名称、副标题、描述、关键词、截图、隐私政策 URL 和 App Privacy 答案。如有需要，在审核备注中添加演示账号。
提交审核
Apple 对大多数应用在 24 到 48 小时内完成审核。如有审核人员提问，请在 Resolution Center 中回答。我们的审核通过保证为您兜底。
提交前针对 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 描述中附上主要界面在手机宽度下的截图。
App Store 审核：对 GitHub Copilot 应用重要的规则
Apple 审核的是应用行为，而不是所用工具。没有人因为使用 GitHub Copilot 而被拒；应用被拒是因为下面这些问题。
- 4.2
最低功能要求
应用必须提供比重新打包的网站更多的东西。响应式布局、原生导航以及至少一项原生能力（推送通知、离线页面、原生分享、生物识别登录）才是区别所在。WebViewGold 各用一个设置即可开启这些功能。
- 2.1
App 完整性
没有占位内容，没有失效链接，没有崩溃。如果内容位于登录之后，请在 App 审核备注中提供演示账号。
- 5.1.1
隐私
必须提供公开的隐私政策 URL。允许用户创建账号的应用还必须允许用户在应用内删除账号。
- 4.8
登录服务
如果应用使用 Google、Facebook 或其他第三方或社交登录服务来创建或验证用户账户，就必须同时提供一个同等的登录选项：只收集姓名和邮箱地址、允许用户隐藏自己的邮箱地址，并且不会为广告目的追踪用户。Sign in with Apple 是满足这一要求的稳妥方式。只使用自有邮箱/密码登录的应用不受此条影响。
- 3.1.1
应用内购买
在应用内销售的数字商品和订阅必须使用 Apple 的应用内购买。实体商品和现实世界的服务可以继续使用 Stripe 或 PayPal。
- 2.3
准确的元数据
截图、描述和应用名称必须与应用的实际功能相符。不要在详情页中提及其他平台或“beta”。
iOS 应用为您的 GitHub Copilot 应用带来的原生功能
每项功能都是可选的，并在WebViewGold for iOS 文档中逐步说明。
推送通知
通过 OneSignal 或 Pushwoosh 的远程推送、通过 JavaScript 调用的本地定时推送，以及在您选择的时机弹出权限请求。
文档Social Login Helper
Google 和 Facebook 登录在应用内正常工作；Sign in with Apple 自动处理。
文档Universal Links
来自邮件的链接（魔法链接、密码重置）直接在应用中打开。
文档应用内购买
通过 RevenueCat 实现 App Store 订阅和一次性购买，由您的 Web 应用触发。
文档离线页面和回退
用户离线时显示原生的“重试”页面，或使用本地 HTML 回退。
文档加载指示器和启动画面
在 Web 应用加载完成前保持启动画面，或显示原生加载动画。
文档生物识别登录
通过 JavaScript 调用触发 Face ID / Touch ID 验证。
文档二维码和条形码扫描器
原生扫描器，将结果返回给您的 Web 应用。
文档原生分享面板和触感反馈
从您的 Web 应用调出分享对话框和触感反馈。
文档自定义 CSS 和 JavaScript
在应用内加载时隐藏仅网站需要的元素并注入代码。
文档App Store 提交前检查清单
逐项勾选后，审核就只是走个流程。免费就绪检查会自动验证其中的技术部分。
- 全站 HTTPS：App Transport Security 会阻止明文 http:// 内容和无效证书。
- 从 320 px 到 iPad 宽度的响应式布局。Apple 在审核时也会在 iPad 上打开 iPhone 应用。
- 准备好隐私政策 URL（Web 应用内的一个页面即可）。
- 如果用户可以注册，应用内须提供账号删除功能。
- 如果内容需要登录才能查看，为审核人员提供演示登录账号。
- 应用内不得有“下载我们的应用”横幅、指向其他应用商店的链接或构建工具徽标。
- 一个 1024 × 1024 px 的应用图标，无透明区域、无圆角（Apple 会自动添加遮罩）。
- 从真实应用截取的当前 iPhone 尺寸截图（如支持 iPad，还需 iPad 截图）。
- 准备好不超过 30 个字符的应用名称、副标题和关键词。
- 回答出口合规问题（仅使用 HTTPS 的应用符合标准加密豁免条件）。
示例：从 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 为您提供
完整的原生应用项目，而不是订阅。以下所有功能都包含在授权中，只需一个设置即可开启。
- 完整的 Xcode 项目
- 推送通知
- 离线页面
- 应用图标与启动画面
- 原生分享与触感反馈
- 深层链接与通用链接
- 应用内购买
- 免费更新，白标
常见问题
如何把用 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。
发布 iOS 应用需要 Mac 吗？
使用 WebViewGold Cloud Builder 则不需要：配置、构建和上传到 App Store Connect 都在浏览器中完成。如果您有 Mac，Xcode 项目开箱即用。
Apple 审核需要多长时间？
大多数提交在 24 到 48 小时内完成审核。首次提交和带登录功能的应用有时会收到审核人员的提问；在 Resolution Center 中回答后审核会继续。
如果 Apple 拒绝了应用怎么办？
拒审通知会注明准则和原因，您可以根据需要多次重新提交。WebViewGold 附带 App Store 审核通过保证：如果 Apple 因非内容原因拒绝应用，您可在购买后 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 iOS 一次性付费 $109（免费更新），加上 Apple Developer Program 账号（每年 $99）。可选：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日。