Raygun4Apple
Raygun为iOS、tvOS和macOS提供的崩溃报告和实时用户监控。
官方支持
- iOS 12+
- tvOS 12+
- macOS 12+
注意：raygun4apple可能与更早的操作系统版本兼容，但我们推荐您更新到我们构建和测试的版本，以避免出现任何意外问题。
安装
使用Swift包管理器
要将Raygun集成到由SPM管理的应用程序中，更新您的Package.swift文件，将raygun4apple作为依赖项添加。
下面是一个使用raygun4apple作为依赖项的macOS CLI应用的示例
import PackageDescription
let package = Package(
name: "macos-cli",
dependencies: [
//Note - the version must be atleast 2.0.0 as this is earliest release of this package through SPM.
.package(url: "https://github.com/MindscapeHQ/raygun4apple.git", from: "2.0.0"),
],
targets: [
.executableTarget(
name: "macos-cli",
dependencies: ["raygun4apple"])
]
)配置Raygun客户端
如果您通过Swift包管理器进行安装，配置步骤略有不同。而不是导入特定目标应用程序的标题文件，只需导入raygun4apple即可。
以下是一个导入raygun4apple、初始化提供程序并发送测试异常的示例
import raygun4apple
let raygunClient = RaygunClient.sharedInstance(apiKey: "YOUR_API_KEY_HERE")
raygunClient.enableCrashReporting()
raygunClient.send(exception: NSException.init(name: NSExceptionName.illegalSelectorException, reason: "This is a macOS error!"))使用 CocoaPods
为了使用 CocoaPods 集成 Raygun，请更新您的 Podfile 以包含以下内容：
pod 'raygun4apple'更新完成后，您可以从终端运行 pod install。
使用 GitHub 版本发布
最新版本可以在这里找到。框架作为压缩文件附加到每个版本中。您可以下载、解压并将其包含在您的项目目录中。
包含后，转到您的应用程序的 通用 设置，并将 raygun4apple 框架添加到 框架、库和嵌入内容 部分。确保框架设置为 嵌入并签名。
配置 Raygun 客户端
在您的 AppDelegate 类文件中，导入目标平台的头文件。
#import <raygun4apple/raygun4apple_iOS.h>通过在 AppDelegate 的 application:didFinishLaunchingWithOptions 方法中添加以下代码片段来初始化 Raygun 客户端：
[RaygunClient sharedInstanceWithApiKey:@"_INSERT_API_KEY_"];
[RaygunClient.sharedInstance enableCrashReporting];
[RaygunClient.sharedInstance enableRealUserMonitoring];
[RaygunClient.sharedInstance enableNetworkPerformanceMonitoring]; // Optional发送测试错误事件
为了确保 Raygun 客户端配置正确，请尝试使用以下代码片段发送测试崩溃报告。
[RaygunClient.sharedInstance sendException:@"Raygun has been successfully integrated!"
withReason:@"A test crash report from Raygun"
withTags:@[@"Test"]
withCustomData:@{@"TestMessage":@"Hello World!"}];设置客户
默认情况下，每个用户将被识别为匿名用户/客户。但是，您可以使用以下代码片段设置更详细的客户信息。
RaygunUserInformation *userInfo = nil;
userInfo = [[RaygunUserInformation alloc] initWithIdentifier:@"[email protected]"
withEmail:@"[email protected]"
withFullName:@"Ronald Raygun"
withFirstName:@"Ronald"];
RaygunClient.sharedInstance.userInformation = userInfo;文档
了解更多信息，请访问我们的公共文档 这里。