Alipay International Mini Program Development PlatformAlipay International Mini Program Development PlatformDOCS

Release notes

v2.61.2

Release date: 2024-11-22

New

  • Added support for the dark mode adaptation (system version: iOS 13 and above versions)
  • Added the filePath field to the my.downloadFile JSAPI, which supports renaming the file upon download.
  • Added customized domain interface.
  • Added the my.isCollected JSAPI to obtain the collection status of a mini program.
  • Added the my.getMenuButtonBoundingClientRect JSAPI to obtain the layout position information of the capsule button (the top-right capsule) and the favorite button.
  • Adapted for iOS 18
  • Provided full values for the scope value in the callback function showAuthWithParam of the customized user authorization prompt.

Fixed

  • Fixed the issue where there was window occlusion problems for the my.setBackgroundColor JSAPI.
  • Fixed the issue where the my.downloadFile JSAPI failed to download because the file name is too long.
  • Fixed the incorrect internal handling of parameters in the my.scan JSAPI.
  • Fixed the issue where in the "about" page, the language cannot change according to the appLanguageDelegateparameter. Now, it can change correspondingly.

v2.59.0

Release date: 2024-08-30

New

  • Added the GRVAppEventDelegate interface to listen for the opening and closing events of the mini program.
  • In the response of the fetchApps API and fetchAppInfosById API, add the firstPublishTime parameter in the GRVAppInfo and GRVApplicationInfoModel objects.
  • Add the nbupdate parameter to configure the mini program update mode (Default mode, Async mode, and Sync mode). For details see Mini program update mechanism.

Enhanced

  • Optimized the multilingual UI texts for the About and Rating pages in the mini program platform.

Fixed

  • Fixed occasional crashes where the completionHandler of the WKUIDelegate callback is not called in specific scenarios.
  • Fixed the YouTube video playback issues on iOS 17 and above.
  • Fixed the occasional appearance of white lines below the navigation bar on H5 pages on iPhone devices with Dynamic Island.
  • Fixed the issue that the my.getBatteryInfo JSAPI retrieves inaccurate battery information.

v2.57.0

Release date: 2024-07-01

New

Enhanced

  • For the my.request JSAPI, updated the logic of the enableCookie parameter. By default, the value of enableCookie is true, which indicates to use the Mini Program cookies. If there are no Mini Program cookies, cookies in the local cache are used.
  • For the my.chooseImage JSAPI, optimize the popup message when choosing images on mobile devices.
  • For the my.chooseVideo JSAPI, optimize the popup message when choosing videos on mobile devices.
  • For the my.showAuthGuide JSAPI, optimize the permission request popup message on mobile devices.
  • For the my.multiLevelSelect JSAPI, optimize the popup message on mobile devices.

Fixed

  • Fixed the issue when the my.relaunch JSAPI is used, there is something wrong with the Home button display in the Mini Program home page.
  • For the my.chooseVideo JSAPI, fixed the issue that incorrect width is returned when using the camera to record videos.
  • For the my.previewImage JSAPI, fixed the issue that image layering occurs when pinching to zoom and dragging images on a mobile device.

v2.55.1

Release date: 2024-04-30

New

  • Added the my.getFileSystemManager JSAPI, enabling mini programs to operate files within their file systems.
  • Added the my.hideShareMenu and my.showShareMenu JSAPIs, enabling mini programs to control the visibility of the share button on the more option menu if the super app supports the share capacity.

Enhanced

  • Enabled the option to disable data reporting within IAPMiniProgram SDK.
  • Updated the my.request JSAPI to support the following HTTP methods: PUT, DELETE, OPTIONS, and HEAD.
  • Updated several JSAPIs to help mini-program developers identify permission-related errors that occur in the following scenarios:
    • The user directly declines a permission request.
    • The user has previously denied a permission request and opted not to receive the same request again.

The updated JSAPIs include my.getLocation, my.chooseImage, my.chooseVideo, and my.scan.

  • Updated the version requirements for the public third-party library dependencies for the iOS IAPMiniProgram SDK as follows:
    • SocketRocket: from 0.5.1 to 0.5.1 or later (>= 0.5.1)
    • ZipArchive: from 1.4.0 to 1.4.0 or later (>= 1.4.0)

Note: With this update, if your project's Podfile does not specify the version numbers for the mentioned libraries, the SDK defaults to using the latest available versions from their official websites. For enhanced stability, if your project does not require specific versions of these libraries, it is recommended to use the following thoroughly-tested versions:

    • SocketRocket: 0.5.1
    • ZipArchive: 1.4.0

To use the recommended library versions, add the following lines to your Podfile:

copy
pod 'SocketRocket', '0.5.1'
pod 'ZipArchive', '1.4.0'

Fixed

  • Fixed the issue where the CanvasContext.toTempFilePath function did not work properly.
  • Fixed an issue specific to the my.chooseImage JSAPI, ensuring to show an error message instead of a black-screen camera when access to the system's camera and album is denied.

v2.53.0

Release date: 2024-02-29

Fixed

Ensured the following functions of the input component when the value of type is number:

  • Display the numeric keypad.
  • Correctly limit the input length that is specified by maxlength.

v2.52.0

Release date: 2024-01-31

