自己动手
$109 每个平台，一次性付费
WebViewGold 许可证：一个现成的 Xcode 或 Android Studio 项目。粘贴您的 URL，设置名称和图标，开启所需功能，构建并提交。永久免费更新。
在主页查看方案几乎所有 Android 构建错误背后的那些文件
WebViewGold Android 项目是一个常规的 Android Studio 项目，您真正需要改动的只有一小部分文件。了解它们，任何 Gradle 错误都能看懂：
- Config.java：您的 URL、主机、User-Agent 和功能开关（参见 Android 设置文档）。
- app/build.gradle：应用标识（
applicationId，在当前版本中还有用于代码包的namespace）、versionCode和versionName、SDK 级别（compileSdk、targetSdk、minSdk）、依赖项，以及使用 OneSignal 时的 OneSignal App ID。 - Gradle wrapper 和插件版本：项目期望使用哪个 Gradle 和哪个 Android Gradle Plugin（AGP）。它们在模板中是匹配的；当 IDE 比项目旧，或者有人改动了它们时，麻烦就开始了。
- app/google-services.json：Firebase 配置，只针对一个特定的包名签发。
- res/：
strings.xml（应用名称和文字）、colors.xml、mipmap-*文件夹中的启动器图标，以及启动画面 GIF。
还有一个文件根本就不应该出现在项目文件夹中：您的上传密钥库。
Gradle 和 Play Console 错误解读
| 错误消息 | 原因 | 修复方法 | Codex 能做吗？ |
|---|---|---|---|
| "The project is using an incompatible version (AGP …) of the Android Gradle plugin. Latest supported version is AGP …" | Android Studio 比项目旧 | 更新 Android Studio（Help → Check for Updates），然后执行 File → Sync Project with Gradle Files。不要降级插件 | 能解释；由您更新 IDE |
| "Android Gradle plugin requires Java 17 to run" / "Invalid Gradle JDK configuration found" | Gradle 运行在错误的 JDK 上 | Settings → Build, Execution, Deployment → Build Tools → Gradle → Gradle JDK：选择 Android Studio 自带的 JDK。在终端中，让 JAVA_HOME 指向它 | 能 |
| "SDK location not found. Define a valid SDK location with an ANDROID_HOME environment variable …" | 没有 local.properties（全新克隆的仓库或在终端中构建） | 在 Android Studio 中打开一次项目，它会写入这个文件；或者手动创建并填写 sdk.dir；绝不要提交它 | 能 |
| "Failed to find target with hash string android-…" / "Module … platform android-… not found" | 没有安装 compileSdk 对应的 SDK 平台 | Tools → SDK Manager → 安装该 API 级别，或者在 Build 窗口中点击“Install missing SDK package(s)” | 能解释 |
| "No matching client found for package name …" | google-services.json 是为另一个包名签发的，通常是模板的包名 | 在 Firebase 中注册新包名，并把新的 google-services.json 下载到 app/ 中 | 能找到问题；由您下载 |
| "Duplicate class ….BuildConfig" | 修改包名后残留了一个过时的自动生成 BuildConfig | 删除过时的文件，执行 Build → Clean Project，然后执行 Rebuild Project | 能 |
| "Duplicate resources" | 两个文件使用了同一个资源名，例如图标生成器生成的 ic_launcher.png 和 ic_launcher.webp | 每个资源名只保留一个文件 | 能 |
| "resource mipmap/ic_launcher_foreground … not found" | 某个 mipmap 文件夹中缺少前景图标 | 逐个替换图标，在每个文件夹中保留所有文件名 | 能 |
| "Keystore was tampered with, or password was incorrect" | 密钥库密码错误或文件不对 | 在您的密码管理器中找到正确的文件和密码；没有任何找回途径 | 不能 |
| Play Console："Your Android App Bundle is signed with the wrong key" | 使用的上传密钥与 Play 期望的不同 | 用最初的上传密钥库签名；如果它已丢失，请在 Play Console 中申请重置上传密钥 | 能比对指纹 |
| Play Console："Version code … has already been used" | 没有提高 versionCode | 在 app/build.gradle 中提高 versionCode（以及面向用户的 versionName） | 能 |
| Play Console："You need to use a different package name because … already exists" | 模板包名 com.webviewgold.myappname 一直没有改 | 在首次上传之前修改包名（步骤见下文） | 能 |
| 目标 API 级别警告或拒审 | 代码包是用较旧的模板构建的 | 更新模板并重新构建（见下方提示框） | 能解释 |
为什么在 Android Studio 中能构建，Codex 运行 Gradle 时却失败
Codex 在终端中运行 ./gradlew，而终端不是 Android Studio。三个差异解释了大多数“可是在 IDE 里明明能用”的情况：
- JDK。Android Studio 使用它自带的 JDK；终端使用的则是
JAVA_HOME指向的 JDK，往往是旧版 Java，甚至什么都没有。在构建之前让它指向自带的 JDK（在 macOS 上通常是/Applications/Android Studio.app/Contents/jbr/Contents/Home），或者让 Codex 去做。 - SDK 路径。Android Studio 会写入带有
sdk.dir的local.properties；全新克隆的仓库里没有这个文件。Codex 可以用您本地的 SDK 路径创建它，并且它不会进入 Git。 - 网络。第一次 Gradle 构建会下载插件和依赖项。根据您的审批设置，Codex 在运行需要沙盒外网络访问的命令之前会征求同意；请为 Gradle 批准，或者自己运行第一次构建。
原则上，Codex 云端任务也能构建 Android 项目，但前提是它的安装脚本配置好了 JDK 和 Android SDK，并且网络规则允许访问 Google 的 Maven 和下载主机。对于一次性的修复，在本地构建更简单。
只要有一个优化良好的Web应用版本，几分钟内您就能拥有一个出色的移动应用。除此之外，客户服务非常友好且乐于助人！我只能说：推荐WebViewGold :-)
一分钟收集所有信息
在 Android 项目文件夹（包含 gradlew 的那个；在 Windows 上使用 gradlew.bat）中运行，或者让 Codex 来运行。debug 构建可以检查项目能否编译，而不涉及您的签名密钥。
bash
# 1. Gradle version and the JDK Gradle runs on
./gradlew --version
# 2. Debug build with stack trace, log saved for Codex
./gradlew clean assembleDebug --stacktrace 2>&1 | tee gradle.log
# 3. Leftovers of the template package name after a rename
grep -rn "com.webviewgold.myappname" app/ --include=*.java --include=*.xml --include=*.gradle --include=*.json
# 4. Identity, versions and SDK levels Google checks
grep -n "applicationId\|namespace\|versionCode\|versionName\|compileSdk\|targetSdk\|minSdk" app/build.gradle
# 5. The package name your google-services.json was issued for
grep -n "package_name" app/google-services.json
# 6. Your upload key fingerprint (you run this; it asks for the keystore password)
keytool -list -v -keystore ~/keys/upload-keystore.jksGradle 分诊提示词
这些规则可以阻止代理的两个典型错误：为了修一个错误而升级所有东西，以及碰签名。
粘贴到在 Android 项目文件夹中打开的 Codex CLI 或 IDE 扩展
这是我们应用的 WebViewGold Android Studio 项目。Gradle 构建失败了。请阅读 gradle.log（./gradlew clean assembleDebug --stacktrace 的输出）并修复问题根源。 项目情况： - 应用设置位于 Config.java；应用标识、版本和 SDK 级别位于 app/build.gradle；文字位于 res/values/strings.xml。 - 我们的包名：[com.yourbrand.app]（模板默认是 com.webviewgold.myappname）。 - 是否已上传到 Google Play：[是/否]。如果是，applicationId 不得更改。 - 我们是否使用 Firebase 或基于 Firebase 的推送：[是/否]。如果是，app/google-services.json 必须是为我们的包名签发的。 规则： - 找到第一个真正的错误；忽略弃用警告。 - 除非错误确实需要，否则不要升级 Android Gradle Plugin、Gradle、Kotlin、compileSdk、targetSdk 或任何依赖项。如果确实需要升级，请停下来，说明原因以及它需要哪个版本的 Android Studio。 - 如果错误与 JDK 或 SDK 路径有关，请为这台机器修复 JAVA_HOME 或 local.properties；不要提交 local.properties。 - 绝不要创建、移动、打印或提交密钥库及其密码，也不要在 build.gradle 中添加签名配置。 - 不要手动编辑 google-services.json。如果其中的包名不匹配，请告诉我从 Firebase 控制台下载一个新文件。 展示 diff，然后再次运行 ./gradlew assembleDebug 进行验证，并用两句话总结问题原因。
在首次上传之前修改包名
模板自带的包名是 com.webviewgold.myappname，它在 Google Play 上已被占用。在任何上传之前修改一次即可。
提交或备份
Android 发布文档说得很直白：修改包名之前先备份源代码文件夹。使用 Git 的话，一次提交就是备份。
选定最终名称
反向域名格式、全部小写、不含连字符，最好与您的 iOS Bundle ID 一致。首次上传到任何 Play 轨道后它就会被锁定（为什么它无法更改）。
在所有出现的地方修改
按照发布文档中的包名修改视频操作（使用 Android Studio 的重构功能），或者让 Codex 来做：app/build.gradle 中的
applicationId和namespace、每个 Java 文件顶部的 package 行以及对应的文件夹路径，还有 AndroidManifest.xml。文档还展示了如何缩短名称、去掉中间部分。替换 google-services.json
如果您使用 Firebase 或基于 Firebase 的推送，请在 Firebase 控制台中用新包名添加一个 Android 应用，并替换
app/google-services.json。手动编辑旧文件不算修复。查找残留、清理、重新构建
反复运行上面代码块中的 grep，直到什么都找不到，然后执行 Build → Clean Project 和 Rebuild Project。如果此时出现“Duplicate class …BuildConfig”错误，说明有一个过时的自动生成文件；删除它并再次清理。
更新所有与名称绑定的内容
OneSignal 和 RevenueCat 的应用设置、Config.java 中的
RATE_MY_APP_URL，如果使用 App Links，还有您域名上的assetlinks.json。
密钥库：Codex 永远不碰的那个文件
Google Play 只接受用您的上传密钥签名的更新，所以密钥库是您 Android 应用中最宝贵的文件。在 Android Studio 中用 Build → Generate Signed App Bundle or APK 创建一次，把它存放在项目文件夹之外，并把文件和两个密码保存在密码管理器中，另外再做一份备份。即使您从未打算提交密钥库，也要把 *.jks 和 *.keystore 添加到 .gitignore 中。
使用 Play 应用签名（新应用的标准做法）时，应用签名密钥由 Google 保管，您的密钥库只是上传密钥。如果您把它弄丢了，这是个好消息：您可以在 Play Console 中申请重置上传密钥。但这不是即时完成的，所以不要指望它。您绝对不能做的，是让代理为一个已经上架 Google Play 的应用生成一个新的密钥库来“修复”签名错误，或者把密码粘贴到提示词中。由您运行 keytool -list -v，并把 SHA-1 指纹与 Play Console 应用完整性页面上显示的指纹进行比对；Codex 只需要知道结果。
常见陷阱
- 为了修一个错误，让 Codex “升级所有东西”。AGP、Gradle、Kotlin 和 SDK 的升级会连锁引发新的错误；只修复眼前的那个错误。
- 在首次上传之后修改包名。Google Play 会把它当作一个拥有新商店页面的不同应用。
- 在整个项目中搜索并替换“webviewgold”。这也会改到那些必须保留的类名、URL 和字符串；要修改的是包路径，而不是这个词的每一次出现。
- 上传 APK。Google Play 上的新应用需要 App Bundle（.aab）。
- 忘了在每次上传时提高
versionCode，包括上传到测试轨道。 - 只测试 debug 构建。发布构建会应用 ProGuard/R8 规则和您的签名；请先从内部测试轨道安装代码包，如果您的个人开发者账号有此要求，还要规划好12 名测试人员的封闭测试。
常见问题
没有安装 Android Studio，Codex 能修复 Gradle 错误吗？
无论如何它都需要 JDK 和 Android SDK，而 Android Studio 是同时获得这两者最简单的方式。安装好之后，Codex 就能在终端中运行 ./gradlew，并修复大部分项目文件错误。
WebViewGold Android 项目需要哪个 JDK？
需要项目中 Android Gradle Plugin 版本所要求的 JDK；当前的插件版本需要 JDK 17 或更高版本。当前版本 Android Studio 自带的 JDK 就能用，这也是为什么把它选为 Gradle JDK 能解决大多数 JDK 错误。
我弄丢了密钥库，我的应用就没救了吗？
如果启用了 Play 应用签名（新应用的标准做法），就不会：在 Play Console 中申请重置上传密钥，之后的更新用新的上传密钥签名即可。如果没有启用 Play 应用签名，您就无法再更新这个应用，只能发布一个新应用。
发布之后还能修改包名吗？
不能。在 Google Play 上，不同的包名就是一个不同的应用，会有新的商店页面，也没有评分。请在首次上传到任何轨道之前修改。
Google Play 提出要求时，我应该自己提高 targetSdk 吗？
请改为更新 WebViewGold 模板。它以当前的级别为目标，并包含新行为所需的代码；只改一个数字，可能上传顺利，之后却导致通知或文件上传失效。
让您的应用上架商店的三种方式
结果相同，只是您需要投入的工作量不同。三种方式都附带审核通过保证和 7×24 小时人工支持。
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日。