Cordova SDK 故障排除

项目
03/17/2024

重要

Visual Studio App Center 计划于 2025 年 3 月 31 日停用。虽然可以继续使用 Visual Studio App Center，直到它完全停用，但你可以考虑迁移到几个建议的替代方法。

未能安装插件 - pod 命令失败，退出代码为 1

更新到最新插件版本后，很可能在期间 cordova plugin add cordova-plugin-appcenter-<module>看到以下错误消息：

Installing "cordova-plugin-appcenter-shared" for ios
Failed to install 'cordova-plugin-appcenter-shared': Error: pod: Command failed with exit code 1

在 0.3.0中，我们删除了 iOS 8 支持。此问题的问题是，默认情况下，4.5.5目标 iOS 9.0 的版本cordova-ios在 podfile 中使用了 iOS8.0。此问题已使用 cordova-ios 5.0.0修复。

有两个选项：

cordova platform add ios@5.0.0
如果要继续使用较旧的 cordova 版本，请转到 platforms>ios，打开 Podfile 并更改为。platform :ios, '8.0'platform :ios, '9.0' 然后运行 pod install。

无法安装“cordova-plugin-appcenter-shared”：未定义

此错误的一个可能原因是在未安装 CocoaPods 的情况下运行cordova plugin add cordova-plugin-appcenter-<module>。

在这种情况下，错误通常包括以下行：

Error: CocoaPods was not found. Please install version 1.0.1 or greater from https://cocoapods.org/

如果看到此行，请运行：

sudo gem install cocoapods
pod setup

CocoaPods 找不到 Pod“AppCenter”的兼容版本

如果在期间 cordova plugin add cordova-plugin-appcenter-<module>看到以下错误消息，则可能是系统上的本地克隆 (~/.cocoapods/repos ，) CocoaPods 规范存储库不是最新的。

CocoaPods could not find compatible versions for pod "AppCenter":
 In Podfile:
   AppCenter (~> 1.12.0)

运行 pod repo update 以更新规范存储库，然后再次尝试添加插件。有关 CocoaPods 命令的详细信息，请参阅 CocoaPods 命令行参考。

找不到模块“AppCenter”iOS 生成错误

如果在期间 cordova build ios看到以下错误消息，则表示 CocoaPods 安装出现问题：

.../cordova-plugin-appcenter-shared/AppCenterShared.h:3:9: fatal error: module 'AppCenter' not found
@import AppCenter;
~~~~~~~^~~~~~~~~
1 error generated.

一个可能的原因是计算机上本地克隆 (~/.cocoapods/repos ，) CocoaPods 规范存储库不是最新的。

运行 pod repo update 以更新规范存储库，然后再次尝试添加插件。有关 CocoaPods 命令的详细信息，请参阅 CocoaPods 命令行参考。

在路径 iOS 生成错误处找不到存档

如果在期间 cordova build ios看到以下错误消息，则必须切换到旧版生成系统。

error: archive not found at path '.../platforms/ios/MyApp.xcarchive'
** EXPORT FAILED **

若要解决此问题，请在运行生成时指定 --buildFlag="-UseModernBuildSystem=0" 。此 StackOverflow 线程中还介绍了该解决方案。

在存储库容器 Android 生成错误中找不到参数 [] 的 google () 方法

如果在期间 cordova build android看到以下错误消息，则可能是版本 cordova-android 太低。

FAILURE: Build failed with an exception.

* Where:
Script '.../cordova/platforms/android/cordova-plugin-appcenter-*/*.gradle' line: 3

* What went wrong:
A problem occurred evaluating script.
> Could not find method google() for arguments [] on repository container.

至少将更新 cordova-android 为 6.4.0。可以运行 cordova platform update android 以将平台更新为最新版本或使用 cordova platform add android@6.4.0 确切版本。

分析未显示在门户中

请确保已将此行添加到配置文件：

<preference name="APPCENTER_ANALYTICS_ENABLE_IN_JS" value="true" />

默认情况下，此值为 false。

保护 App Center 机密值

app_secret是应用的标识符，需要知道流量应用于哪个应用，并且不能用于检索或编辑现有数据。 app_secret如果你被公开，最大的风险是将错误数据发送到你的应用，但它不会影响数据的安全性。

若要检索任何敏感数据，需要提供在客户端生成的应用/用户令牌。无法使客户端上的数据完全安全。

可以通过使用环境变量将应用机密注入代码来提高应用的安全性。这样，机密就不会在代码中可见。

通过