App Center (Cordova) 崩溃
重要
Visual Studio App Center 计划于 2025 年 3 月 31 日停用。 虽然可以继续使用 Visual Studio App Center,直到它完全停用,但你可以考虑迁移到几个建议的替代方法。
备注
对 Cordova Apps 的支持已于 2022 年 4 月结束。 有关详细信息,请参阅 App Center 博客。
每次应用崩溃时,App Center 崩溃都会自动生成崩溃日志。 日志首先写入设备的存储,当用户再次启动应用时,故障报告将发送到 App Center。 收集崩溃适用于 beta 应用和实时应用,即提交到App Store的应用。 故障日志包含有助于修复崩溃的重要信息。
如果尚未在应用程序中设置 SDK,请按照入门部分进行操作。
App Center 崩溃提供了一个 API,用于生成测试崩溃,以便轻松测试 SDK。 此 API 只能在测试/beta 应用中使用,不会在生产应用中执行任何操作。
AppCenter.Crashes.generateTestCrash();
备注
需要在发布模式下编译 Cordova 应用,才能将此崩溃发送到 App Center。
App Center 崩溃有两个 API,可在应用崩溃时为你提供详细信息。
启动 SDK 后,可以随时检查应用是否在上一个会话中收到内存警告:
var success = function(hadLowMemoryWarning) {
console.log(`there was ${hadLowMemoryWarning ? "a" : "no"} memory warning`);
}
var error = function(error) {
console.error(error);
}
AppCenter.Crashes.hasReceivedMemoryWarningInLastSession(success, error);
备注
在某些情况下,运行设备内存不足可能不会触发可跟踪事件。
启动 SDK 后,可以随时检查应用是否在上一次启动中崩溃:
var success = function(didCrash) {
console.log("there was " + (didCrash ? "a" : "no") + " crash");
}
var error = function(error) {
console.error(error);
}
AppCenter.Crashes.hasCrashedInLastSession(success, error);
如果想要在崩溃后调整应用的行为或 UI,这将派上用场。 某些开发人员可能希望向用户道歉,或在发生崩溃后取得联系。
如果你的应用以前崩溃,你可以获取有关上次崩溃的详细信息。
var success = function(crashReport) {
//do something with crash report
}
var error = function(error) {
console.error(error);
}
AppCenter.Crashes.lastSessionCrashReport(success, error);
App Center 崩溃为开发人员提供了在将崩溃日志发送到 App Center 之前和向 App Center 发送时执行其他操作的功能。
可以通过更改 config.xml中的首选项APPCENTER_CRASHES_ALWAYS_SEND
值,将 SDK 配置为自动发送故障报告或在 JavaScript 中处理崩溃。 若要在 JavaScript 中处理崩溃,请将其设置为 false
。
<preference name="APPCENTER_CRASHES_ALWAYS_SEND" value="false" />
然后,可以使用 AppCenter.Crashes.process(processFunction, errorCallback)
方法自定义崩溃过程。
sendCallback
如果要确定是否需要处理特定崩溃,请将 传递给 false
。 例如,可能存在你想要忽略的系统级崩溃,并且不希望发送到 App Center。
var errorCallback = function(error) {
console.error(error);
};
var processFunction = function(attachments, sendCallback) {
sendCallback(false); //crash won't be sent
};
AppCenter.Crashes.process(processFunction, errorCallback);
否则,将 传递给 true
sendCallback
函数,并发送崩溃。
var errorCallback = function(error) {
console.error(error);
};
var processFunction = function(attachments, sendCallback) {
sendCallback(true); //crash will be sent
};
AppCenter.Crashes.process(processFunction, errorCallback);
备注
若要使用此功能,需要将 config.xml 中的首选项值设置为 false
APPCENTER_CRASHES_ALWAYS_SEND
。
因此,此功能依赖于 JavaScript 中的 处理崩溃 。
可以将二进制和文本附件添加到故障报告。 SDK 将随故障一起发送它们,以便你可以在 App Center 门户中查看它们。 在从上一个应用程序启动时发送存储的故障之前,将立即调用以下回调,但不会在崩溃时调用。 请确保 附件文件未 命名 minidump.dmp
,因为该名称是为小型转储文件保留的。 下面是如何将文本和图像附加到崩溃的示例:
var errorCallback = function(error) {
console.error(error);
};
var processFunction = function(attachments, sendCallback) {
for (var i = 0; i < attachments.length; i++) {
attachments[i].addTextAttachment('Hello text attachment!', 'hello.txt');
var imageAsBase64string = '...';
attachments[i].addBinaryAttachment(imageAsBase64string, 'logo.png', 'image/png');
}
sendCallback(true); //crash will be sent
};
AppCenter.Crashes.process(processFunction, errorCallback);
备注
若要使用该功能,需要将 config.xml 中的首选项值设置为 false
APPCENTER_CRASHES_ALWAYS_SEND
。
因此,此功能依赖于 JavaScript 中的 处理崩溃 。
备注
大小限制目前在 Android 上为 1.4 MB,在 iOS 上为 7 MB。 尝试发送更大的附件将触发错误。
可以在运行时启用和禁用 App Center 崩溃。 如果禁用它,SDK 不会对应用执行任何故障报告。
var success = function() {
console.log("crashes disabled");
}
var error = function(error) {
console.error(error);
}
AppCenter.Crashes.setEnabled(false, success, error);
若要再次启用 App Center 崩溃,请使用同一 API,但将 作为参数传递 true
。
var success = function() {
console.log("crashes enabled");
}
var error = function(error) {
console.error(error);
}
AppCenter.Crashes.setEnabled(true, success, error);
在应用程序启动时,状态将保留在设备的存储中。
还可以检查是否启用了 App Center 崩溃:
var success = function(result) {
console.log("crashes " + (result) ? "enabled" : "disabled");
}
var error = function(error) {
console.error(error);
}
AppCenter.Crashes.isEnabled(success, error);