Alipay International Mini Program Development PlatformAlipay International Mini Program Development PlatformDOCS

FAQ

Why am I stuck on the login success page or unable to access mini programs after logging in to the IDE?

This issue might occur if two-factor authentication (2FA) is triggered on Mini Program Platform. To resolve it:

  1. Log in to Mini Program Platform with the same account.
  2. Complete the 2FA process by entering the verification code.
  3. Restart the IDE.

How do I resolve a black screen when opening the IDE?

A black screen often means your account lacks permissions. To resolve it, contact your workspace admin and request the following access based on your workspace type:

Workspace type

Required role

Notes

Tenant Workspace (super apps)

Workspace Admin

N/A

Workspace Developer

Ensure that the target mini programs are assigned to you.

Developer Workspace (merchants)

Developer Admin

N/A

Developer

Ensure that the target mini programs are assigned to you.

Why can't I open the simulator in the IDE?

This issue occurs if you open the wrong file directory. Ensure to open the correct one instead.

Why does the IDE fail to create build tasks?

Creating build tasks requires the version number of the build to be greater than the highest version number already uploaded to Mini Program Platform. To fix this, restart the IDE and re-upload the build with an updated (greater) version number.

How to resolve errors during code build, preview, or upload in the IDE?

Take the following steps to resolve these errors:

  1. Retry the operation

Retry to confirm whether the error is temporary. If it persists, go to step 2.

  1. Check network connectivity. Complete the following checks:
    • In your terminal, run the ping miniprogram.alipay.com command to check connectivity to Mini Program Platform's servers.
    • Ensure your local network can access the OSS upload endpoint for your site.

If either check fails, troubleshoot your local network. If both checks succeed, go to step 3.

  1. Contact technical support for troubleshooting with the network request's trace ID. To obtain the trace ID:
    1. Use tools like Charles or Proxyman to capture network traffic.
    2. Inspect requests to https://miniprogram.alipay.com and look for the request containing "operationType": "gmp.openplatform.app.build.package".
    3. Extract the trace ID from the request.

What if the SDK version is earlier than the required one?

Mini Program Platform can handle backward compatibility by compiling and building the source code into the following types of packages:

  • A complete source code package for the SDKs that do not support subpackage loading.
  • A subpackaged source code package for the SDKs that support subpackage loading.

What should I do if the package size (main package or subpackage) is too large?

It is recommended to keep the size of the main package or each subpackage within 2 MB. If your package size exceeds the limit, you can reduce it by storing some resources (such as images) on the server. If the package size is still an issue, you can segment the resources further with more subpackages.

For more information, see Subpackage loading.

What's the maximum size of a mini program when uploading by CLI to Mini Program Platform?

The maximum size of a mini program when uploading by CLI to Mini Program Platform is 100 MB. This is a limitation. Check the following table for more information.

Size of a mini program project (source package)

Actions

If the size is >= 100M

It will stop further operations and the following message on the console will pop up "Source package size is abnormal (too large), please check and reconfigure before retrying".

If 8M=< size < 100M

It will proceed the subsequent operations, but the following message on the console will pop up "Please note that the source package has a large file size, which may not good for user experience. Consider splitting packages (subpackage loading) or reducing package size."

Related information: