Recent updates

JPush HarmonyOS SDK v1.3.1

Release date

• 2025-08-08

Change Log

• Fixed known issues

Upgrade notes

• If upgrading from v1.1.0 or below, note the init API change:
• From JPushInterface.init(uiContext: common.ApplicationContext) to JPushInterface.init(uiContext: common.UIAbilityContext | common.AbilityStageContext)
• From v1.1.1, setClickWant returns result data via notification; callback is optional:
• From JPushInterface.setClickWant(want) to JPushInterface.setClickWant(want): Promise<JMessage_ | undefined>
• From v1.1.1, receiveExtraDataMessage requires RemoteNotificationExtensionAbility:
• From JPushInterface.receiveExtraDataMessage(remoteNotificationInfo: pushCommon.RemoteNotificationInfo): Promise<JMessageExtra_ | undefined> to JPushInterface.receiveExtraDataMessage(rNEAbility: RemoteNotificationExtensionAbility,remoteNotificationInfo: pushCommon.RemoteNotificationInfo): Promise<JMessageExtra_ | undefined>
• See API documentation

JPush HarmonyOS SDK v1.3.0

Release date

• 2025-08-04

Change Log

• Support push via JPush proprietary channel
• New APIs
• See API documentation for v1.3.0+ APIs
• Fixed known issues

Upgrade notes

• If upgrading from v1.1.0 or below, note the init API change:
• From JPushInterface.init(uiContext: common.ApplicationContext) to JPushInterface.init(uiContext: common.UIAbilityContext | common.AbilityStageContext)
• From v1.1.1, setClickWant returns result data via notification; callback is optional:
• From JPushInterface.setClickWant(want) to JPushInterface.setClickWant(want): Promise<JMessage_ | undefined>
• From v1.1.1, receiveExtraDataMessage requires RemoteNotificationExtensionAbility:
• From JPushInterface.receiveExtraDataMessage(remoteNotificationInfo: pushCommon.RemoteNotificationInfo): Promise<JMessageExtra_ | undefined> to JPushInterface.receiveExtraDataMessage(rNEAbility: RemoteNotificationExtensionAbility,remoteNotificationInfo: pushCommon.RemoteNotificationInfo): Promise<JMessageExtra_ | undefined>
• See API documentation

JPush HarmonyOS SDK v1.2.0

Release date

• 2025-02-12

Change Log

• Historical feature improvements
• New setCustomMessageMaxCacheCount to set local custom message cache count.

Upgrade notes

• If upgrading from v1.1.0 or below, note the init API change:
• From JPushInterface.init(uiContext: common.ApplicationContext) to JPushInterface.init(uiContext: common.UIAbilityContext | common.AbilityStageContext)
• From v1.1.1, setClickWant returns result data via notification; callback is optional:
• From JPushInterface.setClickWant(want) to JPushInterface.setClickWant(want): Promise<JMessage_ | undefined>
• From v1.1.1, receiveExtraDataMessage requires RemoteNotificationExtensionAbility:
• From JPushInterface.receiveExtraDataMessage(remoteNotificationInfo: pushCommon.RemoteNotificationInfo): Promise<JMessageExtra_ | undefined> to JPushInterface.receiveExtraDataMessage(rNEAbility: RemoteNotificationExtensionAbility,remoteNotificationInfo: pushCommon.RemoteNotificationInfo): Promise<JMessageExtra_ | undefined>
• See API documentation

JPush HarmonyOS SDK v1.1.1

Release date

• 2024-10-08

Change Log

• Historical feature improvements
• New setMobileNumber for SMS fallback when push cannot be delivered.

Upgrade notes

• Init API update:
• From JPushInterface.init(uiContext: common.ApplicationContext) to JPushInterface.init(uiContext: common.UIAbilityContext | common.AbilityStageContext)
• setClickWant returns result data via notification; callback is optional:
• From JPushInterface.setClickWant(want) to JPushInterface.setClickWant(want): Promise<JMessage_ | undefined>
• receiveExtraDataMessage requires RemoteNotificationExtensionAbility:
• From JPushInterface.receiveExtraDataMessage(remoteNotificationInfo: pushCommon.RemoteNotificationInfo): Promise<JMessageExtra_ | undefined> to JPushInterface.receiveExtraDataMessage(rNEAbility: RemoteNotificationExtensionAbility,remoteNotificationInfo: pushCommon.RemoteNotificationInfo): Promise<JMessageExtra_ | undefined>
• See API documentation

JPush HarmonyOS SDK v1.1.0

Release date

• 2024-08-13

Change Log

• HarmonyOS BackgroundPayload background messages
• HarmonyOS ExtensionPayload notification extension messages
• HarmonyOS VoIPCallPayload VoIP call messages
• stopPush and resumePush
• setBadgeNumber for badge
• onClickMessage(jMessage: JMessage) update:
• extras type changed from string to Record<string, Object>

Upgrade notes

• Bytecode packaging per official requirements:
• Upgrade DevEco Studio to 5.0.3.500+: Download
• Integration updates: HarmonyOS SDK integration guide
• Set "useNormalizedOHMUrl": true in project-level build-profile.json5

JPush HarmonyOS SDK v1.0.0

Release date

• 2024-04-25

Change Log

• First release of JPush SDK for HarmonyOS Next

Upgrade notes

• See HarmonyOS SDK integration guide.