NativeScript 版本跟踪

跟踪用户之前安装的 NativeScript 应用程序版本。

安装

从您项目的根目录运行以下命令

$ tns plugin add nativescript-version-tracking

用法

探索插件用法的最佳方式是检查插件根目录中的演示应用程序。

初始化插件

此插件需要在您的应用程序启动时初始化。

TypeScript

import * as app from 'tns-core-modules/application';
import versionTracking from 'nativescript-version-tracking';

app.on('launch', () => {
    versionTracking.init();
});

JavaScript

var app = require('tns-core-modules/application');
var versionTracking = require('nativescript-version-tracking');

app.on('launch', function () {
    versionTracking.init();
});

使用 API

您可以在任何时候使用此插件。例如，用户已启动多个先前版本，这是他首次启动新版本 2.0.1

versionTracking.isFirstLaunchEver;        // false
versionTracking.isFirstLaunchForVersion;  // true
versionTracking.isFirstLaunchForBuild;    // true

versionTracking.currentVersion;           // 2.0.1
versionTracking.previousVersion;          // 2.0.0
versionTracking.firstInstalledVersion;    // 1.0.0
versionTracking.versionHistory;           // [1.0.0, 1.0.1, 1.0.2, 2.0.0, 2.0.1]

versionTracking.currentBuild;             // 18
versionTracking.previousBuild;            // 15
versionTracking.firstInstalledBuild;      // 1
versionTracking.buildHistory;             // [1, 2, 3, 4, 5, 8, 9, 10, 11, 13, 15, 18]

versionTracking.firstLaunchForVersion('3.0.0')     // false
versionTracking.firstLaunchForBuild('20')          // false

API

属性

属性	默认值	描述
isFirstLaunchEver	-	检查这是否是应用程序首次启动。
isFirstLaunchForVersion	-	检查这是否是当前版本首次启动。
isFirstLaunchForBuild	-	检查这是否是当前构建首次启动。
currentVersion	-	返回应用程序的当前版本。
previousVersion	-	返回应用程序的先前版本。
firstInstalledVersion	-	返回用户首次安装应用程序的版本。
versionHistory	[]	返回用户已安装的版本列表，例如：['2.1', '3.5', '4.0', '4.1']。列表按安装的第一个版本到当前版本（包括）的顺序排列
currentBuild	-	返回应用程序的当前构建。
previousBuild	-	返回应用程序的先前构建。
firstInstalledBuild	-	返回用户首次安装应用程序的构建。
buildHistory	[]	返回用户已安装的构建列表，例如：['2100', '3500', '4000', '4100']。列表按安装的第一个构建到当前构建（包括）的顺序排列。

方法

方法	返回值	描述
init(versionsKey?: string, buildsKey?: string)	void	初始化插件。调用此方法是必需的。调用它的好地方是在应用程序的 onLaunch() 方法中。
firstLaunchForVersion(version: string)	boolean	检查是否为特定版本号的首次启动。如果您想要在特定版本的首次启动时执行某些代码，则非常有用。
firstLaunchForBuild(build: string)	boolean	检查是否为特定构建号的首次启动。如果您想要在特定构建的首次启动时执行某些代码，则非常有用。

支持

🐞 对于 错误报告 或 功能请求，请使用问题部分。
💬 对于问题，请访问 https://spectrum.chat/bazzite/open-source。
🚀 您还可以选择在 Twitter 上关注支持此项目的公司 BazziteTech。

专业支持

本项目的赞助商为 Bazzite。如果您在项目中需要帮助，请通过 https://www.bazzite.com/contact 联系我们。

贡献

在发起 pull request 之前，请务必阅读贡献指南。

行为准则

所有参与此项目的成员都应同意遵守行为准则。

许可证

代码在 MIT 许可证下发布。

最初灵感来源于 VersionTrackingPlugin。