Alipay International Mini Program Development PlatformAlipay International Mini Program Development PlatformDOCS

Release notes

V2.61.5

Release date: 2024-12-12

New

  • Added support for the dark mode adaptation (system version: Android 10 and above versions)
  • Added the filePath field to the my.downloadFile JSAPI, which supports renaming the file upon download.
  • Added support for integrating HUAWEI Maps by using the map component.
  • Modified the integration method for map components, including Google and HUAWEI Maps.
  • Modified the customized permission popup API, add GriverLocalPermissionDialog to replace the original LocalPermissionDialog.
  • 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.

Fixed

  • Fixed the issue where the arrow after the mini program name in more pop-ups is not visible when the name is too long.
  • Fixed the issue where the my.downloadFile JSAPI fails to download because the file name is too long.
  • Fixed the memory exception that is caused by an oversized "Icon" image on the "Splash" page.
  • Fixed the exception with abnormal URL retrieval for image screenshot.
  • Fixed the empty exception for image "Item".
  • Fixed the incorrect internal handling of parameters in the my.scan JSAPI.
  • Fixed the issue where the keyboard was not destroyed when closing the mini program after the mini program invokes the keyboard on certain devices.
  • Fixed the "Out of Memory" error when getting the system information.
  • Fixed the issue where Lottie animations do not display under certain conditions.

v2.59.2

Release date: 2024-08-30

New

  • In the response of the fetchApps API å’ŒfetchAppInfosById API, add the firstPublishTime parameter in the AppInfo and FetchAppInfo 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 the issue that the navigation bar (NavigationBar) obscures the page on some phones.
  • Fixed the potential crash issue when retrieving the external cache directory.
  • Fixed the potential crash issue when H5 exits the full-screen video playback.
  • Fixed the issue that the my.getNetworkType JSAPI fails to retrieve the current network type.
  • Fixed the default alignment of Google Maps markers to be bottom-centered.
  • Fixed the issue with abnormal triggering of the mini program OptionMenu API events.
  • Fixed the issue that PDF files with the suffixes of authentication information cannot be opened.
  • Fixed the memory leak issue that is caused by opening the share pop-up and other more pop-ups.
  • Fixed the crash issue that is caused by opening the share pop-up in special scenarios.
  • Fixed the white screen issue when opening the encrypted PDFs with the my.openDocument JSAPI.
  • Fixed the crash issue that is caused by enabling the direction sensor listening with the my.startDeviceMotionListening JSAPI.

v2.57.1

Release date: 2024-07-17

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

    • Image cannot be swiped after zooming in.
    • Lagging occurs when attempting to zoom in on an image using pinch gestures on a mobile device.
  • Fixed the issue that the video compenent is unable to extend full screen horizontally by updating the minAspectRatio parameter in the app.json file.
  • For the map component, updated the markers parameter to fix the iconPath type and take it effect.
  • Fixed the issue that loading the mini-program title could potentially cause a crash.
  • Fixed the issue that in the landscape mode on mobile devices, openning the "about" page switches to the portrait orientation incorrectly.
  • For the my.getSystemInfo JSAPI, fixed the issue that this JSAPI incorrectly retrieves the title bar height on certain mobile devices.
  • Fixed the issue that for Android 11 and above versions，in H5, unable to obtain file path after selecting external storage files.
  • Fixed the issue when loading H5 webpages, the background color is incorrectly displayed by updating the containerBackgroundColor parameter.
  • For the setTransparentTitle JSAPI, when the transparentTitle parameter is set as auto or always, fixed the following issues:
    • The web-view page is not properly displayed, for example, the corresponding transparent effect of the Title bar does not appear.
    • The blank space should not be displayed at the bottom of the web-view page.

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.
  • Added the window.minAspectRation parameter in the app.json file, enabling mini programs to set screen display ratio.
  • Updated the my.request JSAPI to support the following HTTP methods: PUT, DELETE, OPTIONS, and HEAD.
  • Updated the my.choosePhoneContact JSAPI to help mini-program developers identify errors that occur in the following scenarios:
    • The user cancels the contact selection.
    • The super app lacks permission to access phone contacts.
  • 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.

  • Enabled the super app set minSdkVersion in the build.gradle file to earlier versions, beginning with 17, to support older Android devices. However, to ensure the proper function of DSL mini programs, it is recommended to set minSdkVersion to 23 or later.

Fixed

  • Fixed an issue specific to the my.request JSAPI, avoiding the headers.Content-Type parameter to be incorrectly overwritten as application/json when the mini program specifies different values.
  • Fixed a mini-program title display issue that occurred when opening an HTML5 link containing spaces.
  • Fixed a potential null pointer exception that occurred during the hot startup of mini-programs.
  • Fixed inaccuracies in the data reporting of the number of JSAPI calls in mini-programs.
  • Fixed a potential crash that occurred when playing videos in mini programs.
  • Fixed the issue where the titleColor startup parameter could not work on some pages.

v2.53.0

Release date: 2024-02-29

Enhanced

Enabled the page.onShareAppMessage function to display the share panel by default without implementing the GriverSharePanelExtension interface.

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.
  • Fixed the issue where the tab bar could not display properly when the my.reLaunch JSAPI was called to open a new page under certain circumstances.
  • Fixed an issue with the my.getLocation JSAPI to ensure proper fallback to the device's location service when GMS (Google Mobile Services) was unavailable.

