跳至内容
WebViewGold 从 Vibe Coding 到 App Store
中文
获取 WebViewGold

GitHub Copilot

GitHub Copilot 代理模式与云端代理:把您的 Web 应用发布到 App Store 和 Google Play

Copilot 为这项工作提供了两个代理:VS Code 中的代理模式,适合亲自动手的工作;以及 Copilot 云端代理(前身是 coding agent),它会接手一个 GitHub issue 并交回一个 pull request。在 .github/copilot-instructions.md 中让两者都了解原生应用,把上架就绪工作拆成一个个小 issue 来执行,然后用 WebViewGold 封装已部署的 URL。

每个平台一次性 $109 起,或由我们的团队全程代劳,$698 起。

  • 审核通过保证 – 否则 14 天内退款
  • 无需编程
  • 一次性付费,免费更新
  • 7×24 小时人工支持
  • 2014 年起德国出品 · ISO 27001

目标,以及两个 Copilot 代理

目标是:当 WebViewGold 在原生 WebView 中加载您的 Web 应用时,它能通过 App Store 和 Google Play 审核,并且在今后每一次 Copilot 改动之后都保持这一点。不需要用 Swift 或 Kotlin 重写任何东西。Copilot 负责 Web 代码;WebViewGold 提供原生的 Xcode 和 Android Studio 项目。

VS Code 中的代理模式就是 Chat 视图代理选择器中的 Agent 选项,位于 Ask 和 Plan 旁边。它会跨整个项目编辑文件、运行终端命令,并在您的注视下根据错误不断迭代。审计工作以及任何需要您当场判断的事,都用它来做。

Copilot 云端代理在 2026 年之前叫 Copilot coding agent,它在 GitHub 上工作。把一个 issue 指派给 Copilot,它就会在基于 GitHub Actions 的环境或云端沙箱中运行,然后打开一个 pull request 并把您添加为审查者。在 pull request 评论中提及 @copilot 即可要求修改。它需要付费的 Copilot 套餐,在 Business 或 Enterprise 套餐中还必须先由管理员启用。

如果您的团队混用 Copilot 与 Claude Code、Codex 或 Cursor,AI 编码代理专题页为每个工具都准备了对应的指南。

两个代理都会读取的指令文件

保存为 .github/copilot-instructions.md。VS Code 会在 Copilot 会话中使用它;在 GitHub 上,云端代理、代码审查和 Copilot Chat 都会使用代码仓库指令。Copilot 也会读取 AGENTS.md,并接受根目录中的单个 CLAUDE.md 或 GEMINI.md,所以如果您的代码仓库里已经有其中之一,请把原生应用章节只放在一个地方;指令文件对比介绍了具体做法。

markdown
# Example app: web app plus native iOS and Android apps

## How the native apps work
- WebViewGold loads https://app.example.com in a WKWebView (iOS) and an Android
  WebView. Every production deploy is live in both store apps.
- Native detection: isNativeApp() in src/lib/platform.ts (user agent contains
  "MyAppNative", configured in WebViewGold). Do not add other user agent checks.
- Native features are URL schemes such as registerpush:// (push permission) or
  shareapp://message?=TEXT&url=URL (share sheet). Use only schemes documented in
  https://www.webviewgold.com/llms-full.txt and always provide a web fallback.
- Never suggest rewriting the app in React Native, Flutter, Swift or Kotlin.

## Store rules every change must keep
- Real /privacy and /terms pages, linked in the footer and in settings.
- In-app account deletion that removes server-side data and the auth user.
- Sign in with Apple wherever Google or another social login is offered.
- No external checkout links for digital goods inside the iOS app.
- Loading, empty and error states for every request; no dead links or placeholders.
- Works from 320 px width; fixed bars use env(safe-area-inset-*); tap targets >= 44 px.

## Build and verify
- Install: npm ci | Lint: npm run lint | Test: npm test | Build: npm run build
- Every pull request description lists what changed, how it was verified, and
  what must be tested on a real iPhone and Android phone.

准备云端代理的环境

云端代理可以自行安装所需的东西,但一个设置工作流能让运行更快、更可预测。它必须位于 .github/workflows/copilot-setup-steps.yml,只包含一个名为 copilot-setup-steps 的 job,并且位于默认分支上。运行器(runner)是 Ubuntu x64 或 64 位 Windows;不支持 macOS,这也是 iOS 构建要在别处完成的原因。

