NativeScript 版本更新
保持您的 {N} 应用更新。
npm i --save nativescript-version-update

NativeScript 版本更新

npm npm

NPM

此插件允许您定义关于应用更新的通知策略。您可以根据平台商店中可用的新版本,指定是否强制、提供或忽略更新。

例如,您可能希望强制所有主要版本更新,但提供给用户选择更新或跳过次要或补丁版本的选择。

您还可以指定在更新发布后多少天后显示警报。

先决条件

您需要添加 appversion 插件才能使此功能正常工作

tns plugin add @nativescript/appversion

安装

tns plugin add nativescript-version-update

使用

在您的 main.tsapp.ts 文件中,在应用启动之前,调用 StoreUpdate.init 并传递所需选项,如下所示

    import { StoreUpdate, AlertTypesConstants } from "nativescript-version-update";

StoreUpdate.init({
notifyNbDaysAfterRelease: 1,
majorUpdateAlertType: AlertTypesConstants.OPTION
})

本地化

插件包含一些默认翻译,位于 src/i18n 文件夹中的 json 文件中,并由 src/helpers/locales.helper.ts 文件手动调用。您还可以通过配置选项指定自定义翻译。如果您想贡献区域化翻译,必须使用在 Apple 文档 中指定的 lang-regionCode 格式,但国家代码为小写(例如:fr-caen-us

API

配置选项

属性 默认值 描述
majorUpdateAlertType FORCE 主要版本更改的警报类型(例如:A.b.c.d)
minorUpdateAlertType OPTION 次要版本更改的警报类型(例如:a.B.c.d)
patchUpdateAlertType NONE 补丁版本更改的警报类型(例如:a.b.C.d)
revisionUpdateAlertType NONE 修订版本更改的警报类型(例如:a.b.c.D)
notifyNbDaysAfterRelease 1 延迟更新提示特定天数
countryCode en 国家代码
alertOptions null 自定义警报对话框文本,绕过 Locale json

警报类型

描述
FORCE 1 显示无法跳过的警报
OPTION 2 显示可跳过的警报
NONE 3 不显示任何警报

警报选项配置(可选)

属性 默认值 描述
title LocaleText 对话框标题,回退到 locale json
message LocaleText 对话框正文文本,回退到 locale json
updateButton LocaleText 对话框更新按钮,回退到 locale json
skipButton LocaleText 对话框跳过按钮,回退到 locale json

开发

克隆此存储库,进入 src 文件夹,然后运行命令 npm run setup。然后您可以使用

  • npm run demo.iosnpm run demo.android 来启动演示
  • npm run plugin.tscwatch 来监视插件文件并开始开发!

存储库包含 2 个演示文件夹,一个包含 angular,另一个不包含。演示使用 bundleId com.bitstrips.imoji 作为它们的 App 版本包含主要、次要和补丁数字,并且它们经常更新它们的应用程序。您可以在 main.tsapp.ts 文件中更改传递给 package init 的参数,并在 android app.gradle 和 ios info.plist 配置文件中更改应用程序版本以测试功能。

许可证

Apache 许可证版本 2.0,2004 年 1 月

贡献者