v2.52.0

Release date: 2024-01-31

Enhanced

    • 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.

Fixed

  • Improved the SDK startup to fix an ANR (Application Not Responding) issue caused by a prolonged startup duration.
  • Fixed a cache clearing issue with the fetchLaunchableGroupsWithCodes API, ensuring a correct language display when the user's language preference changes.

v2.51.0

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.
  • Added support for Android 14 (targetSDKVersion 34).
  • Added GriverSecurityExtension to enable super apps to encrypt local data stored through local-storage JSAPIs. For more information, refer to Encrypt local data for enhanced security.

Enhanced

  • Removed the need for phone call permissions from the my.getNetworkType JSAPI.
  • Removed the need for album and audio permissions from the my.chooseFileFromDisk JSAPI.
  • Removed the need for album permissions from the my.openDocument JSAPI.
  • Removed the need for album and audio permissions from file selections with the HTML <input> element.

Fixed

  • Fixed an issue with the mini-program title bar, ensuring consistent font and complete center alignment of the text.
  • Fixed the following issues that are specific to the my.chooseVideo JSAPI:
    • Returned incorrect video sizes and dimensions.
    • Returned unintended video paths.
  • Fixed a potential app crash that occurred when switching the app to the foreground with an open HTML5 mini program, and the system recycled the app in the background.
  • Fixed the issue where the text on error pages could not be displayed properly under certain scenarios.
  • Fixed the issue where PDF files were displayed with distortion when opened via the my.openDocument JSAPI.

v2.50.3

Release date: 2023-11-24

New

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

Enhanced

Improved the functionality of HTML5 mini programs for handling PDF files as follows:

  • Enabled opening of PDF files that lack a .pdf extension.
  • Removed the blank page that previously appeared during the PDF file's loading process.

Fixed

  • Fixed the issue where the my.getLocation JSAPI passed an incorrect error code to mini programs when the user disabled the app's location permission during the JSAPI call.
  • Removed invalid files and links that might pose security risks.

v2.50.2

Release date: 2023-10-27

New

  • Added Arabic to the supported languages. For more information, refer to Language.
  • Added a back button to the TitleBar for both HTML5 and native mini programs.
  • Enabled to optimize resource delivery for H5+ mini programs.

Enhanced

Updated the my.request JSAPI as follows:

  • Supported multiple Set-Cookie headers in the response.
  • Added the enableCookie request parameter.

Fixed

  • Fixed the occasional page height calculation errors that caused the page layout increase on smartphones with virtual buttons after exiting full-screen videos.
  • Fixed the issue where the customized status error page appeared blank in certain scenarios due to duplicate query parameters.
  • Fixed the unresponsive behavior of the Open File With button when the my.openDocument JSAPI has not obtained corresponding system permissions.
  • Fixed the issue where the splash page displayed the incorrect mini-program name and icon when opening a mini program through the QR codes for preview or debugging.
  • Fixed the issue where the toast dialog triggered by the my.showToast API was not displayed on some Huawei devices.
  • Fixed the issue where the language response parameter of the my.getSystemInfo JSAPI was not promptly updated due to caching.

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 where HTML5 pages cannot be opened when their URLs include the u query parameter.
  • Fixed the issue where the page title of the mini program was displayed abnormally due to the upgrade of Android System WebView.

Notes:

  • We have migrated old support libraries to AndroidX libraries from this version. To ensure the SDK performance, it is recommended to conduct a compatibility test after integration. For more information about the migration, refer to Android documentation on Migrate to AndroidX.
  • From Android IAPMiniProgram SDK v2.47.0, the SDK is adapted to support Google Maps version 21.0.1. This upgraded version of Google Maps introduces API changes and enhancements. For more information, refer to Google's release note on October 13, 2022. If you have a local dependency on Google Maps, make sure to upgrade your play-services-location library to version 21.0.1 or higher with the following sample codes:
copy
implementation 'com.google.android.gms:play-services-location:21.0.1'

v2.45.1

Release date: 2023-07-12

Fixed

Fixed the issue that the header parameter in the my.downloadFile JSAPI was not consumed when passed.

v2.45.0

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 the following two issues that are related to the prefetching feature:
    • The value of the query parameter obtained each time is the initial startup parameters when opening a mini program multiple times.
    • Format conversion problems when calling the getBackgroundFetchData method in certain scenarios.
  • Fixed crashes in the following scenarios:
    • Open large PDF files
    • Call the addEmbedView method when rendering via same-layer rendering components
    • Start video playing when the playing state of the video player components does not support it
    • Pass values that include the special character / to the openUrl method

v2.44.1

Release date: 2023-06-15

Fixed

Fixed the issue of abnormal page title display in mini programs that was caused by the upgrade of Android System Webview.

v2.44.0

Release date: 2023-05-30

New

Added the my.createLivePlayerContext JSAPI to support playing live-streaming videos.

Enhanced

Removed links using the HTTP protocol from Android IAPMiniProgram SDK to enhance security.

Fixed

Resolved the incompatibility with Google Maps version 21.