NativeScript Store Update
保持您的 {N} 应用更新。
npm i --save nativescript-store-update

Nativescript-store-update

npm npm

NPM

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

例如,您可能希望强制所有主要版本更新,但允许用户选择是否更新或跳过小版本或补丁版本。

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

先决条件

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

tns plugin add nativescript-appversion

安装

tns plugin add nativescript-store-update

用法

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

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

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

本地化

插件在 src/i18n 文件夹中包含一些默认翻译,并在 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 NONE
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月

贡献者