npm i --save nativescript-version-update
- 版本:2.0.2
- GitHub:
- NPM: https://npmjs.net.cn/package/nativescript-version-update
- 下载
- 昨日: 3
- 上周: 4
- 上月: 18
NativeScript 版本更新
此插件允许您定义关于应用更新的通知策略。您可以根据平台商店中可用的新版本,指定是否强制、提供或忽略更新。
例如,您可能希望强制所有主要版本更新,但提供给用户选择更新或跳过次要或补丁版本的选择。
您还可以指定在更新发布后多少天后显示警报。
先决条件
您需要添加 appversion 插件才能使此功能正常工作
tns plugin add @nativescript/appversion
安装
tns plugin add nativescript-version-update
使用
在您的 main.ts
或 app.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-ca
,en-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.ios
或npm run demo.android
来启动演示npm run plugin.tscwatch
来监视插件文件并开始开发!
存储库包含 2 个演示文件夹,一个包含 angular,另一个不包含。演示使用 bundleId com.bitstrips.imoji
作为它们的 App 版本包含主要、次要和补丁数字,并且它们经常更新它们的应用程序。您可以在 main.ts
或 app.ts
文件中更改传递给 package init 的参数,并在 android app.gradle
和 ios info.plist
配置文件中更改应用程序版本以测试功能。
许可证
Apache 许可证版本 2.0,2004 年 1 月