text
name: "Copilot Setup Steps"

on:
  workflow_dispatch:
  push:
    paths:
      - .github/workflows/copilot-setup-steps.yml

jobs:
  copilot-setup-steps:
    runs-on: ubuntu-latest
    permissions:
      contents: read
    steps:
      - name: Check out code
        uses: actions/checkout@v5
      - name: Set up Node.js
        uses: actions/setup-node@v4
        with:
          node-version: "22"
          cache: "npm"
      - name: Install dependencies
        run: npm ci

我的iOS WebView应用终于通过审核了。谢谢!!

塔哈·法鲁基(Taha Farooqui) · CodeCanyon

代理模式提示词:审计、修复小问题、编写 issue

从 VS Code 开始。代理会审计代码仓库,自己修复安全的小问题,并把其余问题整理成可以交给云端代理的 issue 大小的任务。

在选中 Agent 的情况下粘贴到 VS Code Copilot Chat
我们即将把这个 Web 应用同时发布为原生 iOS 和 Android 应用。WebViewGold 会在 WKWebView 和 Android WebView 中加载我们的生产 URL。请遵循 .github/copilot-instructions.md。

审计代码仓库中会引发 App Store 和 Google Play 审核问题的地方,并完成三件事:

1. 直接修复(只做小而安全的改动):缺失的 viewport meta 标签、明显的横向溢出、小于 44 px 的点按区域、字号小于 16 px 的输入框、没有安全区域内边距的固定栏、失效的链接、遗留的占位文字。之后运行 lint、测试和构建。
2. 编写 docs/store-readiness.md,把剩余的每个问题列为一个 issue 大小的任务:标题、审核人员为什么在意(写明对应的 Apple 准则或 Google Play 政策领域)、涉及的文件、验收标准,以及如何验证。每个任务都必须能放进一个 pull request。
3. 只报告、不修改:所有销售数字商品、订阅或点数的地方,以及所有收集数据的第三方 SDK。我需要这两份清单来做支付决策和填写隐私标签。

不要添加依赖。这次运行不要碰身份验证或支付代码。最后给出简短总结,并按您建议的顺序列出这些任务。

可以指派给 Copilot 的上架就绪 issue

Issue 标题验收标准您的审查重点
真实的 /privacy 和 /terms 页面内容基于代码收集的数据;从页脚和设置中链接;两者都能直接加载列出了每个 SDK 和数据类型;没有占位的公司名称
应用内账户删除设置中带确认的“删除账户”;服务器删除数据、文件和身份验证用户;公开的 /delete-account 页面用测试用户跑一遍,并亲自检查数据库
在 Google 登录旁添加 Sign in with Apple位置和样式同等;在 Web 和应用中都能使用Apple Services ID 和密钥由您创建;绝不能让它们进入代码仓库
移动端布局检查在 320 px 下没有横向滚动;点按区域 44 px;固定栏有安全区域内边距;16 px 输入框在手机上打开预览部署
加载状态、空状态和错误状态每次请求都具备这三种状态,并有重试按钮;一个友好的 404 页面关掉 Wi-Fi 到处点一点
在应用中隐藏仅限 Web 的元素isNativeApp() 辅助函数;返回 true 时隐藏商店徽章、安装提示和构建工具徽章在浏览器开发者工具中伪造 User-Agent

工作流程,分步说明

需要判断的事用代理模式,定义明确的任务交给云端代理。

  1. 提交指令文件和设置工作流

    把这两个文件推送到默认分支。如果某些路径需要额外规则,请添加 .github/instructions/mobile-ui.instructions.md,并设置一个 applyTo 模式,例如 "src/components/**"。

  2. 在代理模式下审计

    在 VS Code 中运行上面的提示词。像审查任何 diff 一样审查这些小修复,在手机浏览器中运行应用,然后 commit。

  3. 把任务清单变成 issue

    为 docs/store-readiness.md 中的每个任务创建一个 GitHub issue,并把验收标准粘贴到正文中。Copilot 会读取 issue 的标题、描述和已有评论。

  4. 把 issue 指派给 Copilot

    在每个 issue 的 Assignees 侧栏中选择 Copilot,必要时添加说明。保持任务小巧:每个任务正好对应一个分支上的一个 pull request,而且基于 GitHub Actions 的会话会在 59 分钟后停止。

  5. 审查 pull request 并迭代

    阅读 diff,如果愿意,可以从 Reviewers 菜单请求 Copilot 代码审查,并测试预览部署。要修改什么,就在评论中提及 @copilot;它会把新的 commit 推送到同一个分支。

  6. 部署并用 WebViewGold 封装

    部署到您的生产域名。在 Config.swift 中设置 host、webviewurl、useragent_iphone 和 useragent_ipad;在 Config.java 中设置 HOST、HOME_URL 和 USER_AGENT。iOS 设置文档列出了所有选项。

  7. 构建并提交

    使用 Cloud Builder(一次性 $349 的附加服务)就不需要 Mac:它会在浏览器中构建两个应用,并上传到 App Store Connect 和 Play Console。让 Copilot 根据已合并的代码起草审核备注。

