nativescript-hockeyapp
by ethras | v1.0.1
Nativescript 的 HockeyApp SDK 集成
npm i --save nativescript-hockeyapp

Nativescript 的 HockeyApp SDK

NativeScript 插件,用于 HockeyApp SDK(iOS 和 Android)


此插件将在 NativeScript 项目中安装 HockeyApp SDK,并提供在 iOS 和 Android 项目中使用的通用 API。

使用方法

在项目根目录中运行以下命令

$ tns plugin add nativescript-hockeyapp

SDK 包装和初始化机制不客气地从 Fabric 插件 复制。在运行带有此插件的程序之前,您将需要一个来自 HockeyApp 服务的 APP_ID。访问 HockeyApp 网站 以获取您应用程序的密钥。在 AndroidManifest.xmlInfo.plist 中输入该密钥。

iOS

将 HockeyApp 的 APP_ID 添加到 /app/App_Resources/iOS/Info.plist 文件中

<key>HockeyAppId</key>
<string>${APP_ID}</string>

此插件的 iOS 版本使用 HockeyApp SDK CocoaPod。有关其他配置选项,请参阅 HockeyApp SDK CocoaPod 文档

注意:从版本 1.2.0 开始,此插件需要 XCode 8.3+。如果您使用的是较旧的 XCode 版本,则在尝试构建包含此插件的 NativeScript 项目时可能会看到 无效的位码版本 错误。

使用 build.xcconfig

在 iOS 上,您还可以选择将您的 HockeySDK APP_ID 放入 build.xcconfig 文件中,而不是直接嵌入到 Info.plist 中。例如,如果您想避免将 SDK 密钥放入源代码控制中,这可以有所帮助。

使用上面的 Info.plist 语法与 ${APP_ID} 键,只需将此行添加到 build.xcconfig

APP_ID = YOUR-HOCKYSDK-APP-ID

在构建过程中,build.xcconfig 中的值将替换 Info.plist 中的 ${APP_ID} 键。

Android

将 HockeyApp 的 APP_ID 添加到 /app/App_Resources/Android/AndroidManifest.xml 文件中

<meta-data android:name="net.hockeyapp.android.appIdentifier" android:value="${APP_ID}" />

用法

在安装插件并配置 APP_ID 后,只需导入并初始化插件。

import { HockeyApp } from 'nativescript-hockey-sdk';
...
HockeyApp.init();
HockeyApp.trackEvent("LOG_IN");

要在应用程序启动时初始化,请在 app.tsapp.js 文件中的 launchEvent 处理器中导入和初始化

app.on(app.launchEvent, function(context) {
HockeyApp.init();
});

如果您使用 Angular,您还可以使用 AppModule 构造函数

export class AppModule {
constructor() {
HockeyApp.init();
HockeyApp.trackEvent("LAUNCH");
}
}

待办事项

许可证

MIT