Enhanced

  • Added a privacy manifest file to declare the use of Required Reason APIs, ensuring compliance with iOS privacy policies. For more information, refer to the iOS documentation on Privacy manifest files.
  • Improved the my.uploadFile JSAPI as follows:
    • Deprecated the fileType request parameter.
    • Added the timeout request parameter to enable mini-program developers to set a timeout period for requests.
    • Added the hideLoading request parameter to enable mini-program developers to customize the display of a loading icon during the uploading process.
  • Enabled the fetchAppInfosByIds and fetchApps APIs to return mini-program information according to the language preference on the user's device.

Fixed

  • Fixed a cache clearing issue with the fetchLaunchableGroupsWithCodes API, ensuring a correct language display when the user's language preference changes.

v2.51.1

Release date: 2024-01-09

New

  • Added the Biometric Authentication component for user authentication in mini programs, enabling the use of fingerprint or face ID. For more information, refer to Integrate the Biometric Authentication component.
  • Added the cover-view component to enable mini-program developers to overlay a text view on native components. For more information, refer to cover-view.
  • Added the user rating functionality, enabling mini-program users to rate and provide reviews for mini programs.
  • Enabled the titlePenetrate property in the window attribute to allow mini-program developers to set the click-through ability on the navigation bar. For more information, refer to window.
  • Added GRVSecureLocalStorageEncryptorProtocol to enable super apps to encrypt local data stored through local-storage JSAPIs. For more information, refer to Encrypt local data for enhanced security.

Fixed

  • Fixed the issue where the tab bar could partially cover page content.
  • Fixed a potential crash when consuming IconFont images in HTML5 pages.
  • Fixed an occasional crash when opening HTML5 pages in certain iOS versions.
  • Fixed an issue with the date picker that was caused by a bug in NSCalendar in iOS 17.
  • Fixed the issue where HTML5 pages that were opened via the my.pushWindow JSAPI could not retrieve the startup parameters of the previous HTML5 page.

v2.50.2

Release date: 2023-11-24

New

Added Spanish to the supported languages. For more information, refer to Language.

Fixed

  • Fixed the issue where HTML5 mini programs failed to retrieve startup parameters with the my.getStartupParams JSAPI call when opened via the my.pushWindow JSAPI.
  • Removed invalid files that might pose security risks.

v2.50.1

Release date: 2023-11-10

Fixed

  • Fixed an issue in iOS IAPMiniProgram SDK v2.50.0 where the version constraint was missing in the dependency descriptions for IAPResourceManager (the inner framework).
  • Fixed an issue specific to Alipay+ D-store mini programs in the iOS IAPMiniProgram SDK. The fix ensures that the correct value is passed to the type input parameter of the getAuthCode function for your local implementation of IAPWalletOAuthServiceSignature. You can ignore this fix if any of the following situations apply to you:
    • You have never used the mentioned type input parameter.
    • You have overridden the implementation of the my.getAuthCode JSAPI.
    • Your super app does not have any Alipay+ D-store mini programs.

v2.50.0

Release date: 2023-10-27

Note: This release of iOS IAPMiniProgram SDK v2.50.0 contains a critical bug in IAPResourceManager (the inner framework). Please update to iOS IAPMiniProgram SDK v2.50.1, which resolves this issue.

New

  • Added Arabic to the supported languages. For more information, refer to Language.
  • Enabled to optimize resource delivery for H5+ mini programs.

Enhanced

  • Added the Nullability annotation to the GRVURLNavigationEventDelegate and the GRVNavigationContext interfaces to improve compatibility with Swift.
  • Updated the my.request JSAPI as follows:
    • Supported multiple Set-Cookie headers in the response.
    • Added the enableCookie request parameter.

Fixed

  • Fixed the potential crash with the my.chooseFileFromDisk JSAPI.
  • Fixed a potential network crash.
  • Fixed the TabBar functionality issue that caused the clicks on the TabBar to unintentionally interact with the underlying page.
  • Fixed the potential unresponsive behavior of the popup triggered by the my.datePicker JSAPI.
  • Fixed the issue where the URL within the iFrame did not update accordingly when a 302 redirection occurred.
  • Fixed the issue where the iOS IAPMiniProgram SDK was not initialized properly when WKWebView was used before the SDK initialization.
  • Fixed the issue where the web-view component of DSL mini programs might stop rendering when the super app was moved back to the foreground on iOS 17.

v2.47.0

Release Date: 2023-08-11

New

Enabled subpackage loading in mini programs. For more information about this feature, refer to Subpackage loading.

Fixed

Fixed the issue of unresponsive action buttons on a date selection popup that was triggered by calling the my.datePicker JSAPI multiple times.

v2.45.6

Release date: 2023-07-10

Fixed

Fixed the issue that the navigation bar color was permanently white in iOS 17 Public Beta.

v2.45.1

Release date: 2023-06-28

New

Added the <youtube-player> tag to support playing YouTube videos in mini programs.

Enhanced

Improved the integration with the share feature in the more menu of mini programs by adding a new extension point.

Fixed

Fixed potential crashes when using configuration components to save data containing arrays.

v2.44.0

Release date: 2023-05-30

New

  • Added the my.createLivePlayerContext JSAPI to support playing live-streaming videos.
  • Supported the Xcode 14 compilation, which requires a minimum system version of iOS 11.
  • Supported the HTTP/3 protocol for HTML5 IAPMiniProgram SDK.

Fixed

Fixed the issue where the customized favorite button image cannot change its color to adapt to the theme of the navigation bar.