提交前的检查清单

  • copilot-instructions.md 中写明的生产 URL 和 User-Agent 标记与 WebViewGold 配置一致。
  • 每个上架就绪 pull request 都已合并,并包含在生产部署中。
  • 审核人员的演示账户可以使用,并已写进审核备注。
  • 您在商店页面中提到的每项原生功能(推送、分享、生物识别)在构建好的应用中都能正常使用。
  • 应用至少提供一项网站做不到的能力,因此能满足准则 4.2。
  • 免费的就绪检查在您的生产 URL 上全部通过。

使用 Copilot 时的坑

  • issue 太大(“让应用可以上架”)会导致 pull request 膨胀失控。每个 issue 只处理一件事。
  • 分支保护或规则集(rulesets)可能会阻止 Copilot 创建或更新 pull request。管理员可以给 Copilot 授予绕过权限。
  • 基于 GitHub Actions 的会话只能修改任务发起时所在的代码仓库。如果您的 API 在另一个代码仓库中,请提前规划。
  • 在 GitHub.com 上,针对特定路径的指令文件只对云端代理和代码审查生效。Chat 必须知道的内容,请放进代码仓库范围的文件中。
  • Copilot 可能会为订阅添加一个 Stripe Checkout 按钮。指令文件禁止在 iOS 应用中这样做,但每一处支付改动都请亲自审查。
  • 把密钥写进指令文件或设置工作流。请改用代码仓库或环境的 secrets。

常见问题

代理模式和 Copilot 云端代理有什么区别?

代理模式在您的编辑器中运行,您全程看着,使用的是您的本地文件和终端。云端代理在 GitHub 上、在它自己的环境中运行,根据 issue 或提示词工作,并交回一个 pull request。审计用代理模式,定义明确的修复交给云端代理。

Copilot coding agent 和云端代理是一回事吗?

是的。GitHub 现在称它为 Copilot cloud agent(Copilot 云端代理);较早的文档和博客文章称之为 coding agent。指派 issue、pull request 和 @copilot 评论的用法都一样。

Copilot 会读取 AGENTS.md 吗?

会。云端代理会读取代码仓库中任何位置的 AGENTS.md 文件,离得最近的那个优先。它也接受根目录中的单个 CLAUDE.md 或 GEMINI.md。VS Code 默认会把根目录的 AGENTS.md 附加到聊天请求中。

Copilot 能构建 iOS 应用吗?

在 GitHub 上不能:云端代理运行在 Ubuntu 或 Windows 运行器上,而 iOS 构建需要 macOS 上的 Xcode。请在 Mac 上用 Xcode 构建,或在浏览器中使用 WebViewGold Cloud Builder。

我需要哪个 Copilot 套餐?

云端代理需要付费的 Copilot 套餐,Business 和 Enterprise 的管理员还必须先启用它。套餐内容和限制经常变化,所以开始之前请查看 GitHub 当前的套餐对比。

让您的应用上架商店的三种方式

结果相同,只是您需要投入的工作量不同。三种方式都附带审核通过保证和 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 详情 服务提供方: WeSetupYourWebViewApp

冬季特惠价格有效期至 2026年12月31日。

准备好发布您的应用了吗?

App Store & Google Play 审核通过保证 – 否则 14 天内退款

想直接交给我们?Full Service:我们在 72 小时内完成配置、构建并交付,每个平台 $698 起。有疑问?通过 7×24 小时在线聊天联系我们。

退款依据我们 FAQ 中列出的条件:应用因非内容原因被 Apple 和/或 Google 拒审,并在购买后 14 天内提出申请。