功能和设置
复制安装提示并包含此插件的完整 Markdown 指南。
更新器插件配置
标题为“更新器插件配置”查看 Github README 更多信息,请参见。
CapacitorUpdater 可以通过以下选项进行配置:
| 属性 | 类型 | 描述 | 默认值 | 自 |
|---|---|---|---|---|
appReadyTimeout | number | 配置 native 插件等待更新失败的毫秒数。可用于 Android、iOS 和 Electron。 | 10000 // (10 seconds) | |
responseTimeout | number | 配置 native 插件等待 API 超时的毫秒数。可用于 Android、iOS 和 Electron。 | 20000 // (20 seconds) | |
autoDeleteFailed | boolean | 配置是否自动删除失败的包。可用于 Android、iOS 和 Electron。 | true | |
autoDeletePrevious | boolean | 配置是否自动删除之前的包。可用于 Android、iOS 和 Electron。 | true | |
autoUpdate | boolean | ‘off’ | ‘atBackground’ | ‘atInstall’ | ‘onLaunch’ | ‘always’ | ‘onlyDownload’ | 配置如何使用 Auto Update 通过更新服务器。true 相同于“atBackground”;false 相同于“off”。- off:禁用 Auto Update- atBackground:在应用程序切换到后台时检查和下载自动应用- atInstall:仅在新安装或原生应用更新后立即应用,否则使用 atBackground- onLaunch:在启动检查后立即应用,否则在启动检查后使用 atBackground- always:在 Auto Update 运行时立即应用- onlyDownload:检查和下载自动应用,发出 updateAvailable 事件,并且永远不会设置下一个包自动。可用于 Android、iOS 和 Electron。 | ”atBackground” // true is still accepted | |
resetWhenUpdate | boolean | 在安装新版本的本机应用程序包到设备时,自动删除之前下载的包。可用于Android、iOS和Electron。 | true | |
updateUrl | string | 配置更新检查发送到的URL/端点。可用于Android、iOS和Electron。 | https://plugin.capgo.app/updates | |
channelUrl | string | 配置用于频道操作的URL/端点。可用于Android、iOS和Electron。 | https://plugin.capgo.app/channel_self | |
statsUrl | string | 配置更新统计信息发送到的URL/端点。可用于Android、iOS和Electron。设置为“”来禁用统计信息报告。 | https://plugin.capgo.app/stats | |
publicKey | string | 配置用于端到端实时更新加密的公钥(版本2)。可用于Android、iOS和Electron。 | undefined | 6.2.0 |
version | string | 配置当前应用程序的版本。这将用于第一次更新请求。如果未设置,插件将从本机code中获取版本。可用于Android、iOS和Electron。 | undefined | 4.17.48 |
directUpdate | boolean | ‘always’ | ‘atInstall’ | ‘onLaunch’ | 已弃用。使用“atInstall”、“onLaunch”或“always”模式代替: - false:永不进行直接更新 - atInstall:与autoUpdate:“atInstall”相同 - onLaunch:与autoUpdate:“onLaunch”相同 - always:与autoUpdate:“always”相同 - true:与“always”相同(用于向后兼容性)。可用于Android、iOS和Electron。 | false | 5.1.0 |
autoSplashscreen | boolean | 自动处理使用即时应用模式时的启动屏幕隐藏。启用后,插件将在更新应用或无需更新时自动隐藏启动屏幕。这样可以避免手动监听appReady事件并调用SplashScreen.hide()。仅在autoUpdate设置为“atInstall”,“onLaunch”或“always”时有效。为了保持向后兼容,仍支持Legacy直接更新值。需要安装并配置@capacitor/splash-screen插件,launchAutoHide设置为false。需要启用自动更新。适用于Android和iOS。 | false | 7.6.0 |
periodCheckDelay | number | 配置更新检查周期的延迟时间。单位为秒。适用于Android、iOS和Electron。不能小于600秒(10分钟)。 | 600 // (10 minutes) | |
localS3 | boolean | 配置CLI使用本地服务器进行测试或自托管更新服务器。 | undefined | 4.17.48 |
localHost | string | 配置CLI使用本地服务器进行测试或自托管更新服务器。 | undefined | 4.17.48 |
localWebHost | string | 配置CLI使用本地服务器进行测试或自托管更新服务器。 | undefined | 4.17.48 |
localSupa | string | 配置CLI使用本地服务器进行测试或自托管更新服务器。 | undefined | 4.17.48 |
localSupaAnon | string | 配置CLI使用本地服务器进行测试。 | undefined | 4.17.48 |
localApi | string | 配置CLI使用本地api进行测试。 | undefined | 6.3.3 |
localApiFiles | string | 配置CLI使用本地文件api进行测试。 | undefined | 6.3.3 |
allowModifyUrl | boolean | 允许插件动态从JavaScript端修改updateUrl、statsUrl和channelUrl。 | false | 5.4.0 |
defaultChannel | string | 设置应用程序的默认频道在配置中。大小写敏感。这将设置将覆盖云中设置的默认频道,但仍会尊重云端的覆盖设置。 | undefined | 5.5.0 |
appId | string | 配置应用程序ID在配置中。 | undefined | 6.0.0 |
keepUrlPathAfterReload | boolean | 配置插件以在重新加载后保留URL路径。警告:当重新加载时,‘window.history’将被清除。 | false | 6.8.0 |
disableJSLogging | boolean | 禁用JavaScript插件的日志记录。如果为true,插件将不会在JavaScript控制台中记录。只有原生日志会被执行。 | false | 7.3.0 |
shakeMenu | boolean | 启用抖动手势以显示更新菜单(用于调试/测试目的)。 | false | 7.5.0 |
示例
示例在 capacitor.config.json:
{ "plugins": { "CapacitorUpdater": { "appReadyTimeout": 1000 // (1 second), "responseTimeout": 10 // (10 second), "autoDeleteFailed": false, "autoDeletePrevious": false, "autoUpdate": "onlyDownload", "resetWhenUpdate": false, "updateUrl": https://example.com/api/auto_update, "channelUrl": https://example.com/api/channel, "statsUrl": https://example.com/api/stats, "publicKey": undefined, "version": undefined, "directUpdate": undefined, "autoSplashscreen": undefined, "periodCheckDelay": undefined, "localS3": undefined, "localHost": undefined, "localWebHost": undefined, "localSupa": undefined, "localSupaAnon": undefined, "localApi": undefined, "localApiFiles": undefined, "allowModifyUrl": undefined, "defaultChannel": undefined, "appId": undefined, "keepUrlPathAfterReload": undefined, "disableJSLogging": undefined, "shakeMenu": undefined } }}在 capacitor.config.ts:
import { CapacitorConfig } from '@capacitor/cli';
const config: CapacitorConfig = { plugins: { CapacitorUpdater: { appReadyTimeout: 1000 // (1 second), responseTimeout: 10 // (10 second), autoDeleteFailed: false, autoDeletePrevious: false, autoUpdate: 'onlyDownload', resetWhenUpdate: false, updateUrl: https://example.com/api/auto_update, channelUrl: https://example.com/api/channel, statsUrl: https://example.com/api/stats, publicKey: undefined, version: undefined, directUpdate: undefined, autoSplashscreen: undefined, periodCheckDelay: undefined, localS3: undefined, localHost: undefined, localWebHost: undefined, localSupa: undefined, localSupaAnon: undefined, localApi: undefined, localApiFiles: undefined, allowModifyUrl: undefined, defaultChannel: undefined, appId: undefined, keepUrlPathAfterReload: undefined, disableJSLogging: undefined, shakeMenu: undefined, }, },};
export default config;notifyAppReady()setUpdateUrl(...)setStatsUrl(...)setChannelUrl(...)download(...)next(...)set(...)delete(...)list(...)reset(...)current()reload()setMultiDelay(...)cancelDelay()getLatest(...)setChannel(...)unsetChannel(...)getChannel()listChannels()setCustomId(...)getBuiltinVersion()getDeviceId()getPluginVersion()isAutoUpdateEnabled()removeAllListeners()addListener('download', ...)addListener('noNeedUpdate', ...)addListener('updateAvailable', ...)addListener('downloadComplete', ...)addListener('majorAvailable', ...)addListener('updateFailed', ...)addListener('downloadFailed', ...)addListener('appReloaded', ...)addListener('appReady', ...)isAutoUpdateAvailable()getNextBundle()setShakeMenu(...)isShakeMenuEnabled()- 接口
- 类型别名
方法
方法通知应用就绪()
contextnotifyAppReady() => Promise<AppReadyResult>Notify Capacitor Updater that the current bundle is working (a rollback will occur if this method is not called on every app launch) By default this method should be called in the first 10 sec after app launch, otherwise a rollback will occur. Change this behaviour with {@link appReadyTimeout}
设置更新URL(…) Promise<AppReadyResult>
方法
复制到剪贴板setUpdateUrl(options: UpdateUrl) => Promise<void>复制到剪贴板
| 参数 | 类型 | 描述 |
|---|---|---|
options | UpdateUrl | 用于检查更新的 URL。 |
自: 5.4.0
setStatsUrl(…)
标题:setStatsUrl(…)setStatsUrl(options: StatsUrl) => Promise<void>设置应用的 statsUrl,用于发送统计数据。传入空字符串将禁用统计数据收集。
| 参数 | 类型 | 描述 |
|---|---|---|
options | StatsUrl | 包含用于发送统计信息的 URL。 |
自从: 5.4.0
setChannelUrl(…)
标题:setChannelUrl(…)setChannelUrl(options: ChannelUrl) => Promise<void>设置应用程序的 channelUrl,这将用于设置 channel。
| 参数 | 类型 | 描述 |
|---|---|---|
options | ChannelUrl | 包含用于设置 channel 的 URL。 |
自从: 5.4.0
download(…)
下载(…)download(options: DownloadOptions) => Promise<BundleInfo>从提供的 URL 下载一个新的包,应该是一个 zip 文件,包含文件或一个唯一 ID 的文件夹,包含所有文件
| 参数 | 类型 | 描述 |
|---|---|---|
options | DownloadOptions | 下载选项 {@link} 下载新包 zip 的选项返回: |
next(…) Promise<BundleInfo>
next(options: BundleId) => Promise<BundleInfo>设置下次启动应用时使用的包
| 参数 | 类型 | 描述 |
|---|---|---|
options | BundleId | 包含下次启动应用时设置的包ID。 {@link} BundleInfo.id} |
返回: Promise<BundleInfo>
set(…)
标题:set(…)set(options: BundleId) => Promise<void>设置当前包并立即重新加载应用
| 参数 | 类型 | 描述 |
|---|---|---|
options | BundleId | 一个 {@link} 对象,包含要设置为当前的新包 ID。 BundleId} object containing the new bundle id to set as current. |
delete(options: BundleId) => Promise<void>类型
| Section titled “delete(…)” | Copied to clipboard | 简介 |
|---|---|---|
options | BundleId | 一个 {@link} BundleId} 对象,包含要删除的包的 ID(注意,这是包 ID,而不是版本名称) |
list(…)
标题:list(…)list(options?: ListOptions | undefined) => Promise<BundleListResult>获取本地下载的所有包
| 参数 | 类型 | 简介 |
|---|---|---|
options | ListOptions | The {@link} ListOptions}用于列出捆绑包 |
返回: Promise<BundleListResult>
reset(…)
标题:“reset(…)”reset(options?: ResetOptions | undefined) => Promise<void>重置应用到捆绑包(苹果应用商店/谷歌商店发送的那个)或最后成功加载的捆绑包。 builtin 参数
| 类型 | 描述 | 包含{@link} |
|---|---|---|
options | ResetOptions | bundle (the one sent to Apple App Store / Google Play Store ) or the last successfully loaded bundle. ResetOptions.toLastSuccessful}, true 重置为内置的捆绑包并 false 会重置为最后一次成功加载的捆绑包。 |
current()
标题:current()current() => Promise<CurrentBundleResult>获取当前捆绑包,如果没有设置则返回 builtincurrentNative是设备上安装的原始捆绑包
返回: Promise<CurrentBundleResult>
reload()
标题:reload()reload() => Promise<void>重新加载视图
设置多次延迟(…)
标题:设置多次延迟(…)setMultiDelay(options: MultiDelayConditions) => Promise<void>设置一个 {@link} 延迟条件} date 延迟条件 background 延迟条件 nativeVersion 延迟条件 kill 延迟条件
| 延迟条件(不使用) 该函数在选项kill下存在不一致的行为,kill选项会在第一次kill后触发更新,而不是在下一次后台运行时。这个问题将在未来的一次重大更新中得到解决。 | 类型 | 描述 |
|---|---|---|
options | MultiDelayConditions | 包含 {@link} 多延迟条件} 数组,用于设置 |
自 4.3.0
取消延迟()
标题为“取消延迟()”的部分cancelDelay() => Promise<void>取消 {@link} 延迟条件} 以立即处理更新。
自从: 4.0.0
getLatest(…)
标题:getLatest(…)getLatest(options?: GetLatestOptions | undefined) => Promise<LatestVersion>从更新 URL 获取最新的包
| 参数 | 类型 |
|---|---|
options | GetLatestOptions |
返回: Promise<LatestVersion>
自从: 4.0.0
setChannel(…)
标题:setChannel(…)setChannel(options: SetChannelOptions) => Promise<ChannelRes>设置此设备的插件管理的本地频道。频道必须 allow_device_self_set 需要启用才能正常工作。
setChannel() 验证频道并将选定的频道存储在设备上。它不会创建或更新后端设备覆盖,因此设备不会在Capgo控制台中显示为覆盖。只有从控制台或公共API创建的 assignments 才会在设备覆盖 UI 中显示。
重要注意事项:
- 不要在启动时使用此方法设置频道。请在__CAPGO_KEEP_0__配置中使用
defaultChannelin your Capacitor config instead. - 公共频道无法自行分配。
- 如果频道标记为 ,调用
public将返回错误。要使用公共频道,请调用setChannel()设备将自动切换到匹配的公共频道。unsetChannel()instead - the device will automatically fall back to the matching public channel. - 使用
listChannels()来发现可用的频道以及它们是否允许自我赋值。
| 参数 | 类型 | 描述 |
|---|---|---|
options | SetChannelOptions | 是否是 {@link SetChannelOptions}频道设置 |
返回: Promise<ChannelRes>
自: 4.7.0
unsetChannel(…)
标题:unsetChannel(…)unsetChannel(options: UnsetChannelOptions) => Promise<void>清除本地设备的插件管理的频道。这只会清除本地存储的频道,而不会删除仪表板或公共__CAPGO_KEEP_0__设备覆盖记录。 setChannel()调用此方法后,正常频道顺序适用:如果存在仪表板或公共API设备覆盖记录,则仍然有效;否则设备可以回退到匹配公共/默认频道的条件(平台、设备类型、构建类型)。
After calling this method, normal channel precedence applies: an existing Dashboard or Public API Device Override still wins; otherwise the device can fall back to the matching public/default channel for its conditions (platform, device type, build type).
您想将设备移回默认更新轨道
- 您想使用公共频道(由于公共频道无法自行分配至__CAPGO_KEEP_0__
- 参数
setChannel())
| 类型 | since |
|---|---|
options | UnsetChannelOptions |
getChannel() 4.7.0
getChannel()部分
section titled “getChannel()”getChannel() => Promise<GetChannelRes>获取此设备的频道
返回值: Promise<GetChannelRes>
自: 4.8.0
listChannels()
标题:listChannels()listChannels() => Promise<ListChannelsResult>列出此设备可用的所有频道。返回与设备当前环境(平台、模拟器/真实设备、开发/生产构建)兼容的频道,并且是公共频道或允许自我赋值。
结果中的每个频道包括:
public如果true,这是一个 默认频道.您不能使用自身分配它setChannel().如果您使用unsetChannel(),则设备将自动从公共频道接收更新。allow_self_set: 如果true,这是一个 自分配频道.您可以使用setChannel().
返回: Promise<ListChannelsResult>
自 7.5.0
setCustomId(…)
标题:setCustomId(…)setCustomId(options: SetCustomIdOptions) => Promise<void>设置此设备的自定义 ID
| 参数 | 类型 | 描述 |
|---|---|---|
options | SetCustomIdOptions | 是设置 {@link} SetCustomIdOptions} 自定义 ID |
自从: 4.9.0
getBuiltinVersion()
标题:getBuiltinVersion()getBuiltinVersion() => Promise<BuiltinVersion>获取本机应用程序版本或在配置中设置的内置版本
返回值: Promise<BuiltinVersion>
自: 5.2.0
getDeviceId()
getDeviceId()getDeviceId() => Promise<DeviceId>获取设备的唯一 ID(用于自动更新服务器)
返回值: Promise<DeviceId>
getPluginVersion()
getPluginVersion()getPluginVersion() => Promise<PluginVersion>获取本地 Capacitor Updater 插件版本(用于自动更新服务器)
返回值: Promise<PluginVersion>
isAutoUpdateEnabled()
isAutoUpdateEnabled()isAutoUpdateEnabled() => Promise<AutoUpdateEnabled>获取自动更新配置的状态。
返回: Promise<AutoUpdateEnabled>
removeAllListeners()
removeAllListeners()removeAllListeners() => Promise<void>自
addListener('download', …) 1.0.0
addListener('download', …)
addListener(‘download’, …)的说明addListener(eventName: 'download', listenerFunc: (state: DownloadEvent) => void) => Promise<PluginListenerHandle>在 App 中监听包下载事件。触发一次下载开始、下载中和下载完成时。 此事件将返回下载百分比
| 参数 | 类型 |
|---|---|
eventName | ’download’ |
listenerFunc | (state: DownloadEvent) => void |
返回值: Promise<PluginListenerHandle>
自: 2.0.11
addListener(‘noNeedUpdate’, …)
标题:addListener(‘noNeedUpdate’, …)addListener(eventName: 'noNeedUpdate', listenerFunc: (state: NoNeedEvent) => void) => Promise<PluginListenerHandle>监听无需更新事件,适用于每次启动应用时强制检查
| 参数 | 类型 |
|---|---|
eventName | ’noNeedUpdate’ |
listenerFunc | (state: NoNeedEvent) => void |
返回值: Promise<PluginListenerHandle>
自: 4.0.0
添加监听器(‘updateAvailable’,…)
标题:添加监听器(‘updateAvailable’,…)addListener(eventName: 'updateAvailable', listenerFunc: (state: UpdateAvailableEvent) => void) => Promise<PluginListenerHandle>监听可用更新事件,适用于每次启动应用时强制检查更新
| 参数 | 类型 |
|---|---|
eventName | ’updateAvailable’ |
listenerFunc | (state: UpdateAvailableEvent) => void |
返回值: Promise<PluginListenerHandle>
自: 4.0.0
添加监听器(‘downloadComplete’,…)
标题:添加监听器(‘downloadComplete’,…)addListener(eventName: 'downloadComplete', listenerFunc: (state: DownloadCompleteEvent) => void) => Promise<PluginListenerHandle>监听下载完成事件。
| 参数 | 类型 |
|---|---|
eventName | ’downloadComplete’ |
listenerFunc | (state: DownloadCompleteEvent) => void |
返回值: Promise<PluginListenerHandle>
自: 4.0.0
addListener(‘majorAvailable’,…)
标题:addListener(‘majorAvailable’,…)addListener(eventName: 'majorAvailable', listenerFunc: (state: MajorAvailableEvent) => void) => Promise<PluginListenerHandle>监听App中Major更新事件,告知您何时Major更新被禁用(通过设置disableAutoUpdateBreaking)
| 参数 | 类型 |
|---|---|
eventName | ’majorAvailable’ |
listenerFunc | (state: MajorAvailableEvent) => void |
返回值: Promise<PluginListenerHandle>
自: 2.3.0
addListener(‘updateFailed’,…)
标题:addListener(‘updateFailed’,…)addListener(eventName: 'updateFailed', listenerFunc: (state: UpdateFailedEvent) => void) => Promise<PluginListenerHandle>在 App 中监听更新失败事件,让你知道下次启动 App 时更新安装失败
| 参数 | 类型 |
|---|---|
eventName | ’updateFailed’ |
listenerFunc | (state: UpdateFailedEvent) => void |
返回值: Promise<PluginListenerHandle>
自: 2.3.0
addListener(‘downloadFailed’,…)
标题:addListener(‘downloadFailed’,…)addListener(eventName: 'downloadFailed', listenerFunc: (state: DownloadFailedEvent) => void) => Promise<PluginListenerHandle>在 App 中监听下载失败事件,让你知道一个包下载失败了
| 参数 | 类型 |
|---|---|
eventName | ’downloadFailed’ |
listenerFunc | (state: DownloadFailedEvent) => void |
返回值: Promise<PluginListenerHandle>
自: 4.0.0
addListener(‘appReloaded’,…)
标题:addListener(‘appReloaded’,…)addListener(eventName: 'appReloaded', listenerFunc: () => void) => Promise<PluginListenerHandle>在 App 中监听重载事件,让你知道重载已经发生
| 参数 | 类型 |
|---|---|
eventName | ’appReloaded’ |
listenerFunc | () => void |
返回值: Promise<PluginListenerHandle>
自: 4.3.0
addListener(‘appReady’,…)
标题:addListener(‘appReady’,…)addListener(eventName: 'appReady', listenerFunc: (state: AppReadyEvent) => void) => Promise<PluginListenerHandle>监听 App 就绪事件,让你知道 App 已经准备好使用
| 参数 | 类型 |
|---|---|
eventName | ’appReady’ |
listenerFunc | (state: AppReadyEvent) => void |
返回值: Promise<PluginListenerHandle>
自: 5.1.0
isAutoUpdateAvailable()
标题:isAutoUpdateAvailable()isAutoUpdateAvailable() => Promise<AutoUpdateAvailable>获取是否有自动更新可用(不受服务器URL禁用)。
返回值: Promise<AutoUpdateAvailable>
getNextBundle()
getNextBundle()部分getNextBundle() => Promise<BundleInfo | null>获取下一次将在应用重载时使用的包。
如果没有下一个包设置,则返回 null。 Promise<BundleInfo | null>
返回值: 6.8.0
setShakeMenu(options: SetShakeMenuOptions) => Promise<void>启用或禁用shake菜单用于调试/测试目的
| 参数 | 类型 | 描述 |
|---|---|---|
options | SetShakeMenuOptions | 包含启用或禁用的布尔值以启用或禁用shake菜单 |
自: 7.5.0
isShakeMenuEnabled()
标题为“isShakeMenuEnabled()”的部分isShakeMenuEnabled() => Promise<ShakeMenuEnabled>获取shake菜单的当前状态
返回: Promise<ShakeMenuEnabled>
自: 7.5.0
接口
接口应用就绪结果
应用就绪结果| 属性 | 类型 |
|---|---|
bundle | BundleInfo |
包信息
包信息| 属性 | 类型 |
|---|---|
id | string |
version | string |
downloaded | string |
checksum | string |
status | BundleStatus |
更新地址
更新地址| 属性 | 类型 |
|---|---|
url | string |
统计URL
统计URL| 属性 | 类型 |
|---|---|
url | string |
频道URL
频道URL| 属性 | 类型 |
|---|---|
url | string |
下载选项
下载选项此 URL 和版本用于从服务器下载捆绑包。如果您使用后端,则所有信息都将通过方法 getLatest 提供。如果您不使用后端,则需要提供 URL 和捆绑包版本。SessionKey 如果您使用 CLI 命令加密捆绑包,则需要提供加密的结果。
| 属性 | 类型 | 描述 | 默认值 | 自 |
|---|---|---|---|---|
url | string | 捆绑包 zip 文件的 URL (例如:dist.zip),用于下载。 (此 URL 可以是任何 URL。例如:Amazon S3,一个 GitHub 标签,任何您托管的捆绑包的位置。) | ||
version | string | 捆绑包的版本 code/名称 | ||
sessionKey | string | 用于更新的会话密钥,当捆绑包使用会话密钥加密时 | undefined | 4.0.0 |
checksum | string | 用于更新的校验和,应为 sha256,如果捆绑包加密,则应使用私钥加密 | undefined | 4.0.0 |
manifest | ManifestEntry[] | Delta (manifest) 多文件下载的清单 | undefined | 6.1.0 |
| 属性 | 类型 |
|---|---|
file_name | string | null |
file_hash | string | null |
download_url | string | null |
BundleId
节名:BundleId| 属性 | 类型 |
|---|---|
id | string |
BundleListResult
节名:BundleListResult| 属性 | 类型 |
|---|---|
bundles | BundleInfo[] |
ListOptions
Section titled “ListOptions”| Prop | Type | Description | Default | Since |
|---|---|---|---|---|
raw | boolean | 是否返回原始包列表或清单。如果为真,列表将尝试读取内部数据库而不是磁盘上的文件。 | false | 6.14.0 |
ResetOptions
Section titled “ResetOptions”| Prop | Type |
|---|---|
toLastSuccessful | boolean |
CurrentBundleResult
当前包结果| 属性 | 类型 |
|---|---|
bundle | BundleInfo |
native | string |
多延迟条件
多延迟条件| 属性 | 类型 |
|---|---|
delayConditions | DelayCondition[] |
延迟条件
延迟条件| 属性 | 类型 | 描述 |
|---|---|---|
kind | DelayUntilNext | 设置延迟条件在 setMultiDelay |
value | string |
最新版本
最新版本| 属性 | 类型 | 描述 | 自 |
|---|---|---|---|
version | string | getLatest 方法的结果 | 4.0.0 |
checksum | string | 6 | |
major | boolean | ||
message | string | ||
sessionKey | string | ||
error | string | ||
old | string | ||
url | string | ||
manifest | ManifestEntry[] | 6.1 |
获取最新选项
获取最新选项| 属性 | 类型 | 简介 | 默认 | 自 |
|---|---|---|---|---|
channel | string | 获取最新版本的渠道必须允许 '自行分配' 才能工作 | undefined | 6.8.0 |
渠道结果
渠道结果| 属性 | 类型 | 获取最新版本的渠道当前状态 | 设置渠道选项 |
|---|---|---|---|
status | string | 自 | 4.7.0 |
error | string | ||
message | string |
| 属性 | 类型 |
|---|---|
channel | string |
triggerAutoUpdate | boolean |
清除频道选项
Section titled “清除频道选项”| 属性 | 类型 |
|---|---|
triggerAutoUpdate | boolean |
获取频道结果
Section titled “获取频道结果”| 属性 | 类型 | 描述 | 自从 |
|---|---|---|---|
channel | string | 获取频道的当前状态 | 4.8.0 |
error | string | ||
message | string | ||
status | string | ||
allowSet | boolean |
ListChannelsResult
标题:ListChannelsResult| 属性 | 类型 | 描述 | 自从 |
|---|---|---|---|
channels | ChannelInfo[] | 可用的频道列表 | 7.5.0 |
ChannelInfo
标题:ChannelInfo| 属性 | 类型 | 描述 | 自 |
|---|---|---|---|
id | number | 数字频道 ID | 7.5.0 |
name | string | 频道名称 | 7.5.0 |
public | boolean | 如果为 true,则这是一个默认/备份频道。设备无法自行将其分配到公共频道。相反,当设备使用 unsetChannel())将其频道重写移除时,它将自动从匹配的公共频道接收更新。 | 7.5.0 |
allow_self_set | boolean | 如果为 true,则设备可以使用 setChannel())显式将其分配到此频道。通常用于 beta 测试、 A/B 测试或优惠升级跟踪。 | 7.5.0 |
频道命令使用频道 name,而不是数字 id.
SetCustomIdOptions
Section titled “自定义ID选项”| 属性 | 类型 |
|---|---|
customId | string |
| 属性 | 类型 |
|---|---|
version | string |
| 属性 | 类型 |
|---|---|
deviceId | string |
插件版本
插件版本| 属性 | 类型 |
|---|---|
version | string |
自动更新
属性| 类型 | 插件监听器句柄 |
|---|---|
enabled | boolean |
属性
类型| 下载事件 | PluginVersion |
|---|---|
remove | () => Promise<void> |
Prop
下载事件| 属性 | 类型 | 描述 | 自 |
|---|---|---|---|
percent | number | 下载进度,范围为 0 到 100。 | 4.0.0 |
bundle | BundleInfo |
无需事件
属性| 类型 | 描述 | 自 | protectedTokens |
|---|---|---|---|
bundle | BundleInfo | 下载进度,范围为 0 到 100。 | 4.0.0 |
UpdateAvailableEvent
更新可用事件| Prop | Type | 描述 | Since |
|---|---|---|---|
bundle | BundleInfo | 下载进度,范围为 0 到 100。 | 4.0.0 |
DownloadCompleteEvent
下载完成事件| Prop | Type | 描述 | 自 |
|---|---|---|---|
bundle | BundleInfo | 当有新版本可用时触发。 | 4.0.0 |
MajorAvailableEvent
标题:MajorAvailableEvent| 属性 | 类型 | 描述 | 自 |
|---|---|---|---|
version | string | 当有新主要捆绑包可用时触发。 | 4.0.0 |
UpdateFailedEvent
标题:UpdateFailedEvent| 属性 | 类型 | 描述 | 自 |
|---|---|---|---|
bundle | BundleInfo | 当更新安装失败时触发。 | 4.0.0 |
下载失败事件
标题:下载失败事件| 属性 | 类型 | 描述 | 自 |
|---|---|---|---|
version | string | 当下载失败时触发。 | 4.0.0 |
AppReadyEvent
AppReadyEvent| 属性 | 类型 | 描述 | 自 |
|---|---|---|---|
bundle | BundleInfo | 当应用程序准备好使用时发出。 | 5.2.0 |
status | string |
AutoUpdateAvailable
AutoUpdateAvailable| 属性 | 类型 |
|---|---|
available | boolean |
SetShakeMenuOptions
Section titled “设置抖动菜单选项”| 属性 | 类型 |
|---|---|
enabled | boolean |
抖动菜单启用
Section titled “抖动菜单启用”| 属性 | 类型 |
|---|---|
enabled | boolean |
Bundle状态
Section titled “Bundle状态”pending:.Bundle正在等待被 设置 作为下一个捆绑包。 下载中:捆绑包正在下载中。 成功:捆绑包已下载并准备好
‘success’ | ‘error’ | ‘pending’ | ‘downloading’
‘background’ | ‘kill’ | ‘nativeVersion’ | ‘date’
错误:捆绑包下载失败。
延迟到下一个标题:延迟到下一个 继续从功能和设置 to plan dashboard and API operations, connect it with Using @capgo/capacitor-updater 为使用@capgo/capacitor-updater的本地能力 API概述 为API概述的实现细节 介绍 为介绍的实现细节 API密钥 为API密钥的实现细节,以及 设备 为设备的实现细节